https namespace

Les fonctions

Fonction Description
onCall (gestionnaire) Déclare une méthode appelable que les clients peuvent appeler à l'aide d'un SDK Firebase.
onRequest (gestionnaire) Gérez les requêtes HTTP.

Des classes

Classe Description
HttpsErreur Erreur explicite qui peut être générée par un gestionnaire pour envoyer une erreur au client qui a appelé la fonction.

Interfaces

Interface Description
CallableContext L'interface pour les métadonnées de l'API telles que transmises au gestionnaire.
Demande Une demande expresse avec la représentation au format filaire du corps de la demande.

Tapez les alias

Tapez l'alias Description
FonctionsErrorCode L'ensemble des codes d'état des fonctions Firebase. Les codes sont les mêmes que ceux exposés par gRPC .

https.onCall()

Déclare une méthode appelable que les clients peuvent appeler à l'aide d'un SDK Firebase.

Signature:

export declare function onCall(handler: (data: any, context: CallableContext) => any | Promise<any>): HttpsFunction & Runnable<any>;

Paramètres

Paramètre Taper Description
gestionnaire (données : toutes, contexte : CallableContext ) => n'importe quel | Promesse<n'importe lequel> Une méthode qui prend des données et un contexte et renvoie une valeur.

Retour:

Fonction Https et exécutable <n'importe lequel>

https.onRequest()

Gérez les requêtes HTTP.

Signature:

export declare function onRequest(handler: (req: Request, resp: express.Response) => void | Promise<void>): HttpsFunction;

Paramètres

Paramètre Taper Description
gestionnaire (req : Requête, resp : express.Response) => void | Promesse<vide> Une fonction qui prend un objet de requête et de réponse, même signature qu'une application Express.

Retour:

Fonction HTTPS

https.FunctionsErrorCode

L'ensemble des codes d'état des fonctions Firebase. Les codes sont les mêmes que ceux exposés par gRPC .

Valeurs possibles:

  • cancelled : L'opération a été annulée (généralement par l'appelant).

  • unknown : Erreur inconnue ou erreur provenant d'un domaine d'erreur différent.

  • invalid-argument : Le client a spécifié un argument non valide. Notez que cela diffère de failed-precondition . invalid-argument indique les arguments qui posent problème quel que soit l'état du système (par exemple un nom de champ invalide).

  • deadline-exceeded : Délai expiré avant la fin de l'opération. Pour les opérations qui modifient l'état du système, cette erreur peut être renvoyée même si l'opération s'est terminée avec succès. Par exemple, une réponse réussie d'un serveur aurait pu être retardée suffisamment longtemps pour que le délai expire.

  • not-found : Certains documents demandés n'ont pas été trouvés.

  • already-exists : Un document que nous avons tenté de créer existe déjà.

  • permission-denied : L'appelant n'est pas autorisé à exécuter l'opération spécifiée.

  • resource-exhausted : Une ressource a été épuisée, peut-être un quota par utilisateur, ou peut-être que l'ensemble du système de fichiers manque d'espace.

  • failed-precondition : L'opération a été rejetée car le système n'est pas dans un état requis pour l'exécution de l'opération.

  • aborted : L'opération a été interrompue, généralement en raison d'un problème de concurrence tel qu'un abandon de transaction, etc.

  • out-of-range : Une opération a été tentée au-delà de la plage valide.

  • unimplemented : L'opération n'est pas implémentée ou n'est pas prise en charge/activée.

  • internal : Erreurs internes. Cela signifie que certains invariants attendus par le système sous-jacent ont été brisés. Si vous voyez l’une de ces erreurs, quelque chose est vraiment cassé.

  • unavailable : Le service est actuellement indisponible. Il s'agit très probablement d'une condition transitoire qui peut être corrigée en réessayant avec une interruption.

  • data-loss : Perte ou corruption de données irrécupérables.

  • unauthenticated : la demande ne dispose pas d'informations d'authentification valides pour l'opération.

Signature:

export type FunctionsErrorCode = "ok" | "cancelled" | "unknown" | "invalid-argument" | "deadline-exceeded" | "not-found" | "already-exists" | "permission-denied" | "resource-exhausted" | "failed-precondition" | "aborted" | "out-of-range" | "unimplemented" | "internal" | "unavailable" | "data-loss" | "unauthenticated";