如何使用 JSDoc 命名参数

Question

在我的一个 JavaScript 文件中，我不得不引入一些可选参数，因此我遵循this 指南并得出以下方法声明：

function my_func({
    opt1,
    opt2 = 250,
    opt3 = "A message.",
    opt4 = null
}) {
    // Do something
}

我可以这样称呼它：

my_func({
        opt1: "boom",
        opt4: document.getElementById("some-element"),
        opt3: "A different message.",
        opt2: 200
    });

我什至可以删除一些参数并将它们按任意顺序排列。
现在，我想使用 JSDoc 对其进行记录，但我很困惑我的 JSDoc 注释会是什么样子？因为这应该定义我必须在花括号内输入参数，而且我还必须使用键。

如果我可以通过任何其他方式使用命名参数和/或可选参数，那也将不胜感激。

Answer 1

您可以为此使用@typedef。检查this documentation。

对于您的情况：

/**
 * @typedef {Object} NameMeAsYouLike
 * @property {string} opt1 - opt1 description
 * @property {string} [opt2=250] - opt2 description
 * @property {string} [opt3=A message.] - opt3 description
 * @property {number} [opt4=null] - opt4 description
 */

/**
 * @param {NameMeAsYouLike} name me as you like 
 */
function my_func({
    opt1,
    opt2 = 250,
    opt3 = "A message.",
    opt4 = null
}) {
    // Do something
}