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 toSorted()-Methode 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(), außer dass sie die Werte standardmäßig numerisch statt als Zeichenfolgen sortiert.

Syntax

js
toSorted()
toSorted(compareFn)

Parameter

compareFn Optional

Eine Funktion, die die Reihenfolge der Elemente bestimmt. Wenn sie weggelassen wird, werden die Elemente des typisierten Arrays nach ihrem numerischen Wert sortiert. Weitere Informationen finden Sie unter sort().

Rückgabewert

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

Beschreibung

Weitere Details finden Sie unter Array.prototype.toSorted(). Diese Methode ist nicht generisch und kann nur auf typisierten Array-Instanzen aufgerufen werden.

Beispiele

Sortieren eines Arrays

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

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

Browser-Kompatibilität

Siehe auch