array.reverse

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

See also

• Array.prototype.join()
• Array.prototype.sort()
• TypedArray.prototype.reverse()