تعمل الدالة Query
على ترتيب البيانات وتصفيتها في موقع قاعدة البيانات، لكي لا يتم تضمين سوى مجموعة فرعية من البيانات الفرعية. ويمكن استخدام هذه السمة لترتيب مجموعة من البيانات حسب سمة معيّنة (مثل ارتفاع الديناصورات)، بالإضافة إلى حصر قائمة كبيرة من العناصر (مثل رسائل المحادثة) على رقم مناسب لمزامنته مع العميل. يتم إنشاء طلبات البحث عن طريق ربط طريقة واحدة أو أكثر من طرق الفلترة المحدّدة هنا معًا.
يمكنك تلقّي البيانات من Query
باستخدام طرق on*()
، كما هي الحال في DatabaseReference
. ولن تتلقّى سوى الأحداث وDataSnapshot
للمجموعة الفرعية من البيانات التي تتطابق مع طلب بحثك.
لمزيد من المعلومات، يمكنك الاطّلاع على https://firebase.google.com/docs/database/web/lists-of-data#sorting_and_filtering_data.
Signature:
export declare interface Query
أماكن إقامة
الموقع | النوع | الوصف |
---|---|---|
ref | DatabaseReference | رقم DatabaseReference لموقع Query الجغرافي. |
الطُرق
الطريقة | الوصف |
---|---|
isEqual(other) | تعرض ما إذا كانت طلبات البحث الحالية والمقدّمة تمثّل الموقع نفسه أم لا، وتحتوي على معلَمات طلب البحث نفسها، وأنها من مثيل FirebaseApp نفسه.كائنان DatabaseReference متكافئان إذا كانا يمثّلان الموقع نفسه وينتمان إلى مثال FirebaseApp نفسه.هناك كائنان من Query متكافئان إذا كانا يمثّلان الموقع الجغرافي نفسه، ويحتويان على معلَمات طلب البحث نفسها، وهما من مثال FirebaseApp نفسه. تشترك طلبات البحث المكافئة في نفس ترتيب الترتيب والحدود ونقاط البداية والنهاية. |
toJSON() | تعرض تمثيلاً بتنسيق JSON لهذا الكائن. |
toString() | الحصول على عنوان URL المطلق لهذا الموقع.تعرض الطريقة toString() عنوان URL جاهزًا لوضعه في المتصفح أو أمر curl أو استدعاء refFromURL() . وبما أنّ جميع هذه المواقع الإلكترونية تتوقّع أن يكون عنوان URL بترميز عنوان URL، يعرض toString() عنوان URL مرمّزًا.إلحاق " .json" إلى عنوان URL المعروض عند كتابته في متصفّح لتنزيل بيانات بتنسيق JSON. إذا كان الموقع الجغرافي آمنًا (أي لا يمكن للجميع قراءته)، سيظهر لك خطأ رفض الإذن. |
Query.ref
رقم DatabaseReference
لموقع Query
الجغرافي
Signature:
readonly ref: DatabaseReference;
Query.isEqual()
تعرض ما إذا كانت طلبات البحث الحالية والمقدّمة تمثّل الموقع الجغرافي نفسه، وتحتوي على مَعلمات طلب البحث نفسها، وأن تكون من حدث FirebaseApp
نفسه.
يتساوى كائنان من النوع DatabaseReference
إذا كانا يمثّلان الموقع الجغرافي نفسه وهما من الحدث نفسه لـ FirebaseApp
.
يتساوى كائنان من النوع Query
إذا كانا يمثّلان الموقع الجغرافي نفسه ولهما مَعلمات طلب البحث نفسها وكانا من حدث FirebaseApp
نفسه. تشترك طلبات البحث المكافئة في نفس ترتيب الترتيب والحدود ونقاط البداية والنهاية.
Signature:
isEqual(other: Query | null): boolean;
المَعلمات
المعلمة | النوع | الوصف |
---|---|---|
غير ذلك | طلب البحث | فارغ | الاستعلام المطلوب المقارنة به. |
المرتجعات:
قيمة منطقية
ما إذا كانت طلبات البحث الحالية والمقدّمة مماثلة أم لا.
Query.toJSON()
تعرض تمثيلاً بتنسيق JSON لهذا الكائن.
Signature:
toJSON(): string;
المرتجعات:
السلسلة
تمثّل هذه السمة تمثيلاً بتنسيق JSON لهذا العنصر.
Query.toString()
الحصول على عنوان URL المطلق لهذا الموقع.
تعرض الطريقة toString()
عنوان URL جاهزًا لوضعه في متصفح أو أمر curl أو استدعاء refFromURL()
. وبما أنّ جميع هذه المواقع الإلكترونية تتوقع أن يكون عنوان URL بترميز عنوان URL، يعرض toString()
عنوان URL مرمّزًا.
إلحاق "json." إلى عنوان URL المعروض عند كتابته في متصفّح لتنزيل بيانات بتنسيق JSON. إذا كان الموقع الجغرافي آمنًا (أي لا يمكن للجميع قراءته)، سيظهر لك خطأ رفض الإذن.
Signature:
toString(): string;
المرتجعات:
السلسلة
عنوان URL المطلق لهذا الموقع.