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

該表達式傳回的次數。