Method: projects.test

string

Wymagany. W przypadku testów na source nazwa zasobu musi odnosić się do projektu: Format: projects/{project_id}

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

object ( TestCase )

Zbiór przypadków testowych powiązanych z pakietem TestSuite .

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

enum ( Expectation )

Oczekiwanie testowe.

value ( Value format)

Kontekst żądania.

Dokładny format kontekstu żądania zależy od usługi. Informacje o obsługiwanych polach i typach żądania można znaleźć w odpowiedniej dokumentacji serwisowej. Minimalnie wszystkie usługi obsługują następujące pola i typy:

Jeśli wartość żądania nie jest poprawnie sformułowana dla usługi, żądanie zostanie odrzucone jako nieprawidłowy argument.

value ( Value format)

Opcjonalna wartość zasobu wyświetlana w pamięci trwałej przed spełnieniem żądania.

Typ zasobu zależy od wartości request.path .

object ( FunctionMock )

Opcjonalna funkcja Reguły manipuluje funkcjami zdefiniowanymi przez usługę. Jeśli nie jest ustawiona, oczekuje się, że każda funkcja Reguły zdefiniowana przez usługę zwróci błąd, który może, ale nie musi, mieć wpływ na wynik testu.

enum ( PathEncoding )

Określa, czy ścieżki (takie jak request.path) są kodowane i w jaki sposób.

enum ( ExpressionReportLevel )

Określa, co powinno zostać uwzględnione w odpowiedzi.

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

string

Nazwa funkcji.

Nazwa funkcji musi odpowiadać nazwie podanej w deklaracji usługi.

object ( Arg )

Lista wartości Arg do dopasowania. Kolejność podawania argumentów jest kolejnością, w jakiej muszą one wystąpić w wywołaniu funkcji.

object ( Result )

Próbny wynik wywołania funkcji.

{

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

Argument dokładnie odpowiada podanej wartości.

object

Argument pasuje do dowolnej podanej wartości.

{

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

Wynikiem jest rzeczywista wartość. Typ wartości musi być zgodny z typem zadeklarowanym przez usługę.

object

Wynik jest niezdefiniowany, co oznacza, że ​​nie można go obliczyć.

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

object ( SourcePosition )

Pozycja zagadnienia w Source .

string

Krótki opis błędu.

enum ( Severity )

Ważność problemu.

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

string

Nazwa File .

integer

Numer linii fragmentu źródłowego. oparty na 1.

integer

Pierwsza kolumna w wierszu źródłowym powiązana z fragmentem źródłowym.

integer

Pozycja początkowa względem początku pliku.

integer

Pozycja końcowa względem początku pliku.

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

enum ( State )

Stan testu.

string

Debuguj komunikaty związane z problemami z wykonaniem testów napotkanymi podczas oceny.

Komunikaty debugowania mogą być związane ze zbyt dużą lub zbyt małą liczbą wywołań próbnych funkcji lub błędami środowiska wykonawczego, które występują podczas oceny.

Na przykład: Unable to read variable [name: "resource"]

object ( SourcePosition )

Pozycja w Source , w której występuje główny błąd wykonania.

Ocena wyrażenia może spowodować błąd. Reguły są domyślnie odrzucane, więc oczekiwanie DENY w przypadku wygenerowania błędu jest prawidłowe. Jeśli wystąpi błąd DENY , zwracana jest pozycja SourcePosition .

Np. errorPosition { line: 19 column: 37 }

object ( FunctionCall )

Zestaw wywołań funkcji wykonanych do metod zdefiniowanych przez usługę.

Wywołania funkcji są uwzględniane w kolejności, w jakiej zostały napotkane podczas oceny, są dostępne zarówno dla funkcji próbnych, jak i niezaszyfrowanych oraz uwzględniane w odpowiedzi niezależnie od state testu.

object ( VisitedExpression )

Zestaw odwiedzonych wyrażeń uprawnień dla danego testu. Zwraca to pozycje i wyniki oceny wszystkich odwiedzonych wyrażeń uprawnień, które były istotne dla przypadku testowego, np

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

Szczegółowy raport pośrednich stanów oceny znajduje się w polu expressionReports

object ( ExpressionReport )

Mapowanie z wyrażenia w zestawie reguł AST na wartości, według których zostały oszacowane. Częściowo zagnieżdżone, aby odzwierciedlić strukturę AST. Należy pamiętać, że w przeciwieństwie do powyższego pola „visitedExpressions” w tym polu w rzeczywistości śledzone są wyrażenia, a nie instrukcje dotyczące uprawnień. Wyrażenia dosłowne są pomijane.

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

string

Nazwa wywoływanej funkcji.

value ( Value format)

Argumenty dostarczone do funkcji.

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

object ( SourcePosition )

Pozycja w Source , w którym odwiedzono wyrażenie.

value ( Value format)

Oceniana wartość odwiedzanego wyrażenia, np. prawda/fałsz

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

object ( SourcePosition )

Pozycja wyrażenia w oryginalnym źródle reguł.

object ( ValueCount )

Wartości, które to wyrażenie ocenia po napotkaniu.

object ( ExpressionReport )

Podwyrażenia

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

value ( Value format)

Wartość zwracana przez wyrażenie

integer

Liczba zwróconych wystąpień tego wyrażenia.