A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Global_Objects/Array/toSorted below:

Array.prototype.toSorted() - JavaScript | MDN

Array.prototype.toSorted()

Baseline 2023

Newly available

Метод toSorted() экземпляров Array возвращает новый массив с элементами, отсортированными в порядке возрастания. Является копирующей версией метода sort().

Синтаксис
toSorted()
toSorted(compareFn)
Параметры
compareFn Необязательный

Функция, определяющая порядок сортировки. Если этот параметр опущен, элементы массива преобразуются в строки, а затем сортируются в соответствии со значением каждого символа в стандарте Юникод. Смотрите sort() для получения дополнительной информации.

Возвращаемое значение

Новый массив с отсортированными в порядке возрастания элементами.

Описание

Смотрите sort() для получения дополнительной информации о параметре compareFn.

При использовании метода toSorted() с разрежёнными массивами метод toSorted() обрабатывает пустые элементы так, как если бы они имели значение undefined.

Метод toSorted() является универсальным. Для его работы необходимо только, чтобы значение this имело свойство length и свойства с целочисленными индексами.

Примеры Сортировка элементов массива
const months = ["Мар", "Янв", "Фев", "Дек"];
const sortedMonths = months.toSorted();
console.log(sortedMonths); // ["Дек", "Мар", "Фев", "Янв"]
console.log(months); // ["Мар", "Янв", "Фев", "Дек"]

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]

Смотрите sort() для изучения дополнительных примеров использования.

Использование toSorted() на массивах с пропущенными элементами

Пустые элементы сортируются так, как если бы они имели значение undefined. В результате сортировки они всегда оказываются в конце массива, при этом compareFn для них не вызывается.

console.log(["а", "в", , "б"].toSorted()); // ["а", "б", "в", undefined]
console.log([, undefined, "а", "б"].toSorted()); // ["а", "б", undefined, undefined]
Вызов метода toSorted() для объектов, не являющихся массивами

В данном примере создаётся объект arrayLike, который не является массивом, но он обладает свойством length и целочисленными ключами. Поскольку arrayLike имеет свойство length, равное 3, метод toSorted() создаст новый массив с длиной равной 3. В результирующий массив попадут отсортированные значения с целочисленными ключами в диапазоне от 0 до length - 1. Элемент с индексом 1 пропущен, поэтому он превратится в значение undefined.

const arrayLike = {
  length: 3,
  unrelated: "foo",
  0: 5,
  2: 4,
  3: 3, // игнорируется методом toSorted(), так как длина равна 3
};
console.log(Array.prototype.toSorted.call(arrayLike));
// [4, 5, undefined]
Спецификации Совместимость с браузерами Смотрите также

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4