Method: projects.test

string

必須。 sourceに対するテストの場合、リソース名はプロジェクトを参照する必要があります。形式: projects/{project_id}

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

object ( TestCase )

TestSuiteに関連付けられたテスト ケースのコレクション。

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

enum ( Expectation )

テストの期待。

value ( Value format)

リクエストコンテキスト。

リクエスト コンテキストの正確な形式はサービスによって異なります。リクエストでサポートされているフィールドとタイプについては、該当するサービスのドキュメントを参照してください。少なくとも、すべてのサービスは次のフィールドとタイプをサポートします。

リクエスト値がサービスに対して適切な形式でない場合、リクエストは無効な引数として拒否されます。

value ( Value format)

リクエストが実行される前に永続ストレージに表示されるオプションのリソース値。

リソースの種類はrequest.path値によって異なります。

object ( FunctionMock )

サービス定義関数のオプションのルール関数モック。設定されていない場合、サービス定義のルール関数はエラーを返すことが想定されており、テスト結果に影響を与える場合とそうでない場合があります。

enum ( PathEncoding )

パス (request.path など) をエンコードするかどうか、およびその方法を指定します。

enum ( ExpressionReportLevel )

応答に何を含める必要があるかを指定します。

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

string

関数の名前。

関数名はサービス宣言で指定されたものと一致する必要があります。

object ( Arg )

照合するArg値のリスト。引数を指定する順序は、関数呼び出しで指定する必要がある順序です。

object ( Result )

関数呼び出しのモック結果。

{

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

引数は指定された値と完全に一致します。

object

引数は指定された任意の値と一致します。

{

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

結果は実際の値です。値の型は、サービスによって宣言された型と一致する必要があります。

object

結果は未定義です。これは、結果を計算できなかったことを意味します。

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

object ( SourcePosition )

Source内の問題の位置。

string

短いエラーの説明。

enum ( Severity )

問題の重大度。

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

string

Fileの名前。

integer

ソースフラグメントの行番号。 1 ベース。

integer

ソースフラグメントに関連付けられたソース行の最初の列。

integer

ファイルの先頭を基準とした開始位置。

integer

ファイルの先頭を基準とした終了位置。

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

enum ( State )

テストの状態。

string

評価中に発生したテスト実行の問題に関連するデバッグ メッセージ。

デバッグ メッセージは、関数モックの呼び出しが多すぎる、または少なすぎること、または評価中に発生するランタイム エラーに関連している可能性があります。

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

object ( SourcePosition )

主なランタイム エラーが発生するSource内の位置。

式を評価するとエラーが発生する場合があります。ルールはデフォルトで拒否されるため、エラーが生成されたときのDENY期待は有効です。エラーのあるDENYがある場合は、 SourcePositionが返されます。

例: errorPosition { line: 19 column: 37 }

object ( FunctionCall )

サービス定義のメソッドに対して行われる一連の関数呼び出し。

関数呼び出しは、評価中に発生した順序で組み込まれ、モックされた関数とモックされていない関数の両方に提供され、テストのstateに関係なく応答に含まれます。

object ( VisitedExpression )

特定のテストのアクセス許可式のセット。これは、テスト ケースに関連するすべての訪問された許可表現の位置と評価結果を返します。

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

中間評価状態の詳細なレポートについては、 expressionReportsフィールドを参照してください。

object ( ExpressionReport )

ルールセット AST 内の式から評価された値へのマッピング。 AST 構造をミラーリングするために部分的にネストされています。上記の「visitedExpressions」フィールドとは対照的に、このフィールドは実際には式を追跡しており、アクセス許可ステートメントではないことに注意してください。文字通りの表現は省略されています。

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

string

呼び出される関数の名前。

value ( Value format)

関数に提供された引数。

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

object ( SourcePosition )

式がアクセスされたSource内の位置。

value ( Value format)

訪問した式の評価値 (true/false など)

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

object ( SourcePosition )

元のルール ソース内の式の位置。

object ( ValueCount )

この式が見つかったときに評価される値。

object ( ExpressionReport )

部分式

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

value ( Value format)

式の戻り値

integer

式が返された回数。