2025-11-22 JS注解怎么标注数组类型:JS数组类型参数的注解方法与示例 JS注解怎么标注数组类型:JS数组类型参数的注解方法与示例 js /** * @typedef {Object} User * @property {string} name - 用户姓名 * @property {number} age - 用户年龄 *//** * 计算用户平均年龄 * @param {User[]} users - 用户数组 * @returns {number} */ function calculateAverageAge(users) { // 实现逻辑 }此外,还有一种历史写法是使用Array.<T>格式,如{Array.<string>},它与{string[]}等价。尽管这种语法仍然被支持,但在现代开发中已逐渐被方括号形式取代,因其更接近ES6+的数组类型表达习惯。对于多维数组,JSDoc同样支持嵌套标注。例如,二维数字数组可以写作{number[][]},表示“数组的数组,每一项都是数字”。这在处理矩阵或表格数据时非常有用:js /** * 计算二维数组总和 * @param {number[][]} matrix - 二维数字数组 * @returns... 2025年11月22日 2 阅读 0 评论
2025-11-12 JS注解在TypeScript环境下的应用 JS注解在TypeScript环境下的应用 javascript /** * @typedef {Object} User * @property {string} id - 用户唯一标识 * @property {string} name - 用户姓名 * @property {number} age - 用户年龄 *//** * 根据ID查找用户 * @param {string} id * @returns {User|null} */ function findUser(id) { // 模拟查找逻辑 return users.find(u => u.id === id) || null; }此时,当开发者调用 findUser() 并对返回值进行操作时,VSCode 等编辑器能准确提示 user.name、user.age 等属性的存在与否,就像在写原生 TypeScript 一样流畅。此外,对于泛型的支持也已逐步完善。虽然不能像 TS 那样直接写 <T>,但可以通过 @template 实现类似效果:javascript /** * @template T * @par... 2025年11月12日 16 阅读 0 评论