JSDoc：箭头函数参数答案

【问题标题】：JSDoc: arrow function paramsJSDoc：箭头函数参数
【发布时间】：2021-12-22 15:17:20
【问题描述】：

我正在尝试使用 JSDoc（EcmaScript 2015，WebStorm 12 Build 144.3357.8）记录我的代码。

我有一个箭头函数，我想记录它的参数。这两个例子有效（我得到自动完成）：

/** @param {Number} num1*/
var a = num1 => num1 * num1;
//------------------------------
/** @param {Number} num1*/
var a = num1 => {
    return num1 * num1;
};

但是，例如，当我想在 forEach 函数中记录箭头函数时，自动完成功能不起作用（以下所有内容）：

/** @param {Number} num1*/
[].forEach(num1 => {
    return num1 * num1;
});
//------------------------------
/** @param {Number} num1*/
[].forEach(num1 => num1 * num1);
//------------------------------
[].forEach(/** @param {Number} num1*/num1 => num1 * num1);
//------------------------------
[].forEach(/** @param {Number} num1*/num1 => {
    return num1 * num1;
});

有没有人成功完成这项工作？

【问题讨论】：

标签： javascript ecmascript-6 webstorm jsdoc arrow-functions

【解决方案1】：

从下一个 EAP 构建开始，WebStorm 将理解这一点：

[].forEach(/**Number*/num1 => {
    return num1 * num1;
});

详情请关注WEB-19280。

【讨论】：

我在寻找 vscode 解决方案时遇到了这个问题，这就是它在 vscode [].forEach(/** @param {Number} num1*/ num1 => { .... }