Method: projects.test

string

Necessario. Per i test su source , il nome della risorsa deve fare riferimento al progetto: Formato: projects/{project_id}

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

object ( TestCase )

Raccolta di casi di test associati a TestSuite .

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

enum ( Expectation )

Prova aspettativa.

value ( Value format)

Richiedi contesto.

Il formato esatto del contesto della richiesta dipende dal servizio. Consulta la documentazione del servizio appropriata per informazioni sui campi e sui tipi supportati nella richiesta. Come minimo, tutti i servizi supportano i seguenti campi e tipi:

Se il valore della richiesta non è formato correttamente per il servizio, la richiesta verrà rifiutata come argomento non valido.

value ( Value format)

Valore della risorsa facoltativo come appare nell'archivio permanente prima che la richiesta venga soddisfatta.

Il tipo di risorsa dipende dal valore request.path .

object ( FunctionMock )

La funzione Regole facoltative simula le funzioni definite dal servizio. Se non impostata, è previsto che qualsiasi funzione delle regole definita dal servizio restituisca un errore, che potrebbe influenzare o meno il risultato del test.

enum ( PathEncoding )

Specifica se i percorsi (come request.path) sono codificati e come.

enum ( ExpressionReportLevel )

Specifica cosa deve essere incluso nella risposta.

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

string

Il nome della funzione.

Il nome della funzione deve corrispondere a quello fornito da una dichiarazione di servizio.

object ( Arg )

L'elenco dei valori Arg da abbinare. L'ordine in cui vengono forniti gli argomenti è l'ordine in cui devono apparire nell'invocazione della funzione.

object ( Result )

Il risultato fittizio della chiamata di funzione.

{

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

L'argomento corrisponde esattamente al valore fornito.

object

L'argomento corrisponde a qualsiasi valore fornito.

{

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

Il risultato è un valore reale. Il tipo del valore deve corrispondere a quello del tipo dichiarato dal servizio.

object

Il risultato non è definito, ovvero non è stato possibile calcolarlo.

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

object ( SourcePosition )

Posizione del problema nella Source .

string

Breve descrizione dell'errore.

enum ( Severity )

La gravità del problema.

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

string

Nome del File .

integer

Numero di riga del frammento di origine. 1 in base.

integer

Prima colonna sulla riga di origine associata al frammento di origine.

integer

Posizione iniziale relativa all'inizio del file.

integer

Posizione finale rispetto all'inizio del file.

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

enum ( State )

Stato della prova.

string

Messaggi di debug relativi ai problemi di esecuzione del test riscontrati durante la valutazione.

I messaggi di debug possono essere correlati a troppe o troppo poche invocazioni di simulazioni di funzioni o a errori di runtime che si verificano durante la valutazione.

Ad esempio: Unable to read variable [name: "resource"]

object ( SourcePosition )

Posizione Source in cui si verifica l'errore di runtime principale.

La valutazione di un'espressione può causare un errore. Le regole sono negate per impostazione predefinita, quindi un'aspettativa DENY quando viene generato un errore è valida. Quando è presente un DENY con un errore, viene restituita la SourcePosition .

Ad esempio, errorPosition { line: 19 column: 37 }

object ( FunctionCall )

L'insieme di chiamate di funzione effettuate ai metodi definiti dal servizio.

Le chiamate di funzione sono incluse nell'ordine in cui vengono incontrate durante la valutazione, sono fornite sia per le funzioni mock che per quelle non mock e sono incluse nella risposta indipendentemente dallo state del test.

object ( VisitedExpression )

L'insieme delle espressioni di autorizzazione visitate per un determinato test. Ciò restituisce le posizioni e i risultati della valutazione di tutte le espressioni di autorizzazione visitate che erano rilevanti per il caso di test, ad es

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

Per un report dettagliato degli stati di valutazione intermedi, vedere il campo expressionReports

object ( ExpressionReport )

La mappatura dall'espressione nel set di regole AST ai valori in base ai quali sono stati valutati. Parzialmente nidificato per rispecchiare la struttura AST. Tieni presente che questo campo tiene effettivamente traccia delle espressioni e non delle dichiarazioni di autorizzazione, a differenza del campo "visitedExpressions" sopra. Le espressioni letterali vengono omesse.

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

string

Nome della funzione invocata.

value ( Value format)

Gli argomenti forniti alla funzione.

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

object ( SourcePosition )

Posizione nella Source in cui è stata visitata un'espressione.

value ( Value format)

Il valore valutato per l'espressione visitata, ad esempio vero/falso

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

object ( SourcePosition )

Posizione dell'espressione nella fonte delle regole originali.

object ( ValueCount )

Valori valutati da questa espressione quando incontrati.

object ( ExpressionReport )

Sottoespressioni

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

value ( Value format)

Il valore restituito dell'espressione

integer

Il numero di volte in cui l'espressione è stata restituita.