使用 JSDoc 记录 arrays 的 arrays 数组的最佳方法是什么？

Question

我有以下数据结构。 根数组的元素类型是固定的。 使用 JSDoc 记录这种结构的最佳方法是什么？

[
    [
        ['aqua-160', 160, 'PreCleaning'],
        ['aqua-260', 260, 'PreCleaning']
    ],
    [
        ['aqua-360', 360, 'PostCleaning']
    ]
];

Answer 1

我会为此使用@typedef ：

/** @typedef {[string, number, string]} MyTuple */

您可以申请如下：

/** @type {Array<Array<MyTuple>>} */
const x = [ [ ['aqua-160', 160, 'PreCleaning']
            , ['aqua-260', 260, 'PreCleaning']]
          , [ ['aqua-360', 360, 'PostCleaning']]];

当您将鼠标悬停在 VS Code 中的x变量上时，您可以看到以下内容：

使用 VS Code，您还可以使用文件顶部的// @ts-check “指令”进行一些类型检查：

// @ts-check

/**
 * @typedef {[string, number, string]} MyTuple
 */

/** @param {Array<Array<MyTuple>>} z */
function y(z) {
  return 42;
}

y('4');

VS Code 能够看到z参数是错误的：

也可以看看

• https://github.com/jsdoc/jsdoc/issues/1703