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

Node's domain module for the web browser

Note, this is merely an evented try...catch with the same API as node. Nothing more.

Install

NPM

• Use: require('domain-browser')
• Install: npm install --save domain-browser

Browserify

• Use: require('domain-browser')
• Install: npm install --save domain-browser
• CDN URL: //wzrd.in/bundle/domain-browser@1.1.2

Ender

• Use: require('domain-browser')
• Install: ender add domain-browser

History

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

Backers

Maintainers

These amazing people are maintaining this project:

• Benjamin Lupton [e-mail] (https://github.com/balupton)

Sponsors

No sponsors yet! Will you be the first?

Contributors

These amazing people have contributed code to this project:

• Benjamin Lupton [e-mail] — view contributions

Become a contributor!

License

Licensed under the incredibly permissive MIT license

Copyright © Bevry Pty Ltd [e-mail] (http://bevry.me)

Changelog

v1.1.2 2014 June 8

• Added domain.createDomain() alias
  • Thanks to James Halliday for Pull Request #1