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 errors are supported. The constructor of errors classes will NOT be called during deserialization, so if your custom error relies on it being called it will not work.

API

serializeError(value: T extends Error): SerializedError

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.

deserializeError<T extends Error>(value: SerializedError): T

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
• The constructor method of the class is NOT called