Error.prototype.toString()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.

O método toString() retorna uma string representando o objeto Error.

Sintaxe

e.toString()

Valor de retorno

A string representando o objeto Error especificado.

Descrição

O objeto Error sobrescreve o método Object.prototype.toString() herdado por todos os objetos. Sua semântica é a seguinte (assumindo que Object e String tem seus valores originais):

js
Error.prototype.toString = function () {
  "use strict";

  var obj = Object(this);
  if (obj !== this) {
    throw new TypeError();
  }

  var name = this.name;
  name = name === undefined ? "Error" : String(name);

  var msg = this.message;
  msg = msg === undefined ? "" : String(msg);

  if (name === "") {
    return msg;
  }
  if (msg === "") {
    return name;
  }

  return name + ": " + msg;
};

Exemplos

Usando toString()

js
var e = new Error("fatal error");
console.log(e.toString()); // 'Error: fatal error'

e.name = undefined;
console.log(e.toString()); // 'Error: fatal error'

e.name = "";
console.log(e.toString()); // 'fatal error'

e.message = undefined;
console.log(e.toString()); // ''

e.name = "hello";
console.log(e.toString()); // 'hello'

Especificações

Specification

ECMAScript® 2027 Language Specification
# sec-error.prototype.tostring

Compatibilidade com navegadores

Enable JavaScript to view this browser compatibility table.

Veja também

Error.prototype.toSource()

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 8 de nov. de 2023 by MDN contributors.

View this page on GitHub • Report a problem with this content

Objetos Globais
Error
Construtor
1. Error()
Métodos estáticos
1. captureStackTrace()
2. isError()
Propriedades estáticas
1. stackTraceLimit
Métodos de instância
1. Error.prototype.toString()
Propriedades de instância
1. Error.prototype.cause
2. columnNumber
3. fileName
4. lineNumber
5. Error.prototype.message
6. Error.prototype.name
7. stack
Herança
Object/Function
Métodos estáticos
1. Function.prototype.apply()
2. Function.prototype.bind()
3. Function.prototype.call()
4. Function.prototype.toString()
5. [Symbol.hasInstance]()
Propriedades estáticas
1. Function.displayName
2. Function.length
3. Function.name
4. prototype
5. Function.arguments
6. Function.caller
Métodos de instância
1. Object.prototype.__defineGetter__()
2. Object.prototype.__defineSetter__()
3. Object.prototype.__lookupGetter__()
4. Object.prototype.__lookupSetter__()
5. Object.prototype.hasOwnProperty()
6. Object.prototype.isPrototypeOf()
7. Object.prototype.propertyIsEnumerable()
8. Object.prototype.toLocaleString()
9. Object.prototype.toString()
10. Object.prototype.valueOf()
Propriedades de instância
1. Object.prototype.__proto__
2. Object.prototype.constructor
Páginas relacionadas
AggregateError
EvalError
InternalError
RangeError
ReferenceError
SyntaxError
TypeError
URIError

Error.prototype.toString()

In this article

Help improve MDN