Pular para o conteúdo principal
Você pode executar scripts autônomos que interagem com seu app Base44 usando o comando base44 exec. Scripts autônomos:
  • Não requerem configuração ou gerenciamento de token. Um cliente SDK pré-autenticado está disponível como uma variável global base44.
  • São executados localmente usando Deno e rodam contra o app implantado vinculado ao diretório atual do seu projeto.
  • Têm acesso total às entidades, funções e integrações do seu app através do SDK.
  • Rodam com as permissões do seu usuário, não com acesso de service-role.

​
Pré-requisitos

Você precisa instalar o Deno para executar scripts com exec.

​
Casos de uso

O comando exec dá acesso direto ao SDK completo a partir de scripts autônomos. Casos de uso comuns incluem:
  • Migrações de dados: Reformule, preencha ou transforme registros de entidade em lote.
  • Scripts de seed: Popule seu app com dados de amostra para desenvolvimento ou staging.
  • Consultas ad-hoc: Inspecione ou depure rapidamente os dados do seu app a partir do terminal.
  • Tarefas de IA e LLM: Execute operações de IA pontuais como sumarizar dados, gerar conteúdo ou enriquecer registros.
  • Teste de funções: Invoque funções de backend com dados reais para testá-las fora do app.
  • Automação: Execute scripts em pipelines CI ou jobs agendados para realizar tarefas de manutenção.

​
Começar

Para começar, crie um arquivo de script e direcione-o (pipe) para exec.
1

Escreva um script

Crie um arquivo de script que use a variável global base44. Nenhum import ou configuração é necessário. Por exemplo:
// list-tasks.ts
const tasks = await base44.entities.Task.list();
console.log(`Found ${tasks.length} tasks:`);
for (const task of tasks) {
  console.log(`  - ${task.title} (${task.status})`);
}
2

Execute-o

Execute o script a partir do diretório do seu projeto:
cat ./list-tasks.ts | base44 exec
A CLI autentica como seu usuário atual, inicia um processo Deno e executa seu script com o cliente SDK base44 pronto para uso.
Para one-liners rápidos, direcione (pipe) código inline diretamente:
echo "console.log(await base44.entities.Task.list())" | base44 exec

​
Veja também

  • exec: Referência completa do comando
  • Funções de backend: Escreva funções serverless que rodam na infraestrutura da Base44
  • SDK JavaScript: Referência do SDK para entidades, auth, functions e integrações
Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a versão em inglês.