JavaScript String - substr() Method


This method returns the characters in a string beginning at the specified location through the specified number of characters.


The syntax to use substr() is as follows −

string.substr(start[, length]);

Argument Details

  • start − Location at which to start extracting characters (an integer between 0 and one less than the length of the string).

  • length − The number of characters to extract.

Note − If start is negative, substr uses it as a character index from the end of the string.

Return Value

The substr() method returns the new sub-string based on given parameters.


Try the following example.

      <title>JavaScript String substr() Method</title>
      <script type = "text/javascript">
         var str = "Apples are round, and apples are juicy.";         
         document.write("(1,2): "    + str.substr(1,2));
         document.write("<br />(-2,2): "   + str.substr(-2,2));
         document.write("<br />(1): "      + str.substr(1));
         document.write("<br />(-20, 2): " + str.substr(-20,2));
         document.write("<br />(20, 2): "  + str.substr(20,2));


(1,2): pp
(-2,2): y.
(1): pples are round, and apples are juicy.
(-20, 2): nd
(20, 2): d