Die Cloud Functions-Shell bietet eine interaktive Shell zum Aufrufen von Funktionen mit Testdaten. Die Shell unterstützt alle Triggertypen.
Administratoranmeldedaten einrichten (optional)
Wenn Ihre Funktionstests über das Firebase Admin SDK mit Google APIs oder anderen Firebase APIs interagieren sollen, müssen Sie möglicherweise Administratoranmeldedaten einrichten.
- Für Cloud Firestore- und Realtime Database-Trigger sind bereits ausreichende Anmeldedaten vorhanden. Eine zusätzliche Einrichtung ist nicht erforderlich.
- Für alle anderen APIs, einschließlich Firebase APIs wie Authentication und FCM oder Google APIs wie Cloud Translation oder Cloud Speech, sind die in diesem Abschnitt beschriebenen Einrichtungsschritte erforderlich. Das gilt unabhängig davon, ob Sie die Cloud Functions-Shell oder
firebase emulators:start
verwenden.
So richten Sie Administratoranmeldedaten für emulierte Funktionen ein:
- Öffnen Sie den Bereich Dienstkonten in der Google Cloud-Konsole.
- Achten Sie darauf, dass App Engine Standarddienstkonto ausgewählt ist, und wählen Sie im Optionsmenü rechts Schlüssel erstellen aus.
- Wählen Sie auf der nächsten Seite als Schlüsseltyp JSON aus und klicken Sie auf Erstellen.
Legen Sie Ihre Google-Standardanmeldedaten so fest, dass sie auf den heruntergeladenen Schlüssel verweisen:
Unix
export GOOGLE_APPLICATION_CREDENTIALS="path/to/key.json" firebase functions:shell
Windows
set GOOGLE_APPLICATION_CREDENTIALS=path\to\key.json firebase functions:shell
Nachdem Sie diese Schritte ausgeführt haben, können Ihre Funktionstests über das Admin SDK auf Firebase- und Google APIs zugreifen. Beim Testen eines Authentication-Triggers könnte die emulierte Funktion beispielsweise admin.auth().getUserByEmail(email)
aufrufen.
Funktionen mit einer Cloud Functions-Shell bereitstellen
Die Cloud Functions-Shell emuliert alle Arten von Funktionstriggern mit einer interaktiven Shell, über die die Funktionen mit Testdaten aufgerufen werden können. Die Optionen variieren je nach Funktionstyp, das grundlegende Format ist jedoch:
myFunctionName(data, options)
Der Parameter data
ist für Realtime Database-, Cloud Firestore- und Pub/Sub-Trigger erforderlich und für alle anderen Funktionstypen optional.
Außerdem ist der optionale Parameter options
nur für Realtime Database- und Cloud Firestore-Funktionen gültig.
Optional können Sie Testdaten aus einer lokalen Datei laden. Speichern Sie dazu die Datei als Variable und rufen Sie eine Funktion damit auf:
var data = require('./path/to/testData.json');
myFunction(data);
Cloud Functions-Shell installieren und konfigurieren
Für die Verwendung dieser Funktion muss firebase-tools
mindestens Version 3.11.0 und das firebase-functions
SDK mindestens Version 0.6.2 haben. Wenn Sie beide aktualisieren möchten, führen Sie die folgenden Befehle im Verzeichnis functions/
Ihres Projekts aus:
npm install --save firebase-functions@latest
npm install -g firebase-tools
Wenn Sie Konfigurationsvariablen für benutzerdefinierte Funktionen verwenden, führen Sie zuerst den Befehl aus, um die benutzerdefinierte Konfiguration in Ihrer lokalen Umgebung abzurufen (führen Sie ihn im Verzeichnis functions
aus):
firebase functions:config:get > .runtimeconfig.json # If using Windows PowerShell, replace the above with: # firebase functions:config:get | ac .runtimeconfig.json
Führen Sie abschließend die Shell mit dem folgenden Befehl aus:
firebase functions:shell
HTTPS-Funktionen aufrufen
Für das Aufrufen von HTTPS-Funktionen in der Shell gilt dieselbe Verwendung wie für das NPM-Modul request
. Ersetzen Sie jedoch request
durch den Namen der Funktion, die Sie emulieren möchten. Beispiel:
# 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' })
HTTPS-aufrufbare Funktionen aufrufen
Wenn Sie HTTPS-aufrufbare Funktionen lokal aufrufen, müssen Sie entsprechende Testdaten angeben.
# invoke
myCallableFunction('test data')
myCallableFunction({'foo': 'bar'})
Optional können Sie als zweiten Parameter eine Firebase-Instance-ID-token
übergeben. Dies muss ein String sein.
# invoke with FCM registration token
myCallableFunction('test data', {instanceIdToken: 'sample token'})
Die Emulation von context.auth
ist derzeit nicht verfügbar.
Realtime Database-Funktionen aufrufen
Wenn Sie Realtime Database-Funktionen lokal ausführen, müssen Sie entsprechende Testdaten angeben. Das bedeutet in der Regel, dass Sie neue Testdaten für onCreate
-Vorgänge, alte/entfernte Daten für onDelete
-Vorgänge und sowohl für onUpdate
- als auch für onWrite
-Funktionen bereitstellen müssen:
# invoke onCreate function
myDatabaseFunction('new_data')
# invoke onDelete function
myDatabaseFunction('old_data')
# invoke onUpdate or onWrite function
myDatabaseFunction({before: 'old_data', after: 'new_data' })
Zusätzlich zu den before/after
-Optionen bietet die Shell die Option params
, um Platzhalter in einem Pfad zu simulieren:
# mock wildcards in path, for example: if the path was input/{group}/{id}
myDatabaseFunction('data', {params: {group: 'a', id: 123}})
Standardmäßig führt die Shell Realtime Database-Funktionen mit Administratorberechtigungen (Dienstkonto) aus. Mit der Option auth
können Sie Funktionen stattdessen als bestimmter Endnutzer oder als nicht authentifizierter Nutzer ausführen:
# to mock unauthenticated user
myDatabaseFunction('data', {authMode: 'USER'})
# to mock end user
myDatabaseFunction('data', {auth: {uid: 'abcd'}})
Firestore-Funktionen aufrufen
Wenn Sie Firestore-Funktionen lokal ausführen, müssen Sie entsprechende Testdaten angeben. Das bedeutet in der Regel, dass Sie neue Testdaten für onCreate
-Vorgänge, alte/entfernte Daten für onDelete
-Vorgänge und beides für onUpdate
- oder onWrite
-Funktionen bereitstellen müssen. Firestore-Daten müssen Schlüssel/Wert-Paare sein. Weitere Informationen finden Sie unter Unterstützte Datentypen.
# invoke onCreate function
myFirestoreFunction({foo: ‘new’})
# invoke onDelete function
myFirestoreFunction({foo: ‘old’})
# invoke onUpdate or onWrite function
myFirestoreFunction({before: {foo: ‘old’}, after: {foo: ‘new’} })
Zusätzlich zu den before/after
-Feldern des data
-Objekts können Sie die params
-Felder des options
-Objekts verwenden, um Platzhalter in einem Dokumentnamen zu simulieren:
# mock wildcards in document name, for example: if the name was input/{group}/{id}
myFirestoreFunction({foo: ‘new’}, {params: {group: 'a', id: 123}})
Die Shell führt Firestore-Funktionen immer mit Administratorberechtigungen aus. Das bedeutet, dass ein Create-/Update-/Delete-Ereignis so simuliert wird, als wäre es von einem Administrator ausgeführt worden.
PubSub-Funktionen aufrufen
Fügen Sie bei Pub/Sub-Funktionen die Nachrichtenn-Nutzlast in eine Buffer
-Instanz ein und fügen Sie optional Datenattribute hinzu, wie hier gezeigt:
// invokes a function with the JSON message { hello: 'world' } and attributes { foo: 'bar' }
myPubsubFunction({data: new Buffer('{"hello":"world"}'), attributes: {foo: 'bar'}})
Analytics-Funktionen aufrufen
Wenn Sie eine Analytics-Funktion ohne Daten aufrufen möchten, führen Sie myAnalyticsFunction()
in der Shell aus.
Wenn Sie die Funktion mit Testdaten ausführen möchten, sollten Sie eine Variable für die einzelnen Ereignisdatenfelder definieren, die für Ihre Funktion erforderlich sind:
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);
Speicher- und Authentifizierungsfunktionen aufrufen
Rufen Sie für Storage- und Auth-Funktionen die lokale Funktion mit den Testdaten auf, die Sie in der Funktion sehen möchten. Ihre Testdaten müssen den entsprechenden Datenformaten entsprechen:
- Für Cloud Storage:
ObjectMetadata
- Für Authentication:
UserRecord
Geben Sie nur die Felder an, von denen Ihr Code abhängt, oder gar keine, wenn Sie die Funktion nur ausführen möchten.