npm install xtnd

bower install xtnd

var xtnd = require('xtnd');

var a = xtnd({}, {a: 1});  // {a: 1}

function f() {}
f.a = 1; f.b = 2;
xtnd.keys(f);               // ['a', 'b']
xtnd.keys({a: 1, b: 2});    // ['a', 'b']
xtnd.keys([1, 2]);          // []

xtnd.values([1, 2]);         // [1, 2]
xtnd.values({a: 1, b: 2});   // [1, 2]

xtnd.array([1]);        // [1]
xtnd.array({a: 1});     // [{a: 1}]
xtnd.array(arguments);  // converts to array
xtnd.array(undefined);  // []
xtnd.array(null);       // [null]
xtnd.array(123);        // [123]
xtnd.array('a');        // ['a']

xtnd.hash([{a: 1, b: 2}, {a: 3, b: 4}], 'a');   // {1: {a: 1, b: 2}, 3: {a: 3, b: 4}}

xtnd.each(list, function(val, i, orig) {
  return false;
});

var src = {a: 1, b: 2, c: 3};
var res = xtnd.map(src, function(val, i, orig) {
  if (val % 2) {
    return val + 4;
  }
});
// res === {a: 5, c: 7}

var res = xtnd.find([2, 3, 4, 5], function(val, i, orig) {
  return val % 2;  
});
// res === 3

xtnd.param('a=1&b=2')               // {a: '1', b: '1'}
xtnd.param('a:1|b:2', ':', '|')     // {a: '1', b: '2'}

xtnd.isNull(null);            // true
xtnd.isNull({});              // false
 
xtnd.isArray([1, 2]);         // true
xtnd.isObject([1, 2]);        // false
 
xtnd.isObject({a: 1});        // true
xtnd.isArguments(arguments);  // true
xtnd.isUndefined(undefined);  // true