Method: projects.test

string

Erforderlich. Für Tests gegen source muss sich der Ressourcenname auf das Projekt beziehen: Format: projects/{project_id}

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

object ( TestCase )

Sammlung von Testfällen, die der TestSuite zugeordnet sind.

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

enum ( Expectation )

Testerwartung.

value ( Value format)

Kontext anfordern.

Das genaue Format des Anforderungskontexts ist dienstabhängig. Informationen zu den unterstützten Feldern und Typen in der Anfrage finden Sie in der entsprechenden Servicedokumentation. Alle Dienste unterstützen mindestens die folgenden Felder und Typen:

Wenn der Anforderungswert für den Dienst nicht wohlgeformt ist, wird die Anforderung als ungültiges Argument abgelehnt.

value ( Value format)

Optionaler Ressourcenwert, wie er im persistenten Speicher angezeigt wird, bevor die Anforderung erfüllt wird.

Der Ressourcentyp hängt vom Wert request.path ab.

object ( FunctionMock )

Optionale Rules-Funktionsmocks für servicedefinierte Funktionen. Wenn diese Option nicht festgelegt ist, wird von jeder vom Dienst definierten Regelfunktion erwartet, dass sie einen Fehler zurückgibt, der das Testergebnis beeinflussen kann oder auch nicht.

enum ( PathEncoding )

Gibt an, ob und wie Pfade (z. B. request.path) codiert werden.

enum ( ExpressionReportLevel )

Gibt an, was in der Antwort enthalten sein soll.

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

string

Der Name der Funktion.

Der Funktionsname muss mit einem durch eine Dienstdeklaration bereitgestellten Namen übereinstimmen.

object ( Arg )

Die Liste der abzugleichenden Arg Werte. Die Reihenfolge, in der die Argumente bereitgestellt werden, ist die Reihenfolge, in der sie im Funktionsaufruf erscheinen müssen.

object ( Result )

Das Scheinergebnis des Funktionsaufrufs.

{

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

Das Argument stimmt genau mit dem angegebenen Wert überein.

object

Das Argument stimmt mit jedem angegebenen Wert überein.

{

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

Das Ergebnis ist ein tatsächlicher Wert. Der Typ des Werts muss mit dem vom Dienst deklarierten Typ übereinstimmen.

object

Das Ergebnis ist undefiniert, was bedeutet, dass das Ergebnis nicht berechnet werden konnte.

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

object ( SourcePosition )

Position des Problems in der Source .

string

Kurze Fehlerbeschreibung.

enum ( Severity )

Die Schwere des Problems.

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

string

Name der File .

integer

Zeilennummer des Quellfragments. 1-basiert.

integer

Erste Spalte in der Quellzeile, die dem Quellfragment zugeordnet ist.

integer

Startposition relativ zum Anfang der Datei.

integer

Endposition relativ zum Anfang der Datei.

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

enum ( State )

Stand des Tests.

string

Debug-Meldungen im Zusammenhang mit Testausführungsproblemen, die während der Auswertung aufgetreten sind.

Debug-Meldungen können mit zu vielen oder zu wenigen Aufrufen von Funktionsmocks oder mit Laufzeitfehlern zusammenhängen, die während der Auswertung auftreten.

Beispiel: Unable to read variable [name: "resource"]

object ( SourcePosition )

Position in der Source , an der der Hauptlaufzeitfehler auftritt.

Die Auswertung eines Ausdrucks kann zu einem Fehler führen. Regeln verweigern standardmäßig, daher ist eine DENY Erwartung gültig, wenn ein Fehler generiert wird. Wenn ein DENY mit einem Fehler vorliegt, wird die SourcePosition zurückgegeben.

Beispiel: errorPosition { line: 19 column: 37 }

object ( FunctionCall )

Der Satz von Funktionsaufrufen, die an dienstdefinierte Methoden erfolgen.

Funktionsaufrufe werden in der Reihenfolge eingefügt, in der sie während der Auswertung auftreten, werden sowohl für simulierte als auch nicht simulierte Funktionen bereitgestellt und unabhängig vom state in die Antwort einbezogen.

object ( VisitedExpression )

Der Satz der besuchten Berechtigungsausdrücke für einen bestimmten Test. Dies gibt die Positionen und Auswertungsergebnisse aller besuchten Berechtigungsausdrücke zurück, die für den Testfall relevant waren, z

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

Einen detaillierten Bericht der Zwischenauswertungszustände finden Sie im Feld expressionReports

object ( ExpressionReport )

Die Zuordnung vom Ausdruck im Regelsatz-AST zu den Werten, anhand derer sie ausgewertet wurden. Teilweise verschachtelt, um die AST-Struktur widerzuspiegeln. Beachten Sie, dass dieses Feld im Gegensatz zum Feld „visitedExpressions“ oben tatsächlich Ausdrücke und keine Berechtigungsanweisungen verfolgt. Wörtliche Ausdrücke werden weggelassen.

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

string

Name der aufgerufenen Funktion.

value ( Value format)

Die Argumente, die der Funktion bereitgestellt wurden.

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

object ( SourcePosition )

Position in der Source , an der ein Ausdruck aufgerufen wurde.

value ( Value format)

Der ausgewertete Wert für den besuchten Ausdruck, z. B. wahr/falsch

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

object ( SourcePosition )

Position des Ausdrucks in der ursprünglichen Regelquelle.

object ( ValueCount )

Werte, zu denen dieser Ausdruck ausgewertet wird, wenn er auftritt.

object ( ExpressionReport )

Unterausdrücke

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

value ( Value format)

Der Rückgabewert des Ausdrucks

integer

Die Häufigkeit, mit der dieser Ausdruck zurückgegeben wurde.