CKTIS / JavaScript
String — jawna konwersja wartości na tekst
String(value) konwertuje wartość na prymitywny ciąg znaków. Wywołanie bez argumentu zwraca pusty tekst. Jeśli konwersja się powiedzie, new String(value) tworzy obiekt opakowujący, a nie wartość prymitywną.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
String(value)
String()
new String(value)String to wbudowana funkcja ECMAScript, a nie API przeglądarki. Wywołanie String(value) zwraca prymitywną wartość tekstową, o ile konwersja zakończy się powodzeniem. Typ String reprezentuje niezmienne sekwencje 16-bitowych jednostek kodowych, interpretowanych zwykle jako UTF-16; jedna widoczna litera lub inny znak nie musi odpowiadać jednej jednostce.
Brak argumentu różni się od przekazania undefined: String() zwraca "", ale String(undefined) zwraca "undefined". Podobnie String(null) daje "null", a String(42) daje "42". Bezpośredni argument typu Symbol ma specjalną obsługę: String(Symbol("tag")) zwraca "Symbol(tag)".
Ta specjalna obsługa dotyczy tylko wywołania bez new: new String(Symbol("tag")) zgłasza wyjątek TypeError zamiast tworzyć obiekt opakowujący. Jeśli konwersja się powiedzie, new String(value) tworzy obiekt opakowujący. Dlatego typeof String("hello") daje "string", natomiast typeof new String("hello") daje "object". Ścisłe porównanie tych wartości operatorem === daje false. Do zwykłej konwersji tekstowej używaj String(value) bez new.
Konwersja obiektu może uruchomić jego własne mechanizmy konwersji, takie jak [Symbol.toPrimitive] lub toString, i może zgłosić wyjątek. String(value) nie jest serializacją JSON ani sposobem na bezpieczne wyświetlanie dowolnych, niezaufanych obiektów bez wykonywania ich kodu.
Przykłady
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);Wynik
["","undefined","null","42"] Symbol(tag) string object false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.