Query sắp xếp và lọc dữ liệu tại một vị trí Cơ sở dữ liệu để chỉ bao gồm một tập hợp con dữ liệu con. Điều này có thể được sử dụng để sắp xếp việc thu thập dữ liệu theo một số thuộc tính (ví dụ: chiều cao của khủng long) cũng như để hạn chế một danh sách lớn các mục (ví dụ: tin nhắn trò chuyện) xuống một số phù hợp để đồng bộ hóa với máy khách. Các truy vấn được tạo bằng cách kết nối một hoặc nhiều phương thức lọc được xác định ở đây với nhau.
Giống như với DatabaseReference , bạn có thể nhận dữ liệu từ Query bằng cách sử dụng các phương thức on*() . Bạn sẽ chỉ nhận được các sự kiện và DataSnapshot s cho tập hợp con dữ liệu phù hợp với truy vấn của bạn.
Xem https://firebase.google.com/docs/database/web/lists-of-data#sorting_and_filtering_data để biết thêm thông tin.
Chữ ký:
export declare interface Query
Của cải
| Tài sản | Kiểu | Sự miêu tả |
|---|---|---|
| giới thiệu | Cơ sở dữ liệuTham khảo | DatabaseReference cho vị trí của Query . |
phương pháp
| Phương pháp | Sự miêu tả |
|---|---|
| isEqual(khác) | Trả về xem các truy vấn hiện tại và truy vấn được cung cấp có đại diện cho cùng một vị trí hay không, có cùng tham số truy vấn và có cùng phiên bản của FirebaseApp hay không. Hai đối tượng DatabaseReference tương đương nhau nếu chúng đại diện cho cùng một vị trí và từ cùng một phiên bản của FirebaseApp . Hai đối tượng Query tương đương nhau nếu chúng đại diện cho cùng một vị trí, có cùng tham số truy vấn và từ cùng một phiên bản của FirebaseApp . Các truy vấn tương đương có cùng thứ tự sắp xếp, giới hạn, điểm bắt đầu và điểm kết thúc. |
| toJSON() | Trả về một biểu diễn có thể tuần tự hóa JSON của đối tượng này. |
| toString() | Nhận URL tuyệt đối cho vị trí này. Phương thức toString() trả về một URL đã sẵn sàng để đưa vào trình duyệt, lệnh cuộn tròn hoặc lệnh gọi refFromURL() . Vì tất cả những điều đó đều mong đợi URL được mã hóa url, nên toString() trả về một URL được mã hóa. Nối '.json' vào URL được trả về khi nhập vào trình duyệt để tải xuống dữ liệu có định dạng JSON. Nếu vị trí được bảo mật (nghĩa là không thể đọc công khai), bạn sẽ gặp lỗi từ chối cấp phép. |
Truy vấn.ref
DatabaseReference cho Query vị trí của
Chữ ký:
readonly ref: DatabaseReference;
Query.isEqual()
Trả về xem các truy vấn hiện tại và truy vấn được cung cấp có đại diện cho cùng một vị trí hay không, có cùng tham số truy vấn và từ cùng một phiên bản của FirebaseApp .
Hai đối tượng DatabaseReference tương đương nhau nếu chúng đại diện cho cùng một vị trí và từ cùng một phiên bản của FirebaseApp .
Hai đối tượng Query tương đương nhau nếu chúng đại diện cho cùng một vị trí, có cùng tham số truy vấn và từ cùng một phiên bản của FirebaseApp . Các truy vấn tương đương có cùng thứ tự sắp xếp, giới hạn, điểm bắt đầu và điểm kết thúc.
Chữ ký:
isEqual(other: Query | null): boolean;
Thông số
| Tham số | Kiểu | Sự miêu tả |
|---|---|---|
| khác | Truy vấn | vô giá trị | Truy vấn để so sánh với. |
Trả về:
boolean
Liệu các truy vấn hiện tại và được cung cấp có tương đương hay không.
Query.toJSON()
Trả về một biểu diễn có thể tuần tự hóa JSON của đối tượng này.
Chữ ký:
toJSON(): string;
Trả về:
sợi dây
Một biểu diễn có thể tuần tự hóa JSON của đối tượng này.
Truy vấn.toString()
Nhận URL tuyệt đối cho vị trí này.
Phương thức toString() trả về một URL đã sẵn sàng để đưa vào trình duyệt, lệnh cuộn tròn hoặc lệnh gọi refFromURL() . Vì tất cả những điều đó đều mong đợi URL được mã hóa url, nên toString() trả về một URL được mã hóa.
Nối '.json' vào URL được trả về khi nhập vào trình duyệt để tải xuống dữ liệu có định dạng JSON. Nếu vị trí được bảo mật (nghĩa là không thể đọc công khai), bạn sẽ gặp lỗi từ chối cấp phép.
Chữ ký:
toString(): string;
Trả về:
sợi dây
URL tuyệt đối cho vị trí này.