String.prototype.toString()

Метод toString() значений String возвращает это строковое значение.

Попробуйте

const stringObj = new String("foo");

console.log(stringObj);
// Expected output: String { "foo" }

console.log(stringObj.toString());
// Expected output: "foo"

Синтаксис

toString()

Параметры

Нет.

Возвращаемое значение

Строка, представляющая указанное строковое значение.

Описание

Объект String переопределяет метод toString объекта Object; он не наследует Object.prototype.toString(). Для значений String метод toString возвращает саму строку (если это примитив) или строку, которую оборачивает объект String. Он имеет точно такую же реализацию, как String.prototype.valueOf().

Метод toString() требует, чтобы его значение this было примитивом String или объектом-обёрткой. Он генерирует TypeError для других значений this, не пытаясь принудительно преобразовать их в строковые значения.

Поскольку String не имеет метода [Symbol.toPrimitive](), JavaScript автоматически вызывает метод toString(), когда объект String используется в контексте, ожидающем строку, например, в шаблонном литерале. Однако строковые примитивные значения не обращаются к методу toString() для принудительного преобразования в строки — поскольку они уже являются строками, преобразование не выполняется.

String.prototype.toString = () => "Overridden";
console.log(`${"foo"}`); // "foo"
console.log(`${new String("foo")}`); // "Overridden"

Примеры

Использование toString()

Следующий пример показывает строковое значение объекта String:

const x = new String("Hello world");

console.log(x.toString()); // "Hello world"

Спецификации

Совместимость с браузерами

Смотрите также

• String.prototype.valueOf()