Array.prototype.toReversed()

Метод toReversed() экземпляров Array является копирующим аналогом метода reverse(). Он возвращает новый массив с элементами в обратном порядке.

Синтаксис

toReversed()

Параметры

Нет.

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

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

Описание

Метод toReversed() транспонирует элементы вызываемого объекта массива в обратном порядке и возвращает новый массив.

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

Метод toReversed() является универсальным. Он ожидает, что значение this будет иметь свойство length и свойства с целочисленными ключами.

Примеры

Обращение элементов массива

Следующий пример создает массив items, содержащий три элемента, затем создает новый массив, который является обратным для items. Массив items остается без изменений.

const items = [1, 2, 3];
console.log(items); // [1, 2, 3]

const reversedItems = items.toReversed();
console.log(reversedItems); // [3, 2, 1]
console.log(items); // [1, 2, 3]

Использование toReversed() на разреженных массивах

Возвращаемое значение toReversed() никогда не является разреженным. Пустые слоты становятся undefined в возвращаемом массиве.

console.log([1, , 3].toReversed()); // [3, undefined, 1]
console.log([1, , 3, 4].toReversed()); // [4, 3, undefined, 1]

Вызов toReversed() на не-массивных объектах

Метод toReversed() считывает свойство length объекта this. Затем он обходит каждое свойство с целочисленным ключом от length - 1 до 0 в порядке убывания, добавляя значение текущего свойства в конец возвращаемого массива.

const arrayLike = {
  length: 3,
  unrelated: "foo",
  2: 4,
};
console.log(Array.prototype.toReversed.call(arrayLike));
// [4, undefined, undefined]
// The '0' and '1' indices are not present so they become undefined

Спецификации

Совместимость с браузерами

См. также

• Polyfill метода Array.prototype.toReversed в core-js
• Polyfill метода Array.prototype.toReversed из es-shims
• Руководство по индексированным коллекциям
• Array.prototype.reverse()
• Array.prototype.toSorted()
• Array.prototype.toSpliced()
• Array.prototype.with()
• TypedArray.prototype.toReversed()