TS 不擅長懸停文本

一位真正的天使 (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中文網其他相關文章！