The reverse()
method reverses an array in place. The first array element becomes the last, and the last array element becomes the first.
var a = ['one', 'two', 'three']; a.reverse(); console.log(a); // ['three', 'two', 'one']
Syntax
a.reverse()
Return value
The reversed array.
Description
The reverse
method transposes the elements of the calling array object in place, mutating the array, and returning a reference to the array.
Examples
Reversing the elements in an array
The following example creates an array a
, containing three elements, then reverses the array. The call to reverse()
returns a reference to the reversed array a
.
var a = ['one', 'two', 'three']; var reversed = a.reverse(); console.log(a); // ['three', 'two', 'one'] console.log(reversed); // ['three', 'two', 'one']
Specifications
Specification | Status | Comment |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Initial definition. Implemented in JavaScript 1.1. |
ECMAScript 5.1 (ECMA-262) The definition of 'Array.prototype.reverse' in that specification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Array.prototype.reverse' in that specification. |
Standard | |
ECMAScript 2017 Draft (ECMA-262) The definition of 'Array.prototype.reverse' in that specification. |
Draft |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Edge | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 1.0 | 1.0 (1.7 or earlier) | (Yes) | 5.5 | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
See also
Document Tags and Contributors
Tags:
Contributors to this page:
David_Gilbertson,
fscholz,
Didglee,
svrcekmichal,
eduardoboucas,
TotalAMD,
Mingun,
Sheppy,
ethertank,
evilpie,
Inimino,
Brettz9,
Mgjbot,
Waldo,
Yuichirou,
Ptak82,
Maian,
Dria
Last updated by:
David_Gilbertson,