Zum Inhalt springen
Aurabase-Logo
Aurabasis

Edge Functions

Schreiben Sie eine Funktion in TypeScript, stellen Sie sie mit einem Befehl bereit und rufen Sie sie mit dem öffentlichen Schlüssel aus Ihrer App auf.

Erklärung4 Min. gelesenEbene AnfängerÜberarbeitet am 12.10.2026

Diese Seite wurde automatisch übersetzt. Maßgeblich ist die englische Version.

Eine Funktion, drei Möglichkeiten, sie auszulösen#

Eine Edge-Funktion ist ein Teil des Servercodes, den Aurabase für Ihr Projekt speichert und bei Bedarf ausführt. Sie lösen dieselbe Funktion auf drei Arten aus:

  • Ein Aufruf: Ihre App ruft aura.functions.invoke('name') auf oder sendet eine HTTP-Anfrage und erhält die Antwort.
  • Ein Job: Sie stellen einen Anruf in die Warteschlange, um ihn im Hintergrund mit einer Verzögerung und automatischen Wiederholungsversuchen auszuführen.
  • Ein Zeitplan: Ein Cron-Eintrag stellt einen Job zu den von Ihnen gewählten Zeiten in die Warteschlange.

Es gibt zwei Laufzeiten: Deno (TypeScript oder JavaScript, die Standardeinstellung) und WASM (eine kompilierte Rust-Binärdatei). Jeder Aufruf wird in einem eigenen isolierten Worker mit einem Speicherlimit und einer Zeitüberschreitung ausgeführt.

Der Vertrag einer Funktion#

Eine Deno-Funktion ist eine Datei, die Deno.serve aufruft. Es empfängt die von Ihnen beschriebene Anfrage und gibt ein Response zurück.

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

Ein export default wird nie aufgerufen. Eine Funktion ist eine -Einzeldatei: Relative Importe werden nicht ausgeliefert, verwenden Sie daher npm:- oder https://esm.sh/-Importe.

Finden Sie, was Sie brauchen#

Ich möchte…Lesen
Stellen Sie meine erste Funktion bereit und rufen Sie sie aufIhre erste Kantenfunktion
Rufen Sie eine Funktion auf und wissen Sie, wer anruftEine Funktion aufrufen
Behandeln Sie Fehler, Zeitüberschreitungen und WiederholungsversucheFehler, Zeitüberschreitungen und Wiederholungsversuche
Geben Sie Text, ein Bild oder HTML zurückRückgabetext, Binär und HTML
Geben Sie einer Funktion einen API-SchlüsselGeheimnisse und Umgebungsvariablen
Führen Sie die Arbeit im Hintergrund oder nach einem Zeitplan ausJobs, Cron und die Warteschlange für unzustellbare Nachrichten
Seien Sie gewarnt, wenn etwas schief gehtWarnungen
Lokal testen und über CI bereitstellenTesten und Bereitstellen von CI
Suchen Sie nach einem BefehlAura-Funktionen und Aura-Geheimnisse
Suchen Sie nach einer RouteHTTP-API-Referenz
Suchen Sie nach einer SDK-MethodeJavaScript SDK: Funktionen
Kennen Sie die Größen, Dauer und KontingenteLimits und Kontingente
Verstehen Sie, was während eines Anrufs passiertSo funktioniert ein Aufruf
Verstehen Sie, wer was tun kannSicherheitsmodell
Wechseln Sie zu SDK 0.6Upgrade auf SDK 0.6

Fakten, die Sie zuerst wissen sollten#

  • Nur der Aufruf einer Funktion funktioniert mit dem öffentlichen Schlüssel. Alles andere benötigt einen service_role-Schlüssel und gehört auf Ihren Server.
  • Anfragen und Antworten müssen unter etwa 256 KiB bleiben. Verwenden Sie Storage für größere Datenmengen.
  • Jeder Anruf ist zustandslos. Behalten Sie keine Daten zwischen Anrufen im Speicher.
  • Geheimnisse sind Variablen der Funktion, die mit aura secrets set oder PUT /env festgelegt werden. Die Verschlüsselung im Ruhezustand gilt nur für den Pfad PUT und nur, wenn die Bereitstellung über einen Schlüssel verfügt.
  • Was eine Funktion mit console.log schreibt, steht Ihnen noch nicht zur Verfügung. Die aktuellen Lücken finden Sie unter -Grenzwerte.
  • Es gibt eine Region und keinen Versionsverlauf: Behalten Sie Ihre Funktionen in Git.