Symbol.keyFor(key)‎

من موسوعة حسوب

الدالة Symbol.keyFor(key)‎ تحصل على مفتاحٍ للرمز المعطي من سجل الرموز العام.

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

Symbol.keyFor(sym);

sym

الرمز الذي سنبحث عنه.

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

سلسلة نصية تمثل الرمز المرتبط بالرمز المعطي إن كان موجودًا في السجل العام؛ وإلا فستعاد القيمة undefined.

أمثلة

سنستخدم الدالة Symbol.for()‎ لإنشاء رمز عام جديد ثم سنحصل على قيمة مفتاحه عبر الدالة Symbol.KeyFor()‎ في المثال الآتي:

var globalSym = Symbol.for('foo'); // إنشاء رمز عام جديد
Symbol.keyFor(globalSym); // "foo"

لاحظ أنَّ الدالة Symbol.KeyFor()‎ لن تُعيد قيمة رمز المفتاح المحلي، لأنَّه ليس موجودًا في سجل الرموز العام:

var localSym = Symbol();
Symbol.keyFor(localSym); // undefined

الرموز المعروفة (well-known symbols) ليست موجودةً في سجل الرموز العام:

Symbol.keyFor(Symbol.iterator) // undefined

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

الميزة Chrome Firefox Internet Explorer Opera Safari
الدعم الأساسي 40 36 غير مدعومة نعم 9

على النقيض من متصفح IE، يدعم متصفح Edge هذه الميزة.

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