Guard-function

Guard a function using a predicate.

Installation

npm install guard-function

Usage

Basic usage

var guard = require('guard-function');
 
let capitalize = (str) => str.charAt(0).toUpperCase() + str.slice(1);
 
// Silently fail when non-string is passed in
capitalize = guard((str) => typeof str === 'string', capitalize);
 
capitalize(12); // => undefined
capitalize("you shall not pass!"); // => "You shall not pass!"
 
let div = (a, b) => a / b;
 
// Throw exception instead of failing silently by passing an Error instance as 3rd param
div = guard((a, b) => b !== 0, div, new Error('Divide by 0!');
 
div(8, 2); // => 4
 
div(8, 0); // => throws an Error