Synchronisiert, asynchron und verspricht

Es ist wichtig, den Lebenszyklus einer Funktion zu verwalten, damit sie ordnungsgemäß aufgelöst wird. Wenn Sie Funktionen richtig beenden, können Sie übermäßige Kosten durch Funktionen vermeiden, die zu lange laufen oder in einer Endlosschleife laufen. Außerdem können Sie dafür sorgen, dass die Cloud Functions-Instanz, in der Ihre Funktion ausgeführt wird, nicht heruntergefahren wird, bevor die Funktion die Beendigungsbedingung oder den Beendigungsstatus erreicht hat.

Verwenden Sie die folgenden empfohlenen Ansätze, um den Lebenszyklus Ihrer Funktionen zu verwalten:

  • Lösen Sie Funktionen auf, die eine asynchrone Verarbeitung ausführen (auch als "Hintergrundfunktionen" bezeichnet), indem Sie ein JavaScript-Promise zurückgeben.
  • Beenden Sie HTTP-Funktionen mit res.redirect(), res.send() oder res.end().
  • Beenden Sie eine synchrone Funktion mit einer return;-Anweisung.

Asynchronen Code mit JavaScript-Promises vereinfachen

Versprechen sind eine moderne Alternative zu Callbacks für asynchronen Code. Ein Promise stellt einen Vorgang und den zukünftigen Wert dar, der zurückgegeben werden kann. Außerdem können Sie Fehler ähnlich wie bei try/catch in synchronem Code weitergeben. Informationen zu Versprechen im Firebase SDK finden Sie im Firebase-Blog und allgemeine Informationen zu Versprechen auf der MDN.

Funktionsweise von Versprechen mit Funktionen

Wenn Sie einer Funktion ein JavaScript-Versprechen zurückgeben, wird diese Funktion so lange ausgeführt, bis das Versprechen erfüllt oder abgelehnt wurde. Um anzugeben, dass eine Funktion ihre Arbeit erfolgreich abgeschlossen hat, sollte das Versprechen aufgelöst werden. Um einen Fehler anzuzeigen, sollte das Versprechen abgelehnt werden. Das bedeutet, dass Sie nur Fehler behandeln müssen, die Sie behandeln möchten.

Im folgenden Code wird ein Firebase Realtime Database ref verwendet und sein Wert auf "world!" festgelegt. Wenn Sie das Ergebnis von set zurückgeben, wird Ihre Funktion garantiert so lange ausgeführt, bis die asynchrone Arbeit zum Schreiben des Strings in die Datenbank vollständig abgeschlossen ist:

// Always change the value of "/hello" to "world!"
exports.hello = functions.database.ref('/hello').onWrite(event => {
  // set() returns a promise. We keep the function alive by returning it.
  return event.data.ref.set('world!').then(() => {
    console.log('Write succeeded!');
  });
});

Beispiele im Kontext

Die meisten unserer Cloud Functions Codebeispiele enthalten Beispiele für die korrekte Funktionsweise. Hier einige Beispiele für typische Fälle: