string

Required. For tests againstsource, the resource name must refer to the project: Format:projects/{project_id}

object (TestCase)

Collection of test cases associated with theTestSuite.

enum (Expectation)

Test expectation.

value (Value format)

Request context.

The exact format of the request context is service-dependent. See the appropriate service documentation for information about the supported fields and types on the request. Minimally, all services support the following fields and types:

If the request value is not well-formed for the service, the request will be rejected as an invalid argument.

value (Value format)

Optional resource value as it appears in persistent storage before the request is fulfilled.

The resource type depends on therequest.path value.

object (FunctionMock)

Optional Rules function mocks for service-defined functions. If not set, any service-defined Rules function is expected to return an error, which may or may not influence the test outcome.

enum (PathEncoding)

Specifies whether paths (such as request.path) are encoded and how.

enum (ExpressionReportLevel)

Specifies what should be included in the response.

string

The name of the function.

The function name must match one provided by a service declaration.

object (Arg)

The list ofArg values to match. The order in which the arguments are provided is the order in which they must appear in the function invocation.

object (Result)

The mock result of the function call.

value (Value format)

Argument exactly matches value provided.

object

Argument matches any value provided.

value (Value format)

The result is an actual value. The type of the value must match that of the type declared by the service.

object

The result is undefined, meaning the result could not be computed.

object (SourcePosition)

Position of the issue in theSource.

string

Short error description.

enum (Severity)

The severity of the issue.

string

Name of theFile.

integer

Line number of the source fragment. 1-based.

integer

First column on the source line associated with the source fragment.

integer

Start position relative to the beginning of the file.

integer

End position relative to the beginning of the file.

enum (State)

State of the test.

string

Debug messages related to test execution issues encountered during evaluation.

Debug messages may be related to too many or too few invocations of function mocks or to runtime errors that occur during evaluation.

For example:Unable to read variable [name: "resource"]

object (SourcePosition)

Position in theSource where the principle runtime error occurs.

Evaluation of an expression may result in an error. Rules are deny by default, so aDENY expectation when an error is generated is valid. When there is aDENY with an error, theSourcePosition is returned.

E.g.errorPosition { line: 19 column: 37 }

object (FunctionCall)

The set of function calls made to service-defined methods.

Function calls are included in the order in which they are encountered during evaluation, are provided for both mocked and unmocked functions, and included on the response regardless of the teststate.

object (VisitedExpression)

The set of visited permission expressions for a given test. This returns the positions and evaluation results of all visited permission expressions which were relevant to the test case, e.g.

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

For a detailed report of the intermediate evaluation states, see theexpressionReports field

object (ExpressionReport)

The mapping from expression in the ruleset AST to the values they were evaluated to. Partially-nested to mirror AST structure. Note that this field is actually tracking expressions and not permission statements in contrast to the "visitedExpressions" field above. Literal expressions are omitted.

string

Name of the function invoked.

value (Value format)

The arguments that were provided to the function.

object (SourcePosition)

Position in theSource where an expression was visited.

value (Value format)

The evaluated value for the visited expression, e.g. true/false

object (SourcePosition)

Position of expression in original rules source.

object (ValueCount)

Values that this expression evaluated to when encountered.

object (ExpressionReport)

Subexpressions

value (Value format)

The return value of the expression

integer

The number of times that expression returned.