如何在 JSDoc 中定义类参数的类型？

Question

我有一个项目，其中包含一些 Web 组件类，并且我还有一个接收这些组件并将它们注册到窗口中的函数。 例如：

/**
* @param {} ComponentClass - class that extends HTMLElement
* @param {string} displayName - tag name to be used in html
*/
function registerComponent(ComponentClass, displayName){
  window.customElements.define(displayName, ComponentClass);
}

我的问题是：如何正确输入 ComponentClass？有没有办法描述它是一个扩展 HTMLElement 的类？

Answer 1

CustomElementConstructor 是你所追求的，例如

/**
 * @param {CustomElementConstructor} ComponentClass - class that extends HTMLElement
 * @param {string} displayName - tag name to be used in html
 */
function registerComponent(ComponentClass, displayName) {
  window.customElements.define(displayName, ComponentClass);
}

class WCTest extends HTMLElement {}

registerComponent(WCTest, 'wc-test');