یک Query
و جو داده ها را در یک مکان پایگاه داده مرتب و فیلتر می کند تا فقط زیر مجموعه ای از داده های فرزند گنجانده شود. این می تواند برای سفارش مجموعه ای از داده ها بر اساس برخی ویژگی ها (مثلاً ارتفاع دایناسورها) و همچنین برای محدود کردن لیست بزرگی از موارد (به عنوان مثال، پیام های چت) به تعداد مناسب برای همگام سازی با مشتری استفاده شود. کوئری ها با زنجیر کردن یک یا چند روش فیلتر تعریف شده در اینجا ایجاد می شوند.
درست مانند یک DatabaseReference
، می توانید با استفاده از روش های on*()
داده ها را از یک Query
دریافت کنید. شما فقط رویدادها و DataSnapshot
دریافت خواهید کرد s برای زیرمجموعه داده هایی که با درخواست شما مطابقت دارد.
برای اطلاعات بیشتر به https://firebase.google.com/docs/database/web/lists-of-data#sorting_and_filtering_data مراجعه کنید.
امضا:
export declare interface Query
خواص
ویژگی | تایپ کنید | شرح |
---|---|---|
مرجع | مرجع پایگاه داده | DatabaseReference برای مکان Query . |
مواد و روش ها
روش | شرح |
---|---|
برابر است (سایر) | نشان میدهد که آیا جستارهای فعلی و ارائهشده نشاندهنده یک مکان هستند یا نه، پارامترهای پرس و جوی یکسانی دارند و از همان نمونه FirebaseApp هستند. دو شی DatabaseReference اگر مکان یکسانی را نشان دهند و از یک نمونه از FirebaseApp باشند معادل هستند. دو شیء Query اگر مکان یکسانی را نشان دهند، پارامترهای جستجوی یکسانی داشته باشند و از یک نمونه از FirebaseApp باشند، معادل هستند. پرس و جوهای معادل، ترتیب مرتب سازی، محدودیت ها، و نقطه شروع و پایان یکسانی دارند. |
toJSON() | نمایشی قابل سریالسازی با JSON از این شی را برمیگرداند. |
toString() | URL مطلق این مکان را دریافت می کند. متد toString() URL را برمی گرداند که آماده قرار دادن در مرورگر، دستور curl یا فراخوانی refFromURL() است. از آنجایی که همه آنها انتظار دارند که URL با url کدگذاری شود، toString() یک URL کدگذاری شده را برمیگرداند. هنگامی که در مرورگر تایپ میشود، «json.» را به URL بازگشتی اضافه کنید تا دادههای با قالب JSON بارگیری شود. اگر مکان امن باشد (یعنی قابل خواندن برای عموم نباشد)، یک خطای عدم مجوز دریافت خواهید کرد. |
Query.ref
DatabaseReference
برای Query
موقعیت مکانی
امضا:
readonly ref: DatabaseReference;
Query.isEqual()
نشان میدهد که آیا کوئریهای فعلی و ارائهشده مکان یکسانی را نشان میدهند، پارامترهای جستجوی یکسانی دارند و از همان نمونه FirebaseApp
هستند یا خیر. .
دو شی DatabaseReference
اگر یک مکان را نشان دهند و از یک نمونه از FirebaseApp
باشند معادل هستند .
دو شیء Query
اگر مکان یکسانی را نشان دهند، پارامترهای پرس و جوی یکسانی داشته باشند و از یک نمونه از FirebaseApp
باشند، معادل هستند. . پرس و جوهای معادل، ترتیب مرتب سازی، محدودیت ها، و نقطه شروع و پایان یکسانی دارند.
امضا:
isEqual(other: Query | null): boolean;
مولفه های
پارامتر | تایپ کنید | شرح |
---|---|---|
دیگر | پرس و جو | خالی | پرس و جو برای مقایسه با. |
برمیگرداند:
بولی
اینکه آیا پرس و جوهای فعلی و ارائه شده معادل هستند یا نه.
Query.toJSON()
نمایشی قابل سریالسازی با JSON از این شی را برمیگرداند.
امضا:
toJSON(): string;
برمیگرداند:
رشته
نمایش JSON-Serializable از این شی.
Query.toString()
URL مطلق این مکان را دریافت می کند.
متد toString()
URL را برمی گرداند که آماده قرار دادن در مرورگر، دستور curl یا فراخوانی refFromURL()
است. از آنجایی که همه آنها انتظار دارند که URL با url کدگذاری شود، toString()
یک URL کدگذاری شده را برمیگرداند.
هنگامی که در مرورگر تایپ میشود، «json.» را به URL بازگشتی اضافه کنید تا دادههای با قالب JSON بارگیری شود. اگر مکان امن باشد (یعنی قابل خواندن برای عموم نباشد)، یک خطای عدم مجوز دریافت خواهید کرد.
امضا:
toString(): string;
برمیگرداند:
رشته
URL مطلق برای این مکان.