Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > agorum core JavaScript-API


JavaScript-Bibliothek 3rdparty/lodash

lodash ist eine leistungsstarke JavaScript-Bibliothek, die eine Vielzahl von nützlichen Funktionen zur Verfügung stellt, um die Arbeit mit Arrays, Objekten, Zahlen und Strings zu erleichtern. Sie bietet Funktionalitäten, die in den nativen JavaScript-Funktionen nicht vorhanden sind oder sonst nur umständlich verwendet werden können, und hilft dabei, alltägliche Programmieraufgaben effizienter und einfacher umzusetzen. Die Bibliothek wird mit agorum core ausgeliefert und kann ohne zusätzliche Installation verwendet werden.

Im Folgenden finden Sie grundlegende Beispiele zur Verwendung von lodash in agorum core. Für die ausführliche Dokumentation der lodash-Bibliothek siehe die lodash-Dokumentation.

Verwendung


Binden Sie die Bibliothek stets am Anfang eines Skripts ein:

let lodash = require('3rdparty/lodash');

Einfache Beispiele


Vergleichen von Arrays und Objekten

Die lodash-Funktion isEqual vergleicht zwei Werte auf Deep Equality. Das bedeutet, dass die Funktion nicht nur die oberflächlichen Eigenschaften der Arrays oder Objekte prüft, sondern auch die innerhalb von verschachtelten Strukturen, um festzustellen, ob alle Ebenen identisch sind.

let lodash = require('3rdparty/lodash');

let a1 = ['a', 'b', { x: 1.0, y: 'hallo' }];
let b1 = ['a', 'b', { x: 1.0, y: 'hallo' }];

// the result is true
lodash.isEqual(a1, b1);

// now b1 is changed
b1[2].x = 1.0001;

// now the result is false
lodash.isEqual(a1, b1);

Kombinieren von Objekt-Eigenschaften

Die lodash-Funktion merge ermöglicht es, mehrere Objekte rekursiv zu einem neuen Objekt zu kombinieren. Bei dieser Zusammenführung werden Eigenschaften von Quellobjekten in das Zielobjekt kopiert. Wenn Eigenschaften denselben Schlüssel haben, überschreibt der Wert des zuletzt übergebenen Objekts den vorherigen Wert.

let lodash = require('3rdparty/lodash');

// define the first object with properties a and b
let object1 = { a: 1.0, b: 1.5 };

// define the second object with properties b and c (where b has a different value)
let object2 = { b: 2.3, c: 4.2 };

// use the lodash merge function to combine object1 and object2
// the values from object2 overwrite those in object1 with matching keys
let mergedObject = lodash.merge(object1, object2);

// the mergedObject contains the combined properties 
mergedObject; // Output: { a: 1.0, b: 2.3, c: 4.2 }

lodash-Version herausfinden

Sie können die Version der mitgelieferten lodash-Bibliothek selbst überprüfen:

let lodash = require('3rdparty/lodash');

lodash.VERSION; // Output: 4.17.15