JavaScript Array sort()

❮ Previous JavaScript Array Reference Next ❯

Examples

// Create an Array
const fruits = ["Banana", "Orange", "Apple", "Mango"];

// Sort the Array
fruits.sort();

Try it Yourself »

More Examples Below !

Description

The sort() method sorts the elements of an array.

The sort() method sorts the elements as strings in alphabetical and ascending order.

The sort() method overwrites the original array.

Array Sort Methods:

Method	Finds
reverse()	Reverses the order of the elements in an array
sort()	Sorts the elements of an array
toReversed()	Reverses the elements of an array into a new array
toSorted()	Sorts the elements of an array into a new array

Sort Compare Function

Sorting alphabetically works well for strings ("Apple" comes before "Banana").

But, sorting numbers can produce incorrect results.

"25" is bigger than "100", because "2" is bigger than "1".

You can fix this by providing a "compare function" (See examples below).

Syntax

array.sort(compareFunction)

Parameters

Parameter Description

compareFunction Optional.
A function that defines a sort order. The function should return a negative, zero, or positive value, depending on the arguments:

function(a, b){return a-b}

When sort() compares two values, it sends the values to the compare function, and sorts the values according to the returned (negative, zero, positive) value.

Example:

The sort function will sort 40 as a value lower than 100.

When comparing 40 and 100, sort() calls the function(40,100).

The function calculates 40-100, and returns -60 (a negative value).

Return Value

Type Description

Array The array with the items sorted.

More Examples

Sort Decending

Sort and then reverse the order:

// Create an Array
const fruits = ["Banana", "Orange", "Apple", "Mango"];

// Sort the Array
fruits.sort();

// Reverse the array
fruits.reverse();

Try it Yourself »

Numeric Sorts

Using a Sort Function

Sort numbers in ascending order:

// Create an Array
const points = [40, 100, 1, 5, 25, 10];

// Sort the Array
points.sort(function(a, b){return a-b});

Try it Yourself »

Sort numbers in descending order:

// Create an Array
const points = [40, 100, 1, 5, 25, 10];

// Sort the Array
points.sort(function(a, b){return b-a});

Try it Yourself »

Find the lowest value:

// Create an Array
const points = [40, 100, 1, 5, 25, 10];

// Sort the numbers in ascending order
points.sort(function(a, b){return a-b});

let lowest = points[0];

Try it Yourself »

Find the highest value:

// Create an Array
const points = [40, 100, 1, 5, 25, 10];

// Sort the numbers in descending order:
points.sort(function(a, b){return b-a});

let highest = points[0];

Try it Yourself »

Find the highest value:

// Create an Array
const points = [40, 100, 1, 5, 25, 10];

// Sort the numbers in ascending order:
points.sort(function(a, b){return a-b});

let highest = points[points.length-1];

Try it Yourself »