자바스크립트 작업을 할 때,
함수에 주석을 달아서 문서화(Doc?)해두면,
함수를 호출할 때 아래처럼 자동완성 툴팁이 노출되어 아주 편하다.
즉, 함수의 파라미터 타입, 반환값에 대한 정보를 보면서 프로그래밍할 수 있게 된다.
(작업 환경: VSCode 자바스크립트 개발)
# JS 함수의 문서화 주석 만드는 방법
1. 함수 선언
▶︎ 평소처럼 함수를 만들어준다.
▶︎ 여기서는 id, name을 파라미터로 받아서 반환하는 getInfo 함수를 선언했다.
2. 주석 생성
▶︎ 함수의 바로 윗부분에서 /** 까지만 입력한다.
▶︎ 아래와 같은 자동완성이 노출되면 엔터를 쳐준다.
3. 파라미터 타입
▶︎ @param {*} 파라미터 형식의 주석이 자동완성 되면,
▶︎ 대괄호 { } 사이에 number, string 등의 파라미터의 타입을 입력해 준다.
▶︎ tab을 쳐주면 다음 입력 항목으로 커서가 이동한다.
4. 파라미터 의미
▶︎ 파라미터의 뒷부분에는 해당 파라미터가 무엇을 의미하는지 입력해준다.
▶︎ 입력 완료 후 tab을 쳐주면서, 모든 파라미터에 대해 주석을 달아준다.
5. 반환값 의미
▶︎ @returns 뒤에는 반환값의 의미에 대해 입력해준다.
6. 함수 설명
▶︎ 리턴값 입력후 tab을 쳐주면, 커서가 맨위로 이동하는데,
▶︎ 함수 자체에 대한 설명을 입력해주면 끝난다.
7. 함수 호출
▶︎ 이제 함수 호출 시, 아래와 같이 함수에 대한 설명이 툴팁으로 노출된다.
▶︎ 또한 파라미터를입력할 때마다, 현재 입력 중인 파라미터가 무엇인지 표시되어 편하다.
참고로 위와 같이 /** */ 주석 사이에 @(어노테이션) 달아 문서화하는 포맷을 Javadoc 양식이라고 한다.
'개발(Development) > JS(자바스크립트)' 카테고리의 다른 글
HTML/JS: Audio 객체 음악 파일 제어 및 사운드 재생/정지 방법 (0) | 2021.06.19 |
---|---|
[자바스크립트] setInterval/clearInterval 반복 중단, 재시작(재개) 방법 (0) | 2021.06.03 |
[자바스크립트] 코드 실행 2단계와 변수/함수 생성 과정 (0) | 2021.04.08 |
[자바스크립트] 콜스택/메모리힙 구조, 데이터 저장/참조 원리 (0) | 2021.04.07 |
[자바스크립트] 메모리 구조, 원시타입 변수 생성 원리, 가비지컬렉터 (0) | 2021.04.07 |
댓글