A map that creates a default object if one does not exist.

| What | Where | | --- | --- | | Discussion | https://github.com/bigeasy/vivifyer/issues/1 | | Documentation | https://bigeasy.github.io/vivifyer | | Source | https://github.com/bigeasy/vivifyer | | Issues | https://github.com/bigeasy/vivifyer/issues | | CI | https://travis-ci.org/bigeasy/vivifyer | | Coverage: | https://codecov.io/gh/bigeasy/vivifyer | | License: | MIT |

npm install vivifyer

Overview

Extant is an implementation of SQL's COALESCE that I've used for some time to deal with the fact that JavaScript truthiness will treat '' and 0 as true so the || operator can't always be used to create given or default one-liner.

const { compare, raise, equal } = require('vivifyer')

We use the name "extant" on NPM because we want the first extant argument.

Living README.md

This README.md is also a unit test using the Proof unit test framework. We'll use the Proof okay function to assert out statements in the readme. A Proof unit test generally looks like this.

require('proof')(4, async okay => {
    okay('always okay')
    okay(true, 'okay if true')
    okay(1, 1, 'okay if equal')
    okay({ value: 1 }, { value: 1 }, 'okay if deep strict equal')
})

You can run this unit test yourself to see the output from the various code sections of the readme.

git clone [email protected]:bigeasy/vivifyer.git
cd vivifyer
npm install --no-package-lock --no-save
node test/readme.t.js

Usage

The 'extant' module exports a single coalesce function.

const vivifyer = require('vivifyer')

Note that Extant is SQL's COALESCE. It returns the first non-null-like value, that is the first value that is not == null, which would be null or undefined. If there is no such argument it returns null.

okay('test')