Um Query classifica e filtra os dados no local do banco de dados para que apenas um subconjunto dos dados filhos seja incluído. Isso pode ser usado para ordenar uma coleção de dados por algum atributo (por exemplo, altura de dinossauros), bem como para restringir uma grande lista de itens (por exemplo, mensagens de chat) a um número adequado para sincronização com o cliente. As consultas são criadas encadeando um ou mais métodos de filtro definidos aqui.
Assim como acontece com um DatabaseReference, você pode receber dados de um Query usando os métodos on*(). Você só vai receber eventos e DataSnapshots do subconjunto de dados correspondente à sua consulta.
Consulte https://firebase.google.com/docs/database/web/lists-of-data#sorting_and_filtering_data para mais informações.
Assinatura:
export declare interface Query
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| ref | DatabaseReference (em inglês) | O DatabaseReference do local do Query. |
Métodos
| Método | Descrição |
|---|---|
| isEqual(outro) | Retorna se as consultas atuais e fornecidas representam ou não o mesmo local, têm os mesmos parâmetros de consulta e são da mesma instância de FirebaseApp.Dois objetos DatabaseReference são equivalentes se representam o mesmo local e são da mesma instância de FirebaseApp.Dois objetos Query são equivalentes se representam o mesmo local, têm os mesmos parâmetros de consulta e são da mesma instância de FirebaseApp. Consultas equivalentes compartilham a mesma ordem de classificação, limites e pontos inicial e final. |
| toJSON() (link em inglês) | Retorna uma representação serializável do JSON desse objeto. |
| toString(). | Recebe o URL absoluto para este local.O método toString() retorna um URL que está pronto para ser colocado em um navegador, no comando curl ou em uma chamada refFromURL(). Como todos eles esperam que o URL seja codificado por URL, toString() retorna um URL codificado.Anexar ".json" ao URL retornado, quando digitado em um navegador para fazer o download de dados formatados em JSON. Se o local for protegido (ou seja, não possa ser lido publicamente), você receberá um erro de permissão negada. |
Query.ref
O DatabaseReference do local de Query.
Assinatura:
readonly ref: DatabaseReference;
Query.isEqual()
Retorna se as consultas atuais e fornecidas representam ou não o mesmo local, têm os mesmos parâmetros de consulta e são da mesma instância de FirebaseApp.
Dois objetos DatabaseReference serão equivalentes se representarem o mesmo local e forem da mesma instância de FirebaseApp.
Dois objetos Query serão equivalentes se representarem o mesmo local, tiverem os mesmos parâmetros de consulta e forem da mesma instância de FirebaseApp. Consultas equivalentes compartilham a mesma ordem de classificação, limites e pontos inicial e final.
Assinatura:
isEqual(other: Query | null): boolean;
Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
| outro | Consulta | nulo | A consulta a ser comparada. |
Retorna:
booleano
Se as consultas atuais e fornecidas são equivalentes ou não.
Query.toJSON()
Retorna uma representação serializável do JSON desse objeto.
Assinatura:
toJSON(): string;
Retorna:
string
Uma representação serializável do JSON desse objeto.
Função Query.toString()
Recebe o URL absoluto para este local.
O método toString() retorna um URL pronto para ser colocado em um navegador, um comando curl ou uma chamada refFromURL(). Como todos eles esperam que o URL seja codificado por URL, toString() retorna um URL codificado.
Anexar ".json" ao URL retornado, quando digitado em um navegador para fazer o download de dados formatados em JSON. Se o local for protegido (ou seja, não possa ser lido publicamente), você receberá um erro de permissão negada.
Assinatura:
toString(): string;
Retorna:
string
O URL absoluto para este local.