Ir para o conteúdo
Aura Logo
aurabase

Edge Functions

Escreva uma função em TypeScript, implante-a com um comando e chame-a do seu aplicativo com a chave pública.

Explicação4 min lidoNível inicianteRevisado em 12 de out. de 2026

Esta página foi traduzida automaticamente. A versão em inglês é oficial.

Uma função, três maneiras de acioná-la#

Uma Edge Function é um pedaço de código de servidor que Aurabase armazena para o seu projeto e é executado sob demanda. Você aciona a mesma função de três maneiras:

  • Uma chamada: seu aplicativo chama aura.functions.invoke('name') ou envia uma solicitação HTTP e obtém a resposta.
  • Um trabalho: você enfileira uma chamada para ser executada em segundo plano, com atraso e novas tentativas automáticas.
  • Um agendamento: uma entrada cron enfileira um trabalho nos horários que você escolher.

Existem dois tempos de execução: Deno (TypeScript ou JavaScript, o padrão) e WASM (um binário Rust compilado). Cada chamada é executada em seu próprio trabalhador isolado com limite de memória e tempo limite.

O contrato de uma função#

Uma função Deno é um arquivo que chama Deno.serve. Ele recebe a solicitação que você descreveu e retorna um Response.

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

Um export default nunca é chamado. Uma função é um arquivo único : importações relativas não são enviadas, então use importações npm: ou https://esm.sh/.

Encontre o que você precisa#

Eu quero…Leia
Implantar e chamar minha primeira funçãoSua primeira função de borda
Chame uma função e saiba quem está ligandoInvocar uma função
Lidar com falhas, tempos limite e novas tentativasErros, tempos limites e novas tentativas
Retornar texto, uma imagem ou HTMLRetorna texto, binário e HTML
Dê a uma função uma chave de APISegredos e variáveis de ambiente
Execute o trabalho em segundo plano ou de acordo com uma programaçãoJobs, cron e fila de mensagens mortas
Seja avisado quando algo der erradoAlertas
Teste localmente e implante a partir do CITeste e implante do CI
Procure um comandofunções e segredos da aura
Procure uma rotaReferência da API HTTP
Procure um método SDKSDK JavaScript: funções
Conheça os tamanhos, durações e cotasLimites e cotas
Entenda o que acontece durante uma chamadaComo funciona uma invocação
Entenda quem pode fazer o quêModelo de segurança
Migrar para o SDK 0.6Atualizar para SDK 0.6

Fatos para saber primeiro#

  • Somente invocando uma função funciona com a chave pública. Todo o resto precisa de uma chave service_role e pertence ao seu servidor.
  • As solicitações e respostas devem ficar abaixo de cerca de 256 KiB. Use o armazenamento para dados maiores.
  • Cada chamada é sem estado. Não guarde dados na memória entre chamadas.
  • Os segredos são variáveis da função, definidas com aura secrets set ou PUT /env. A criptografia em repouso se aplica somente no caminho PUT e somente quando a implantação possui uma chave.
  • O que uma função escreve com console.log ainda não está disponível para você. Consulte limites para as lacunas atuais.
  • Há uma região e nenhum histórico de versão: mantenha suas funções no Git.