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

<noinclude>{{DISPLAYTITLE:<code>Symbol.keyFor(key)‎</code>}}</noinclude>
الدالة <code>Symbol.keyFor(key)‎</code> تحصل على مفتاحٍ للرمز المعطي من سجل الرموز العام.

== البنية العامة ==
<syntaxhighlight lang="javascript">
Symbol.keyFor(sym);

</syntaxhighlight>

=== <code>sym</code> ===
الرمز الذي سنبحث عنه.

=== القيمة المعادة ===
سلسلة نصية تمثل الرمز المرتبط بالرمز المعطي إن كان موجودًا في السجل العام؛ وإلا فستعاد القيمة <code>[[JavaScript/undefined|undefined]]</code>.

== أمثلة ==
سنستخدم الدالة <code>Symbol.for()‎</code> لإنشاء رمز عام جديد ثم سنحصل على قيمة مفتاحه عبر الدالة <code>Symbol.KeyFor()‎</code> في المثال الآتي:<syntaxhighlight lang="javascript">
var globalSym = Symbol.for('foo'); // إنشاء رمز عام جديد
Symbol.keyFor(globalSym); // "foo"

</syntaxhighlight>لاحظ أنَّ الدالة <code>Symbol.KeyFor()‎</code> لن تُعيد قيمة رمز المفتاح المحلي، لأنَّه ليس موجودًا في سجل الرموز العام:<syntaxhighlight lang="javascript">
var localSym = Symbol();
Symbol.keyFor(localSym); // undefined

</syntaxhighlight>الرموز المعروفة (well-known symbols) ليست موجودةً في سجل الرموز العام:<syntaxhighlight lang="javascript">
Symbol.keyFor(Symbol.iterator) // undefined

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

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