Method: projects.test

string

Obrigatório. Para testes em source , o nome do recurso deve fazer referência ao projeto: Formato: projects/{project_id}

{
  "testCases": [
    {
      object (TestCase)
    }
  ]
}

object ( TestCase )

Coleção de casos de teste associados ao TestSuite .

{
  "expectation": enum (Expectation),
  "request": value,
  "resource": value,
  "functionMocks": [
    {
      object (FunctionMock)
    }
  ],
  "pathEncoding": enum (PathEncoding),
  "expressionReportLevel": enum (ExpressionReportLevel)
}

enum ( Expectation )

Expectativa de teste.

value ( Value format)

Contexto da solicitação.

O formato exato do contexto da solicitação depende do serviço. Consulte a documentação de serviço apropriada para obter informações sobre os campos e tipos suportados na solicitação. No mínimo, todos os serviços suportam os seguintes campos e tipos:

Se o valor da solicitação não estiver bem formado para o serviço, a solicitação será rejeitada como um argumento inválido.

value ( Value format)

Valor do recurso opcional conforme aparece no armazenamento persistente antes que a solicitação seja atendida.

O tipo de recurso depende do valor request.path .

object ( FunctionMock )

Simulações de funções de regras opcionais para funções definidas pelo serviço. Se não for definido, espera-se que qualquer função de regras definida pelo serviço retorne um erro, que pode ou não influenciar o resultado do teste.

enum ( PathEncoding )

Especifica se os caminhos (como request.path) são codificados e como.

enum ( ExpressionReportLevel )

Especifica o que deve ser incluído na resposta.

{
  "function": string,
  "args": [
    {
      object (Arg)
    }
  ],
  "result": {
    object (Result)
  }
}

string

O nome da função.

O nome da função deve corresponder ao fornecido por uma declaração de serviço.

object ( Arg )

A lista de valores Arg a serem correspondidos. A ordem em que os argumentos são fornecidos é a ordem em que devem aparecer na invocação da função.

object ( Result )

O resultado simulado da chamada de função.

{

  // Union field type can be only one of the following:
  "exactValue": value,
  "anyValue": {
    object
  }
  // End of list of possible types for union field type.
}

value ( Value format)

O argumento corresponde exatamente ao valor fornecido.

object

O argumento corresponde a qualquer valor fornecido.

{

  // Union field type can be only one of the following:
  "value": value,
  "undefined": {
    object
  }
  // End of list of possible types for union field type.
}

value ( Value format)

O resultado é um valor real. O tipo do valor deve corresponder ao tipo declarado pelo serviço.

object

O resultado é indefinido, o que significa que o resultado não pôde ser calculado.

{
  "sourcePosition": {
    object (SourcePosition)
  },
  "description": string,
  "severity": enum (Severity)
}

object ( SourcePosition )

Posição do problema na Source .

string

Breve descrição do erro.

enum ( Severity )

A gravidade do problema.

{
  "fileName": string,
  "line": integer,
  "column": integer,
  "currentOffset": integer,
  "endOffset": integer
}

string

Nome do File .

integer

Número da linha do fragmento de origem. Baseado em 1.

integer

Primeira coluna na linha de origem associada ao fragmento de origem.

integer

Posição inicial relativa ao início do arquivo.

integer

Posição final relativa ao início do arquivo.

{
  "state": enum (State),
  "debugMessages": [
    string
  ],
  "errorPosition": {
    object (SourcePosition)
  },
  "functionCalls": [
    {
      object (FunctionCall)
    }
  ],
  "visitedExpressions": [
    {
      object (VisitedExpression)
    }
  ],
  "expressionReports": [
    {
      object (ExpressionReport)
    }
  ]
}

enum ( State )

Estado do teste.

string

Mensagens de depuração relacionadas a problemas de execução de teste encontrados durante a avaliação.

As mensagens de depuração podem estar relacionadas a muitas ou poucas invocações de simulações de função ou a erros de tempo de execução que ocorrem durante a avaliação.

Por exemplo: Unable to read variable [name: "resource"]

object ( SourcePosition )

Posição na Source onde ocorre o principal erro de tempo de execução.

A avaliação de uma expressão pode resultar em erro. As regras são negadas por padrão, portanto, uma expectativa DENY quando um erro é gerado é válida. Quando há um DENY com erro, o SourcePosition é retornado.

Por exemplo, errorPosition { line: 19 column: 37 }

object ( FunctionCall )

O conjunto de chamadas de função feitas para métodos definidos pelo serviço.

As chamadas de função são incluídas na ordem em que são encontradas durante a avaliação, são fornecidas para funções simuladas e não simuladas e incluídas na resposta, independentemente do state do teste.

object ( VisitedExpression )

O conjunto de expressões de permissão visitadas para um determinado teste. Isso retorna as posições e os resultados da avaliação de todas as expressões de permissão visitadas que foram relevantes para o caso de teste, por exemplo

match /path {
  allow read if: <expr>
}

Para um relatório detalhado dos estados de avaliação intermediários, consulte o campo expressionReports

object ( ExpressionReport )

O mapeamento da expressão no conjunto de regras AST para os valores para os quais foram avaliados. Parcialmente aninhado para espelhar a estrutura AST. Observe que este campo está, na verdade, rastreando expressões e não declarações de permissão, em contraste com o campo "visitedExpressions" acima. Expressões literais são omitidas.

{
  "function": string,
  "args": [
    value
  ]
}

string

Nome da função invocada.

value ( Value format)

Os argumentos que foram fornecidos à função.

{
  "sourcePosition": {
    object (SourcePosition)
  },
  "value": value
}

object ( SourcePosition )

Posição na Source onde uma expressão foi visitada.

value ( Value format)

O valor avaliado para a expressão visitada, por exemplo, verdadeiro/falso

{
  "sourcePosition": {
    object (SourcePosition)
  },
  "values": [
    {
      object (ValueCount)
    }
  ],
  "children": [
    {
      object (ExpressionReport)
    }
  ]
}

object ( SourcePosition )

Posição da expressão na fonte original das regras.

object ( ValueCount )

Valores que esta expressão avaliou quando encontrada.

object ( ExpressionReport )

Subexpressões

{
  "value": value,
  "count": integer
}

value ( Value format)

O valor de retorno da expressão

integer

O número de vezes que essa expressão retornou.