Our volunteers haven't translated this article into عربي yet. Join us and help get the job done!
The toString()
method returns a string representing the specified array and its elements.
Syntax
arr.toString()
Return value
A string representing the elements of the array.
Description
The Array
object overrides the toString
method of Object
. For Array objects, the toString
method joins the array and returns one string containing each array element separated by commas. For example, the following code creates an array and uses toString
to convert the array to a string.
var monthNames = ['Jan', 'Feb', 'Mar', 'Apr']; var myVar = monthNames.toString(); // assigns 'Jan,Feb,Mar,Apr' to myVar.
JavaScript calls the toString
method automatically when an array is to be represented as a text value or when an array is referred to in a string concatenation.
ECMAScript 5 semantics
Starting in JavaScript 1.8.5 (Firefox 4), and consistent with ECMAScript 5th edition semantics, the toString()
method is generic and can be used with any object. If the object has a join()
method, it will be called and that value will be returned. Otherwise Object.prototype.toString()
will be called, and the resulting value will be returned.
Specifications
Specification | Status | Comment |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Initial definition. Implemented in JavaScript 1.1. |
ECMAScript 5.1 (ECMA-262) The definition of 'Array.prototype.toString' in that specification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Array.prototype.toString' in that specification. |
Standard | |
ECMAScript 2017 Draft (ECMA-262) The definition of 'Array.prototype.toString' in that specification. |
Draft |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |