عرض مصدر JavaScript/Error/toString

<noinclude>{{DISPLAYTITLE:<code>Error.prototype.toString()‎</code>}}</noinclude>
الدالة <code>Error.prototype.toString()‎</code> تُعيد سلسلةً نصيةً تُمثِّل كائن <code>[[JavaScript/Error|Error]]</code> المُحدَّد.

== البنية العامة ==
<syntaxhighlight lang="javascript">
e.toString()

</syntaxhighlight>

=== القيمة المعادة ===
سلسلة نصيّة تُمثِّل كائن <code>[[JavaScript/Error|Error]]</code> المعطي.

== الوصف ==
يُعيد الكائن <code>[[JavaScript/Error|Error]]</code> تعريف الدالة <code>[[JavaScript/Object/toString|toString]]</code> الموروثة من الكائن <code>[[JavaScript/Object|Object]]</code>؛ وتستخدم هذه الدالة قيمة الخاصيتين <code>[[JavaScript/Error/name|name]]</code> و <code>[[JavaScript/Error/message|message]]</code> لتركيب السلسلة النصية. 
تكون بنية هذه الدالة البرمجية كما يلي: <syntaxhighlight lang="javascript">
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;
};

</syntaxhighlight> 
== أمثلة ==
أمثلة عن ناتج تنفيذ الدالة <code>toString</code> على كائن <code>[[JavaScript/Error|Error]]</code> مع مختلف قيم الخاصيتين <code>[[JavaScript/Error/name|name]]</code> و <code>[[JavaScript/Error/message|message]]</code>:<syntaxhighlight lang="javascript">
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'

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|6
|نعم
|نعم
|}
== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-error.prototype.tostring ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-error.prototype.tostring ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.11.4.4 ECMAScript 5.1].
* معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%201st%20edition,%20June%201997.pdf ECMAScript 1st Edition] . 
[[تصنيف:JavaScript]]
[[تصنيف:JavaScript Global Objects]]
[[تصنيف:JavaScript Error]]