JS로 타입 지정하기

javascript로 타입 지정?

우리는 javascript에 특징 중 하나인 type을 지정하지 않는 다는 것을 해결하기 위해 흔히 typescript를 사용한다.

그러나 javascript 또한 타입 지정이 가능하다.

JSDoc

JSDoc은 자바스크립트 API 문서 생성기다. 자바스크립트 소스코드에 JSDoc 형식의 주석을 추가하면 API를 설명하는 HTML 문서를 생성할 수 있다. JSDoc 주석은 /** ... */ 사이에 기술한다.

/**
 * @param {any[]} arr
 */
function compact(arr) {
  if (arr.length > 10) return arr.trim(0, 10);
  //                              ~~~~
  // 'any[]' 형식에 'trim' 속성이 없습니다.ts(2339)
  return arr;
}

/** @type {string} */
let str;

/** @type {number} */
let num;

/** @type {boolean} */
let bool;

/** @type {*} */
let any;

/** @type {?} */
let unknown;

/** @type {number[]} */
let nums;

/** @type { {id: number, content: string, completed: boolean} } */
let obj;

/** @type {string|number} */
let union;

/** @type {Array<{ id: number, content: string, completed: boolean }>} */
let generic;

다음과 같이 JSDoc을 통해 type이나 param 혹은 함수까지 타입 지정이 모두 가능하다.

참고 문서

JSDoc