From 383285ecd5292bf9a825e05904955b937de84cc9 Mon Sep 17 00:00:00 2001 From: Minteck Date: Sat, 4 Jun 2022 08:51:01 +0200 Subject: Initial commit --- node_modules/dot-prop/readme.md | 117 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 117 insertions(+) create mode 100644 node_modules/dot-prop/readme.md (limited to 'node_modules/dot-prop/readme.md') diff --git a/node_modules/dot-prop/readme.md b/node_modules/dot-prop/readme.md new file mode 100644 index 0000000..4170565 --- /dev/null +++ b/node_modules/dot-prop/readme.md @@ -0,0 +1,117 @@ +# dot-prop [![Build Status](https://travis-ci.org/sindresorhus/dot-prop.svg?branch=master)](https://travis-ci.org/sindresorhus/dot-prop) + +> Get, set, or delete a property from a nested object using a dot path + + +## Install + +``` +$ npm install dot-prop +``` + + +## Usage + +```js +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?) + +### set(object, path, value) + +Returns the object. + +### has(object, path) + +### delete(object, 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. +
+
-- cgit