CKTIS / JavaScript
String — izričita pretvorba u tekst
String(value) pretvara vrijednost u primitivni niz. Poziv bez argumenta vraća prazan niz. Ako je pretvorba uspješna, new String(value) stvara omotni objekt, a ne primitivnu vrijednost.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
String(value)
String()
new String(value)String je ugrađena funkcija ECMAScripta, a ne API preglednika. Poziv String(value) vraća primitivni niz ako je pretvorba uspješna. Tip String predstavlja nepromjenjive nizove 16-bitnih kodnih jedinica, koje se obično tumače kao UTF-16; jedno vidljivo slovo ili drugi znak ne mora odgovarati jednoj kodnoj jedinici.
Izostavljanje argumenta razlikuje se od prosljeđivanja vrijednosti undefined: String() vraća "", a String(undefined) vraća "undefined". Slično tome, String(null) daje "null", a String(42) daje "42". Izravni argument Symbol obrađuje se posebno: String(Symbol("tag")) vraća "Symbol(tag)".
Ta posebna obrada vrijedi samo pri pozivu bez new: new String(Symbol("tag")) izaziva iznimku TypeError umjesto da stvori omotni objekt. Ako je pretvorba uspješna, new String(value) stvara omotni objekt. Zato typeof String("hello") daje "string", dok typeof new String("hello") daje "object". Stroga usporedba tih vrijednosti operatorom === daje false. Za uobičajenu pretvorbu u tekst upotrijebi String(value) bez new.
Pretvorba objekta može pozvati njegove vlastite mehanizme pretvorbe, kao što su [Symbol.toPrimitive] ili toString, i može izazvati iznimku. String(value) nije ni JSON serijalizacija ni način sigurnog prikaza proizvoljnih nepouzdanih objekata bez izvršavanja njihova koda.
Primjeri
console.log(JSON.stringify([String(), String(undefined), String(null), String(42)]));
console.log(String(Symbol("tag")));
const text = String("hello");
const wrapped = new String("hello");
console.log(typeof text, typeof wrapped);
console.log(text === wrapped);Rezultat
["","undefined","null","42"] Symbol(tag) string object false
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.