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

해당 표현식이 반환된 횟수입니다.