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, das auf die Elemente aus dem gegebenen typisierten Array reduziert ist, die den Test bestehen, der durch die bereitgestellte Funktion implementiert wird. Diese Methode hat denselben Algorithmus wie Array.prototype.filter().

Probieren Sie es aus

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 kein Element den Test besteht, 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 aufgerufen werden.

Beispiele

Herausfiltern aller kleinen Werte

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

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 Language Specification
# sec-%typedarray%.prototype.filter

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch