nanoassert

nanoassert

Nanoscale assertion module

Usage

const assert = require('nanoassert')

assert(a !== b, `${a} !== ${b}`)

API

assert(predicate, [message])

Assert that predicate is truthy, otherwise throw AssertionError with optional message. In Javascript runtimes that support Error.captureStackTrace, you will get a nicer stack trace with this error. If you want friendlier messages you can use template strings to show the assertion made like in the example above.

Why

I like to write public facing code very defensively, but have reservations about the size incurred by the assert module. I only use the top-level assert method anyway.

nanoassert@^1.1.0

Docs for the previous version, which is used by many modules on npm, can be found here

nanoassert@^3.0.0

Modernise nanoassert some, and add the small type definition from DefinitelyTyped. Functionally there should be no changes for most users, but the name property of the AssertionError is no longer set on the prototype, and newer syntax is employed, which might break some downstream modules.

Thank you to the folks that created and maintained the original type definitions.

Install

npm install nanoassert

License

ISC

Similar packages

Other packages similar to nanoassert

chai

Chai is a BDD / TDD assertion library for node and the browser that can be delightfully paired with any javascript testing framework. It provides a rich set of assertions and is more feature-rich compared to nanoassert.

assert

The 'assert' module from Node.js provides a set of assertion functions for verifying invariants. It is built into Node.js and offers more comprehensive functionality compared to nanoassert.

should

Should.js is an expressive, readable, and powerful assertion library for node and the browser. It extends the Object prototype with a single non-enumerable property, making it more expressive but also more intrusive compared to nanoassert.