javascript - 使用jsdoc注释，调用时如何指定泛型函数的输出类型

Question

我的代码类似于:

document.querySelectorAll('.thing').forEach(el => el.style.color = 'red');

VsCode 中的类型提示系统将 Element 中的 el.style 标记为缺失。我可以用以下方法解决这个问题:

/** @type {NodeListOf<HTMLElement>} */
const things = document.querySelectorAll('.thing');
things.forEach(el => el.style.color = 'red');

仅仅为了保持 VsCode 的类型系统满意而创建 var 似乎是错误的。

如果我使用 typescript ，我想我可以做到

document.querySelectorAll<HTMLElement>('.thing') // etc...

有没有办法告诉 VsCode 的类型系统我期望从泛型方法中获得哪种类型？

Answer 1

您可以使用 jsdoc cast为此:

// @ts-check
(/** @type {NodeListOf<HTMLElement>} */ (document.querySelectorAll('.thing'))).forEach(el => el.style.color = 'red');

请注意，您必须将转换的目标 ((document.querySelectorAll('.thing')) 括在括号中，以便该类型适用于正确的表达式。