String.prototype.toString()

Метод toString() (до рядка) значень String повертає рядкове значення, з якого викликаний.

Спробуйте його в дії

Синтаксис

toString()

Параметри

Жодних.

Повернене значення

Рядок, що представляє задане рядкове значення.

Опис

Об'єкт String заміщує метод toString() об'єкта Object, а не успадковує Object.prototype.toString(). Для значень String метод toString повертає сам рядок (якщо він є примітивом) або рядок, котрий обгортає об'єкт String. Він має таку ж реалізацію, як String.prototype.valueOf().

Метод toString()вимагає, щоб його значення this було примітивом або об'єктом-обгорткою String. Він викидає TypeError у випадку інших значень this, не намагаючись звести їх до рядкових значень.

У зв'язку з тим, що String не має методу [Symbol.toPrimitive](), JavaScript викликає метод toString() автоматично, коли об'єкт String вживається в контексті, що очікує на рядок, наприклад, у шаблонному літералі. Проте примітивні значення String не радяться з методом toString() для свого зведення до рядків: оскільки вони вже є рядками, перетворення не виконується.

String.prototype.toString = () => "Відкинуто";
console.log(`${"агов"}`); // "агов"
console.log(`${new String("агов")}`); // "Відкинуто"

Приклади

Застосування методу toString()

Наступний приклад виводить рядкове значення об'єкта String:

const x = new String("Привіт, світе");

console.log(x.toString()); // "Привіт, світе"

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

Сумісність із браузерами

Дивіться також

• String.prototype.valueOf()