Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

String.prototype.concat — łączenie napisów

String.prototype.concat dołącza dowolną liczbę argumentów do napisu, konwertując je na tekst. Zwraca prymitywną wartość string i nie zmienia napisu źródłowego.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

str.concat(...args)

String.prototype.concat łączy napis odbiorcy z zerem lub większą liczbą argumentów, w podanej kolejności. Nie dodaje separatorów: spacje i znaki interpunkcyjne trzeba przekazać jawnie. Wynik jest prymitywną wartością string, a nie obiektem String.

Napisy są niemutowalne: metoda nie zmienia wartości źródłowej. Aby zachować wynik, przypisz go do zmiennej. Wywołanie bez argumentów zwraca tekst odbiorcy bez zmian.

Odbiorca jest konwertowany na tekst jako pierwszy, a następnie argumenty od lewej do prawej, operacją ToString. Argumenty null i undefined dają odpowiednio "null" i "undefined"; argument typu symbol powoduje TypeError. Konwersja obiektów może uruchomić własny kod i zgłosić wyjątek.

Metoda jest generyczna: String.prototype.concat.call(42, "!") zwraca "42!". Jednak null i undefined jako odbiorca powodują TypeError. To metoda standardu ECMAScript, a nie API przeglądarki.

Przykłady

const base = "Level";
const result = base.concat(" ", 3, "!");
console.log(result);
console.log(base);
console.log(base.concat() === base);

Wynik

Level 3!
Level
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła