CKTIS / JavaScript
String.prototype.concat — spojování řetězců
String.prototype.concat připojí k řetězci libovolný počet argumentů a převede je na text. Vrací primitivní hodnotu typu string a původní řetězec nemění.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
str.concat(...args)String.prototype.concat připojí k řetězci příjemce argumenty v zadaném pořadí. Metodu lze zavolat i bez argumentů. Nevkládá žádné oddělovače: mezery a interpunkční znaménka je třeba zadat výslovně. Výsledkem je primitivní hodnota typu string, nikoli objekt String.
Řetězce jsou neměnné: metoda původní hodnotu nezmění. Chcete-li si výsledek ponechat, přiřaďte ho do proměnné. Volání bez argumentů vrátí text příjemce beze změny.
Nejprve se na text převede příjemce a poté argumenty zleva doprava pomocí ToString. Argumenty null a undefined vytvoří hodnoty "null", respektive "undefined"; argument typu symbol vyvolá TypeError. Při převodu objektů se může spustit vlastní kód a vyvolat výjimku.
Metoda je generická: String.prototype.concat.call(42, "!") vrátí "42!". Pokud je však příjemcem null nebo undefined, dojde k chybě TypeError. Jde o metodu standardu ECMAScript, nikoli o API prohlížeče.
Příklady
const base = "Level";
const result = base.concat(" ", 3, "!");
console.log(result);
console.log(base);
console.log(base.concat() === base);Výsledek
Level 3! Level true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.