fault
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