База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници