CKTIS / JavaScript
String.prototype.concat — združevanje nizov
String.prototype.concat nizu doda poljubno število argumentov in jih pretvori v besedilo. Vrne primitivno vrednost vrste string in ne spremeni izvirnega niza.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
str.concat(...args)String.prototype.concat združi niz prejemnika z nič ali več argumenti v podanem vrstnem redu. Ne vstavi nobenih ločil: presledke in ločila je treba podati izrecno. Rezultat je primitivna vrednost vrste string, ne objekt String.
Nizi so nespremenljivi: metoda ne spremeni izvirne vrednosti. Če želite rezultat ohraniti, ga priredite spremenljivki. Klic brez argumentov vrne besedilo prejemnika nespremenjeno.
Najprej se v besedilo pretvori prejemnik, nato pa argumenti od leve proti desni z uporabo ToString. Argumenta null in undefined ustvarita vrednosti "null" oziroma "undefined"; argument vrste symbol sproži TypeError. Pretvorba objektov lahko izvede uporabniško kodo in sproži izjemo.
Metoda je generična: String.prototype.concat.call(42, "!") vrne "42!". Če pa sta prejemnik null ali undefined, pride do napake TypeError. To je metoda standarda ECMAScript, ne API brskalnika.
Primeri
const base = "Level";
const result = base.concat(" ", 3, "!");
console.log(result);
console.log(base);
console.log(base.concat() === base);Rezultat
Level 3! Level true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.