THE WORLD'S LARGEST WEB DEVELOPER SITE

JavaScript String localeCompare() Method

Example

Compare two strings in the current locale:

var str1 = "ab";
var str2 = "cd";
var n = str1.localeCompare(str2);
Try it Yourself »

More "Try it Yourself" examples below.


Definition and Usage

The localeCompare() method compares two strings in the current locale.

The locale is based on the language settings of the browser.

The localeCompare() method returns a number indicating whether the string comes before, after or is equal as the compareString in sort order.


Browser Support

Method
localeCompare() Yes Yes Yes Yes Yes

Syntax

string.localeCompare(compareString)

Parameter Values

Parameter Description
compareString Required. The string to compare with


Technical Details

Return Value: A Number, indicating whether the reference string comes before, after or is the same as the compareString in sort order. Returns one of three values:
  • -1 if the reference string is sorted before the compareString
  • 0 if the two strings are equal
  • 1 if the reference string is sorted after the compareString
JavaScript Version: ECMAScript 1

More Examples

Example

Compare two strings in the current locale:

var str1 = "cd";
var str2 = "ab";
var n = str1.localeCompare(str2);
Try it Yourself »

Example

Compare two equal strings in the current locale:

var str1 = "ab";
var str2 = "ab";
var n = str1.localeCompare(str2);
Try it Yourself »