database.DataSnapshot class

Interface que representa um instantâneo de dados do banco de dados Firebase Realtime.

Assinatura:

export declare class DataSnapshot implements database.DataSnapshot 

Implementa: database.DataSnapshot

Construtores

Construtor Modificadores Descrição
(construtor)(dados, caminho, aplicativo, instância) Constrói uma nova instância da classe DataSnapshot

Propriedades

Propriedade Modificadores Tipo Descrição
instância corda
chave seqüência de caracteres | nulo A chave (última parte do caminho) da localização deste DataSnapshot . O último token em um local de banco de dados é considerado sua chave. Por exemplo, "ada" é a chave para o nó /users/ada/ . Acessar a chave em qualquer DataSnapshot retorna a chave para o local que a gerou. No entanto, acessar a chave na URL raiz de um banco de dados retorna null .
ref banco de dados. Referência Retorna uma [ Reference ](/docs/reference/admin/node/admin.database.Reference) para o local do banco de dados onde ocorreu a gravação do acionador. Tem acesso total de leitura e gravação.

Métodos

Método Modificadores Descrição
filho(filhoCaminho) Obtém um DataSnapshot para o local no caminho relativo especificado. O caminho relativo pode ser um nome filho simples (por exemplo, "ada") ou um caminho mais profundo separado por barra (por exemplo, "ada/nome/primeiro").
existe() Retorna true se este DataSnapshot contiver quaisquer dados. É um pouco mais eficiente do que usar snapshot.val() !== null . true se este DataSnapshot contiver quaisquer dados; caso contrário, false .
exportVal() Exporta todo o conteúdo do DataSnapshot como um objeto JavaScript. O conteúdo do DataSnapshot como um valor JavaScript (Object, Array, string, number, boolean ou null ).
paraCada(ação) Enumera os DataSnapshot s dos itens filhos. Devido à maneira como os objetos JavaScript funcionam, não há garantia de que a ordem dos dados no objeto JavaScript retornado por val() corresponda à ordem no servidor nem à ordem dos eventos child_added . É aí que forEach() é útil. Ele garante que os filhos de um DataSnapshot possam ser iterados em sua ordem de consulta. Se nenhum método orderBy*() explícito for usado, os resultados serão retornados ordenados por chave (a menos que prioridades sejam usadas; nesse caso, os resultados serão retornados por prioridade).
getPriority() Obtém o valor de prioridade dos dados neste DataSnapshot . Como alternativa ao uso de prioridade, os aplicativos podem ordenar as coleções por propriedades comuns. Consulte [Classificando e filtrando dados](/docs/database/web/lists-of-data#sorting_and_filtering_data). O valor de prioridade dos dados.
hasChild(childPath) Retorna true se o caminho filho especificado tiver dados (não null ).
temFilhos() Retorna se o DataSnapshot tem ou não propriedades filhas não null . Você pode usar hasChildren() para determinar se um DataSnapshot tem filhos. Em caso afirmativo, você pode enumerá-los usando forEach() . Caso contrário, esse instantâneo contém um valor primitivo (que pode ser recuperado com val() ) ou está vazio (nesse caso, val() retorna null ). true se este instantâneo tiver algum filho; senão false .
numChildren() Retorna o número de propriedades filho deste DataSnapshot . Número de propriedades filhas deste DataSnapshot .
toJSON() Retorna uma representação serializável em JSON desse objeto. Uma representação serializável em JSON deste objeto.
val() Extrai um valor JavaScript de um DataSnapshot . Dependendo dos dados em um DataSnapshot , o método val() pode retornar um tipo escalar (string, número ou booleano), uma matriz ou um objeto. Ele também pode retornar null , indicando que o DataSnapshot está vazio (não contém dados). O conteúdo do instantâneo como um valor JavaScript (Object, Array, string, number, boolean ou null ).

banco de dados.DataSnapshot.(construtor)

Constrói uma nova instância da classe DataSnapshot

Assinatura:

constructor(data: any, path?: string, // path is undefined for the database root
    app?: App, instance?: string);

Parâmetros

Parâmetro Tipo Descrição
dados qualquer
caminho corda
aplicativo Aplicativo
instância corda

banco de dados.DataSnapshot.instance

Assinatura:

instance: string;

banco de dados.DataSnapshot.key

A chave (última parte do caminho) da localização deste DataSnapshot .

O último token em um local de banco de dados é considerado sua chave. Por exemplo, "ada" é a chave para o nó /users/ada/ . Acessar a chave em qualquer DataSnapshot retorna a chave para o local que a gerou. No entanto, acessar a chave na URL raiz de um banco de dados retorna null .

Assinatura:

get key(): string | null;

banco de dados.DataSnapshot.ref

Devolve um [ Reference ](/docs/reference/admin/node/admin.database.Reference) para o local do banco de dados onde ocorreu a gravação do acionador. Tem acesso total de leitura e gravação.

Assinatura:

get ref(): database.Reference;

banco de dados.DataSnapshot.child()

Obtém um DataSnapshot para o local no caminho relativo especificado.

O caminho relativo pode ser um nome filho simples (por exemplo, "ada") ou um caminho mais profundo separado por barra (por exemplo, "ada/nome/primeiro").

Assinatura:

child(childPath: string): DataSnapshot;

Parâmetros

Parâmetro Tipo Descrição
childPath corda

Retorna:

DataSnapshot

banco de dados.DataSnapshot.exists()

Retorna true se este DataSnapshot contiver quaisquer dados. É um pouco mais eficiente do que usar snapshot.val() !== null .

true se este DataSnapshot contiver quaisquer dados; caso contrário, false .

Assinatura:

exists(): boolean;

Retorna:

boleano

banco de dados.DataSnapshot.exportVal()

Exporta todo o conteúdo do DataSnapshot como um objeto JavaScript.

O conteúdo do DataSnapshot como um valor JavaScript (Object, Array, string, number, boolean ou null ).

Assinatura:

exportVal(): any;

Retorna:

qualquer

banco de dados.DataSnapshot.forEach()

Enumera o DataSnapshot s dos itens infantis.

Devido à maneira como os objetos JavaScript funcionam, não há garantia de que a ordem dos dados no objeto JavaScript retornado por val() corresponda à ordem no servidor nem à ordem dos eventos child_added . É aí que forEach() é útil. Ele garante que os filhos de um DataSnapshot possam ser iterados em sua ordem de consulta.

Se nenhum método orderBy*() explícito for usado, os resultados serão retornados ordenados por chave (a menos que prioridades sejam usadas; nesse caso, os resultados serão retornados por prioridade).

Assinatura:

forEach(action: (a: DataSnapshot) => boolean | void): boolean;

Parâmetros

Parâmetro Tipo Descrição
Ação (a: DataSnapshot ) => booleano | vazio Uma função que é chamada para cada filho DataSnapshot . O retorno de chamada pode retornar true para cancelar mais enumerações. true se a enumeração foi cancelada devido ao seu retorno de chamada retornar true .

Retorna:

boleano

banco de dados.DataSnapshot.getPriority()

Obtém o valor de prioridade dos dados neste DataSnapshot .

Como alternativa ao uso de prioridade, os aplicativos podem ordenar as coleções por propriedades comuns. Consulte [Classificando e filtrando dados](/docs/database/web/lists-of-data#sorting_and_filtering_data).

O valor de prioridade dos dados.

Assinatura:

getPriority(): string | number | null;

Retorna:

seqüência de caracteres | número | nulo

banco de dados.DataSnapshot.hasChild()

Retorna true se o caminho filho especificado tiver (não null ) dados.

Assinatura:

hasChild(childPath: string): boolean;

Parâmetros

Parâmetro Tipo Descrição
childPath corda

Retorna:

boleano

banco de dados.DataSnapshot.hasChildren()

Retorna se o DataSnapshot tem ou não propriedades filhas não null .

Você pode usar hasChildren() para determinar se um DataSnapshot tem filhos. Em caso afirmativo, você pode enumerá-los usando forEach() . Se não, então este instantâneo contém um valor primitivo (que pode ser recuperado com val() ) ou está vazio (nesse caso, val() retorna null ).

true se este instantâneo tiver algum filho; senão false .

Assinatura:

hasChildren(): boolean;

Retorna:

boleano

database.DataSnapshot.numChildren()

Retorna o número de propriedades filhas deste DataSnapshot .

Número de propriedades filhas deste DataSnapshot .

Assinatura:

numChildren(): number;

Retorna:

número

banco de dados.DataSnapshot.toJSON()

Retorna uma representação serializável em JSON desse objeto.

Uma representação serializável em JSON deste objeto.

Assinatura:

toJSON(): Record<string, unknown>;

Retorna:

Registro<string, desconhecido>

banco de dados.DataSnapshot.val()

Extrai um valor JavaScript de um DataSnapshot .

Dependendo dos dados em um DataSnapshot , o método val() pode retornar um tipo escalar (string, número ou booleano), uma matriz ou um objeto. Também pode retornar null , indicando que o DataSnapshot está vazio (não contém dados).

O conteúdo do instantâneo como um valor JavaScript (objeto, matriz, string, número, booleano ou null ).

Assinatura:

val(): any;

Retorna:

qualquer