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

من موسوعة حسوب
< jQuery‏ | jQuery
(بالتحويل من jQuery/jQuery.isEmptyObject)

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

مصادر