Testare le funzioni in modo interattivo

La shell Cloud Functions fornisce una shell interattiva per richiamare funzioni con dati di test. La shell supporta tutti i tipi di trigger.

Configura le credenziali di amministratore (facoltativo)

Se desideri che i test delle funzioni interagiscano con le API di Google o altre API Firebase tramite Firebase Admin SDK , potrebbe essere necessario impostare le credenziali di amministratore.

  • I trigger Cloud Firestore e Realtime Database dispongono già di credenziali sufficienti e non richiedono configurazioni aggiuntive.
  • Tutte le altre API, incluse le API Firebase come Authentication e FCM o le API Google come Cloud Translation o Cloud Speech, richiedono i passaggi di configurazione descritti in questa sezione. Questo vale sia che utilizzi la shell Cloud Functions o firebase emulators:start .

Per impostare le credenziali di amministratore per le funzioni emulate:

  1. Apri il riquadro Account di servizio della console Google Cloud.
  2. Assicurati che l'account di servizio predefinito di App Engine sia selezionato e utilizza il menu delle opzioni a destra per selezionare Crea chiave .
  3. Quando richiesto, seleziona JSON come tipo di chiave e fai clic su Crea .
  4. Imposta le tue credenziali predefinite di Google in modo che puntino alla chiave scaricata:

    Unix

    export GOOGLE_APPLICATION_CREDENTIALS="path/to/key.json"
    firebase functions:shell
    

    finestre

    set GOOGLE_APPLICATION_CREDENTIALS=path\to\key.json
    firebase functions:shell
    

Dopo aver completato questi passaggi, i test delle funzioni possono accedere alle API Firebase e Google utilizzando l' SDK Admin . Ad esempio, durante il test di un trigger di autenticazione, la funzione emulata potrebbe chiamare admin.auth().getUserByEmail(email) .

Servi funzioni utilizzando una shell Cloud Functions

La shell Cloud Functions emula tutti i tipi di trigger di funzione con una shell interattiva per richiamare le funzioni con i dati di test. Le opzioni variano in base al tipo di funzione, ma il formato di utilizzo di base è:

myFunctionName(data, options)

Il parametro data è obbligatorio per i trigger Realtime Database, Cloud Firestore e PubSub ed è facoltativo per tutti gli altri tipi di funzioni. Inoltre, il parametro opzionale options è valido solo per le funzioni Realtime Database e Cloud Firestore.

Facoltativamente, puoi caricare i dati del test da un file locale salvando il file come variabile e richiamando una funzione con esso:

var data = require('./path/to/testData.json');
myFunction(data);

Installa e configura la shell Cloud Functions

Per utilizzare questa funzionalità, firebase-tools deve avere la versione minima 3.11.0 e firebase-functions SDK deve avere la versione minima 0.6.2. Per aggiornare entrambi, esegui i seguenti comandi nella directory functions/ del tuo progetto:

npm install --save firebase-functions@latest
npm install -g firebase-tools

Se utilizzi variabili di configurazione delle funzioni personalizzate, esegui prima il comando per ottenere la configurazione personalizzata (eseguila nella directory functions ) nel tuo ambiente locale:

firebase functions:config:get > .runtimeconfig.json
# If using Windows PowerShell, replace the above with:
# firebase functions:config:get | ac .runtimeconfig.json

Infine, esegui la shell con il seguente comando:

firebase functions:shell

Richiama le funzioni HTTPS

Per richiamare le funzioni HTTPS nella shell, l'utilizzo è lo stesso del modulo request NPM, ma sostituisci request con il nome della funzione che desideri emulare. Per esempio:

# invoke
myHttpsFunction()
myHttpsFunction.get()
myHttpsFunction.post()

# invoke at sub-path
myHttpsFunction('/path')
myHttpsFunction.get('/path')
myHttpsFunction.post('/path')

# send POST request with form data
myHttpsFunction.post('/path').form( {foo: 'bar' })

Richiama le funzioni richiamabili HTTPS

Quando richiami le funzioni HTTPS Callable localmente, dovrai fornire dati di test appropriati.

# invoke
myCallableFunction('test data')
myCallableFunction({'foo': 'bar'})

Facoltativamente, puoi passare un Firebase-Instance-ID-token come secondo parametro. Deve essere una stringa.

