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

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

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

Източници