JavaScript метод join()

JavaScript Array

Определение и применение

JavaScript метод join() позволяет преобразовать и объединить все элементы массива в одно строковое значение. По умолчанию, элементы массива будут разделены запятой, это поведение можно изменить передав в качестве параметра метода значение, которое будет использовано в качестве разделителя.


Обращаю Ваше внимание, что если метод вызывается на пустом массиве (длина массива соответствует нулю), то в этом случае будет возвращена пустая строка. Любой элемент массива, который имеет значение undefined, или null, будет преобразован в пустую строку.


Поддержка браузерами

МетодChrome
Chrome
Firefox
Firefox
Opera
Opera
Safari
Safari
Internet Explorer
IExplorer
Microsoft Edge
Edge
join()ДаДаДаДаДаДа

JavaScript синтаксис:

// в качестве разделителя будет использована запятая
array.join()

// в качестве разделителя будет использовано пользовательское значения
array.join( separator )

Версия JavaScript

ECMAScript 1 (реализовано в JavaScript 1.1)

Значения параметров

ПараметрОписание
separatorЭтот параметр является опциональным и позволяет указать разделитель, который будет использован при объединении элементов в строковом значении. Если в качестве параметра метода передать пустую строку, то элементы массива будут объединены в одну строку без использования разделителя.

Пример использования

var x = [1, 2, 3, "a", "b", "c"]; // инициализируем переменную, содержащую массив
var y = [undefined, null, 1, 2, 3, null]; // инициализируем переменную, содержащую массив
var a, b, c, d, e; // инициализируем пустые переменные

a = x.join(); // значение переменной "1,2,3,a,b,c"
b = x.join(""); // значение переменной "123abc"
c = x.join(" "); // значение переменной "1 2 3 a b c"
d = x.join(" and "); // значение переменной "1 and 2 and 3 and a and b and c"

e = y.join(); // значение переменной ",,1,2,3," (null и undefined преобразованы в пустую строку)
JavaScript Array