@f/set-prop

Non-destructively set a nested property, given its path

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
@f/set-prop
101.0.16 years ago7 years agoMinified + gzip package size for @f/set-prop in KB

Readme

set-prop
!Build statustravis-imagetravis-url !Git taggit-imagegit-url !NPM versionnpm-imagenpm-url !Code stylestandard-imagestandard-url
Non-destructively set a nested property, given its path

Installation

$ npm install @f/set-prop

Usage

var setProp = require('@f/set-prop')
var obj = {a: {b: 1}}
var newObj = setProp('a.b', obj, 2)

obj.a.b === 1
newObj.a.b === 2
obj !== newObj

API

setProp(path, obj, value)

  • path - The path (specified as array or dotted string) of the property you wish to set
  • obj - The root object you want to set within
  • value - The value you want to assign to path within obj

Returns: A new root obj that has path changed to value, and all of the sub-objects in its tree cloned as well.

License

MIT