extend() para Node.js

node-extend é uma adaptação do clássico método extend() do jQuery. Ele se comporta como esperado. É simples, testado e comprovado.

Notas:

• Desde Node.js >= 4, Object.assign agora oferece a mesma funcionalidade nativamente (mas sem a opção de "cópia profunda"). Veja ECMAScript 2015 (ES6) no Node.js.
• Algumas implementações nativas de Object.assign tanto no Node.js quanto em muitos navegadores (já que os módulos NPM também são para o navegador) podem não estar totalmente em conformidade com a especificação. Verifique o módulo object.assign para uma alternativa compatível.

Instalação

Este pacote está disponível no npm como: extend

npm install extend

Uso

Sintaxe: extend ( [deep], target, object1, [objectN] )

Estende um objeto com um ou mais outros, retornando o objeto modificado.

Exemplo:

var extend = require('extend');
extend(targetObject, object1, object2);

Lembre-se de que o objeto alvo será modificado e será retornado por extend().

Se um booleano verdadeiro for especificado como primeiro argumento, extend realiza uma cópia profunda, copiando recursivamente quaisquer objetos que encontrar. Caso contrário, a cópia compartilhará a estrutura com o(s) objeto(s) original(is). Propriedades indefinidas não são copiadas. No entanto, propriedades herdadas do protótipo do objeto serão copiadas. Aviso: passar false como primeiro argumento não é suportado.

Argumentos

• deep Boolean (opcional) Se definido, a mesclagem se torna recursiva (ou seja, cópia profunda).
• target Object O objeto a ser estendido.
• object1 Object O objeto que será mesclado ao primeiro.
• objectN Object (Opcional) Mais objetos a serem mesclados ao primeiro.

Licença

node-extend está licenciado sob a Licença MIT.

Agradecimentos

Todo o crédito aos autores do jQuery por aperfeiçoar esta utilidade incrível.

Adaptado para Node.js por Stefan Thomas com contribuições de Jonathan Buchanan e Jordan Harband.