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

من موسوعة حسوب
< jQuery‏ | jQuery
اذهب إلى التنقل اذهب إلى البحث
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

jQuery.isEmptyObject( object )‎

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

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

الوصف

يتحقَّق هذا التابع إن كان الكائن المُمرَّر إليه فارغًا (لا يحوي أيَّة خاصِّيَّة قابلة للإحصاء) أم لا.

jQuery.isEmptyObject( object )‎

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

objcet

الكائن المراد التحقُّق منه لمعرفة إن كان فارغًا أم لا.

بدءًا من الإصدار jQuery 1.4، أصبح هذا التابع يتحقَّق من خاصِّيَّات الكائن نفسه، والخاصِّيَّات الموروثة عبر سلسلة prototypes (لا يستخدم هنا hasOwnProperty). يجب أن يكون الوسيط المعطى كائن JavaScript مجرَّد (Object)، إذ قد لا تعطي أنواع الكائنات الأخرى (مثل عناصر DOM، والأعداد أو السلاسل النصية الأوليَّة، والكائنات المضيفة ...إلخ.) نتائج ثابتة عبر المتصفحات. لتحديد إن كان الكائن المعطى كائن JavaScript مجرَّد، استعمل التابع ‎$.isPlainObject()‎.

أمثلة

التحقُّق إن كان الكائن المعطى فارغًا أم لا:

jQuery.isEmptyObject({}); // true
jQuery.isEmptyObject({ foo: "bar" }); // false

مصادر