JavaScript常用注释规范

阿龙Aloner

已于 2025-08-08 15:42:08 修改

阅读量1.5k

点赞数 1

CC 4.0 BY-SA版权

于 2022-01-13 16:15:39 首次发布

本文链接：https://blog.csdn.net/weixin_44799428/article/details/122475720

前端专栏收录该内容

4 篇文章

订阅专栏

本文介绍了JSDoc注释规范的使用方法，包括@param/@argument、@returns、@author等标签的含义及应用场景，适用于TypeScript及JavaScript开发人员。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

@param/@argument 指定参数名和说明来描述一个函数参数

@returns 描述函数的返回值

@author 指示代码的作者

@deprecated 指示一个函数已经废弃，而且在将来的代码版本中将彻底删除。尽量避免使用这段代码

@version 指定发布版本

@throws @exception 描述函数可能抛出的异常的类型

@class 提供类的有关信息，用在构造函数的文档中

@constructor 明确一个函数是某个类的构造函数

@type 指定函数的返回类型

@extends 指示一个类派生了另一个类。JSDoc通常自己就可以检测出这种信息，不过，在某些情况下则必须使用这个标记

@final 指示一个值是常量值。要记住JavaScript无法真正保证一个值是常量

@default 指示参数的默认值

使用方式：

/**
 * @description一个示例函数
 * @author 泽 pro max plus
 * @version 0.0.1
 * @param number 输入一个数字
 * @param str 输入一个字符串
 * @returns 返回相加的结果
 */

export default function example(number: number, str: string) { //ts
    return number + str;
}

ts中可以定义interface后使用上述注释，可以在使用时能够给出提示信息

参考：JSDoc 注释规范 - jndream - 博客园