Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.join: łączenie elementów w napis

join konwertuje elementy na tekst i łączy je separatorem, traktując dziury, null i undefined jak puste fragmenty.

Wersja: ECMAScript 2026 draft; example target: Node.js 24.22.2

Składnia

array.join([separator])

array.join([separator]) zwraca jeden napis. Domyślny separator to przecinek; podany separator jest konwertowany do tekstu. Każdy element jest odczytywany i konwertowany, lecz null, undefined oraz dziura wnoszą pusty fragment. Zagnieżdżona tablica używa własnego toString, więc wewnątrz zwykle pojawia się przecinek.

Metoda nie mutuje odbiorcy i jest generyczna dla array-like. Pusta tablica daje pusty napis, a jeden element nie dodaje separatora. Błąd gettera albo konwersji elementu/separatora jest przekazywany; symbol wymagający abstrakcyjnej konwersji może spowodować TypeError. Przykład pokazuje puste fragmenty oraz niezależny separator zewnętrzny przy tablicach zagnieżdżonych.

Przykłady

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

Wynik

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

Źródła