Namespace: debug

depurar

debug()

Uma função básica de depuração que mostra a linguagem das regras de segurança. objetos, variáveis e resultados de instruções são avaliadas pelo mecanismo de regras de segurança. As saídas de debug são gravadas em firestore-debug.log.

A função debug só pode ser chamada dentro de regras condições.

Os blocos de função de debug só são executados pelo mecanismo de regras de segurança em o emulador do Firestore, que faz parte do Pacote de emuladores do Firebase. O comando função não tem efeito na produção.

As entradas do arquivo de registro de depuração são precedidas por uma string que identifica as regras tipo de dados de idioma da saída do registro (por exemplo, string_value, map_value).

As chamadas para debug podem ser aninhadas.

Atualmente, o recurso debug não é compatível com o conceito de geração de registros. níveis (por exemplo, INFO, WARN, ERROR).

// firestore.rules
// Nested debug calls in the following match block....
match /carts/{cartID} {
  allow create: if request.auth != null && request.auth.uid == request.resource.data.ownerUID;
    allow read, update, delete: if
      debug(
        debug(request.auth.uid) == debug(resource.data.ownerUID)
      );
  }
...

// firestore-debug.log
// ...produce logfile output like the following.
string_value: "alice" // for debug(request.auth.uid)

string_value: "alice" // for debug(resource.data.ownerUID)

bool_value: true      // for the outermost enclosing debug() call
...