TypedArray.prototype.toSorted()

Baseline 2023
Newly available

Since July 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die Methode toSorted() von TypedArray-Instanzen ist die kopierende Version der sort()-Methode. Sie gibt ein neues typisiertes Array zurück, dessen Elemente in aufsteigender Reihenfolge sortiert sind. Diese Methode verwendet denselben Algorithmus wie Array.prototype.toSorted(), sortiert die Werte jedoch standardmäßig numerisch statt als Zeichenfolgen.

Syntax

js
toSorted()
toSorted(compareFn)

Parameter

compareFn Optional

Eine Funktion, die die Reihenfolge der Elemente bestimmt. Wird diese weggelassen, werden die Elemente des typisierten Arrays numerisch sortiert. Weitere Informationen finden Sie unter sort().

Rückgabewert

Ein neues typisiertes Array mit den in aufsteigender Reihenfolge sortierten Elementen.

Beschreibung

Siehe Array.prototype.toSorted() für weitere Details. Diese Methode ist nicht generisch und kann nur auf Instanzen von typisierten Arrays aufgerufen werden.

Beispiele

Sortieren eines Arrays

Weitere Beispiele finden Sie auch in der Methode Array.prototype.sort().

js
const numbers = new Uint8Array([40, 1, 5, 200]);
const numberSorted = numbers.toSorted();
console.log(numberSorted); // Uint8Array [ 1, 5, 40, 200 ]
// Unlike plain Arrays, a compare function is not required
// to sort the numbers numerically.
console.log(numbers); // Uint8Array [ 40, 1, 5, 200 ]

Spezifikationen

Specification
ECMAScript Language Specification
# sec-%typedarray%.prototype.tosorted

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch