التابع ‎‎jQuery.isPlainObject()‎‎ في jQuery

من موسوعة حسوب
< jQuery‏ | jQuery
اذهب إلى: تصفح، ابحث

jQuery.isPlainObject( object )‎

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

يعيد قيمةً منطقيِّةً (Boolean).

الوصف

يتحقَّق هذا التابع إن كان الكائن الممرَّر إليه كائنًا مجرَّدًا (أُنشئ باستعمال "{}" أو "new Object") أم لا.

jQuery.isPlainObject( object )‎

أُضيف مع الإصدار: 1.4.

object

الكائن المراد التحقُّق منه.

ملاحظة: كائنات المضيف (Host objects، أو الكائنات المستعملة من قِبَل بيئة المتصفح المضيف لإكمال بيئة التنفيذ ECMAScript) لها عددٌ من التناقضات التي يصعب على أي ميِّزة صارمة اكتشافها عبر المنصات. نتيجةً لذلك، قد يعطي التابع ‎$.isPlainObject()‎ قيمًا غير متناسقة تختلف باختلاف المتصفح في بعض النُسخ.

التحقُّق من الكائن document.location باستعمال ‎$.isPlainObject()‎ هو خير مثالٌ عن الكلام السابق:
console.log( $.isPlainObject( document.location ) );
إذ يُرمى الاستثناء "invalid pointer" إن استعمل هذا المثال في المتصفح IE8. أبقي هذا في بالك دومًا، إذ من الضروري أن تكون مدركًا للقيم الممرَّرة إلى التابع ‎$.isPlainObject()‎ عند استعماله مع المتصفحات القديمة. تفحَّص جيدًا المثالين التاليين في قسم الأمثلة.

أمثلة

التحقُّق من بعض القيم الممرَّرة إلى التابع لمعرفة إن كانت كائنات مجرَّدةً أم لا:
jQuery.isPlainObject({}) // true
jQuery.isPlainObject( "test" ) // false

مصادر