TypedArray.prototype.filter()

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 filter() Methode von TypedArray Instanzen erstellt eine Kopie eines Teils eines gegebenen typisierten Arrays, gefiltert auf die Elemente aus dem gegebenen typisierten Array, die den Test bestehen, der durch die bereitgestellte Funktion implementiert wurde. Diese Methode verwendet denselben Algorithmus wie Array.prototype.filter().

Probieren Sie es aus

function isNegative(element, index, array) {
  return element < 0;
}

const int8 = new Int8Array([-10, 20, -30, 40, -50]);
const negInt8 = int8.filter(isNegative);

console.log(negInt8);
// Expected output: Int8Array [-10, -30, -50]

Syntax

js
filter(callbackFn)
filter(callbackFn, thisArg)

Parameter

callbackFn

Eine Funktion, die für jedes Element im typisierten Array ausgeführt wird. Sie sollte einen truthy Wert zurückgeben, um das Element im resultierenden typisierten Array zu behalten, und einen falsy Wert andernfalls. Die Funktion wird mit den folgenden Argumenten aufgerufen:

element

Das aktuelle Element, das im typisierten Array verarbeitet wird.

index

Der Index des aktuellen Elements, das im typisierten Array verarbeitet wird.

array

Das typisierte Array, auf dem filter() aufgerufen wurde.

thisArg Optional

Ein Wert, der als this verwendet wird, wenn callbackFn ausgeführt wird. Siehe iterative Methoden.

Rückgabewert

Eine Kopie des gegebenen typisierten Arrays, die nur die Elemente enthält, die den Test bestehen. Wenn keine Elemente den Test bestehen, wird ein leeres typisiertes Array zurückgegeben.

Beschreibung

Siehe Array.prototype.filter() für weitere Details. Diese Methode ist nicht generisch und kann nur auf typisierten Array-Instanzen angewendet werden.

Beispiele

Herausfiltern aller kleinen Werte

Das folgende Beispiel verwendet filter(), um ein gefiltertes typisiertes Array zu erstellen, bei dem alle Elemente mit Werten kleiner als 10 entfernt wurden.

js
function isBigEnough(element, index, array) {
  return element >= 10;
}
new Uint8Array([12, 5, 8, 130, 44]).filter(isBigEnough);
// Uint8Array [ 12, 130, 44 ]

Spezifikationen

Specification
ECMAScript® 2026 Language Specification
# sec-%typedarray%.prototype.filter

Browser-Kompatibilität

Siehe auch