|
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299 |
- // Make sure Map exists for old Node.js versions
- var Map = global.Map != null ? global.Map : function() {};
-
- // These properties are special and can open client libraries to security
- // issues
- var ignoreProperties = ['__proto__', 'constructor', 'prototype'];
-
- /**
- * Returns the value of object `o` at the given `path`.
- *
- * ####Example:
- *
- * var obj = {
- * comments: [
- * { title: 'exciting!', _doc: { title: 'great!' }}
- * , { title: 'number dos' }
- * ]
- * }
- *
- * mpath.get('comments.0.title', o) // 'exciting!'
- * mpath.get('comments.0.title', o, '_doc') // 'great!'
- * mpath.get('comments.title', o) // ['exciting!', 'number dos']
- *
- * // summary
- * mpath.get(path, o)
- * mpath.get(path, o, special)
- * mpath.get(path, o, map)
- * mpath.get(path, o, special, map)
- *
- * @param {String} path
- * @param {Object} o
- * @param {String} [special] When this property name is present on any object in the path, walking will continue on the value of this property.
- * @param {Function} [map] Optional function which receives each individual found value. The value returned from `map` is used in the original values place.
- */
-
- exports.get = function (path, o, special, map) {
- var lookup;
-
- if ('function' == typeof special) {
- if (special.length < 2) {
- map = special;
- special = undefined;
- } else {
- lookup = special;
- special = undefined;
- }
- }
-
- map || (map = K);
-
- var parts = 'string' == typeof path
- ? path.split('.')
- : path
-
- if (!Array.isArray(parts)) {
- throw new TypeError('Invalid `path`. Must be either string or array');
- }
-
- var obj = o
- , part;
-
- for (var i = 0; i < parts.length; ++i) {
- part = parts[i];
-
- if (Array.isArray(obj) && !/^\d+$/.test(part)) {
- // reading a property from the array items
- var paths = parts.slice(i);
-
- return obj.map(function (item) {
- return item
- ? exports.get(paths, item, special || lookup, map)
- : map(undefined);
- });
- }
-
- if (lookup) {
- obj = lookup(obj, part);
- } else {
- var _from = special && obj[special] ? obj[special] : obj;
- obj = _from instanceof Map ?
- _from.get(part) :
- _from[part];
- }
-
- if (!obj) return map(obj);
- }
-
- return map(obj);
- };
-
- /**
- * Returns true if `in` returns true for every piece of the path
- *
- * @param {String} path
- * @param {Object} o
- */
-
- exports.has = function (path, o) {
- var parts = typeof path === 'string' ?
- path.split('.') :
- path;
-
- if (!Array.isArray(parts)) {
- throw new TypeError('Invalid `path`. Must be either string or array');
- }
-
- var len = parts.length;
- var cur = o;
- for (var i = 0; i < len; ++i) {
- if (cur == null || typeof cur !== 'object' || !(parts[i] in cur)) {
- return false;
- }
- cur = cur[parts[i]];
- }
-
- return true;
- };
-
- /**
- * Deletes the last piece of `path`
- *
- * @param {String} path
- * @param {Object} o
- */
-
- exports.unset = function (path, o) {
- var parts = typeof path === 'string' ?
- path.split('.') :
- path;
-
- if (!Array.isArray(parts)) {
- throw new TypeError('Invalid `path`. Must be either string or array');
- }
-
- var len = parts.length;
- var cur = o;
- for (var i = 0; i < len; ++i) {
- if (cur == null || typeof cur !== 'object' || !(parts[i] in cur)) {
- return false;
- }
- // Disallow any updates to __proto__ or special properties.
- if (ignoreProperties.indexOf(parts[i]) !== -1) {
- return false;
- }
- if (i === len - 1) {
- delete cur[parts[i]];
- return true;
- }
- cur = cur instanceof Map ? cur.get(parts[i]) : cur[parts[i]];
- }
-
- return true;
- };
-
- /**
- * Sets the `val` at the given `path` of object `o`.
- *
- * @param {String} path
- * @param {Anything} val
- * @param {Object} o
- * @param {String} [special] When this property name is present on any object in the path, walking will continue on the value of this property.
- * @param {Function} [map] Optional function which is passed each individual value before setting it. The value returned from `map` is used in the original values place.
- */
-
- exports.set = function (path, val, o, special, map, _copying) {
- var lookup;
-
- if ('function' == typeof special) {
- if (special.length < 2) {
- map = special;
- special = undefined;
- } else {
- lookup = special;
- special = undefined;
- }
- }
-
- map || (map = K);
-
- var parts = 'string' == typeof path
- ? path.split('.')
- : path
-
- if (!Array.isArray(parts)) {
- throw new TypeError('Invalid `path`. Must be either string or array');
- }
-
- if (null == o) return;
-
- for (var i = 0; i < parts.length; ++i) {
- // Silently ignore any updates to `__proto__`, these are potentially
- // dangerous if using mpath with unsanitized data.
- if (ignoreProperties.indexOf(parts[i]) !== -1) {
- return;
- }
- }
-
- // the existance of $ in a path tells us if the user desires
- // the copying of an array instead of setting each value of
- // the array to the one by one to matching positions of the
- // current array. Unless the user explicitly opted out by passing
- // false, see Automattic/mongoose#6273
- var copy = _copying || (/\$/.test(path) && _copying !== false)
- , obj = o
- , part
-
- for (var i = 0, len = parts.length - 1; i < len; ++i) {
- part = parts[i];
-
- if ('$' == part) {
- if (i == len - 1) {
- break;
- } else {
- continue;
- }
- }
-
- if (Array.isArray(obj) && !/^\d+$/.test(part)) {
- var paths = parts.slice(i);
- if (!copy && Array.isArray(val)) {
- for (var j = 0; j < obj.length && j < val.length; ++j) {
- // assignment of single values of array
- exports.set(paths, val[j], obj[j], special || lookup, map, copy);
- }
- } else {
- for (var j = 0; j < obj.length; ++j) {
- // assignment of entire value
- exports.set(paths, val, obj[j], special || lookup, map, copy);
- }
- }
- return;
- }
-
- if (lookup) {
- obj = lookup(obj, part);
- } else {
- var _to = special && obj[special] ? obj[special] : obj;
- obj = _to instanceof Map ?
- _to.get(part) :
- _to[part];
- }
-
- if (!obj) return;
- }
-
- // process the last property of the path
-
- part = parts[len];
-
- // use the special property if exists
- if (special && obj[special]) {
- obj = obj[special];
- }
-
- // set the value on the last branch
- if (Array.isArray(obj) && !/^\d+$/.test(part)) {
- if (!copy && Array.isArray(val)) {
- for (var item, j = 0; j < obj.length && j < val.length; ++j) {
- item = obj[j];
- if (item) {
- if (lookup) {
- lookup(item, part, map(val[j]));
- } else {
- if (item[special]) item = item[special];
- item[part] = map(val[j]);
- }
- }
- }
- } else {
- for (var j = 0; j < obj.length; ++j) {
- item = obj[j];
- if (item) {
- if (lookup) {
- lookup(item, part, map(val));
- } else {
- if (item[special]) item = item[special];
- item[part] = map(val);
- }
- }
- }
- }
- } else {
- if (lookup) {
- lookup(obj, part, map(val));
- } else if (obj instanceof Map) {
- obj.set(part, map(val));
- } else {
- obj[part] = map(val);
- }
- }
- }
-
- /*!
- * Returns the value passed to it.
- */
-
- function K (v) {
- return v;
- }
|