c29b520108 | ||
---|---|---|
.. | ||
CHANGELOG.md | ||
LICENSE | ||
README.md | ||
index.js | ||
package.json | ||
pathval.js |
README.md
pathval
Tool for Object value retrieval given a string path for node and the browser.
What is pathval?
Pathval is a module which you can use to retrieve or set an Object's property for a given String
path.
Installation
Node.js
pathval
is available on npm. To install it, type:
$ npm install pathval
Browsers
You can also use it within the browser; install via npm and use the pathval.js
file found within the download. For example:
<script src="./node_modules/pathval/pathval.js"></script>
Usage
The primary export of pathval
is an object which has the following methods:
hasProperty(object, name)
- Checks whether anobject
hasname
d property or numeric array index.getPathInfo(object, path)
- Returns an object with info indicating the value of theparent
of that path, thename
of the property we're retrieving and itsvalue
.getPathValue(object, path)
- Retrieves the value of a property at a givenpath
inside anobject
'.setPathValue(object, path, value)
- Sets thevalue
of a property at a givenpath
inside anobject
'.
var pathval = require('pathval');
.hasProperty(object, name)
var pathval = require('pathval');
var obj = { prop: 'a value' };
pathval.hasProperty(obj, 'prop'); // true
.getPathInfo(object, path)
var pathval = require('pathval');
var obj = { earth: { country: 'Brazil' } };
pathval.getPathInfo(obj, 'earth.country'); // { parent: { country: 'Brazil' }, name: 'country', value: 'Brazil', exists: true }
.getPathValue(object, path)
var pathval = require('pathval');
var obj = { earth: { country: 'Brazil' } };
pathval.getPathValue(obj, 'earth.country'); // 'Brazil'
.setPathValue(object, path, value)
var pathval = require('pathval');
var obj = { earth: { country: 'Brazil' } };
pathval.setPathValue(obj, 'earth.country', 'USA');
obj.earth.country; // 'USA'