Aller au contenu
Logo Aurabase
aurabase

Edge Functions

Écrivez une fonction dans TypeScript, déployez-la avec une seule commande et appelez-la depuis votre application avec la clé publique.

Explication4 min de lectureNiveau débutantRévisé le 12 oct. 2026

Cette page a été traduite automatiquement. La version anglaise fait foi.

Une fonction, trois façons de la déclencher#

Une fonction Edge est un morceau de code serveur que Aurabase stocke pour votre projet et s'exécute à la demande. Vous déclenchez la même fonction de trois manières :

  • Un appel: votre application appelle aura.functions.invoke('name'), ou envoie une requête HTTP, et obtient la réponse.
  • Un job: vous mettez en file d'attente un appel à exécuter en arrière-plan, avec un délai et des tentatives automatiques.
  • Un planning: une entrée cron met un travail en file d'attente aux heures que vous choisissez.

Il existe deux environnements d'exécution : Deno (TypeScript ou JavaScript, la valeur par défaut) et WASM (un binaire Rust compilé). Chaque appel s'exécute dans son propre travailleur isolé avec une limite de mémoire et un délai d'attente.

Le contrat d'une fonction#

Une fonction Deno est un fichier qui appelle Deno.serve. Il reçoit la demande que vous avez décrite et renvoie un Response.

aurabase/functions/hello/index.tstypescript
Deno.serve(async (req) => {
  const { name = 'world' } = await req.json().catch(() => ({}))
  return Response.json({ greeting: `Hello, ${name}!` })
})

Un export default n'est jamais appelé. Une fonction est un fichier unique : les importations relatives ne sont pas expédiées, utilisez donc les importations npm: ou https://esm.sh/.

Trouvez ce dont vous avez besoin#

Je veux…Lire
Déployer et appeler ma première fonctionVotre première fonction Edge
Appeler une fonction et savoir qui appelleInvoquer une fonction
Gérer les échecs, les délais d'attente et les tentativesErreurs, délais d'attente et tentatives
Renvoie du texte, une image ou du HTMLRenvoie du texte, binaire et HTML
Donner à une fonction une clé APISecrets et variables d'environnement
Exécutez le travail en arrière-plan ou selon un planningTravaux, cron et file d'attente de lettres mortes
Soyez averti lorsque quelque chose ne va pasAlertes
Testez localement et déployez à partir de CITest et déploiement à partir de CI
Rechercher une commandefonctions de l'aura et secrets de l'aura
Rechercher un itinéraireRéférence API HTTP
Rechercher une méthode SDKSDK JavaScript : fonctions
Connaître les tailles, les durées et les quotasLimites et quotas
Comprendre ce qui se passe lors d'un appelComment fonctionne une invocation
Comprendre qui peut faire quoiModèle de sécurité
Passer au SDK 0.6Mise à niveau vers le SDK 0.6

Faits à savoir en premier#

  • Seul invoquant une fonction fonctionne avec la clé publique. Tout le reste nécessite une clé service_role et appartient à votre serveur.
  • Les demandes et les réponses doivent rester inférieures à environ 256 Ko. Utilisez le stockage pour des données plus volumineuses.
  • Chaque appel est apatride. Ne conservez pas de données en mémoire entre les appels.
  • Les secrets sont des variables de la fonction, définies avec aura secrets set ou PUT /env. Le chiffrement au repos s'applique uniquement sur le chemin PUT et uniquement lorsque le déploiement dispose d'une clé.
  • Ce qu'une fonction écrit avec console.log ne vous est pas encore disponible. Voir les limites Limits and quotas pour les écarts actuels.
  • Il n'y a qu'une seule région et pas d'historique des versions : conservez vos fonctions dans Git.