覆盖默认 jsdoc -> .d.ts 转换以摆脱 ...args: any[]

编程问答 2022-04-30

问题描述

当仅使用 tsc 生成声明时，JSDoc 标签用于推断类型等

是否可以覆盖从 JSDoc 推断的类型？

具体来说，对于使用 arguments 的函数，tsc will always add 将 ...args: any[] vararg 参数用于函数声明。我想覆盖它以摆脱它，因为 arguments 仅用于遗留原因，并且该函数不应该有 vararg 参数。

示例：

/**
 * @param {number} x
 */
function myLegacyFunction(x) {
  if (arguments.length > 1) {
    throw new Error();
  }
  return 42;
}

...将呈现

export function myLegacyFunction(x: number,...args: any[]): number;

请注意，即使我确实使用 @param 来记录 x 而省略 args，它仍然是隐式添加的。 我还尝试将 args 明确列为 ...never 类型，但这也无济于事：

/**
 * @param {number} x
 * @param {...never} args
 */
function myLegacyFunction(x) {
  if (arguments.length > 1) {
    throw new Error();
  }
  return 42;
}

我怎样才能让 tsc 明白这个函数应该是：

export function myLegacyFunction(x: number): number;

（使用 typescript 4.2.3。）

解决方法

暂无找到可以解决该程序问题的有效方法，小编努力寻找整理中！

如果你已经找到好的解决方法，欢迎将解决方案带上本链接一起发送给小编。

小编邮箱:dio#foxmail.com (将#修改为@）

tsctypescripttypescripttypescripttypescript-declarations