TypedArray.prototype.reduce()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.
Die reduce() Methode von TypedArray Instanzen führt eine vom Benutzer bereitgestellte "Reducer"-Callback-Funktion auf jedem Element des typisierten Arrays aus, der Reihe nach, und übergibt den Rückgabewert der Berechnung des vorhergehenden Elements. Das endgültige Ergebnis der Ausführung des Reducers über alle Elemente des typisierten Arrays ist ein einzelner Wert. Diese Methode hat denselben Algorithmus wie Array.prototype.reduce().
Probieren Sie es aus
const uint8 = new Uint8Array([0, 1, 2, 3]);
function sum(accumulator, currentValue) {
return accumulator + currentValue;
}
console.log(uint8.reduce(sum));
// Expected output: 6
Syntax
reduce(callbackFn)
reduce(callbackFn, initialValue)
Parameter
callbackFn-
Eine Funktion, die für jedes Element im typisierten Array ausgeführt wird. Ihr Rückgabewert wird zum Wert des
accumulator-Parameters beim nächsten Aufruf voncallbackFn. Beim letzten Aufruf wird der Rückgabewert zum Rückgabewert vonreduce(). Die Funktion wird mit den folgenden Argumenten aufgerufen:accumulator-
Der Wert, der sich aus dem vorhergehenden Aufruf von
callbackFnergibt. Beim ersten Aufruf ist sein WertinitialValue, wenn letzteres angegeben ist; andernfalls ist sein Wertarray[0]. currentValue-
Der Wert des aktuellen Elements. Beim ersten Aufruf ist sein Wert
array[0], wenninitialValueangegeben ist; andernfalls ist sein Wertarray[1]. currentIndex-
Die Indexposition von
currentValueim typisierten Array. Beim ersten Aufruf ist sein Wert0, wenninitialValueangegeben ist, andernfalls1. array-
Das typisierte Array, auf dem
reduce()aufgerufen wurde.
initialValueOptional-
Ein Wert, auf den der
accumulatorbeim ersten Aufruf des Callback initialisiert wird. WenninitialValueangegeben ist, beginntcallbackFndie Ausführung mit dem ersten Wert im typisierten Array alscurrentValue. WenninitialValuenicht angegeben ist, wirdaccumulatorauf den ersten Wert im typisierten Array initialisiert undcallbackFnbeginnt die Ausführung mit dem zweiten Wert im typisierten Array alscurrentValue. In diesem Fall, wenn das typisierte Array leer ist (sodass kein erster Wert alsaccumulatorzurückgegeben werden kann), wird ein Fehler ausgelöst.
Rückgabewert
Der Wert, der sich ergibt, wenn die "Reducer"-Callback-Funktion über das gesamte typisierte Array durchgeführt wird.
Ausnahmen
TypeError-
Wird ausgelöst, wenn das typisierte Array keine Elemente enthält und
initialValuenicht angegeben ist.
Beschreibung
Siehe Array.prototype.reduce() für weitere Details. Diese Methode ist nicht generisch und kann nur auf Typisierungs-Array-Instanzen aufgerufen werden.
Beispiele
>Alle Werte innerhalb eines Arrays summieren
const total = new Uint8Array([0, 1, 2, 3]).reduce((a, b) => a + b);
// total === 6
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-%typedarray%.prototype.reduce> |