Retornando respostas JSON
Use o auxiliar json() para retornar JSON estruturado com o tipo de conteúdo correto.
Retornando respostas JSON é uma aula grátis de Sveltejs Academy no CoddyKit. Esta é a aula 3 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.
O auxiliar json
Use json() de @sveltejs/kit para retornar JSON com os cabeçalhos adequados.
import { json } from "@sveltejs/kit";
return json({ ok: true });Códigos de status
Passe um segundo objeto de opções para controlar o status e os cabeçalhos adicionais.
return json({ ok: false }, { status: 400 });Cabeçalhos personalizados
Adicione controle de cache, CORS ou qualquer outra coisa por meio de cabeçalhos.
return json(data, { headers: { "cache-control": "max-age=60" } });Resposta manual
Você também pode retornar um objeto Response bruto se precisar de um corpo que não seja JSON.
return new Response("plain text", { headers: { "content-type": "text/plain" } });Corpo com segurança de tipos
Com TypeScript, você pode tipar o corpo da resposta para facilitar o uso pelos consumidores.
Transmissão de JSON
Para coleções enormes, transmita partes de JSON delimitado por quebras de linha.
Paginação
Inclua nextCursor ou metadados de página nas respostas para obter uma paginação organizada.
Formato do erro
Adote uma estrutura consistente para os erros, como { error: { code, message } }, para proporcionar clareza.
Cache com ETag
Defina cabeçalhos ETag em respostas estáveis para habilitar o cache no nível HTTP.
Negociação de conteúdo
Use o cabeçalho Accept para alternar entre JSON e outros formatos.
Boa prática
Sempre retorne JSON nas APIs, até mesmo em caso de erros. Os clientes esperam um formato consistente.
Verificação rápida
Como retornar JSON com os cabeçalhos adequados?
Recapitulação
Use json() para obter respostas JSON práticas, com status e cabeçalhos. Retorne um Response bruto para conteúdo que não seja JSON.
Perguntas Frequentes
A aula “Retornando respostas JSON” é grátis?
Sim — o texto completo de “Retornando respostas JSON” é 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 “Retornando respostas JSON”?
Use o auxiliar json() para retornar JSON estruturado com o tipo de conteúdo correto. 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 3 de 4.
Quanto tempo leva a aula “Retornando respostas JSON”?
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
- +server.js: GET POST PUT DELETE
- Request e RequestEvent
- Retornando respostas JSON
- Transmissão com ReadableStream