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.