DietoSorted() Methode vonArray Instanzen ist diekopierende Version dersort() Methode. Sie gibt ein neues Array zurück, bei dem die Elemente in aufsteigender Reihenfolge sortiert sind.

Syntax

toSorted()toSorted(compareFn)

Parameter

compareFnOptional

Eine Funktion, die die Reihenfolge der Elemente bestimmt. Wird sie weggelassen, werden die Array-Elemente in Zeichenfolgen umgewandelt und dann gemäß jedem Zeichen-Unicode-Codepunktwert sortiert. Siehesort() für weitere Informationen.

Rückgabewert

Ein neues Array, bei dem die Elemente in aufsteigender Reihenfolge sortiert sind.

Beschreibung

Siehesort() für weitere Informationen über dencompareFn Parameter.

Bei Verwendung aufsparse Arrays behandelt dietoSorted() Methode leere Plätze, als hätten sie den Wertundefined.

DietoSorted() Methode istgenerisch. Sie erwartet lediglich, dass derthis Wert einelength Eigenschaft und integer-gekoppelte Eigenschaften hat.

Beispiele

Ein Array sortieren

const months = ["Mar", "Jan", "Feb", "Dec"];const sortedMonths = months.toSorted();console.log(sortedMonths); // ['Dec', 'Feb', 'Jan', 'Mar']console.log(months); // ['Mar', 'Jan', 'Feb', 'Dec']const values = [1, 10, 21, 2];const sortedValues = values.toSorted((a, b) => a - b);console.log(sortedValues); // [1, 2, 10, 21]console.log(values); // [1, 10, 21, 2]

Für weitere Anwendungsbeispiele siehesort().

Verwenden von toSorted() auf sparse Arrays

Leere Plätze werden sortiert, als hätten sie den Wertundefined. Sie werden immer ans Ende des Arrays sortiert undcompareFn wird nicht für sie aufgerufen.

console.log(["a", "c", , "b"].toSorted()); // ['a', 'b', 'c', undefined]console.log([, undefined, "a", "b"].toSorted()); // ["a", "b", undefined, undefined]

Aufrufen von toSorted() auf Nicht-Array-Objekten

DietoSorted() Methode liest dielength Eigenschaft vonthis. Sie sammelt dann alle existierenden integer-gekoppelten Eigenschaften im Bereich von0 bislength - 1, sortiert sie und schreibt sie in ein neues Array.

const arrayLike = {  length: 3,  unrelated: "foo",  0: 5,  2: 4,  3: 3, // ignored by toSorted() since length is 3};console.log(Array.prototype.toSorted.call(arrayLike));// [4, 5, undefined]

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Polyfill vonArray.prototype.toSorted incore-js
• es-shims Polyfill vonArray.prototype.toSorted
• Leitfaden für indizierte Sammlungen
• Array.prototype.sort()
• Array.prototype.toReversed()
• Array.prototype.toSpliced()
• Array.prototype.with()
• TypedArray.prototype.toSorted()