Iterator.zipKeyed()
Die Iterator.zipKeyed() statische Methode erstellt ein neues Iterator-Objekt, das Elemente aus mehreren iterierbaren Objekten aggregiert, indem es Objekte generiert, die Elemente an derselben Position enthalten, wobei die Schlüssel durch die Eingabe spezifiziert werden. Sie "zippt" im Wesentlichen die Eingaben miteinander, um eine gleichzeitige Iteration über sie zu ermöglichen.
Die Methode Iterator.zip() ist ähnlich, generiert jedoch Arrays anstelle von Objekten.
Syntax
Iterator.zipKeyed(iterables)
Iterator.zipKeyed(iterables, options)
Parameter
iterables-
Ein Objekt. Jeder Eigenschaftsschlüssel wird als Schlüssel in den resultierenden Objekten verwendet. Der Wert der Eigenschaft muss entweder das iterable Protokoll oder, falls dies fehlschlägt, das iterator Protokoll implementieren. Diese Iterables können unendlich sein. Strings werden abgelehnt: Um Strings zu zippen, müssen sie explizit in Iteratoren umgewandelt werden, indem
Iterator.from()verwendet wird. optionsOptional-
Ein Objekt, das das Verhalten im Fall von inkonsistenten Eingabelängen spezifiziert. Es kann die folgenden Eigenschaften haben:
modeOptional-
Eines der folgenden:
"shortest"(Standard): Der resultierende Iterator stoppt, wenn ein Eingabe-Iterable erschöpft ist."longest": Der resultierende Iterator stoppt, wenn alle Eingabe-Iterables erschöpft sind. Fehlende Werte kürzerer Iterables werden gemäß derpadding-Option gefüllt."strict": EinTypeErrorwird ausgelöst, wenn nicht alle Eingabe-Iterables gleichzeitig fertig sind.
paddingOptional-
Ein Objekt. Wird nur abgerufen und validiert, wenn
mode"longest"ist. Wennundefinedoder nicht vorhanden, werden fehlende Werte kürzerer Iterables mitundefinedgefüllt (was dem Übergeben eines leeren Objekts entspricht). Wenn ein Objekt bereitgestellt wird, wird jeder Schlüssel desiterables-Arguments sofort abgerufen, wennIterator.zipKeyed()aufgerufen wird.padding[key]wird für fehlende Werte füriterables[key]verwendet. Wenn dempaddingObjekt einige Schlüssel fehlen, werden diese Schlüssel mitundefinedgefüllt.
Rückgabewert
Ein neues Iterator-Objekt. Jedes seiner Elemente ist ein Objekt mit denselben Schlüsseln wie das iterables-Argument, das die Elemente von jedem Eingabe-Iterable an der entsprechenden Position enthält.
Beschreibung
Die Funktion Iterator.zipKeyed() verhält sich ähnlich wie Iterator.zip(); der einzige Unterschied besteht darin, dass Sie die in den resultierenden Objekten verwendeten Schlüssel angeben können, während Iterator.zip() immer numerische Indizes verwendet (da es Arrays generiert).
Wenn wir Iterables als Arrays darstellen, könnte die Eingabe so aussehen:
({
a: [a1, a2, a3, a4],
b: [b1, b2, b3],
c: [c1, c2, c3, c4, c5],
});
Der resultierende Iterator wird, unabhängig von den Optionen, mit dem Ausgeben der folgenden Arrays beginnen:
({ a: a1, b: b1, c: c1 });
({ a: a2, b: b2, c: c2 });
({ a: a3, b: b3, c: c3 });
Nachdem die ersten drei Objekte generiert wurden, ist das Eingabe-Iterable b beim vierten next() Aufruf erschöpft — es gibt { done: true } zurück. Was als Nächstes passiert, hängt von der mode-Option ab. Wenn mode "shortest" ist (Standard), stoppt der resultierende Iterator hier: die anderen beiden Eingabe-Iteratoren werden geschlossen. Wenn mode "strict" ist, wird ein Fehler ausgelöst, weil die anderen beiden Iterables nicht fertig sind, wenn das zweite { done: true } ergibt. Wenn mode "longest" ist, setzt der resultierende Iterator das Generieren von Objekten fort und füllt fehlende Werte. Wenn padding nicht bereitgestellt wird, wird es standardmäßig auf undefined gesetzt:
({ a: a4, b: undefined, c: c4 });
({ a: undefined, b: undefined, c: c5 });
Wenn padding als Objekt bereitgestellt wird, könnte es wie { a: p1, b: p2, c: p3 } aussehen. Dann wird p2 verwendet, um den fehlenden Wert aus dem Eingabe-Iterable b zu füllen, und p1 wird verwendet, um den fehlenden Wert aus dem Eingabe-Iterable a zu füllen:
({ a: a4, b: p2, c: c4 });
({ a: p1, b: p2, c: c5 });
Beispiele
Transponieren von tabellarischen Daten
Es gibt zwei gängige Wege, um tabellarische Daten darzustellen: als ein Objekt, bei dem jede Eigenschaft eine Spalte ist, oder als ein Array von Objekten, bei dem jedes Objekt eine Zeile ist. Dieses Beispiel zeigt, wie Sie die spaltenbasierte Darstellung zeilenweise mit Iterator.zipKeyed() iterieren können.
const table = {
name: ["Caroline", "Danielle", "Evelyn"],
age: [30, 25, 35],
city: ["New York", "London", "Hong Kong"],
};
for (const { name, age, city } of Iterator.zipKeyed(table)) {
console.log(`${name}, aged ${age}, lives in ${city}.`);
}
// Output:
// Caroline, aged 30, lives in New York.
// Danielle, aged 25, lives in London.
// Evelyn, aged 35, lives in Hong Kong.
Die meisten Anwendungsfälle von Iterator.zipKeyed() sind identisch mit denen von Iterator.zip(). Welche verwendet wird, hängt davon ab, ob Sie bereits ein Objekt mit Iterables (verwenden Sie zipKeyed()) oder ein Array mit Iterables (verwenden Sie zip()) haben. Wir empfehlen, zipKeyed() nach Möglichkeit zu verwenden, da das Angeben expliziter Schlüssel es schwieriger macht, die Reihenfolge der Iterables versehentlich zu vertauschen.