JavaScript метод join()

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

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

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

Спецификация: ecma262

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьjavascript.builtins.Array.join
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
join✓1✓12✓1✓4✓1✓18✓4✓10.1✓1✓1.0✓1✓1

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

JavaScript синтаксис

JavaScript
array.join();
array.join(separator);

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

ECMAScript: Array.prototype.join.

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

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

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

Строка; для пустого массива — пустая строка. Массив не изменяется.

Особенности

Пропущенный separator или undefined означает запятую. Пустые позиции, null и undefined дают пустые части строки; разделители между ними сохраняются.

Примеры, попробуйте сами

Как разделитель влияет на строку массива

Измените разделитель и элементы. Сравните строки с обычными значениями, null и undefined.

index.html
HTML
<p>Результат выполнения выводится в консоль.</p>
main.js
JavaScript
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 преобразованы в пустую строку)
console.log(a, b, c, d, e)

// Вложенные массивы преобразуются своим toString(), поэтому внутри остаются запятые.
console.log([1, [2, [3, 4]]].join('; ')) // "1; 2,3,4"