Update jsdom 28.0.0 → 29.0.0 (major)

[depfu]

Here is everything you need to know about this upgrade. Please take a good look at what changed and the test results before merging this pull request.

What changed?

✳️ jsdom (28.0.0 → 29.0.0) · Repo · Changelog

Release Notes

29.0.0

Breaking changes:

• Node.js v22.13.0+ is now the minimum supported v22 version (was v22.12.0+).

Other changes:

• Overhauled the CSSOM implementation, replacing the @acemir/cssom and cssstyle dependencies with fresh internal implementations built on webidl2js wrappers and the css-tree parser. Serialization, parsing, and API behavior is improved in various ways, especially around edge cases.
• Added CSSCounterStyleRule and CSSNamespaceRule to jsdom Windows.
• Added cssMediaRule.matches and cssSupportsRule.matches getters.
• Added proper media query parsing in MediaList, using css-tree instead of naive comma-splitting. Invalid queries become "not all" per spec.
• Added cssKeyframeRule.keyText getter/setter validation.
• Added cssStyleRule.selectorText setter validation: invalid selectors are now rejected.
• Added styleSheet.ownerNode, styleSheet.href, and styleSheet.title.
• Added bad port blocking per the fetch specification, preventing fetches to commonly-abused ports.
• Improved Document initialization performance by lazily initializing the CSS selector engine, avoiding ~0.5 ms of overhead per Document. (@thypon)
• Fixed a memory leak when stylesheets were removed from the document.
• Fixed CSSStyleDeclaration modifications to properly trigger custom element reactions.
• Fixed nested @media rule parsing.
• Fixed CSSStyleSheet's "disallow modification" flag not being checked in all mutation methods.
• Fixed XMLHttpRequest's response getter returning parsed JSON during the LOADING state instead of null.
• Fixed getComputedStyle() crashing in XHTML documents when stylesheets contained at-rules such as @page or @font-face.
• Fixed a potential hang in synchronous XMLHttpRequest caused by a race condition with the worker thread's idle timeout.

28.1.0

• Added blob.text(), blob.arrayBuffer(), and blob.bytes() methods.
• Improved getComputedStyle() to account for CSS specificity when multiple rules apply. (asamuzaK)
• Improved synchronous XMLHttpRequest performance by using a persistent worker thread, avoiding ~400ms of setup overhead on every synchronous request after the first one.
• Improved performance of node.getRootNode(), node.isConnected, and event.dispatchEvent() by caching the root node of document-connected trees.
• Fixed getComputedStyle() to correctly handle !important priority. (asamuzaK)
• Fixed document.getElementById() to return the first element in tree order when multiple elements share the same ID.
• Fixed <svg> elements to no longer incorrectly proxy event handlers to the Window.
• Fixed FileReader event timing and fileReader.result state to more closely follow the spec.
• Fixed a potential hang when synchronous XMLHttpRequest encountered dispatch errors.
• Fixed compatibility with environments where Node.js's built-in fetch() has been used before importing jsdom, by working around undici v6/v7 incompatibilities.

Does any of this look wrong? Please let us know.

Commits

See the full diff on Github. The new version differs by 53 commits:

• Version 29.0.0
• Use undici's request() API for XHR dispatching
• Convert CSSStyleDeclaration to webidl2js
• Merge in `cssstyle` and replace `@acemir/cssom`
• Remove unused http(s)-proxy-agent dependencies
• Update domSelector
• Use --fgrep for npm run test:tuwpt:browser
• Use stable ports for test:tuwpt:browser
• Suppress informational WPT output when using the min reporter
• Lazily initialize DOMSelector
• Replace manual attribute reflection with IDL reflection
• Update ESLint toolchain and fix XHR JSON response bug
• Update most dependencies and dev dependencies
• Add failing test for background and border with cssText
• Instruct agents to use mocha's min reporter
• Skip non-style at-rules in getComputedStyle processing
• Fix a potential race in the sync XHR worker
• Add failing test for stroke property
• Split rule processing into handleRule() and handleStyle()
• Fix link to css parser (#4076)
• Disable send-redirect-bogus-sync.htm for now
• Add bad port blocking
• Avoid redundant cloning in getCascadedPropertyValue
• Add failing test for CSS font parsing
• Skip response-body-errors.any.html test on Node.js v20
• Version 28.1.0
• Apply CSS specificity when computing styles
• Skip single-byte-decoder encoding tests on Node 20
• Generalize node version conditions in test expectations
• Rewrite getElementById ID caching for tree-order correctness
• Fix potential sync XHR worker hang from unhandled dispatch errors
• Cache the root node for document-connected trees
• Add documentation comment to create-event-accessor.js
• Simplify Window.js installEventHandlers
• Centralize "determine the target of an event handler"
• Clarify script execution threat model in README
• Generate event handler sets from WebIDL files
• Move generated outputs to lib/generated/
• Fix undici v6/v7 cross-version global dispatcher compatibility
• Fix two to-upstream tests that fail in real browsers
• Add script to verify to-upstream WPT tests in a real browser
• Port 18 legacy test files to web platform tests
• Refactor getComputedStyle() + style-rules.js boundary
• Fix priority handling in getComputedStyle()
• Use a persistent worker thread for synchronous XHR
• Refactor style code organization and cache initialization
• Replace Benchmark.js with tinybench
• Fix FileReader event timing and result state
• Implement Blob's text(), arrayBuffer(), and bytes() methods
• Fix assert.rejects() calls that were not being awaited
• Consolidate test server helpers into a single module
• Replace custom delay helper with node:timers/promises
• Update dependencies and dev dependencies

---

Depfu will automatically keep this PR conflict-free, as long as you don't add any commits to this branch yourself. You can also trigger a rebase manually by commenting with @depfu rebase.

All Depfu comment commands

@​depfu rebase

Rebases against your default branch and redoes this update

@​depfu recreate

Recreates this PR, overwriting any edits that you've made to it

@​depfu merge

Merges this PR once your tests are passing and conflicts are resolved

@​depfu cancel merge

Cancels automatic merging of this PR

@​depfu close

Closes this PR and deletes the branch

@​depfu reopen

Restores the branch and reopens this PR (if it's closed)

@​depfu pause

Ignores all future updates for this dependency and closes this PR

@​depfu pause [minor|major]

Ignores all future minor/major updates for this dependency and closes this PR

@​depfu resume

Future versions of this dependency will create PRs again (leaves this PR as is)