Array.prototype.toReversed()
Baseline2023Newly available
Since July 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
구문
js
toReversed()매개변수
없음.
반환 값
역순으로 정렬된 새로운 배열을 반환합니다.
설명
예제
배열의 요소를 반대로 뒤집기
다음 예제는 세 개의 요소를 가진items 배열을 생성하고, 이를 반대로 뒤집은 새로운 배열을 생성합니다.items 배열은 변경되지 않습니다.
js
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가 됩니다.
js
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 사이의 각 인덱스를 내림차순으로 방문하고, 원래 배열의 해당 인덱스의 값을 새 배열의 해당 인덱스에 추가합니다.
js
const arrayLike = { length: 3, unrelated: "foo", 2: 4,};console.log(Array.prototype.toReversed.call(arrayLike));// [4, undefined, undefined]// '0'번과 '1'번 인덱스가 없기 때문에 undefined가 됩니다.명세서
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.prototype.toreversed |