jsdom 30.x

Complete instructions

Verified against jsdom@30.0.1 on 2026-09-07. 2 of 2 examples executed.

jsdom ^30.0.0

Runtime requirement

The v30 release requires Node.js ^22.22.2 || ^24.15.0 || >=26.0.0.

Construct and query a DOM

Import the named JSDOM export. The constructor accepts an HTML string and returns an object whose DOM is available through dom.window.document.

import assert from "node:assert/strict";
import { JSDOM } from "jsdom";

const dom = new JSDOM("<!DOCTYPE html><p>Hello world</p>");

assert.equal(dom.window.document.querySelector("p")?.textContent, "Hello world");

A common shape mistake is treating the constructor result as the document itself. Query through dom.window.document, not directly through dom.

Document fragments

JSDOM.fragment() creates a document fragment from markup without requiring a full JSDOM window.

import assert from "node:assert/strict";
import { JSDOM } from "jsdom";

const fragment = JSDOM.fragment("<p>One</p><p>Two</p>");

assert.equal(fragment.querySelectorAll("p").length, 2);
assert.equal(fragment.querySelector("p")?.textContent, "One");

Inline scripts

Scripts are disabled by default. The documented constructor option for enabling inline script execution is { runScripts: "dangerously" }.

No standalone runnable example is included for this option: when executed as the required direct Bun script, the documented inline-script example failed before running the script with TypeError: Proxy is not allowed in the global prototype chain. Use this feature only in a runtime where jsdom v30's script execution works, and only with trusted HTML.

Other documented exports and factories

The README also documents or demonstrates:

• JSDOM.fromURL() for creating a DOM from a URL.
• JSDOM.fromFile() for creating a DOM from a file.
• VirtualConsole.
• CookieJar.
• requestInterceptor.
• The toughCookie module export.

fromURL() requires network access and fromFile() requires a file, so neither is used in the isolated examples here. The available research does not provide enough detail to specify their options or behavior safely.

What this skill does not cover

This skill does not cover URL loading, file loading, virtual-console configuration, cookie-jar usage, request interception, the toughCookie export, DOM APIs beyond the demonstrated construction and fragment querying, or configuration beyond the documented runScripts setting. It also does not cover a working standalone example of inline script execution under Bun, or using jsdom through a test runner or framework.