Funções de depuração

Funções de depuração

Nome Descrição
EXISTS Retorna TRUE se o valor não estiver ausente
IS_ABSENT Retorna TRUE se o valor estiver ausente.
IF_ABSENT Substitui o valor por uma expressão se ele estiver ausente.
IS_ERROR Captura e verifica se uma expressão subjacente gerou um erro.
IF_ERROR Substitui o valor por uma expressão se ele tiver gerado um erro.

EXISTS

Sintaxe:

exists(value: ANY) -> BOOLEAN

Descrição:

Retorna TRUE se value não for o valor ausente.

Exemplos:

value exists(value)
0L TRUE
"foo" TRUE
NULL TRUE
ABSENT FALSE
Node.js

Exemplo:

const results = await db.pipeline()
  .collection("customers")
  .select(exists(Field.of("orders")))
  .execute();

Web

Exemplo:

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("rating").exists().as("hasRating"))
);
test.firestore.js
Swift
let result = try await db.pipeline()
  .collection("books")
  .select([Field("rating").exists().as("hasRating")])
  .execute()
PipelineSnippets.swift

Kotlin

Exemplo:

val result = db.pipeline()
    .collection("books")
    .select(field("rating").exists().alias("hasRating"))
    .execute()
DocSnippets.kt

Java

Exemplo:

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("rating").exists().alias("hasRating"))
    .execute();
DocSnippets.java
Python
from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(Field.of("rating").exists().as_("hasRating"))
    .execute()
)
firestore_pipelines.py

IS_ABSENT

Sintaxe:

is_absent(value: ANY) -> BOOLEAN

Descrição:

Retorna TRUE se value for o valor ausente. Caso contrário, retorna FALSE. Valores ausentes são aqueles que não estão na entrada, como um campo de documento ausente.

Exemplos:

value is_absent(value)
0L FALSE
"foo" FALSE
NULL FALSE
ABSENT TRUE

IF_ABSENT

Sintaxe:

if_absent(value: ANY, replacement: ANY) -> ANY

Descrição:

Se value for um valor ausente, avalia e retorna replacement. Caso contrário, retornará value.

Exemplos:

value replacement if_absent(value, replacement)
5L 0L 5L
NULL 0L NULL
ABSENT 0L 0L

IS_ERROR

Sintaxe:

is_error(try: ANY) -> BOOLEAN

Descrição:

Retorna TRUE se um erro for gerado durante a avaliação de try. Caso contrário, retorna FALSE.

IF_ERROR

Sintaxe:

if_error(try: ANY, catch: ANY) -> ANY

Descrição:

Se um erro for gerado durante a avaliação de try, avalia e retorna replacement. Caso contrário, retorna o valor resolvido de try.