Uma Query classifica e filtra os dados em um local do banco de dados para que apenas um subconjunto dos dados filho 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 bate-papo) a um número adequado para sincronização com o cliente. As consultas são criadas encadeando um ou mais dos métodos de filtro definidos aqui.
Assim como com um DatabaseReference , você pode receber dados de uma Query usando os métodos on*() . Você receberá apenas eventos e DataSnapshot s para o subconjunto de dados que corresponde à sua consulta.
Consulte https://firebase.google.com/docs/database/web/lists-of-data#sorting_and_filtering_data para obter mais informações.
Assinatura:
export declare interface Query
Propriedades
| Propriedade | Modelo | Descrição |
|---|---|---|
| referência | Referência de banco de dados | O DatabaseReference para o local da Query . |
Métodos
| Método | Descrição |
|---|---|
| éigual(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 do FirebaseApp . Dois objetos DatabaseReference são equivalentes se representarem o mesmo local e forem da mesma instância de FirebaseApp . Dois objetos Query são equivalentes se representarem o mesmo local, tiverem os mesmos parâmetros de consulta e forem da mesma instância de FirebaseApp . As consultas equivalentes compartilham a mesma ordem de classificação, limites e pontos inicial e final. |
| toJSON() | Retorna uma representação serializável em JSON deste objeto. |
| para sequenciar() | Obtém a URL absoluta para este local. O toString() retorna uma URL que está pronta para ser colocada em um navegador, comando curl ou uma chamada refFromURL() . Como todos esperam que o URL seja codificado por URL, toString() retorna um URL codificado. Acrescente '.json' ao URL retornado quando digitado em um navegador para fazer download de dados formatados em JSON. Se o local for seguro (ou seja, não legível publicamente), você receberá um erro de permissão negada. |
Consulta.ref
A referência de banco de DatabaseReference para a Query localização.
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 do FirebaseApp .
Dois objetos DatabaseReference são equivalentes se representarem o mesmo local e forem da mesma instância do FirebaseApp .
Dois objetos Query são equivalentes se representarem o mesmo local, tiverem os mesmos parâmetros de consulta e forem da mesma instância do FirebaseApp . As 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 | Modelo | Descrição |
|---|---|---|
| outro | Consulta | nulo | A consulta com a qual comparar. |
Devoluções:
boleano
Se as consultas atuais e fornecidas são equivalentes ou não.
Query.toJSON()
Retorna uma representação serializável em JSON deste objeto.
Assinatura:
toJSON(): string;
Devoluções:
corda
Uma representação serializável em JSON desse objeto.
Query.toString()
Obtém a URL absoluta para este local.
O toString() retorna uma URL que está pronta para ser colocada em um navegador, comando curl ou uma chamada refFromURL() . Como todos esperam que o URL seja codificado por URL, toString() retorna um URL codificado.
Acrescente '.json' ao URL retornado quando digitado em um navegador para fazer download de dados formatados em JSON. Se o local for seguro (ou seja, não legível publicamente), você receberá um erro de permissão negada.
Assinatura:
toString(): string;
Devoluções:
corda
A URL absoluta para este local.