Symbol.keyFor(key)
< JavaScript | Symbol
الدالة 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 هذه الميزة.
مصادر ومواصفات
- مسودة المعيار ECMAScript Latest Draft.
- معيار ECMAScript 2015 (6th Edition).