toString

by 1 contributor:

Summary

The toString() method returns a string representing the specified array and its elements.

Syntax

arr.toString()

Parameters

None.

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. Standard Initial definition.
Implemented in JavaScript 1.1
ECMAScript 5.1 (ECMA-262)
The definition of 'Array.prototype.toString' in that specification.
Standard  
ECMAScript 6 (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)

See Also

Document Tags and Contributors

Contributors to this page: Sevenspade
Last updated by: Sevenspade,
Hide Sidebar