CKTIS / JavaScript
String — изрично преобразуване в текст
String(value) преобразува стойност в примитивен низ. Извикана без аргумент, функцията връща празен низ. При успешно преобразуване new String(value) създава обект-обвивка, а не примитивна стойност.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
String(value)
String()
new String(value)String е вградена функция на ECMAScript, а не API на браузъра. Извикването String(value) връща примитивен низ, ако преобразуването е успешно. Типът String представя неизменяеми последователности от 16-битови кодови единици, които обикновено се интерпретират като UTF-16; една видима буква или друг знак не съответства непременно на една кодова единица.
Пропускането на аргумента се различава от подаването на undefined: String() връща "", а String(undefined) връща "undefined". По същия начин String(null) дава "null", а String(42) дава "42". Подаден директно, аргументът Symbol се обработва по специален начин: String(Symbol("tag")) връща "Symbol(tag)".
Тази специална обработка се прилага само при извикване без new: new String(Symbol("tag")) хвърля изключение TypeError, вместо да създаде обект-обвивка. При успешно преобразуване new String(value) създава обект-обвивка. Затова typeof String("hello") дава "string", докато typeof new String("hello") дава "object". Строгото сравнение на тези стойности с === дава false. За обичайно преобразуване в текст използвай String(value) без new.
Преобразуването на обект може да извика собствените му механизми за преобразуване, като [Symbol.toPrimitive] или toString, и може да доведе до изключение. String(value) не е JSON сериализация и не е начин за безопасно показване на произволни ненадеждни обекти, без да се изпълни кодът им.
Примери
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);Резултат
["","undefined","null","42"] Symbol(tag) string object false
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.