4.17.11
3.10.1
2.4.2
1.3.1

_.defaults(object, [sources])

Assigns own and inherited enumerable string keyed properties of source objects to the destination object for all destination properties that resolve to undefined. Source objects are applied from left to right. Once a property is set, additional values of the same property are ignored.

Note: This method mutates object.

Since

0.1.0

Arguments

argument
object
[sources]
type
Object
...Object
description
The destination object.
The source objects.

Returns

(array)

Example

_.defaults(
  { a: 1 },
  { b: 2 },
  { a: 3 }
);
// => { 'a': 1, 'b': 2 }
_.defaults({ a: 1 }, { b: 2 }, { a: 3 });
// => { 'a': 1, 'b': 2 }