dot-prop

WebJar for dot-prop

License

License

MIT
GroupId

GroupId

org.webjars.npm
ArtifactId

ArtifactId

dot-prop
Last Version

Last Version

5.3.0
Release Date

Release Date

Type

Type

jar
Description

Description

dot-prop
WebJar for dot-prop
Project URL

Project URL

https://www.webjars.org
Source Code Management

Source Code Management

https://github.com/sindresorhus/dot-prop

Download dot-prop

How to add to project

<!-- https://jarcasting.com/artifacts/org.webjars.npm/dot-prop/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>dot-prop</artifactId>
    <version>5.3.0</version>
</dependency>
// https://jarcasting.com/artifacts/org.webjars.npm/dot-prop/
implementation 'org.webjars.npm:dot-prop:5.3.0'
// https://jarcasting.com/artifacts/org.webjars.npm/dot-prop/
implementation ("org.webjars.npm:dot-prop:5.3.0")
'org.webjars.npm:dot-prop:jar:5.3.0'
<dependency org="org.webjars.npm" name="dot-prop" rev="5.3.0">
  <artifact name="dot-prop" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.webjars.npm', module='dot-prop', version='5.3.0')
)
libraryDependencies += "org.webjars.npm" % "dot-prop" % "5.3.0"
[org.webjars.npm/dot-prop "5.3.0"]

Dependencies

compile (1)

Group / Artifact Type Version
org.webjars.npm : is-obj jar [2.0.0,3)

Project Modules

There are no modules declared in this project.

dot-prop

Get, set, or delete a property from a nested object using a dot path

Install

$ npm install dot-prop

Usage

const dotProp = require('dot-prop');

// Getter
dotProp.get({foo: {bar: 'unicorn'}}, 'foo.bar');
//=> 'unicorn'

dotProp.get({foo: {bar: 'a'}}, 'foo.notDefined.deep');
//=> undefined

dotProp.get({foo: {bar: 'a'}}, 'foo.notDefined.deep', 'default value');
//=> 'default value'

dotProp.get({foo: {'dot.dot': 'unicorn'}}, 'foo.dot\\.dot');
//=> 'unicorn'

// Setter
const object = {foo: {bar: 'a'}};
dotProp.set(object, 'foo.bar', 'b');
console.log(object);
//=> {foo: {bar: 'b'}}

const foo = dotProp.set({}, 'foo.bar', 'c');
console.log(foo);
//=> {foo: {bar: 'c'}}

dotProp.set(object, 'foo.baz', 'x');
console.log(object);
//=> {foo: {bar: 'b', baz: 'x'}}

// Has
dotProp.has({foo: {bar: 'unicorn'}}, 'foo.bar');
//=> true

// Deleter
const object = {foo: {bar: 'a'}};
dotProp.delete(object, 'foo.bar');
console.log(object);
//=> {foo: {}}

object.foo.bar = {x: 'y', y: 'x'};
dotProp.delete(object, 'foo.bar.x');
console.log(object);
//=> {foo: {bar: {y: 'x'}}}

API

get(object, path, defaultValue?)

Get the value of the property at the given path.

Returns the value if any.

set(object, path, value)

Set the property at the given path to the given value.

Returns the object.

has(object, path)

Check whether the property at the given path exists.

Returns a boolean.

delete(object, path)

Delete the property at the given path.

Returns a boolean of whether the property existed before being deleted.

object

Type: object

Object to get, set, or delete the path value.

You are allowed to pass in undefined as the object to the get and has functions.

path

Type: string

Path of the property in the object, using . to separate each nested key.

Use \\. if you have a . in the key.

The following path components are invalid and results in undefined being returned: __proto__, prototype, constructor.

value

Type: unknown

Value to set at path.

defaultValue

Type: unknown

Default value.


Get professional support for this package with a Tidelift subscription
Tidelift helps make open source sustainable for maintainers while giving companies
assurances about security, maintenance, and licensing for their dependencies.

Versions

Version
5.3.0
5.2.0
4.2.1
4.2.0
4.1.1
2.4.0
2.3.0
2.1.0