大网数据广告活动
Web 标准与前端开发

Array.prototype.toReversed()

· 52CE 我爱测

Array 实例的 **`toReversed()`** 方法是 Array/reverse 方法对应的复制版本。它返回一个元素顺序相反的新数组。

Array 实例的 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() 方法读取 this 的 length 属性。然后按降序访问 length - 1 和 0 之间的每个索引,并将原始数组中该索引的值添加到新数组相应的索引中。

const arrayLike = {
  length: 3,
  unrelated: "foo",
  2: 4,
};
console.log(Array.prototype.toReversed.call(arrayLike));
// [4, undefined, undefined]
// '0' 和 '1' 两个索引不存在,所以它们会变成 undefined

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。