Array.prototype.join()
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Сводка
Метод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);
Спецификации
Specification |
---|
ECMAScript® 2026 Language Specification # sec-array.prototype.join |