.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», автор А. П. Чехов

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