Name	Last modified	Size	Description
	Parent Directory		-
	LICENSE	2015-10-02 22:23	1.1K
	test.js	2015-10-02 22:23	1.0K
	index.js	2015-10-02 22:23	277	3e510ca test new git [كارل مبارك]
	package.json	2023-06-13 07:17	1.3K	3e510ca test new git [كارل مبارك]
	README.md	2015-10-02 22:23	827	d768d73 docs [كارل مبارك]

# defaults

A simple one level options merge utility

## install

`npm install defaults`

## use

```javascript

var defaults = require('defaults');

var handle = function(options, fn) {
  options = defaults(options, {
    timeout: 100
  });

  setTimeout(function() {
    fn(options);
  }, options.timeout);
}

handle({ timeout: 1000 }, function() {
  // we're here 1000 ms later
});

handle({ timeout: 10000 }, function() {
  // we're here 10s later
});

```

## summary

this module exports a function that takes 2 arguments: `options` and `defaults`.  When called, it overrides all of `undefined` properties in `options` with the clones of properties defined in `defaults`

Sidecases: if called with a falsy `options` value, options will be initialized to a new object before being merged onto.

## license

[MIT](LICENSE)