CKTIS / JavaScript
String.prototype.toString() — получаване на стойност от тип низ
String.prototype.toString() връща примитивната стойност от тип низ на низ или обект String. Това не е общ преобразувател: несъвместима стойност на this води до TypeError.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
stringValue.toString()
String.prototype.toString.call(value)Каталожният символ String.toString тук обозначава String.prototype.toString(), извикан върху стойност от тип низ. Не го бъркайте с израза String.toString(), който извиква метод върху самата функция String.
Методът не приема параметри. За примитивен низ връща същата стойност; за обект, създаден с new String(...), извлича текста от вътрешния слот [[StringData]]. Резултатът е примитивна стойност от тип string, а не обект. Вграденият метод String.prototype.valueOf() връща същата стойност.
Методът не е генеричен: String.prototype.toString.call(42) хвърля TypeError, както и извикванията с null, undefined или обикновен обект без [[StringData]]. Самото наличие на собствен метод toString не е достатъчно. Примерът показва валидни получатели и умишлено улавя грешката при число.
Примери
const text = "hello";
const wrapped = new String(text);
const result = wrapped.toString();
console.log(text.toString() === text);
console.log(result, typeof result);
console.log(result === wrapped.valueOf());
try {
String.prototype.toString.call(42);
} catch (error) {
console.log(error instanceof TypeError);
}Резултат
true hello string true true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.