domain-parent

Adds a parent Node.js domain reference (parentDomain property) to all domains.

Usage no npm install needed!

<script type="module">
  import domainParent from 'https://cdn.skypack.dev/domain-parent';
</script>

README

domain-parent 👪

Travis build status Coveralls NPM version Canonical Code Style Twitter Follow

Adds a parent Node.js domain reference (parentDomain property) to all domains.

Motivation

Domains provide a way to add context to a chain of asynchronous calls. Having a reference to the parentDomain allows to collect context from all parent domains.

Implementation

domain-parent monkey-patches Node.js domain create method. All domains that are created after Node.js has been shimmed will have parentDomain property. Top-level domain will have parentDomain set to NULL.

Usage

To shim Node.js, import domain-parent/auto, e.g.

import 'domain-parent/auto';
import domain from 'domain';

domain.parentDomain === null;

const d0 = domain.create();

d0.run(() => {
  process.domain.parentDomain === null;

  const d1 = domain.create();

  d1.run(() => {
    process.domain.parentDomain === d0;
  });
});

Do not use in distributed packages

Do not shim Node.js in distributable NPM package. If your package depends on parentDomain, then:

  1. Check if Node.js is shimmed (require('domain').parentDomain !== undefined) and warn if Node.js is not shimmed.
  2. Document that your package depends on parentDomain and provide instructions for adding domain-parent shim.