domain-browser

What is domain-browser?

The domain-browser package is a shim for Node.js's domain module, which allows you to handle multiple different IO operations as a single group. This is particularly useful in the context of handling errors across asynchronous operations. The package provides a way to group and handle errors and cleanup resources in client-side JavaScript that mimics Node.js's domain module functionality.

What are domain-browser's main functionalities?

Error Handling

This feature allows grouping of IO operations and handling errors that occur within that group. The code sample demonstrates creating a domain, setting up an error handler, and running a function that throws an error asynchronously.

var domain = require('domain-browser');
var d = domain.create();
d.on('error', function(err) {
  console.error('Caught error!', err);
});
d.run(function() {
  setTimeout(function() {
    throw new Error('Failed!');
  }, 1000);
});

Other packages similar to domain-browser

async-hook-domain

This package provides similar functionality to domain-browser by using async hooks to track asynchronous operations and errors. It differs in that it uses a more modern API provided by Node.js, which can offer better performance and more detailed control over asynchronous contexts.

zone.js

Zone.js is another library that captures asynchronous operations into 'zones', which is similar to domains but with a broader scope that includes patching asynchronous APIs in the browser to provide context across async operations. It's more comprehensive than domain-browser, often used in frameworks like Angular for managing application state and change detection.

README

domain-browser

Node's domain module for the web browser. This is merely an evented try...catch with the same API as node, nothing more.

Install

npm

• Install: npm install --save domain-browser
• Import: import * as pkg from ('domain-browser')
• Require: const pkg = require('domain-browser')

jspm

<script type="module">
    import * as pkg from '//dev.jspm.io/domain-browser@4.23.0'
</script>

Editions

This package is published with the following editions:

• domain-browser aliases domain-browser/source/index.js
• domain-browser/source/index.js is ES5 source code for web browsers and Node.js with Require for modules

History

Discover the release history by heading on over to the HISTORY.md file.

Backers

Maintainers

These amazing people are maintaining this project:

• Benjamin Lupton — view contributions

Sponsors

No sponsors yet! Will you be the first?

Contributors

These amazing people have contributed code to this project:

• Benjamin Lupton — view contributions
• Bogdan Chadkin — view contributions
• Evan Solomon — view contributions
• Guy Bedford — view contributions
• James Halliday — view contributions
• Sammy filly — view contributions

Discover how you can contribute by heading on over to the CONTRIBUTING.md file.

License

Unless stated otherwise all works are:

• Copyright © 2013+ Bevry Pty Ltd

and licensed under:

• Artistic License 2.0

Changelog

v4.23.0 2023 November 1

• Updated dependencies, base files, and editions using boundation
• Updated license from MIT to Artistic-2.0