Iterator.prototype.chunks()

Syntax

chunks(chunkSize)

Parameter

chunkSize

Die Anzahl der Elemente in jedem Chunk. Muss eine positive Ganzzahl kleiner als 232 (die maximale Array-Lnge) sein.

Rckgabewert

Ein neues Iterator-Helferobjekt. Jedes Mal, wenn die next()-Methode des zurckgegebenen Iterator-Helfers aufgerufen wird, wird der ursprngliche Iterator um chunkSize Elemente weitergefhrt, und diese Elemente werden zusammen als Array geliefert.

Wenn der ursprngliche Iterator einige, aber weniger als chunkSize Elemente brig hat, werden diese Elemente trotzdem als Array geliefert (die Lnge ist also kleiner als chunkSize), und der Iterator-Helfer wird sofort abgeschlossen, wenn next() das nchste Mal aufgerufen wird.

Wenn der ursprngliche Iterator keine Elemente mehr brig hat, wird der Iterator-Helfer sofort ohne ein leeres Array abgeschlossen.

Ausnahmen

TypeError

Wird ausgelst, wenn chunkSize keine Ganzzahl ist.

RangeError

Wird ausgelst, wenn chunkSize kleiner als 1 oder grer als 2321 ist.

Beispiele

Elemente in einem Raster drucken

Das folgende Beispiel erstellt einen Iterator, der Begriffe der Fibonacci-Folge ausgibt. Dann werden sie in einem Rasterlayout gedruckt, indem jedes Mal 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

Browser-Kompatibilitt

Siehe auch

• Polyfill von Iterator.prototype.chunks in core-js
• es-shims Polyfill von Iterator.prototype.chunks
• Iterator
• Iterator.prototype.windows()