将 happy-dom 从 20.x 升级到 21.x

根据 TypeScript 类型自动比较 happy-dom 20.14.6 与 21.0.0 的公开 API。签名变化表示可能存在不兼容变更，并非确定结论。

概要

已删除的导入路径	0
已删除的导出	0
已修改的签名	0
已删除的类或接口成员	177
已修改的类或接口成员	0
新增弃用	2
要求变化（engines、peer 依赖）	0
新增导出	0

已删除的导出

未发现。

已修改的签名

未发现。

已删除的类或接口成员

member	import	之前
`Element.static __@tagName@1334`	`happy-dom`	`string \| null`
`Element.static __@localName@1336`	`happy-dom`	`string \| null`
`Element.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`FileList.static __@species@3388`	`happy-dom`	`(arrayLength?: number \| undefined): any[] \| <T>(arrayLength: number): T[] \| <T>(...items: T[]): T[]`
`SVGElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`SVGElement.static __@localName@1336`	`happy-dom`	`string \| null`
`SVGElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLBRElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLBRElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLBRElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLHRElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLHRElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLHRElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLLIElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLLIElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLLIElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLDivElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLDivElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLDivElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLMapElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLMapElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLMapElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLModElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLModElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLModElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLPreElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLPreElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLPreElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLBaseElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLBaseElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLBaseElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLBodyElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLBodyElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLBodyElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLDataElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLDataElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLDataElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLHeadElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLHeadElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLHeadElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLHtmlElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLHtmlElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLHtmlElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLLinkElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLLinkElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLLinkElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLMenuElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLMenuElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLMenuElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLMetaElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLMetaElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLMetaElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLSlotElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLSlotElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLSlotElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLSpanElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLSpanElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLSpanElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLTimeElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLTimeElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLTimeElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLDListElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLDListElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLDListElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLEmbedElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLEmbedElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLEmbedElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLLabelElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLLabelElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLLabelElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLMeterElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLMeterElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLMeterElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLOListElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLOListElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLOListElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLParamElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLParamElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLParamElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLQuoteElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLQuoteElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLQuoteElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLStyleElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLStyleElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLStyleElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLTableElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLTableElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLTableElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLTitleElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLTitleElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLTitleElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLTrackElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLTrackElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLTrackElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLUListElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLUListElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLUListElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`TextTrackCueList.static __@species@3388`	`happy-dom`	`(arrayLength?: number \| undefined): any[] \| <T>(arrayLength: number): T[] \| <T>(...items: T[]): T[]`
`HTMLCanvasElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLCanvasElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLCanvasElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLDialogElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLDialogElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLDialogElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLIFrameElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLIFrameElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLIFrameElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLLegendElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLLegendElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLLegendElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLObjectElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLObjectElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLObjectElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLOptionElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLOptionElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLOptionElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLOutputElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLOutputElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLOutputElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLScriptElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLScriptElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLScriptElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLSourceElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLSourceElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLSourceElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLDetailsElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLDetailsElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLDetailsElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLHeadingElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLHeadingElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLHeadingElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLPictureElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLPictureElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLPictureElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLUnknownElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLUnknownElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLUnknownElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`SVGGraphicsElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`SVGGraphicsElement.static __@localName@1336`	`happy-dom`	`string \| null`
`SVGGraphicsElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLDataListElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLDataListElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLDataListElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLFieldSetElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLFieldSetElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLFieldSetElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLOptGroupElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLOptGroupElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLOptGroupElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLProgressElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLProgressElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLProgressElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLTableColElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLTableColElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLTableColElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLTableRowElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLTableRowElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLTableRowElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLTemplateElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLTemplateElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLTemplateElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`DataTransferItemList.static __@species@3388`	`happy-dom`	`(arrayLength?: number \| undefined): any[] \| <T>(arrayLength: number): T[] \| <T>(...items: T[]): T[]`
`HTMLParagraphElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLParagraphElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLParagraphElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLTableCellElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLTableCellElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLTableCellElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLTableCaptionElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLTableCaptionElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLTableCaptionElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`
`HTMLTableSectionElement.static __@tagName@1334`	`happy-dom`	`string \| null`
`HTMLTableSectionElement.static __@localName@1336`	`happy-dom`	`string \| null`
`HTMLTableSectionElement.static __@namespaceURI@1338`	`happy-dom`	`string \| null`

已修改的类或接口成员

未发现。

新增弃用

export	@deprecated
`happy-dom · IBrowserSettings.disableCSSFileLoading`	CSS file loading is disabled by default. Use "enableCSSFileLoading" to enable it.
`happy-dom · IOptionalBrowserSettings.disableCSSFileLoading`	CSS file loading is disabled by default. Use "enableCSSFileLoading" to enable it.

要求变化（engines、peer 依赖）

未发现。

把这些数据交给你的 AI 智能体

Vigia 是免费的 MCP 服务器：你的编程智能体在写代码之前就能检查版本、不兼容变更和安全漏洞。无需注册，无需 API 密钥。

claude mcp add --transport http vigia https://vigia.coredls.cloud/mcp

添加到 Cursor 添加到 VS Code ★ 在 GitHub 上加星

任何其他 MCP 客户端

{ "mcpServers": { "vigia": { "url": "https://vigia.coredls.cloud/mcp" } } }

智能体技能（SKILL.md）：告诉智能体何时使用 Vigia · 用于拉取请求的 GitHub Action

常见问题

将 happy-dom 从 20 升级到 21 有哪些不兼容变更？

在 happy-dom 20.14.6 与 21.0.0 之间，Vigia 发现 0 个已删除的导出、0 个已修改的签名，以及 177 个已删除或修改的类或接口成员。

happy-dom 21 中弃用了哪些内容？

happy-dom 21.0.0 中有 2 个导出或成员新被标记为弃用。

供智能体使用

GET https://vigia.coredls.cloud/v1/packages/npm/happy-dom/upgrade?from=20.14.6&to=21.0.0