serialize-error-cjs

Serialize/deserialize an error into a plain object in commonjs

Loosely based on serialize-error, but with support for commonjs projects.

Useful if you for example need to JSON.stringify() or process.send() the error.

Install

1npm install serialize-error-cjs

Usage

1import {serializeError, deserializeError} from 'serialize-error-cjs';
2
3const error = new Error('🦄');
4
5console.log(error);
6//=> [Error: 🦄]
7
8const serialized = serializeError(error);
9
10console.log(serialized);
11//=> {name: 'Error', message: '🦄', stack: 'Error: 🦄\n    at Object.<anonymous> …'}
12
13const deserialized = deserializeError(serialized);
14
15console.log(deserialized);
16//=> [Error: 🦄]

Error constructors

When a serialized error with a known name is encountered, it will be deserialized using the corresponding error constructor, while unknown error names will be deserialized as regular errors:

1import {deserializeError} from 'serialize-error';
2
3const known = deserializeError({
4	name: 'TypeError',
5	message: '🦄'
6});
7
8console.log(known);
9//=> [TypeError: 🦄] <-- Still a TypeError
10
11const unknown = deserializeError({
12	name: 'TooManyCooksError',
13	message: '🦄'
14});
15
16console.log(unknown);
17//=> [Error: 🦄] <-- Just a regular Error

The list of known errors can be extended globally. This also works if serialize-error-cjs is a sub-dependency that's not used directly.

1import {errorConstructors} from 'serialize-error-cjs';
2import {MyCustomError} from './errors.js'
3
4errorConstructors.set('MyCustomError', MyCustomError)

Warning: Only simple and standard error constructors are supported, like new MyCustomError(message). If your error constructor requires a second parameter or does not accept a string as first parameter, adding it to this map will break the deserialization.

API

serializeError(value)

Serialize an Error object into a plain object.

• Custom properties NOT are preserved.
• Non-enumerable properties are kept non-enumerable (name, message, stack).
• Circular references are NOT handled.

value

Type: Error

deserializeError(value)

Deserialize a plain object or any value into an Error object.

• All passed values are interpreted as errors
• Custom properties are NOT preserved
• Non-enumerable properties are kept non-enumerable (name, message, stack, cause)
• Circular references are NOT handled

value

Type: {message: string} | unknown