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 for the web browser

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

Usage

AMD/UMD/Require.js

Require domain, install: https://raw.github.com/bevry/domain-browser/master/index.js

Bower

Require domain, install domain

Ender.js

Require domain, install domain-browser

Browserify

Require domain-browser, install domain-browser

Component.io

Require domain-browser, install bevry/domain-browser

Vanilla

Use window.domain or this.domain, install https://raw.github.com/bevry/domain-browser/master/index.js

History

You can discover the version history inside the History.md file

License

Licensed under the incredibly permissive MIT License
Copyright © 2013+ Bevry Pty Ltd

Changelog

v1.0.0 2013 September 18

• Initial release