O hook handle(): middleware para requisições
Intercepte cada requisição recebida, modifique event.locals e chame resolve().
O hook handle(): middleware para requisições é uma aula grátis de Sveltejs Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Sveltejs Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Sveltejs Academy inclui 4 aulas no total.
Ganchos do servidor
Os ganchos ficam em src/hooks.server.js. Eles são executados em cada solicitação ao servidor.
Exportar handle
Exporte uma função assíncrona chamada handle que recebe { event, resolve }.
export async function handle({ event, resolve }) {
// do stuff before
const res = await resolve(event);
// do stuff after
return res;
}Modificar o evento
Defina event.locals para disponibilizar dados ao carregamento e aos pontos de acesso.
event.locals.user = await getUser(event.cookies.get("sid"));Inspecionar ou substituir a resposta
Depois de resolve(event), você pode inspecionar ou modificar a resposta.
Registrar solicitações
Um gancho handle é um ótimo lugar para adicionar o registro de solicitações ou métricas de tempo.
Camada de autenticação
Leia os cookies, busque o usuário e anexe-o a locals. As páginas e as APIs poderão então confiar em locals.
Composição de ganchos
Várias responsabilidades podem ser encapsuladas em auxiliares e combinadas com sequence().
Cabeçalhos CORS
Adicione cabeçalhos CORS na saída para APIs que atendem a outras origens.
Desempenho
Os ganchos são executados em cada solicitação. Mantenha-os rápidos e seguros para uso assíncrono.
Ignorar recursos estáticos
O SvelteKit ignora os ganchos para arquivos estáticos. Seu gancho é executado apenas para as rotas da aplicação.
TypeScript
Use o tipo Handle de @sveltejs/kit para implementações tipadas.
Verificação rápida
Onde ficam os ganchos do servidor?
Recapitulação
O gancho handle em hooks.server.js intercepta cada solicitação. Preencha locals para o código subsequente.
Perguntas Frequentes
A aula “O hook handle(): middleware para requisições” é grátis?
Sim — o texto completo de “O hook handle(): middleware para requisições” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Sveltejs Academy, atualize para CoddyKit PRO. O curso de Sveltejs Academy inclui 4 aulas no total.
O que vou aprender em “O hook handle(): middleware para requisições”?
Intercepte cada requisição recebida, modifique event.locals e chame resolve(). Você pratica Sveltejs Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Sveltejs Academy?
Nenhuma experiência prévia é necessária. Sveltejs Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.
Quanto tempo leva a aula “O hook handle(): middleware para requisições”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Sveltejs Academy?
Sim. Cada aula de Sveltejs Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- O hook handle(): middleware para requisições
- handleError para registro de erros do servidor
- O hook init()
- Sequence() para compor hooks