عرض مصدر JavaScript/Symbol/toStringTag

<noinclude>{{DISPLAYTITLE:<code>Symbol.toStringTag</code>}}</noinclude>
الرمز المعروف <code>Symbol.toStringTag</code> يُشير إلى خاصيةٍ تحمل سلسلةً نصيةً التي تُستخدَم في إنشاء الوصف النصي الافتراضي للكائن، وتستخدمها الدالة <code>[[JavaScript/Object/toString|Object.prototype.toString()‎]]</code> داخليًا.
{| class="wikitable"
! colspan="2" |سمات الخاصية Symbol.toStringTag
|-
|قابلة للكتابة
|لا
|-
|قابلة للإحصاء
|لا
|-
|قابلة للضبط
|لا
|}

== الوصف ==
العديد من أنواع البيانات في لغة JavaScript لها وسوم نصية (tags):<syntaxhighlight lang="javascript">
Object.prototype.toString.call('foo');     // "[object String]"
Object.prototype.toString.call([1, 2]);    // "[object Array]"
Object.prototype.toString.call(3);         // "[object Number]"
Object.prototype.toString.call(true);      // "[object Boolean]"
Object.prototype.toString.call(undefined); // "[object Undefined]"
Object.prototype.toString.call(null);      // "[object Null]"
// ...
</syntaxhighlight>وهنالك دوال أخرى عُرِّفَ فيها الرمز <code>Symbol.toStringTag</code>:<syntaxhighlight lang="javascript">
Object.prototype.toString.call(new Map());         // "[object Map]"
Object.prototype.toString.call(function* () {});   // "[object GeneratorFunction]"
Object.prototype.toString.call(Promise.resolve()); // "[object Promise]"
// ...

</syntaxhighlight>وعند إنشاء صنف كائنات جديد، فإنَّ الوسم النصي الافتراضي الذي تعطيه JavaScript له هو <code>"Object"</code>:<syntaxhighlight lang="javascript">
class ValidatorClass {}

Object.prototype.toString.call(new ValidatorClass()); // "[object Object]"

</syntaxhighlight>لكن بمساعدة الرمز <code>Symbol.toStringTag</code>، فسنتمكن من ضبط الوسم النصي كما نشاء:<syntaxhighlight lang="javascript">
class ValidatorClass {
  get [Symbol.toStringTag]() {
    return 'Validator';
  }
}

Object.prototype.toString.call(new ValidatorClass()); // "[object Validator]"

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|49
|51
|غير مدعومة
|نعم
|نعم
|}
على النقيض من متصفح IE، يدعم متصفح Edge هذه الميزة.

== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-symbol.tostringtag ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-symbol.tostringtag ECMAScript 2015 (6th Edition)]‎. 
[[تصنيف:JavaScript]]
[[تصنيف:JavaScript Global Objects]]
[[تصنيف:JavaScript Symbol]]