Method: projects.test

string

Requerido. Para las pruebas contra la source , el nombre del recurso debe hacer referencia al proyecto: Formato: projects/{project_id}

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

object ( TestCase )

Colección de casos de prueba asociados con TestSuite .

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

enum ( Expectation )

Prueba de expectativa.

value ( Value format)

Solicitar contexto.

El formato exacto del contexto de la solicitud depende del servicio. Consulte la documentación de servicio correspondiente para obtener información sobre los campos y tipos admitidos en la solicitud. Como mínimo, todos los servicios admiten los siguientes campos y tipos:

Si el valor de la solicitud no está bien formado para el servicio, la solicitud se rechazará como un argumento no válido.

value ( Value format)

Valor de recurso opcional tal como aparece en el almacenamiento persistente antes de que se cumpla la solicitud.

El tipo de recurso depende del valor de request.path .

object ( FunctionMock )

La función de reglas opcionales simula las funciones definidas por el servicio. Si no se establece, se espera que cualquier función de reglas definidas por el servicio devuelva un error, que puede o no influir en el resultado de la prueba.

enum ( PathEncoding )

Especifica si las rutas (como request.path) están codificadas y cómo.

enum ( ExpressionReportLevel )

Especifica qué debe incluirse en la respuesta.

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

string

El nombre de la función.

El nombre de la función debe coincidir con uno proporcionado por una declaración de servicio.

object ( Arg )

La lista de valores de Arg que deben coincidir. El orden en el que se proporcionan los argumentos es el orden en el que deben aparecer en la invocación de la función.

object ( Result )

El resultado simulado de la llamada a la función.

{

  // 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)

El argumento coincide exactamente con el valor proporcionado.

object

El argumento coincide con cualquier valor proporcionado.

{

  // 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)

El resultado es un valor real. El tipo del valor debe coincidir con el del tipo declarado por el servicio.

object

El resultado no está definido, lo que significa que no se pudo calcular.

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

object (SourcePosition )

Posición del problema en la Source .

string

Breve descripción del error.

enum ( Severity )

La gravedad del problema.

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

string

Nombre del File .

integer

Número de línea del fragmento de origen. 1 basado.

integer

Primera columna de la línea fuente asociada con el fragmento fuente.

integer

Posición inicial relativa al principio del archivo.

integer

Posición final relativa al comienzo del archivo.

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

enum ( State )

Estado de la prueba.

string

Depurar mensajes relacionados con problemas de ejecución de pruebas encontrados durante la evaluación.

Los mensajes de depuración pueden estar relacionados con demasiadas o muy pocas invocaciones de simulaciones de funciones o con errores de tiempo de ejecución que ocurren durante la evaluación.

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

object (SourcePosition )

Posición en la Source donde se produce el error de tiempo de ejecución principal.

La evaluación de una expresión puede generar un error. Las reglas se niegan de forma predeterminada, por lo que una expectativa DENY cuando se genera un error es válida. Cuando hay un DENY con un error, se devuelve SourcePosition .

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

object ( FunctionCall )

El conjunto de llamadas a funciones realizadas a métodos definidos por el servicio.

Las llamadas a funciones se incluyen en el orden en que se encuentran durante la evaluación, se proporcionan para funciones simuladas y no simuladas, y se incluyen en la respuesta independientemente del state de la prueba.

object ( VisitedExpression )

El conjunto de expresiones de permisos visitadas para una prueba determinada. Esto devuelve las posiciones y los resultados de la evaluación de todas las expresiones de permiso visitadas que fueron relevantes para el caso de prueba, p. Ej.

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

Para obtener un informe detallado de los estados de evaluación intermedia, consulte el campo expressionReports

object ( ExpressionReport )

El mapeo de la expresión en el conjunto de reglas AST a los valores con los que se evaluaron. Parcialmente anidado para reflejar la estructura AST. Tenga en cuenta que este campo en realidad está rastreando expresiones y no declaraciones de permisos en contraste con el campo "VisitExpressions" anterior. Se omiten las expresiones literales.

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

string

Nombre de la función invocada.

value ( Value format)

Los argumentos que se proporcionaron a la función.

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

object (SourcePosition )

Posición en la Source donde se visitó una expresión.

value ( Value format)

El valor evaluado para la expresión visitada, por ejemplo, verdadero / falso

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

object (SourcePosition )

Posición de expresión en la fuente de reglas originales.

object ( ValueCount )

Valores a los que se evaluó esta expresión cuando se encontró.

object ( ExpressionReport )

Subexpresiones

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

value ( Value format)

El valor de retorno de la expresión.

integer

La cantidad de veces que regresó esa expresión.