建议

🔍 搜索词

ts-ignore ts-expect-error d.ts

✅ 可实现性检查清单

我的建议符合以下准则：

• 这不会对现有的TypeScript/JavaScript代码造成破坏性的更改
• 这不会改变现有JavaScript代码的运行时行为
• 这可以在不根据表达式的类型生成不同的JS的情况下实现
• 这不是一个运行时特性(例如库功能、带有JavaScript输出的非ECMAScript语法、JS的新语法糖等)
• 这个特性将与 TypeScript's Design Goals 的其他部分保持一致。

⭐ 建议

@ts-ignore 和 @ts-expect-error 在编译时会被剥离，导致下游错误在有人尝试使用您的包之前无法被检测到。参见 #38628 (评论)
如果能在类型定义和签名中禁止注解，并在需要在 .d.ts 文件中暴露它们的地方保留它们，那就太好了。