一位真正的天使 (AngelCMHxD),针对我的一个存储库创建了一个 PR,为自动完成和悬停文本添加 .d.ts 定义文件。这就是接下来发生的事情...
使用 TypeScript .d.ts 文件在本地测试他的 PR 后,结果是这样的:
请注意,我将鼠标悬停在 Windows 键上,但它没有给我任何有价值的信息。它提供了与将鼠标悬停在 createDesktopShortcuts 上时相同的被截断的混乱文本(很难在视觉上解析)。
该存储库已经通过一个简单的 linting 插件使用 JSDocs 编写(使用它,它非常好)。相比之下,JSDocs 提供了与 TS 相同的类型支持,以及更好的提示。
使用 JSDocs,我们可以获得更清晰的悬停:
将鼠标悬停在 Windows 键上时,我们会得到更好的上下文,解释它需要一个文件路径字符串。
最终,没有办法让 TS 生成可用的悬停工具提示。他们的官方建议是使用 JSDocs。
由于 TypeScript 引擎和编译器对于 JSDocs 中定义的类型的工作方式与使用 TypeScript 语法编写的类型完全相同,因此我的库根本不使用任何 TypeScript,而是完全类型化且完全 TS 兼容。
以上是TS 不擅长悬停文本的详细内容。更多信息请关注PHP中文网其他相关文章!