Method: projects.test

string

Requis. Pour les tests sur source , le nom de la ressource doit faire référence au projet : Format : projects/{project_id}

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

object ( TestCase )

Collection de cas de tests associés à la TestSuite .

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

enum ( Expectation )

Attente du test.

value ( Value format)

Contexte de la demande.

Le format exact du contexte de demande dépend du service. Consultez la documentation du service approprié pour obtenir des informations sur les champs et les types pris en charge dans la demande. Au minimum, tous les services prennent en charge les champs et types suivants :

Si la valeur de la requête n'est pas bien formée pour le service, la requête sera rejetée comme argument non valide.

value ( Value format)

Valeur de ressource facultative telle qu'elle apparaît dans le stockage persistant avant que la demande ne soit satisfaite.

Le type de ressource dépend de la valeur request.path .

object ( FunctionMock )

La fonction Règles facultatives se moque des fonctions définies par le service. Si elle n'est pas définie, toute fonction de règles définie par le service est censée renvoyer une erreur, qui peut ou non influencer le résultat du test.

enum ( PathEncoding )

Spécifie si les chemins (tels que request.path) sont codés et comment.

enum ( ExpressionReportLevel )

Spécifie ce qui doit être inclus dans la réponse.

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

string

Le nom de la fonction.

Le nom de la fonction doit correspondre à celui fourni par une déclaration de service.

object ( Arg )

La liste des valeurs Arg à faire correspondre. L'ordre dans lequel les arguments sont fournis est l'ordre dans lequel ils doivent apparaître dans l'invocation de la fonction.

object ( Result )

Le résultat fictif de l'appel de fonction.

{

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

L’argument correspond exactement à la valeur fournie.

object

L’argument correspond à n’importe quelle valeur fournie.

{

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

Le résultat est une valeur réelle. Le type de la valeur doit correspondre à celui du type déclaré par le service.

object

Le résultat n'est pas défini, ce qui signifie qu'il n'a pas pu être calculé.

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

object ( SourcePosition )

Position du problème dans la Source .

string

Brève description de l'erreur.

enum ( Severity )

La gravité du problème.

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

string

Nom du File .

integer

Numéro de ligne du fragment source. basé sur 1.

integer

Première colonne de la ligne source associée au fragment source.

integer

Position de départ par rapport au début du fichier.

integer

Position de fin par rapport au début du fichier.

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

enum ( State )

Etat de l'essai.

string

Messages de débogage liés aux problèmes d’exécution des tests rencontrés lors de l’évaluation.

Les messages de débogage peuvent être liés à trop ou trop peu d’appels de fonctions simulées ou à des erreurs d’exécution qui se produisent lors de l’évaluation.

Par exemple : Unable to read variable [name: "resource"]

object ( SourcePosition )

Position dans la Source où l'erreur d'exécution principale se produit.

L'évaluation d'une expression peut entraîner une erreur. Les règles sont refusées par défaut, donc une attente DENY lorsqu'une erreur est générée est valide. Lorsqu'il y a un DENY avec une erreur, la SourcePosition est renvoyée.

Par exemple errorPosition { line: 19 column: 37 }

object ( FunctionCall )

L'ensemble des appels de fonction effectués vers des méthodes définies par le service.

Les appels de fonction sont inclus dans l'ordre dans lequel ils sont rencontrés lors de l'évaluation, sont fournis pour les fonctions simulées et non simulées, et inclus dans la réponse quel que soit l' state du test.

object ( VisitedExpression )

L'ensemble des expressions d'autorisation visitées pour un test donné. Cela renvoie les positions et les résultats d'évaluation de toutes les expressions d'autorisation visitées qui étaient pertinentes pour le scénario de test, par exemple

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

Pour un rapport détaillé des états d'évaluation intermédiaires, voir le champ expressionReports

object ( ExpressionReport )

Le mappage de l'expression dans l'ensemble de règles AST aux valeurs auxquelles elles ont été évaluées. Partiellement imbriqué pour refléter la structure AST. Notez que ce champ suit en fait les expressions et non les déclarations d'autorisation contrairement au champ "visitedExpressions" ci-dessus. Les expressions littérales sont omises.

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

string

Nom de la fonction invoquée.

value ( Value format)

Les arguments fournis à la fonction.

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

object ( SourcePosition )

Position dans la Source où une expression a été visitée.

value ( Value format)

La valeur évaluée pour l'expression visitée, par exemple vrai/faux

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

object ( SourcePosition )

Position de l'expression dans la source des règles originales.

object ( ValueCount )

Valeurs auxquelles cette expression est évaluée lorsqu’elle est rencontrée.

object ( ExpressionReport )

Sous-expressions

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

value ( Value format)

La valeur de retour de l'expression

integer

Nombre de fois que cette expression a été renvoyée.