Javascript 기초 (19) 좋은 주석

코린이서현이·2023년 8월 7일
0

🙂좋은 주석에 대해서 아주 짧게🙂

🙅‍♀️ 좋지 않은 주석

  • 코드에서 일어나는 일 -> 코드가 불분명하게 적어라
    (함수를 활용해서!)

🙆 좋은 주석

  • 아키택처
  • 함수 용례와 매개변수 정보를 담고 있는 주석
  • 당장봐선 명확해 보이지 않는 해결방법에 대한 설명

🗒️ 함수 용례 작성 문법

태그설명
@author개발자 이름
@constructor함수를 생성자로 표시합니다.
@deprecated메서드를 더 이상 사용되지 않는 것으로 표시합니다.
@exception@throws의 동의어
@exports모듈에서 내보낸 멤버를 식별합니다.
@param메서드 매개변수를 문서화합니다. 중괄호 사이에 데이터 유형 표시기를 추가할 수 있습니다.
ex) @param {number} x 거듭제곱할 숫자
@private멤버가 비공개임을 나타냅니다.
@returns반환 값 문서화
@return@returns의 동의어
@see다른 개체에 대한 연결을 문서화합니다.
@todo누락된/열린 것을 문서화합니다.
@this키워드 this가 함수 내에서 참조하는 개체의 유형을 지정합니다.
@throws메서드에 의해 발생한 예외를 문서화합니다.
@version라이브러리의 버전 번호를 제공합니다.
profile
24년도까지 프로젝트 두개를 마치고 25년에는 개발 팀장을 할 수 있는 실력이 되자!

0개의 댓글