JavaScript String - localeCompare() Method



This method returns a number indicating whether a reference string comes before or after or is the same as the given string in sorted order.


The syntax of localeCompare() method is −

string.localeCompare( param )

Argument Details

param − A string to be compared with string object.

Return Value

  • 0 − If the string matches 100%.

  • 1 − no match, and the parameter value comes before the string object's value in the locale sort order

  • -1 −no match, and the parameter value comes after the string object's value in the local sort order


Try the following example.

      <title>JavaScript String localeCompare() Method</title>
      <script type="text/javascript">
         var str1 = new String( "This is beautiful string" );
         var index = str1.localeCompare( "XYZ" );
         document.write("localeCompare first :" + index ); 
         document.write("<br />" ); 
         var index = str1.localeCompare( "AbCD ?" );
         document.write("localeCompare second :" + index ); 


localeCompare first :-1
localeCompare second :1