ifnotundef v1.1.3

ifnotundef

A set of helper functions that simplify the (is a undefined ? b : c) syntax

Author: Loïc Formont
License: MIT Licensed
Example

var undef = require("ifnotundef");

• ifnotundef
  • .if(a, b, [c]) ⇒ *
  • .is(a, b) ⇒ boolean
  • .isnot(a, b) ⇒ boolean
  • .check(a, b) ⇒ boolean
  • .try(a, [b]) ⇒ *
  • .child(a, b, c, [d]) ⇒ *

undef.if(a, b, c) ⇒ *

Two parameters mode If a is undefined, return b else a Three parameters mode If a is undefined, return c else b

Kind: static method of ifnotundef
Returns: * - a, b or c depending on their undefined status

Example
Two ways to use if. Either with two parameters (a||b):

var myHost = undef.if(options.host, options.hostname);

or with three parameters (a?b:c):

var myHost = undef.if(options.host, options.hostname, 'localhost');

undef.is(a, b) ⇒ boolean

Invert of "check"

Kind: static method of ifnotundef
Returns: boolean - a or ab's undefined status

Example

if(undef.is(options.host)) console.log('Deal with it');

undef.isnot(a, b) ⇒ boolean

Alias of "check"

Kind: static method of ifnotundef
Returns: boolean - a or ab's undefined status

Example

if(undef.isnot(options.host)) console.log('Great');

undef.check(a, b) ⇒ boolean

One parameters mode If a is undefined, false else true Two parameters mode If ab is undefined, false else true

Kind: static method of ifnotundef
Returns: boolean - a or ab's undefined status

Example

if(!undef.check(options.host)) console.log('Deal with it');

undef.try(a, b) ⇒ *

One parameters mode If a is undefined, throw a else return a Two parameters mode If a is undefined, throw b else return a

Kind: static method of ifnotundef
Returns: * - a or exception depending on a's undefined status

Example
Two ways to use if. Either with one parameter:

var myHost = undef.try(options.host);

or with two parameters:

var myUndefined = undef.try(undefined, 'undefined is not defined ... ;-)');
// Exeption raised above

undef.child(a, b, c, d) ⇒ *

Three parameters mode If ab is undefined, return c else ab Four parameters mode If ab is undefined, return d else c

Kind: static method of ifnotundef
Returns: * - ab or c or d depending on their undefined status

Example
Two ways to use child. Either with three parameters (ab||c):

var myHost = undef.child(options, ['params', 'host'], 'localhost');

or with four parameters (ab?c:d):

var myHost = undef.child(options, ['params'], options.params.host, 'localhost');