jsdom/jsdom
Jsdom
jsdom is a Node.js DOM implementation that functions as a headless browser emulator and virtual browser environment. It provides a pure JavaScript implementation of web standards, acting as a web standards polyfill that simulates the window and document objects within a non-browser runtime.
The project implements W3C and WHATWG specifications to provide a programmatic environment for parsing HTML and manipulating content. It serves as an HTML parser and serializer, allowing for the transformation of HTML strings into document structures and the export of those structures back into text.
The system covers a broad range of browser emulation capabilities, including the execution of in-page and external scripts, the management of HTTP cookies, and the loading of external resources via network request interception. It also includes support for CSSOM mapping, canvas API integration, and virtual console log capture.
Documents can be initialized using local files or remote URLs.
Features
- DOM Implementations - Provides a pure JavaScript implementation of web standards to simulate the DOM without a native browser engine.
- Headless Browsers - Functions as a headless browser emulator that executes page scripts and manages a document object model without a graphical interface.
- HTML Parsing - Implements the official WHATWG specification to transform HTML strings into structured document nodes.
- Virtual Browser Environments - Creates a programmatic environment for testing and manipulating web pages by simulating window and document objects.
- Browser Environment Emulation - Binds browser global objects to the Node.js runtime to enable script execution outside of a browser.
- Node.js DOM Implementations - Implements web standards to simulate a browser environment specifically for use within the Node.js runtime.
- Web-Standard Runtimes - Implements W3C and WHATWG specifications to provide a browser-compatible API environment outside of a traditional browser.
- Frontend Unit Testing - Provides a virtual browser environment to run JavaScript tests for frontend components within Node.js.
- Server Side DOM Manipulation - Allows parsing and modifying HTML or XML content on the server using standard web APIs to generate documents.
- Virtual Browser Globals - Creates a simulated global environment that mimics browser globals like window and document.
- Web Standard Implementations - JSDOM simulates a browser environment by providing JavaScript implementations of various W3C and WHATWG specifications.
- Web Standards - Implements web standards and document APIs to parse HTML and manipulate content like a browser.
- HTML Serialization - Provides tools for converting HTML strings into a manipulatable document structure and exporting that structure back to text.
- External Script Execution - Executes external JavaScript to modify the document structure and interact with web platform APIs.
- In-Page Script Execution - Runs embedded or external JavaScript to modify content and access web APIs within the simulated environment.
- Programmable Fetch Interceptors - Provides a programmable fetch mechanism to intercept and resolve external requests for scripts and styles.
- Runtime Shims - Modifies the window or document objects before parsing to ensure necessary global variables exist.
- JavaScript and Web-Standard - Provides a collection of JavaScript implementations for W3C and WHATWG specifications, including DOM and network APIs.
- DOM Serialization - Converts the current state of the document back into an HTML string including the doctype.
- CSSOM Simulations - Maintains a simulated CSS object model to track styles applied to DOM elements.
- Web Automation and Scraping - Enables extraction of data from HTML pages by simulating a browser environment to handle scripts.
- DOM Manipulation - Web standards-compliant DOM implementation for Node.js.
- General Utilities - JavaScript implementation of HTML and DOM.
