.toString()

Метод toString() возвращает строковое представление объекта. Метод автоматически вызывается, когда объект нужно представить в текстовом виде. При необходимости поведение метода можно изменить.

        
          
          const book = {  title: 'JavaScript: the good parts',  author: 'Douglas Crockford'}console.log(`Сейчас читаю ${book}`)// Сейчас читаю [object Object]
          const book = {
  title: 'JavaScript: the good parts',
  author: 'Douglas Crockford'
}

console.log(`Сейчас читаю ${book}`)
// Сейчас читаю [object Object]

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

Object.prototype.toString() не имеет аргументов.

Object.prototype.toString() возвращает строковое представление объекта.

Обычно метод toString() не используется для объектов явно, а вызывается JavaScript автоматически, если объект находится в контексте, где он должен быть представлен в виде строки.

Объекты, в отличие от примитивных типов, сложно преобразовывать в строку. Объект может содержать произвольное количество полей и без программиста непонятно, какие из них важные. Поэтому стандартная реализация метода toString() представляет собой заглушку и возвращает малоинформативную строку, например, '[object Object]'.

Метод toString() является одним из нескольких базовых методов, наследуемых всеми объектами созданными из Object. Встроенные объекты (например: Number, Array, Error, Function и другие) переопределяют реализацию метода toString() для отображения объекта в подходящем виде.

Например, Number преобразует число в строку в указанной системе счисления, Array выводит список элементов через запятую, а Error отображает имя и сообщение об ошибке.

Следует отметить, что при использовании Console API метод toString() для объектов не используется:

        
          
          const person = {name: 'Brendan Eich', year: 1961}// Объект как аргумент console.logconsole.log('person: ', person)// person: { name: 'Brendan Eich', year: 1961 }// Строка как аргумент console.logconsole.log('person: ' + person)// person: [object Object]
          const person = {name: 'Brendan Eich', year: 1961}

// Объект как аргумент console.log
console.log('person: ', person)
// person: { name: 'Brendan Eich', year: 1961 }

// Строка как аргумент console.log
console.log('person: ' + person)
// person: [object Object]

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

Для обычных объектов (имеющих набор полей {ключ: значение}) метод toString() возвращает строку '[object Object]'.

        
          
          const book = {  title: 'Замок',  author: 'Ф. Кафка'}book[Symbol.toPrimitive] = function(hint) {  if (hint === 'string') {    return `(название: ${this.title}, автор: ${this.author})`  }  return true;}console.log(`Книга ${book}`)// Книга (название: Замок, автор: Ф. Кафка)
          const book = {
  title: 'Замок',
  author: 'Ф. Кафка'
}

book[Symbol.toPrimitive] = function(hint) {
  if (hint === 'string') {
    return `(название: ${this.title}, автор: ${this.author})`
  }
  return true;
}

console.log(`Книга ${book}`)
// Книга (название: Замок, автор: Ф. Кафка)

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

        
          
          const book = {  title: 'Дар',  author: 'В. В. Набоков'}book[Symbol.toStringTag] = 'Book'console.log(`Сейчас читаю ${book}`)// Сейчас читаю [object Book]
          const book = {
  title: 'Дар',
  author: 'В. В. Набоков'
}

book[Symbol.toStringTag] = 'Book'

console.log(`Сейчас читаю ${book}`)
// Сейчас читаю [object Book]

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

        
          
          const toString = Object.prototype.toStringconsole.log(toString.call([1, 2, 3]))// [object Array]console.log(toString.call(25))// [object Number]console.log(toString.call(true))// [object Boolean]
          const toString = Object.prototype.toString

console.log(toString.call([1, 2, 3]))
// [object Array]

console.log(toString.call(25))
// [object Number]

console.log(toString.call(true))
// [object Boolean]

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

Существует несколько способов изменить поведение метода toString().

Переопределение метода на уровне объекта. Можно использовать перечисленные выше способы с использованием специальных полей Symbol.toPrimitive, Symbol.toStringTag.

Переопределение метода для всех экземпляров класса. Допустим, классу требуется переопределить поведение метода toString(). Для этого нужно добавить собственную реализацию метода. Тогда все объекты этого класса будут использовать переопределённую реализацию:

        
          
          class Book {  title = ''  author = ''  constructor(title, author) {    this.title = title    this.author = author  }  toString() {    return `«${this.title}», автор ${this.author}`  }}const book = new Book('Палата №6', 'А. П. Чехов')console.log(`Читаю ${book}`)// Читаю «Палата №6», автор А. П. Чехов
          class Book {
  title = ''
  author = ''

  constructor(title, author) {
    this.title = title
    this.author = author
  }

  toString() {
    return `«${this.title}», автор ${this.author}`
  }
}

const book = new Book('Палата №6', 'А. П. Чехов')
console.log(`Читаю ${book}`)
// Читаю «Палата №6», автор А. П. Чехов

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

Переопределение метода на уровне прототипа функции. Для создания объектов с необходимым набором свойств может использоваться функция. В этом случае переопределить метод toString() можно для прототипа:

        
          
          function Book(title, author) {  this.title = title  this.author = author}Book.prototype.toString = function() {  return `«${this.title}», автор ${this.author}`}const book = new Book('Палата №6', 'А. П. Чехов')console.log(`Читаю ${book}`)// Читаю «Палата №6», автор А. П. Чехов
          function Book(title, author) {
  this.title = title
  this.author = author
}

Book.prototype.toString = function() {
  return `«${this.title}», автор ${this.author}`
}

const book = new Book('Палата №6', 'А. П. Чехов')
console.log(`Читаю ${book}`)
// Читаю «Палата №6», автор А. П. Чехов

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать