toString Method (Object) (JavaScript)

2017-1-18 1 minutes to read Contributors

Returns a string representation of an object.

Syntax


objectname.toString([radix])

Parameters

objectname
Required. An object for which a string representation is sought.

radix
Optional. Specifies a radix for converting numeric values to strings. This value is only used for numbers.

Remarks

The toString method is a member of all built-in JavaScript objects. How it behaves depends on the object type:

Object	Behavior
Array	Elements of an `Array` are converted to strings. The resulting strings are concatenated, separated by commas.
Boolean	If the Boolean value is true, returns "`true`". Otherwise, returns "`false`".
Date	Returns the textual representation of the date.
Error	Returns a string containing the associated error message.
Function	Returns a string of the following form, where functionname is the name of the function whose toString method was called: `function functionname( ) { [native code] }`
Number	Returns the textual representation of the number.
String	Returns the value of the `String` object.
Default	Returns `"[object objectname]"`, where `objectname` is the name of the object type.

Example

The following example illustrates the use of the toString method with a radix argument. The return value of function shown below is a Radix conversion table.

function CreateRadixTable (){  
   var s = "";  

   // Create table heading.  
   s += "Hex  Dec  Bin \n";  

   for (x = 0; x < 16; x++)  
   {  
      s += "   ";  

      // Convert to hexidecimal.  
      s += x.toString(16);  
      s += "     ";  
      if (x < 10) s += "  ";  

      // Convert to decimal.  
      s += x.toString(10);  
      s += "     ";  

      // Convert to binary.  
      s += x.toString(2);  
      s += "\n";  
   }  

   return(s);  
}

Requirements

Supported in the following document modes: Quirks, Internet Explorer 6 standards, Internet Explorer 7 standards, Internet Explorer 8 standards, Internet Explorer 9 standards, Internet Explorer 10 standards, Internet Explorer 11 standards. Also supported Store apps (Windows 8 and Windows Phone 8.1). See Version Information.