Error.prototype.toString()‎

الدالة Error.prototype.toString()‎ تُعيد سلسلةً نصيةً تُمثِّل كائن Error المُحدَّد.

البنية العامة

e.toString()

القيمة المعادة

سلسلة نصيّة تُمثِّل كائن Error المعطي.

الوصف

يُعيد الكائن Error تعريف الدالة toString الموروثة من الكائن Object؛ وتستخدم هذه الدالة قيمة الخاصيتين name و message لتركيب السلسلة النصية.

تكون بنية هذه الدالة البرمجية كما يلي:

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

أمثلة

أمثلة عن ناتج تنفيذ الدالة toString على كائن Error مع مختلف قيم الخاصيتين name و message:

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'

دعم المتصفحات

الميزة	Chrome	Firefox	Internet Explorer	Opera	Safari
الدعم الأساسي	نعم	نعم	6	نعم	نعم

مصادر ومواصفات

• مسودة المعيار ECMAScript Latest Draft.
• معيار ECMAScript 2015 (6th Edition)‎.
• معيار ECMAScript 5.1.
• معيار ECMAScript 1st Edition .