Creates an object with the same keys as object and values generated by running each own enumerable string key through iteratee. Part of Lodash Object since 0.8.3 (stable — not deprecated).
Note: Key insertion order in the result follows own enumerable string keys; do not rely on a specific order across older engines.
Call _.mapValues. Start with this line.
_.mapValues(object, [iteratee])| Call | What it does |
|---|---|
_.mapValues(object, [iteratee]) | Primary signature. |
_.mapValues(object) | Work with an object’s keys, values, or paths. |
Prefer import mapValues from "lodash/mapValues" when you want a smaller bundle.
_.mapValues(object, [iteratee])This method has no parameters beyond those shown in the signature.
| Return Value | Description |
|---|---|
| * | New object (source not mutated) |
Pluck one field from each nested value with a string iteratee.
var users = {
fred: { user: 'fred', age: 40 },
pebbles: { user: 'pebbles', age: 1 }
};
_.mapValues(users, 'age');
// → { fred: 40, pebbles: 1 }'age' means “read .age from each value”.{user:'fred', age:40} → new value 40.1.fred and pebbles.Return a field with an explicit function — same idea as the shorthand.
var users = {
fred: { user: 'fred', age: 40 },
pebbles: { user: 'pebbles', age: 1 }
};
_.mapValues(users, function(o) {
return o.user;
});
// → { fred: 'fred', pebbles: 'pebbles' }o.o.user becomes the new value.fred, pebbles)._.mapValues(users, 'user').Transform plain numeric values with a function.
_.mapValues({ a: 1, b: 2 }, function(value) {
return value * value;
});
// → { a: 1, b: 4 }1 * 1 → 1.2 * 2 → 4.a and b.The iteratee also receives the key — build labeled strings.
_.mapValues({ a: 1, b: 2 }, function(value, key) {
return key + ':' + value;
});
// → { a: 'a:1', b: 'b:2' }(value, key, object).'a:1'.'b:2'.mapValues vs mapKeysSame source; rewrite values or rewrite keys.
var obj = { a: 1, b: 2 };
_.mapValues(obj, function(v) { return v * 10; });
// → { a: 10, b: 20 }
_.mapKeys(obj, function(v, k) { return k.toUpperCase(); });
// → { A: 1, B: 2 }_.mapValues is a Lodash Object helper since 0.8.3. It runs anywhere Lodash runs — modern browsers (CDN or bundle) and Node.js / Bun / Deno with npm install lodash.
Available in [email protected] full builds and the lodash/mapValues modular import. Works in evergreen browsers and current Node LTS when Lodash is installed.
Bottom line: Safe for production once Lodash is loaded. Prefer import mapValues from "lodash/mapValues" for smaller bundles. Use it to transform object values without mutating the source.
Recursively merge source objects into a destination.
10 people found this page helpful