⚠️ This package has been deprecated. Happy DOM now supports this feature built in by setting "errorCapture" to "processLevel". ⚠️

About

Happy DOM is a JavaScript implementation of a web browser without its graphical user interface. It includes many web standards from WHATWG DOM and HTML.

The goal of Happy DOM is to emulate enough of a web browser to be useful for testing, scraping web sites and server-side rendering.

Happy DOM focuses heavily on performance and can be used as an alternative to JSDOM.

This package contains a tool that can observe uncaught exceptions and Promise rejections in Happy DOM. It will dispatch uncaught errors as events on the Happy DOM Window instance.

Uncaught exceptions and rejections must be listened to on the NodeJS process at a global level. This tool will therefore not work in all environments as there may already be listeners added by other libraries on the NodeJS process that may conflict.

DOM Features

• Custom Elements (Web Components)

• Shadow Root (Shadow DOM)

• Declarative Shadow DOM

• Mutation Observer

• Tree Walker

• Fetch

And much more..

Works With

• Google LitHTML

• Google LitElement

• React

• Angular

• Vue

Module Systems

• ESM
• CommonJS

Installation

npm install happy-dom @happy-dom/uncaught-exception-observer

Usage

import { Window } from "happy-dom";
import { UncaughtExceptionObserver } from "@happy-dom/uncaught-exception-observer";

const window = new Window();
const document = window.document;
const observer = new UncaughtExceptionObserver();

// Connects observer
observer.observe(window);

window.addEventListener((error) => {
	// Do something on error
});

document.write(`
    <script>
        (() => {
            async function main() {
                await fetch('https://localhost:3000/')
                throw Error('This error will be caught, but would otherwise have terminated the process.');
            }

            main();
        })();
    </script>
`);

// Disconnects observer
observer.disconnect();

Documentation

Read more about how Happy DOM works in our documentation.

Performance

See how the test was done here

Sponsors