TS est mauvais en texte survolé

Un ange littéral (AngelCMHxD), a fait un PR contre l'un de mes dépôts pour ajouter un fichier de définition .d.ts pour la saisie semi-automatique et le texte de survol. C'est ce qui s'est passé ensuite...

---

Après avoir testé son PR localement avec le fichier TypeScript .d.ts, le résultat était celui-ci :

Notez que je passe la souris sur la touche Windows et qu'elle ne me donne aucune information précieuse. Il fournit le même désordre de texte tronqué (difficile à analyser visuellement), que lorsque vous survolez createDesktopShortcuts.

---

Le repo était déjà écrit avec JSDocs appliqué partout via un simple plugin de linting (utilisez-le, c'est très bien). En comparaison, JSDocs fournit une prise en charge de type identique à celle de TS, ainsi que de bien meilleures astuces.

---

Avec JSDocs, on obtient un survol plus propre :

Et au survol de la touche Windows, nous obtenons un bien meilleur contexte, expliquant qu'il nécessite une chaîne filePath.

---

En fin de compte, il n'y avait aucun moyen pour que TS génère une info-bulle de survol utilisable. Leur recommandation officielle est d'utiliser JSDocs.

Étant donné que le moteur et le compilateur TypeScript fonctionnent exactement de la même manière avec les types définis dans JSDocs qu'avec les types écrits dans la syntaxe TypeScript, ma bibliothèque n'utilise aucun TypeScript, mais est entièrement typée et entièrement compatible TS.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!