是否可以在打字稿中将某些内容标记为已弃用？

Question

我正在使用已弃用的方法为 Javascript API 编写打字稿定义。这是文档的摘录（他们说 API 但它只是关于这种单一方法）：

此 API 无效。出于兼容性目的而对其进行了维护。

出于兼容性目的，我还想在定义文件中记录此方法。但如果可能的话，我想以某种方式传达它已被弃用。

虽然我当前的问题只是关于定义文件中的弃用，但我也想在其他代码中使用此功能。所以问题更普遍：如何在打字稿中将某些内容标记为已弃用？

Answer 1

您可以使用 JSDoc 注释来标记已弃用的代码：

/**
 * @deprecated The method should not be used
 */
export const oldFunc = () => {}

此外，这个 eslint 规则可以查看已弃用的方法并警告它们的使用。