عرض مصدر TypeScript/symbols

<noinclude>{{DISPLAYTITLE:الرموز في TypeScript}}</noinclude>
==مقدمة==
أضافت النسخة ECMAScript 2015 من لغة JavaScript نوع بيانات أوليّ (primitive data type) جديد يُسمّى ‎<code>symbol</code>‎، وهو نوعٌ أوليّ مثل النوع ‎<code>number</code>‎ والنوع ‎<code>string</code>‎. انظر توثيق ‎<code>Symbol</code>‎ لتفصيل دقيق عن هذه الرموز.

تنشأ القيم من النوع ‎<code>symbol</code>‎ عبر استدعاء الدالة البانية ‎<code>‎Symbol()‎</code>‎:
<syntaxhighlight lang="typescript">
let sym1 = Symbol();

let sym2 = Symbol("key"); // مفتاح نصيّ اختياريّ
</syntaxhighlight>
الرموز فريدة (unique) وغير قابلة للتعديل (immutable):
<syntaxhighlight lang="typescript">
let sym2 = Symbol("key");
let sym3 = Symbol("key");

sym2 === sym3; // false, الرموز فريدة ولو أُنشِأت بنفس المفتاح
</syntaxhighlight>
يُمكن استخدام الرموز كمفاتيح لخاصيات الكائنات كما السلاسل النصيّة:
<syntaxhighlight lang="typescript">
let sym = Symbol();

let obj = {
    [sym]: "value"
};

console.log(obj[sym]); // "value"
</syntaxhighlight>
يُمكن كذلك مزج الرموز مع تصريحات الخاصيات المحسوبة (computed property declarations) للتصريح عن خاصيات الكائنات وعناصر الأصناف:
<syntaxhighlight lang="typescript">
const getClassNameSymbol = Symbol();

class C {
    [getClassNameSymbol](){
       return "C";
    }
}

let c = new C();
let className = c[getClassNameSymbol](); // "C"
</syntaxhighlight>
==الرموز المعروفة (Well-known Symbols)==
إضافة إلى الرموز التي يُعرِّفها المبرمج، هناك كذلك رموز خاصّة مسبقة التعريف تُسمّى بالرموز المعروفة. تُستخدَم هذه الرموز المضمّنة لتمثيل آلية عمل بعض أجزاء اللغة داخليًّا.

هذه قائمة رموز معروفة (انظر توثيق الرموز للاستزادة):

==== <code>Symbol.hasInstance</code> ====
دالة تُحدِّد ما إذا كانت الدالة البانية تتعرّف على أحد الكائنات على أنَّه كائنٌ مُنشَأٌ منها. وتُستخدَم من المعامل <code>[[JavaScript/instanceof|instanceof]]</code>؛ ويمكن تخصيص سلوك المعامل <code>[[JavaScript/instanceof|instanceof]]</code> باستخدام هذا الرمز.
==== <code>[[JavaScript/Symbol/isConcatSpreadable|Symbol.isConcatSpreadable]]</code> ====
قيمة منطقية تُحدِّد ما إذا كان يجب «تسطيح» (flatten) الكائن إلى عناصر مصفوفة. ويستخدم هذا الرمز من الدالة <code>[[JavaScript/Array/concat|Array.prototype.concat()‎]]</code>.

==== <code>[[JavaScript/Symbol/iterator|Symbol.iterator]]</code> ====
دالة تُعيد المكرّر (iterator) الافتراضي لكائن معيّن، الذي يُستخدَم من حلقة <code>[[JavaScript/for...of|for...of]]</code>.

==== <code>[[JavaScript/Symbol/match|Symbol.match]]</code> ====
دالة تُطابَق مع سلسلة نصية، وتُستخدَم أيضًا لتحديد إذا كان بالإمكان استخدام الكائن كتعبير نمطي. وتُستخدَم من الدالة <code>[[JavaScript/String/match|String.prototype.match()‎]]</code>.

==== <code>Symbol.replace</code> ====
هذا الرمز المعروف يُحدِّد الدالة التي ستستبدل جزءًا من سلسلة نصية؛ وهذه الدالة ستُستدعى من الدالة <code>[[JavaScript/String/replace|String.prototype.replace()‎]]</code>.

==== <code>Symbol.search</code> ====
هذا الرمز المعروف يُحدِّد الدالة التي ستعيد فهرسًا (index) ضمن سلسلة نصية الذي يُطابِق التعبير النمطي؛ وهذه الدالة ستُستدعى من الدالة <code>[[JavaScript/String/search|String.prototype.search()‎]]</code>.

==== <code>[[JavaScript/Symbol/species|Symbol.species]]</code> ====
دالة تُستخدَم لإنشاء كائنات مشتقة.

==== <code>Symbol.split</code> ====
هذا الرمز المعروف يُحدِّد الدالة التي ستقسم سلسلة نصية في الفهارس (indexes) التي تُطابِق تعبيرًا نمطيًا؛ وهذه الدالة ستُستدعى من الدالة <code>[[JavaScript/String/split|String.prototype.split()‎]]</code>.

==== <code>[[JavaScript/Symbol/toPrimitive|Symbol.toPrimitive]]</code> ====
دالة تُستخدَم لتحويل الكائن إلى قيمة أوليّة مناسبة. تُستدعى من العملية المجرّدة ‎<code>ToPrimitive</code>‎.

==== <code>[[JavaScript/Symbol/toStringTag|Symbol.toStringTag]]</code> ====
سلسلة نصية تُستخدَم في الوصف الافتراضي للكائن، ويستخدم هذا الرمز من الدالة <code>[[JavaScript/Object/toString|Object.prototype.toString()‎]]</code>.

==== <code>Symbol.unscopables</code> ====
كائن ‎<code>Object</code>‎ تكون أسماء خاصياته أسماء خاصياتٍ تُستبعد من  بيئة ارتباطات ‎<code>with</code>‎ الخاصّة بالكائنات ذات العلاقة.
== مصادر ==
* [https://www.typescriptlang.org/docs/handbook/symbols.html صفحة Symbols في توثيق TypeScript الرسمي.]
[[تصنيف:TypeScript]]