npm

Need private packages and team management tools?Check out npm Orgs. »

fault

1.0.3 • Public • Published

fault

Build Coverage Downloads Size

Functional errors with formatted output.

Installation

npm:

npm install fault

Usage

var fault = require('fault')
 
throw fault('Hello %s!', 'Eric')

Yields:

Error: Hello Eric!
    at FormattedError (~/node_modules/fault/index.js:30:12)
    at Object.<anonymous> (~/example.js:3:7)
    ...

Or, format a float in a type error:

var fault = require('fault')
 
throw fault.type('Who doesn’t like %f? \uD83C\uDF70', Math.PI)

Yields:

TypeError: Who doesn’t like 3.141593? 🍰
    at Function.FormattedError [as type] (~/node_modules/fault/index.js:30:12)
    at Object.<anonymous> (~/example.js:3:7)

API

fault(format?[, values...])

Create an error with a printf-like formatted message.

Parameters
  • format (string, optional)
  • values (*, optional)
Formatters
  • %s — String
  • %b — Binary
  • %c — Character
  • %d — Decimal
  • %f — Floating point
  • %o — Octal
  • %x — Lowercase hexadecimal
  • %X — Uppercase hexadecimal
  • % followed by any other character, prints that character

See samsonjs/format for argument parsing.

Returns

An instance of Error.

Other errors

fault.create(Constructor)

Factory to create instances of ErrorConstructor with support for formatting. Used internally to wrap the global error constructors, exposed for custom errors. Returns a function just like fault.

License

MIT © Titus Wormer

install

npm i fault

Downloadsweekly downloads

695,579

version

1.0.3

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability