عرض مصدر JavaScript/Object/getOwnPropertySymbols

<noinclude>{{DISPLAYTITLE:<code>Object.getOwnPropertySymbols()‎</code>}}</noinclude>
الدالة <code>Object.getOwnPropertySymbols()‎</code> تُعيد مصفوفةً فيها جميع الخاصيات الرمزية (symbol properties) الموجودة مباشرةً في الكائن المعطي.

== البنية العامة ==
<syntaxhighlight lang="javascript">
Object.getOwnPropertySymbols(obj)

</syntaxhighlight>

=== <code>obj</code> ===
الكائن الذي نريد الحصول على جميع خاصياته الرمزية.

=== القيمة المعادة ===
مصفوفة فيها جميع الخاصيات الرمزية (symbol properties) التابعة مباشرةً للكائن المعطي.

== الوصف ==
بما يشبه الدالة <code>[[JavaScript/Object/getOwnPropertyNames|Object.getOwnPropertyNames()]]‎</code>، يمكن الحصول على جميع الخاصيات الرمزية لكائنٍ ما باستخدام هذه الدالة؛ لكن لاحظ أنَّ الدالة <code>[[JavaScript/Object/getOwnPropertyNames|Object.getOwnPropertyNames()]]‎</code> لا تُعيد الخاصيات الرمزية وإنما ستعيد الخاصيات النصية فقط.

ولمّا كانت جميع الكائنات لا تحتوي على خاصيات رمزية عند تهيئتها، فستُعيد الدالة <code>Object.getOwnPropertySymbols()‎</code> مصفوفةً فارغةً ما لم تضبط خاصيات رمزية على الكائن.

== أمثلة ==
سنستخدم الدالة <code>Object.getOwnPropertySymbols()‎</code> للحصول على مصفوفة تحتوي على الخاصيات الرمزية في الكائن <code>obj</code> في المثال الآتي:<syntaxhighlight lang="javascript">
var obj = {};
var a = Symbol('a');
var b = Symbol.for('b');

obj[a] = 'localSymbol';
obj[b] = 'globalSymbol';

var objectSymbols = Object.getOwnPropertySymbols(obj);

console.log(objectSymbols.length); // 2
console.log(objectSymbols);        // [Symbol(a), Symbol(b)]
console.log(objectSymbols[0]);     // Symbol(a)

</syntaxhighlight>

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

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