capricorn86/happy-dom
Happy Dom
happy-dom is a JavaScript-based headless browser simulation and virtual DOM engine. It implements the Document Object Model and Web APIs to execute frontend code and run tests within non-browser environments such as Node.js.
The project provides a programmatic interface for creating and testing custom elements and shadow DOM structures. It supports stateful page instance management to simulate multiple concurrent browsing sessions and includes a programmable clock to synchronize asynchronous operations.
The system covers a broad range of browser simulation capabilities, including DOM manipulation and mutation monitoring, network request execution, and the management of window settings and viewport dimensions. It also allows for the injection of browser-standard globals into the execution context.
Features
- DOM Simulations - Implements a complete Document Object Model using JavaScript to simulate browser behavior without a graphical interface.
- Simulated Browser Environments - Provides a JavaScript-based headless browser simulation to execute frontend code in non-browser environments.
- Virtual Browser Environments - Creates a virtual DOM and browser APIs in Node.js to test web applications without a graphical interface.
- Node.js DOM Implementations - Implements a virtual Document Object Model and Web APIs specifically designed to run within Node.js.
- Global Window Injections - Injects browser-standard globals like window and document into Node.js for seamless test execution.
- Virtual DOM Testing - Enables creating and modifying virtual HTML elements to verify UI responses to programmatic changes.
- DOM Observers - Utilizes observers to monitor and react to structural changes within the simulated DOM.
- Virtual DOM Implementations - Provides a virtual DOM engine for manipulating HTML elements and monitoring mutations without a real browser.
- DOM Mutation Observation - Implements MutationObserver to track and react to structural changes in the virtual DOM.
- HTML DOM Manipulators - Provides a full suite of tools for creating, appending, and querying nodes within a virtual document.
- Asynchronous Simulation Workflows - Simulates network requests and page lifecycles to test how applications handle timing and external data.
- Asynchronous Control Flow - Provides a programmable clock to synchronize asynchronous operations and timers during tests.
- Browser Page Management - Manages multiple page instances and navigation between URLs to simulate complex user browsing sessions.
- Web Components - Provides a simulated environment for building and testing custom elements and shadow DOM structures.
- Viewport and Timer Control - Allows programmatic adjustment of viewport dimensions and timer execution during active tests.
- Shadow DOM Encapsulation - Supports isolated document fragments to ensure styles and elements remain encapsulated within custom elements.
- Independent Instance Management - Maintains independent window and document states to simulate multiple concurrent browsing sessions.
- Page Lifecycle Controls - Provides programmatic control over page lifecycles, including waiting for or aborting asynchronous operations.
- Web Components - Supports the creation and testing of custom elements and declarative shadow DOM.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
