AZ Tools

JSON to JSDoc @typedef 생성기

개발

JSON 객체나 배열을 붙여넣으면 바로 사용할 수 있는 JSDoc @typedef 정의를 얻을 수 있습니다. 각 필드는 JSDoc 타입(string, number, boolean, type[])으로 매핑되고, 중첩 객체는 별도의 @typedef 블록으로 생성됩니다. TypeScript 없이 순수 JavaScript에 타입을 추가하기에 완벽합니다. null과 빈 배열은 * (any) 타입이 됩니다. 모든 처리는 브라우저에서 로컬로 실행되며 JSON은 업로드되지 않습니다.

JSDoc typedef

사용법

  1. 입력 상자에 JSON을 붙여넣거나 입력합니다.
  2. 선택적으로 루트 typedef 이름을 변경합니다(기본값 Root).
  3. 생성된 @typedef 블록을 JavaScript 소스에 복사합니다.

자주 묻는 질문

타입은 어떻게 매핑되나요?
문자열은 string, 모든 숫자는 number, 불리언은 boolean이 되고, 배열은 첫 번째 요소를 기준으로 type[]이 됩니다. 중첩 객체는 각각 고유한 @typedef를 가지며 이름으로 참조됩니다.
null이나 빈 배열은 어떻게 되나요?
샘플에서 타입을 추론할 수 없으므로 null은 * (any), 빈 배열은 *[]로 매핑됩니다. 실제 타입을 안다면 직접 좁혀주세요.
TypeScript 대신 JSDoc을 쓰는 이유는?
JSDoc @typedef는 빌드 단계나 .ts 파일 없이도(예: VS Code나 tsc --checkJs로) 순수 JavaScript를 문서화하고 타입 검사할 수 있게 해줍니다.
제 JSON이 어딘가로 전송되나요?
아니요. 변환은 전적으로 브라우저에서 이루어지며 아무것도 업로드되지 않습니다.

관련 도구