doowb / koalas

Coalesce for JavaScript. Returns the first value that is not undefined or null.

koalas

Coalesce for JavaScript. Returns the first value that is not undefined or null.

Install

Install with npm:

$ npm install --save koalas

Usage

var koalas = require('koalas');

API

koalas

Coalesce function to find the first valid value. A valid value is one that is not undefined, not null and not NaN (not a number). If no values are valid, then the last argument is returned.

Params

• arguments {Mixed}: Pass in any amount of arguments.
• returns {Mixed}: First valid value.

Example

console.log(koalas(undefined, null, NaN, 'a', 'b'));
//=> 'a'

console.log(koalas(undefined, null, NaN, {a: 'b'}, 'b'));
//=> {a: 'b'}

console.log(koalas(undefined, null, NaN, ['a', 'b', 'c'], {a: 'b'}, 'b'));
//=> ['a', 'b', 'c']

console.log(koalas(undefined, NaN, null));
//=> null

About

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Contributors

Commits	Contributor
39	doowb
1	jonschlinkert

Building docs

(This project's readme.md is generated by verb, please don't edit the readme directly. Any changes to the readme must be made in the .verb.md readme template.)

To generate the readme, run the following command:

$ npm install -g verbose/verb#dev verb-generate-readme && verb

Running tests

Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:

$ npm install && npm test

Author

Brian Woodward

• github/doowb
• twitter/doowb

License

Copyright © 2017, Brian Woodward. Released under the MIT License.

---

This file was generated by verb-generate-readme, v0.4.3, on April 18, 2017.

koalas's Issues

Used in anything

I'm looking for a replacement for _.defaultTo and I stumbled upon this. Is it used anywhere? Maybe we can update it and use it in gulp.

suggestion for description

Change the description above the project to "Coalesce for JavaScript. Returns the first value that is not undefined or null".