fault
Functional errors with formatted output.
Install
npm:
npm install fault
Use
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.eval(format?[, values...])
— EvalErrorfault.range(format?[, values...])
— RangeErrorfault.reference(format?[, values...])
— ReferenceErrorfault.syntax(format?[, values...])
— SyntaxErrorfault.type(format?[, values...])
— TypeErrorfault.uri(format?[, values...])
— URIError
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
.