База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Array.prototype.join: свързване на елементи в низ

join преобразува елементите в текст и ги свързва; дупки, null и undefined стават празни части.

Версия: ECMAScript 2026 draft; example target: Node.js 24.22.2

Синтаксис

array.join([separator])

array.join([separator]) връща един низ. Разделителят по подразбиране е запетая; подаденият се преобразува в текст. Всеки елемент се чете и преобразува, но null, undefined и дупка дават празна част. Вложен масив използва своя toString, затова вътре обикновено има запетая.

Методът не променя получателя и е общ за array-like обекти. Празен масив дава празен низ, а един елемент не добавя разделител. Грешки от getter или преобразуване се разпространяват; Symbol може да хвърли TypeError. Примерът показва празни части и независим външен разделител.

Примери

console.log([1, null, , 3].join("|"));
console.log([[1, 2], [3]].join(";"));
console.log(JSON.stringify([].join("-")));

Резултат

1|||3
1,2;3
""

Източници