Method: projects.test

string

Requerido. Para pruebas con 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 )

Expectativa de prueba.

value ( Value format)

Solicitar contexto.

El formato exacto del contexto de 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 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 request.path .

object ( FunctionMock )

La función de reglas opcionales se simula para 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 influir o no en el resultado de la prueba.

enum ( PathEncoding )

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

enum ( ExpressionReportLevel )

Especifica lo que se debe incluir 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 que se proporcionan los argumentos es el orden en 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 de valor debe coincidir con el tipo declarado por el servicio.

object

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

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

object ( SourcePosition )

Posición del tema 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 fuente. Basado en 1.

integer

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

integer

Posición inicial relativa al comienzo 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

Mensajes de depuración 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 simulacros 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 ocurre el error principal de tiempo de ejecución.

La evaluación de una expresión puede dar como resultado un error. Las reglas son denegadas 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 permiso visitadas para una prueba determinada. Esto devuelve las posiciones y los resultados de la evaluación de todas las expresiones de permiso visitadas que eran relevantes para el caso de prueba, por ejemplo

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 fueron evaluados. Parcialmente anidado para reflejar la estructura AST. Tenga en cuenta que este campo en realidad rastrea expresiones y no declaraciones de permiso, a diferencia del campo "visitedExpressions" 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 original.

object ( ValueCount )

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

object ( ExpressionReport )

Subexpresiones

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

value ( Value format)

El valor de retorno de la expresión.

integer

El número de veces que regresó esa expresión.