Vai al contenuto
Logo Aurabase
aurabase

Edge Functions

Scrivi una funzione in TypeScript, distribuiscila con un comando e chiamala dalla tua app con la chiave pubblica.

Spiegazione4 min lettoLivello principianteRevisionato il 12 ott 2026

Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.

Una funzione, tre modi per attivarla#

Una funzione Edge è una parte di codice server che Aurabase archivia per il tuo progetto ed viene eseguita su richiesta. Puoi attivare la stessa funzione in tre modi:

  • Una chiamata: la tua app chiama aura.functions.invoke('name') o invia una richiesta HTTP e ottiene la risposta.
  • Un lavoro: accoda una chiamata da eseguire in background, con un ritardo e tentativi automatici.
  • Una pianificazione: una voce cron accoda un lavoro negli orari che scegli.

Sono disponibili due runtime: Deno (TypeScript o JavaScript, il valore predefinito) e WASM (un file binario compilato Rust). Ogni chiamata viene eseguita nel proprio lavoratore isolato con un limite di memoria e un timeout.

Il contratto di una funzione#

Una funzione Deno è un file che chiama Deno.serve. Riceve la richiesta che hai descritto e restituisce 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 non viene mai chiamato. Una funzione è un file singolo : le importazioni relative non vengono spedite, quindi utilizzare le importazioni npm: o https://esm.sh/.

Trova ciò di cui hai bisogno#

voglio…Leggi
Distribuisci e chiama la mia prima funzioneLa tua prima Edge Function
Chiama una funzione e scopri chi sta chiamandoInvoca una funzione
Gestire errori, timeout e tentativiErrori, timeout e tentativi
Restituisce testo, un'immagine o HTMLRestituisce testo, binario e HTML
Assegna a una funzione una chiave APISegreti e variabili di ambiente
Esegui il lavoro in background o secondo una pianificazioneJob, cron e coda dei messaggi non recapitati
Ricevi un avviso quando qualcosa va stortoAvvisi
Testare localmente e distribuire da CITesta e distribuisci da CI
Cerca un comandofunzioni e segreti dell'aura
Cerca un percorsoRiferimento API HTTP
Cerca un metodo SDKSDK JavaScript: funzioni
Conoscere le dimensioni, le durate e le quoteLimiti e quote
Comprendi cosa succede durante una chiamataCome funziona un'invocazione
Capire chi può fare cosaModello di sicurezza
Passa all'SDK 0.6Aggiorna all'SDK 0.6

Fatti da sapere prima#

  • Solo invocando una funzione funziona con la chiave pubblica. Tutto il resto necessita di una chiave service_role e appartiene al tuo server.
  • Le richieste e le risposte devono rimanere al di sotto di circa 256 KiB. Utilizza Spazio di archiviazione per dati più grandi.
  • Ogni chiamata è apolide. Non conservare i dati in memoria tra una chiamata e l'altra.
  • I segreti sono variabili della funzione, impostate con aura secrets set o PUT /env. La crittografia dei dati inattivi si applica solo al percorso PUT e solo quando la distribuzione dispone di una chiave.
  • Ciò che scrive una funzione con console.log non è ancora disponibile per te. Vedi limiti per gli attuali gap.
  • C'è una regione e nessuna cronologia delle versioni: mantieni le tue funzioni in Git.