set-value

What is set-value?

The set-value npm package is a utility for setting deeply nested values within an object using dot-path notation or by providing a path array. It is useful for updating values in a mutable way without directly accessing properties, especially when dealing with complex or deeply nested objects.

What are set-value's main functionalities?

Set nested values using dot-path

This feature allows you to set a value at a nested path within an object using a string dot-path notation.

const setValue = require('set-value');
const obj = {};
setValue(obj, 'a.b.c', 'value');
console.log(obj); //=> { a: { b: { c: 'value' } } }

Set nested values using array-path

This feature allows you to set a value at a nested path within an object using an array to describe the path.

const setValue = require('set-value');
const obj = {};
setValue(obj, ['a', 'b', 'c'], 'value');
console.log(obj); //=> { a: { b: { c: 'value' } } }

Set multiple values

This feature allows you to set multiple values at different paths within the same object.

const setValue = require('set-value');
const obj = {};
setValue(obj, 'a.b.c', 'value1');
setValue(obj, 'x.y.z', 'value2');
console.log(obj); //=> { a: { b: { c: 'value1' } }, x: { y: { z: 'value2' } } }

Other packages similar to set-value

lodash.set

lodash.set is a method from the Lodash library that performs a similar function to set-value. It allows setting values at a given path of an object tree. Lodash is a more extensive utility library, and lodash.set is just one of its many functions.

dot-prop

dot-prop is another npm package that allows you to get, set, or delete properties from a nested object using dot-path notation. It is similar to set-value but also provides methods for getting and deleting properties.

deepdash

deepdash is an extension for Lodash that adds deep object manipulation capabilities. It provides methods for deep setting, getting, and many other operations on nested objects. It is more feature-rich compared to set-value, which focuses solely on setting values.

README

set-value

Create nested values and any intermediaries using dot notation ('a.b.c') paths.

Install with npm

npm i set-value --save

Usage

var set = require('set-value');

var obj = {};
set(obj, 'a.b.c', 'd');
console.log(obj);
//=> {a: {b: c: 'd'}}

Related projects

• has-own-deep: Returns true if an object has an own, nested property.
• get-value: Use property paths (a.b.c) get a nested value from an object.
• has-value: Returns true if a value exists, false if empty. Works with deeply nested values using object paths.
• has-any: Returns true if an object has any of the specified keys.
• has-any-deep: Return true if key exists deeply on the given object.
• any: Returns true if a value exists in the given string, array or object.

Running tests

Install dev dependencies:

npm i -d && npm test

Contributing

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

Author

Jon Schlinkert

• github/jonschlinkert
• twitter/jonschlinkert

License

Copyright (c) 2015 Jon Schlinkert
Released under the MIT license

---

This file was generated by verb-cli on April 02, 2015.