defaults.js 835 B

12345678910111213141516171819202122232425
  1. var assign = require('./assign'),
  2. assignDefaults = require('../internal/assignDefaults'),
  3. createDefaults = require('../internal/createDefaults');
  4. /**
  5. * Assigns own enumerable properties of source object(s) to the destination
  6. * object for all destination properties that resolve to `undefined`. Once a
  7. * property is set, additional values of the same property are ignored.
  8. *
  9. * **Note:** This method mutates `object`.
  10. *
  11. * @static
  12. * @memberOf _
  13. * @category Object
  14. * @param {Object} object The destination object.
  15. * @param {...Object} [sources] The source objects.
  16. * @returns {Object} Returns `object`.
  17. * @example
  18. *
  19. * _.defaults({ 'user': 'barney' }, { 'age': 36 }, { 'user': 'fred' });
  20. * // => { 'user': 'barney', 'age': 36 }
  21. */
  22. var defaults = createDefaults(assign, assignDefaults);
  23. module.exports = defaults;