extend() für Node.js

node-extend ist ein Port der klassischen extend()-Methode von jQuery. Es verhält sich so, wie man es erwartet. Es ist einfach, erprobt und bewährt.

Hinweise:

• Seit Node.js >= 4, Object.assign bietet jetzt dieselbe Funktionalität nativ (allerdings ohne die Option „deep copy“). Siehe ECMAScript 2015 (ES6) in Node.js.
• Einige native Implementierungen von Object.assign in Node.js und in vielen Browsern (da NPM-Module auch für den Browser bestimmt sind) sind möglicherweise nicht vollständig spezifikationskonform. Prüfen Sie das Modul object.assign für eine konforme Alternative.

Installation

Dieses Paket ist auf npm als extend verfügbar.

npm install extend

Verwendung

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

Erweitert ein Objekt um ein oder mehrere andere und gibt das modifizierte Objekt zurück.

Beispiel:

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

Beachten Sie, dass das Zielobjekt verändert und von extend() zurückgegeben wird.

Wenn als erstes Argument ein boolescher true angegeben wird, führt extend eine tiefe Kopie aus und kopiert rekursiv alle Objekte, die es findet. Andernfalls teilt die Kopie die Struktur mit dem/den ursprünglichen Objekt(en). Undefinierte Eigenschaften werden nicht kopiert. Eigenschaften, die vom Prototyp des Objekts geerbt wurden, werden jedoch kopiert. Warnung: Das Übergeben von false als erstes Argument wird nicht unterstützt.

Argumente

• deep Boolean (optional) Wenn gesetzt, wird die Zusammenführung rekursiv (d. h. eine tiefe Kopie).
• target Object Das zu erweiternde Objekt.
• object1 Object Das Objekt, das in das erste zusammengeführt wird.
• objectN Object (optional) Weitere Objekte, die in das erste zusammengeführt werden.

Lizenz

node-extend ist unter der MIT-Lizenz lizenziert.

Danksagungen

Alle Anerkennung gebührt den jQuery-Autoren für die Perfektionierung dieses erstaunlichen Werkzeugs.

Auf Node.js portiert von Stefan Thomas mit Beiträgen von Jonathan Buchanan und Jordan Harband.