Array.prototype.toString()

BaselineWidely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

DietoString() Methode vonArray-Instanzen gibt einen String zurück, der das angegebene Array und dessen Elemente repräsentiert.

Probieren Sie es aus

const array1 = [1, 2, "a", "1a"];console.log(array1.toString());// Expected output: "1,2,a,1a"

Syntax

toString()

Rückgabewert

Ein String, der die Elemente des Arrays darstellt.

DasArray-Objekt überschreibt dietoString-Methode vonObject. DietoString-Methode von Arrays ruft internjoin() auf, welches das Array verbindet und einen String zurückgibt, der jedes Array-Element durch Kommas getrennt enthält. Wenn diejoin-Methode nicht verfügbar ist oder keine Funktion ist, wird stattdessenObject.prototype.toString verwendet, das[object Array] zurückgibt.

const arr = [];arr.join = 1; // re-assign `join` with a non-functionconsole.log(arr.toString()); // [object Array]console.log(Array.prototype.toString.call({ join: () => 1 })); // 1

JavaScript ruft dietoString-Methode automatisch auf, wenn ein Array als Textwert dargestellt werden soll oder wenn ein Array in einer String-Konkatenation referenziert wird.

Array.prototype.toString konvertiert rekursiv jedes Element, einschließlich anderer Arrays, zu Strings. Da der vonArray.prototype.toString zurückgegebene String keine Trennzeichen hat, sehen verschachtelte Arrays aus, als wären sie abgeflacht.

const matrix = [  [1, 2, 3],  [4, 5, 6],  [7, 8, 9],];console.log(matrix.toString()); // 1,2,3,4,5,6,7,8,9

Wenn ein Array zyklisch ist (es ein Element enthält, das es selbst ist), vermeiden Browser eine unendliche Rekursion, indem sie die zyklische Referenz ignorieren.

const arr = [];arr.push(1, [3, arr, 4], 2);console.log(arr.toString()); // 1,3,,4,2

Beispiele

Verwendung von toString()

const array1 = [1, 2, "a", "1a"];console.log(array1.toString()); // "1,2,a,1a"

Verwendung von toString() bei lückenhaften Arrays

Dem Verhalten vonjoin() folgend, behandelttoString() leere Plätze genauso wieundefined und erzeugt einen zusätzlichen Separator:

console.log([1, , 3].toString()); // '1,,3'

Aufruf von toString() bei Nicht-Array-Objekten

toString() istgenerisch. Es erwartet, dassthis einejoin()-Methode hat; oder, falls dies fehlschlägt, wird stattdessenObject.prototype.toString() verwendet.

console.log(Array.prototype.toString.call({ join: () => 1 }));// 1; a numberconsole.log(Array.prototype.toString.call({ join: () => undefined }));// undefinedconsole.log(Array.prototype.toString.call({ join: "not function" }));// "[object Object]"