Сводка

Методjoin() объединяет все элементы массива (илимассивоподобного объекта) в строку.

Интерактивный пример

const elements = ["Fire", "Air", "Water"];console.log(elements.join());// Expected output: "Fire,Air,Water"console.log(elements.join(""));// Expected output: "FireAirWater"console.log(elements.join("-"));// Expected output: "Fire-Air-Water"

Синтаксис

arr.join([separator])

Параметры

separatorНеобязательный

Определяет строку, разделяющую элементы массива. В случае необходимости тип разделителя приводится к типу Строка. Если он не задан, элементы массива разделяются запятой ','. Если разделитель - пустая строка, элементы массива ничем не разделяются в возвращаемой строке.

Возвращаемое значение

Строка, содержащая все элементы массива. Еслиarr.length ==0, то будет возвращена пустая строка.

Описание

Преобразует все элементы массива в строки и объединяет их в одну большую строку. Элемент массива с типомundefined илиnull преобразуется в пустую строку.

Примеры

Соединение массива четырьмя различными способами

В следующем примере создаётся массивa с тремя элементами, затем они четыре раза объединяются в строку: с использованием разделителя по умолчанию, запятой с пробелом, плюса, окружённого пробелами, и пустой строки.

var a = ["Ветер", "Дождь", "Огонь"];var myVar1 = a.join(); // присвоит 'Ветер,Дождь,Огонь' переменной myVar1var myVar2 = a.join(", "); // присвоит 'Ветер, Дождь, Огонь' переменной myVar2var myVar3 = a.join(" + "); // присвоит 'Ветер + Дождь + Огонь' переменной myVar3var myVar4 = a.join(""); // присвоит 'ВетерДождьОгонь' переменной myVar4

Соединение элементов массивоподобного объекта

В следующем примере соединяется массивоподобный объект (в данном случае списокаргументов функции) с использованием вызоваFunction.prototype.callдля Array.prototype.join.

function f(a, b, c) {  var s = Array.prototype.join.call(arguments);  console.log(s); // '1,a,true'}f(1, "a", true);

Спецификации

Совместимость с браузерами

Смотрите также

• String.prototype.split()
• Array.prototype.toString()
• TypedArray.prototype.join()