Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri