empower

What is empower?

The empower npm package is a tool designed to enhance assertion libraries by providing more detailed and readable assertion error messages. It works by instrumenting assertion functions to capture additional context and information about the assertions being made.

What are empower's main functionalities?

Enhanced Assertion Messages

This feature allows you to use enhanced assertion messages that provide more context and detail about the assertion failure, making it easier to debug.

const assert = require('assert');
const empower = require('empower');
const enhancedAssert = empower(assert);

try {
  enhancedAssert.equal(1, 2);
} catch (e) {
  console.log(e.message); // Outputs detailed assertion error message
}

Integration with Various Assertion Libraries

Empower can be integrated with various assertion libraries, allowing you to enhance the error messages of your existing assertions without changing your testing framework.

const assert = require('assert');
const empower = require('empower');
const enhancedAssert = empower(assert);

try {
  enhancedAssert.deepEqual({ a: 1 }, { a: 2 });
} catch (e) {
  console.log(e.message); // Outputs detailed assertion error message
}

Customizable Output

You can customize the output of the enhanced assertion messages by configuring empower with different patterns and options.

const assert = require('assert');
const empower = require('empower');
const enhancedAssert = empower(assert, { patterns: ['assert.*'] });

try {
  enhancedAssert.equal(1, 2);
} catch (e) {
  console.log(e.message); // Outputs detailed assertion error message
}

Other packages similar to empower

chai

Chai is a BDD / TDD assertion library for node and the browser that can be delightfully paired with any javascript testing framework. Unlike empower, Chai provides a rich set of assertion styles and plugins, but it does not focus specifically on enhancing error messages.

should

Should is an expressive, readable, and powerful assertion library for node. It extends the Object prototype with a single non-enumerable getter that allows you to express assertions in a natural language style. While it provides readable assertions, it does not focus on enhancing error messages like empower.

expect

Expect is a minimalistic assertion library that works well with Jest. It provides a set of assertion functions and is designed to work seamlessly with Jest's test runner. Unlike empower, it does not focus on enhancing error messages but provides a simple and straightforward API for assertions.

README

empower

Power Assert feature enhancer for assert function/object

DESCRIPTION

empower is a core module of power-assert family. empower enhances standard assert function or any assert-like object to work with power-assert feature added code instrumented by espower. empower module also provides a default formatter for power-assert output.

empower works with standard assert function (best fit with Mocha), and also supports assert-like objects provided by various testing frameworks such as QUnit or nodeunit.

Please note that empower is an alpha version product. Pull-requests, issue reports and patches are always welcomed. See power-assert project for more documentation.

AUTHOR

• Takuto Wada

LICENSE

Licensed under the MIT license.