has-value    

> Returns true if a value exists, false if empty. Works with deeply nested values using object paths.

Please consider following this project's author, Jon Schlinkert, and consider starring the project to show your :heart: and support.

Install

Install with npm:

``sh
$ npm install --save has-value
`

Heads up!

Breaking changes in v2.0! See the release history for details.

Usage

`js
const has = require('has-value');

console.log(has()) //=> true
console.log(has('foo')) //=> true
`

Works for:

* booleans
* functions
* numbers
* strings
* nulls
* object
* arrays

isEmpty

To do the opposite and test for empty values, do:

`js
const isEmpty = (...args) => !has(...args);
`

Supported types

$3

`js
console.log(has({ foo: { bar: ['a'] } }, 'foo.bar')); //=> true
console.log(has({ foo: { bar: [0] } }, 'foo.bar')); //=> true
console.log(has({ foo: { bar: [[[]]] } }, 'foo.bar')); //=> false
console.log(has({ foo: { bar: [[], []] } }, 'foo.bar')); //=> false
console.log(has({ foo: { bar: [] } }, 'foo.bar')); //=> false
`

$3

`js
console.log(has({ foo: { bar: true } }, 'foo.bar')); //=> true
console.log(has({ foo: { bar: false } }, 'foo.bar')); //=> true
`

$3

`js
console.log(has({ foo: { bar: new Buffer() } }, 'foo.bar')); //=> false
console.log(has({ foo: { bar: new Buffer('foo') } }, 'foo.bar')); //=> true
`

$3

Dates are always true.

`js
console.log(has({ foo: { bar: new Date() } }, 'foo.bar')); //=> true
`

$3

Returns false if err.message is an empty string.

`js
console.log(has({ foo: { bar: new Error() } }, 'foo.bar')); //=> false
console.log(has({ foo: { bar: new Error('foo') } }, 'foo.bar')); //=> true
`

$3

Functions are always true.

`js
console.log(has({ foo: { bar: function(foo) {} } }, 'foo.bar')); //=> true
console.log(has({ foo: { bar: function() {} } }, 'foo.bar')); //=> true
`

$3

`js
console.log(has({ foo: { bar: new Map() } }, 'foo.bar')); //=> false
console.log(has({ foo: { bar: new Map([['foo', 'bar']]) } }, 'foo.bar')); //=> true
`

$3

null is always true, as it's assumed that this is a user-defined value, versus undefined which is not.

`js
console.log(has({ foo: { bar: null } }, 'foo.bar')); //=> true
`

$3

`js
console.log(has({ foo: { bar: {} } }, 'foo.bar')); //=> false
console.log(has({ foo: { bar: { a: 'a' }} } }, 'foo.bar')); //=> true
console.log(has({ foo: { bar: { foo: undefined } } }, 'foo.bar')); //=> false
console.log(has({ foo: { bar: { foo: null } } }, 'foo.bar')); //=> true
`

$3

`js
console.log(has({ foo: { bar: 1 } }, 'foo.bar')); //=> true
console.log(has({ foo: { bar: 0 } }, 'foo.bar')); //=> true
`

$3

`js
console.log(has({ foo: { bar: new RegExp() } }, 'foo.bar')); //=> false
console.log(has({ foo: { bar: new RegExp('foo') } }, 'foo.bar')); //=> true
`

$3

`js
console.log(has({ foo: { bar: new Set() } }, 'foo.bar')); //=> false
console.log(has({ foo: { bar: new Set(['foo', 'bar']) } }, 'foo.bar')); //=> true
`

$3

`js
console.log(has({ foo: { bar: 'a' } }, 'foo.bar')); //=> true
console.log(has({ foo: { bar: '' } }, 'foo.bar')); //=> false
`

Undefined

`js
console.log(has({ foo: { bar: } }, 'foo.bar')); //=> false
console.log(has({ foo: { bar: void 0 } }, 'foo.bar')); //=> false
console.log(has({ foo: { bar: undefined } }, 'foo.bar')); //=> false
`

Release history

$3

Breaking changes

* Now returns false if the first argument is not an object, function or array, and the second argument is not a string or array.

$3

* zero always returns true
* array now recurses, so that an array of empty arrays will return false
* null now returns true

About

$3

You might also be interested in these projects:

* define-property: Define a non-enumerable property on an object. Uses Reflect.defineProperty when available, otherwise Object.defineProperty. | homepage
* get-value: Use property paths like 'a.b.c' to get a nested value from an object. Even works… more | homepage.")
* set-value: Create nested values and any intermediaries using dot notation ('a.b.c') paths. | 'a.b.c'`" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">homepage paths.")
* unset-value: Delete nested properties from an object using dot notation. | homepage

$3

| Commits | Contributor |
| --- | --- |
| 32 | jonschlinkert |
| 2 | rmharrison |
| 1 | wtgtybhertgeghgtwtg |

$3

Jon Schlinkert

* LinkedIn Profile
* GitHub Profile
* Twitter Profile

$3

Copyright © 2018, Jon Schlinkert.
Released under the MIT License.

*

_This file was generated by verb-generate-readme, v0.6.0, on March 03, 2018._