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

<noinclude>{{DISPLAYTITLE:<code>Object.entries()‎</code>}}</noinclude>
الدالة <code>Object.entries()‎</code> تُعيد مصفوفةً تحتوي على الخاصيات القابلة للإحصاء التابعة لأحد الكائن على شكل الأزواج <code>[key, value]</code> بنفس الترتيب الذي تُوفِّر حلقة التكرار <code>[[JavaScript/for...in|for...in]]</code>.

الفرق بين هذه الدالة وحلقة التكرار <code>[[JavaScript/for...in|for...in]]</code> هو أنَّ حلقة <code>[[JavaScript/for...in|for...in]]</code> ستمرّ على الخاصيات القابلة للإحصاء والموجودة في سلسلة prototype أيضًا.
==البنية العامة==
<syntaxhighlight lang="javascript">
Object.entries(obj)

</syntaxhighlight>

=== <code>obj</code> ===
الكائن الذي ستُعاد الخاصيات القابلة للإحصاء التابعة له على شكل الأزواج <code>[key, value]</code>.
=== القيمة المعادة ===
مصفوفة تحتوي على قيم الخاصيات القابلة للإحصاء التابعة للكائن <code>obj</code> على شكل الأزواج <code>[key, value]</code>.

== أمثلة ==
مثال عن كائن بسيط:<syntaxhighlight lang="javascript">
const obj = { foo: 'bar', baz: 42 };
console.log(Object.entries(obj)); // [ ['foo', 'bar'], ['baz', 42] ]

</syntaxhighlight>مثال عن كائن شبيه بالمصفوفات:<syntaxhighlight lang="javascript">
const obj = { 0: 'a', 1: 'b', 2: 'c' };
console.log(Object.entries(obj)); // [ ['0', 'a'], ['1', 'b'], ['2', 'c'] ]

</syntaxhighlight>مثال عن كائن شبيه بالمصفوفات لكن ترتيب المفاتيح فيه عشوائيٌ:<syntaxhighlight lang="javascript">
const anObj = { 100: 'a', 2: 'b', 7: 'c' };
console.log(Object.entries(anObj)); // [ ['2', 'b'], ['7', 'c'], ['100', 'a'] ]

</syntaxhighlight>الخاصية <code>getFoo</code> هي خاصيةٌ غير قابلةٍ للإحصاء في الكائن <code>myObj</code>:<syntaxhighlight lang="javascript">
const myObj = Object.create({}, { getFoo: { value() { return this.foo; } } });
myObj.foo = 'bar';
console.log(Object.entries(myObj)); // [ ['foo', 'bar'] ]

</syntaxhighlight>لاحظ أنَّه إذا مُرِّر وسيطٌ لا يُمثِّل كائنًا، فسيحوّل إلى كائن؛ كما في السلسلة النصية الآتية:<syntaxhighlight lang="javascript">
console.log(Object.entries('foo')); // [ ['0', 'f'], ['1', 'o'], ['2', 'o'] ]

</syntaxhighlight>لكن ستُعاد مصفوفةٌ فارغةٌ لأيّ نوع بياناتٍ أوليّ، لأنَّ القيم الأوليّة لا تملك أيّة خاصيات تابعة لها:<syntaxhighlight lang="javascript">
console.log(Object.entries(100));  // [ ]
console.log(Object.entries(true)); // [ ]

</syntaxhighlight>المرور على خاصيات الكائن وقيمها عبر حلقة التكرار <code>[[JavaScript/for...of|for...of]]</code>:<syntaxhighlight lang="javascript">
const obj = { a: 5, b: 7, c: 9 };
for (const [key, value] of Object.entries(obj)) {
  console.log(`${key} ${value}`); // "a 5", "b 7", "c 9"
}
</syntaxhighlight>أو عبر استخدام دوال المصفوفات:<syntaxhighlight lang="javascript">
Object.entries(obj).forEach(([key, value]) => {
console.log(`${key} ${value}`); // "a 5", "b 7", "c 9"
});

</syntaxhighlight>يمكن استخدام الدالة <code>Object.entries()‎</code> لتحويل كائن من النوع <code>[[JavaScript/Object|Object]]</code> إلى <code>[[JavaScript/Map|Map]]:</code><syntaxhighlight lang="javascript">
const obj = { foo: 'bar', baz: 42 }; 
const map = new Map(Object.entries(obj));
console.log(map); // Map { foo: "bar", baz: 42 }

</syntaxhighlight>

== تعويض نقص دعم المتصفحات ==
لإضافة دعم للدالة <code>Object.entries()‎</code> في البيئات التي لا تدعمها، فيمكنك الاستعانة بالشيفرة الآتية:

<syntaxhighlight lang="javascript">
if (!Object.entries)
  Object.entries = function( obj ){
    var ownProps = Object.keys( obj ),
        i = ownProps.length,
        resArray = new Array(i); // preallocate the Array
    while (i--)
      resArray[i] = [ownProps[i], obj[ownProps[i]]];
    
    return resArray;
  };
</syntaxhighlight>إذا أردتَ دعم متصفحات IE التي إصدارها أقل من 9، فيجب أن توفِّر دالةً بديلةً للدالة <code>[[JavaScript/Object/keys|Object.keys]]</code> (وستجدها في صفحتها).

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

== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-object.entries ECMAScript Latest Draft].
* معيار [https://tc39.github.io/ecma262/2017/#sec-object.entries ECMAScript 2017]. 
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Object|{{SUBPAGENAME}}]]