Error.prototype.toString()

Die toString() Methode gibt einen String zurück, der das Error Objekt repräsentiert.
 

Syntax

e.toString()

Rückgabewert

Einen String, der das gegebenen Error Objekt repräsentiert.

Beschreibung

Das Error Objekt überschreibt die Object.prototype.toString() (en-US) Methode, die an allen Objekte vererbt werden. Die Semanik ist die folgende (angenommen Object und String wurden nicht verändert):

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;
};

Beispiele

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()); // 'Error'

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

Spezifikationen

Spezifikation Status Kommentar
ECMAScript 1st Edition (ECMA-262) Standard Initiale Definition. Implementiert in JavaScript 1.1.
ECMAScript 5.1 (ECMA-262)
Die Definition von 'Error.prototype.toString' in dieser Spezifikation.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
Die Definition von 'Error.prototype.toString' in dieser Spezifikation.
Standard  
ECMAScript (ECMA-262)
Die Definition von 'Error.prototype.toString' in dieser Spezifikation.
Lebender Standard  

Browserkompatibilität

BCD tables only load in the browser

Siehe auch