至尊技术网

登录

标签搜索

搜索到 3 篇与的结果

JS函数可选参数的精准注解指南

JS函数可选参数的精准注解指南

正文：在JavaScript中，函数参数默认是可选的——即使定义时声明了参数，调用时也可省略。这种灵活性在带来便利的同时，也容易因参数缺失引发隐蔽的undefined错误。通过类型注解明确标记可选参数，不仅能提升代码可读性，还能借助工具实现静态检查。以下是两种通用注解方案：一、JSDoc：传统注释型注解适用于纯JavaScript环境，通过特殊注释语法向IDE或文档工具传递类型信息。核心语法是@param标签结合方括号[]：javascript /** * 计算圆柱体体积 * @param {number} radius 底面半径 * @param {number} [height] 可选：柱体高度（默认10） * @returns {number} */ function calculateCylinderVolume(radius, height) { const h = height ?? 10; // 处理可选参数默认值 return Math.PI * radius ** 2 * h; }// ✅ 合法调用 calculateCylinderVolum...

2025年12月14日

33 阅读

0 评论

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日

44 阅读

0 评论

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日

39 阅读

0 评论

悠悠楠杉

36,928 文章数

92 评论量

人生倒计时

今日已经过去小时

这周已经过去天

本月已经过去天

今年已经过去个月

最新回复

强强强
2025-04-07

强的一批
jesse
2025-01-16

有whmcs接口吗？
sowxkkxwwk
2024-11-20

博主太厉害了！
zpzscldkea
2024-11-20

博主太厉害了！
bruvoaaiju
2024-11-14

博主太厉害了！

标签云

强的一批
有whmcs接口吗？
博主太厉害了！
博主太厉害了！
博主太厉害了！
怎么收藏这篇文章？
怎么收藏这篇文章？
想想你的文章写的特别好
想想你的文章写的特别好
不错不错，我喜欢看