CKTIS / JavaScript
String — izrecna pretvorba v besedilo
String(value) pretvori vrednost v primitivni niz. Klic brez argumenta vrne prazen niz. Če je pretvorba uspešna, new String(value) ustvari ovojni objekt, ne pa primitivne vrednosti.
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
String(value)
String()
new String(value)String je vgrajena funkcija ECMAScripta, ne API brskalnika. Klic String(value) vrne primitivni niz, če je pretvorba uspešna. Tip String predstavlja nespremenljiva zaporedja 16-bitnih kodnih enot, ki se običajno razlagajo kot UTF-16; ena vidna črka ali drug znak ne ustreza nujno eni kodni enoti.
Izpuščeni argument se razlikuje od podane vrednosti undefined: String() vrne "", String(undefined) pa "undefined". Podobno String(null) ustvari "null", String(42) pa "42". Neposredni argument Symbol je obravnavan posebej: String(Symbol("tag")) vrne "Symbol(tag)".
Ta posebna obravnava velja le pri klicu brez new: new String(Symbol("tag")) sproži izjemo TypeError, namesto da bi ustvaril ovojni objekt. Če je pretvorba uspešna, new String(value) ustvari ovojni objekt. Zato typeof String("hello") vrne "string", medtem ko typeof new String("hello") vrne "object". Stroga primerjava teh vrednosti z === vrne false. Za običajno pretvorbo v besedilo uporabi String(value) brez new.
Pretvorba objekta lahko sproži njegove lastne mehanizme za pretvorbo, kot sta [Symbol.toPrimitive] ali toString, in lahko povzroči izjemo. String(value) ni serializacija JSON in tudi ne omogoča varnega prikaza poljubnih nezaupanja vrednih objektov, ne da bi se izvedla njihova koda.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.