Iterator.prototype.chunks()
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die Methode chunks() von Iterator-Instanzen gibt ein neues Iterator-Hilfsobjekt zurück, das die Elemente des ursprünglichen Iterators in aufeinanderfolgende Arrays aufteilt. Bei jedem Iterationsschritt ruft das Hilfsobjekt die angegebene Anzahl von Elementen aus dem zugrunde liegenden Iterator ab und gibt sie gemeinsam zurück.
Informationen zur Ausgabe überlappender Sequenzen (eines gleitenden Fensters) finden Sie unter Iterator.prototype.windows().
Syntax
chunks(chunkSize)
Parameter
chunkSize-
Die Anzahl der Elemente in jedem Array. Muss eine positive Ganzzahl kleiner als 232 (die maximale Array-Länge) sein.
Rückgabewert
Ein neues Iterator-Hilfsobjekt. Bei jedem Aufruf der Methode next() des zurückgegebenen Iterator-Hilfsobjekts wird der ursprüngliche Iterator um chunkSize Elemente weiterbewegt. Diese Elemente werden gemeinsam als Array zurückgegeben.
Wenn im ursprünglichen Iterator noch Elemente vorhanden sind, aber weniger als chunkSize, werden diese ebenfalls als Array zurückgegeben (dessen Länge somit kleiner als chunkSize ist). Beim nächsten Aufruf von next() ist das Iterator-Hilfsobjekt dann abgeschlossen.
Wenn im ursprünglichen Iterator keine Elemente mehr vorhanden sind, ist das Iterator-Hilfsobjekt sofort abgeschlossen, ohne ein leeres Array zurückzugeben.
Ausnahmen
TypeError-
Wird ausgelöst, wenn
chunkSizekeine Ganzzahl ist. RangeError-
Wird ausgelöst, wenn
chunkSizekleiner als 1 oder größer als 232－1 ist.
Beispiele
Elemente in einem Raster ausgeben
Das folgende Beispiel erstellt einen Iterator, der Glieder der Fibonacci-Folge zurückgibt. Anschließend werden sie in einem Raster ausgegeben, indem jeweils 5 Elemente abgerufen werden.
function* fibonacci() {
let current = 1;
let next = 1;
while (true) {
yield current;
[current, next] = [next, current + next];
}
}
const rows = fibonacci().chunks(5);
for (const row of rows.take(5)) {
console.log(row.join("\t"));
}
Ausgabe:
1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987 1597 2584 4181 6765 10946 17711 28657 46368 75025
Spezifikationen
| Spezifikation |
|---|
| Iterator Chunking # sec-iterator.prototype.chunks |