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 )

Дополнительная функция Rules имитирует определяемые службой функции. Если этот параметр не установлен, ожидается, что любая определяемая службой функция правил будет возвращать ошибку, которая может повлиять или не повлиять на результат теста.

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

Сколько раз возвращалось это выражение.