# invoke with FCM registration token
myCallableFunction('test data', {instanceIdToken: 'sample token'})

L'emulazione di context.auth non è attualmente disponibile.

Richiama le funzioni del Realtime Database

Quando esegui le funzioni di Realtime Database localmente, dovrai fornire dati di test appropriati. Ciò significa generalmente fornire nuovi dati di test per le operazioni onCreate , dati vecchi/rimossi per le operazioni onDelete ed entrambi per le funzioni onUpdate o onWrite :

# invoke onCreate function
myDatabaseFunction('new_data')

# invoke onDelete function
myDatabaseFunction('old_data')

# invoke onUpdate or onWrite function
myDatabaseFunction({before: 'old_data', after: 'new_data' })

Oltre alle opzioni before/after , la shell fornisce l'opzione params da utilizzare per simulare i caratteri jolly in un percorso:

# mock wildcards in path, for example: if the path was input/{group}/{id}
myDatabaseFunction('data', {params: {group: 'a', id: 123}})

Per impostazione predefinita, la shell esegue le funzioni Realtime Database con privilegi di amministratore (account di servizio). Utilizza l'opzione auth per eseguire invece le funzioni come un particolare utente finale o come utente non autenticato:

# to mock unauthenticated user
myDatabaseFunction('data', {authMode: 'USER'})
# to mock end user
myDatabaseFunction('data', {auth: {uid: 'abcd'}})

Richiama le funzioni Firestore

Quando esegui le funzioni Firestore localmente, dovrai fornire dati di test appropriati. Ciò generalmente significa fornire nuovi dati di test per le operazioni onCreate , dati vecchi/rimossi per le operazioni onDelete ed entrambi per le funzioni onUpdate o onWrite . Tieni presente che i dati Firestore devono essere coppie chiave-valore; vedere Tipi di dati supportati .

# invoke onCreate function
myFirestoreFunction({foo: ‘new’})

# invoke onDelete function
myFirestoreFunction({foo: ‘old’})

# invoke onUpdate or onWrite function
myFirestoreFunction({before: {foo: ‘old’}, after: {foo: ‘new’} })

Oltre ai campi before/after dell'oggetto data , puoi utilizzare i campi params sull'oggetto options per simulare i caratteri jolly nel nome di un documento:

# mock wildcards in document name, for example: if the name was input/{group}/{id}
myFirestoreFunction({foo: ‘new’}, {params: {group: 'a', id: 123}})

La shell esegue sempre le funzioni Firestore con privilegi amministrativi, il che significa che simula un evento di creazione/aggiornamento/eliminazione come se fosse stato eseguito da un utente amministrativo.

Richiama le funzioni PubSub

Per le funzioni PubSub, inserisci il payload del messaggio in un'istanza Buffer e aggiungi facoltativamente attributi di dati come mostrato:

// invokes a function with the JSON message { hello: 'world' } and attributes { foo: 'bar' }
myPubsubFunction({data: new Buffer('{"hello":"world"}'), attributes: {foo: 'bar'}})

Richiama le funzioni di Analytics

Puoi richiamare una funzione Analytics senza dati eseguendo myAnalyticsFunction() nella shell. Per eseguire la funzione con dati di test, si consiglia di definire una variabile per i campi dati evento specifici di cui la funzione ha bisogno:

var data = {
  eventDim: [{
    // populates event.data.params
    params: {foo: {stringValue: 'bar'} },
    // Also valid:
    //   {intValue: '10'}, {floatValue: '1.0'}, {doubleValue: '1.0'}
    // populates event.data.name
    name: 'event_name',
    // populates event.data.logTime, specify in microseconds
    timestampMicros: Date.now() * 1000,
    // populates event.data.previousLogTime, specify in microseconds
    previousTimestampMicros: Date.now() * 1000,
    // populates event.data.reportingDate, specify in 'YYYYMMDD' format
    date: '20170930',
    // populates event.data.valueInUSD
    valueInUsd: 230
  }],
  userDim: userDim
};

myAnalyticsFunction(data);

Richiama le funzioni di archiviazione e autenticazione

Per le funzioni di archiviazione e autenticazione, richiama la funzione locale con i dati di test che desideri vedere all'interno della funzione. I dati del test devono seguire i formati dati corrispondenti:

Specifica solo i campi da cui dipende il tuo codice o nessuno se desideri solo eseguire la funzione.