Renderização do Next.js: estática, dinâmica e streaming
VPS Agêntica
30% off na sua VPS Agêntica nos 2 primeiros meses
A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.
Link de parceiro da Promovaweb.
Black Friday até 30/11
30%off
nos 2 primeiros meses do plano mensal da VPS
- Backup diário grátis para sempre
- Servidores em São Paulo no datacenter da Ascenty
- Datacenter Tier III manutenção sem parada
- Acesso root com disco SSD NVMe
- Réplica do backup em Ashburn, nos EUA
A renderização transforma componentes numa interface visível no navegador. No Next.js, partes da página podem ser preparadas antes da visita ou durante a requisição e chegar por streaming.
Sumário da página
Quando o conteúdo é preparado
Renderizar uma página significa produzir a interface que será apresentada. No Next.js, esse trabalho pode aproveitar conteúdo preparado antes da visita ou executar partes durante uma requisição. O comportamento depende das APIs usadas, das opções de cache e da versão do framework. Uma única aplicação pode combinar páginas públicas e telas personalizadas com necessidades diferentes.
A página pública de um produto pode reutilizar uma apresentação preparada anteriormente. O painel de compras de um cliente precisa considerar a sessão atual. Esses dois endereços podem compartilhar componentes visuais sem compartilhar a mesma política de produção e atualização. O projeto precisa entender qual informação é pública e qual depende da sessão da requisição.
O fato de o HTML vir do servidor não informa sozinho quando ele foi produzido. Ele pode ter sido gerado no build ou preparado durante a visita. Também pode combinar partes reutilizáveis com trechos calculados para aquela requisição, conforme os recursos configurados. Uma página pode abrir com conteúdo antigo apesar de receber uma resposta rápida, caso a representação tenha sido preparada antes de uma alteração.
Conteúdo estático e conteúdo por requisição
Na geração estática, o trabalho de renderização pode acontecer antes de você abrir o endereço. Isso permite reutilizar uma resposta para várias visitas. Um catálogo que aceita atualização posterior pode aproveitar esse mecanismo. A atualização precisa ter uma forma definida de substituir a resposta anterior quando o conteúdo de origem muda.
Na renderização dinâmica, a aplicação usa informações disponíveis na requisição para preparar a resposta. Cookies de sessão e parâmetros de busca podem participar desse trabalho. Um extrato de compras precisa apresentar somente os registros autorizados. O servidor não pode tratar a resposta personalizada como conteúdo público compartilhável entre todas as sessões.
As APIs e os comportamentos padrão de cache evoluem entre versões. A configuração Cache Components também altera a forma de combinar partes preparadas e trechos por requisição. Você precisa ler a documentação correspondente à aplicação instalada. Uma explicação sobre uma versão antiga não deve ser aplicada automaticamente a um projeto atual apenas porque o endereço da página é parecido.
Estrutura inicial
O layout e o conteúdo disponível formam a primeira resposta.
Espera delimitada
Suspense apresenta uma indicação de carregamento para o trecho pendente.
Conteúdo concluído
O servidor envia a parte pronta para completar a interface.
Streaming entrega partes da página
Sem delimitar uma consulta lenta, a renderização pode esperar até que ela termine para entregar a página. O streaming permite enviar partes prontas enquanto outras continuam sendo preparadas. A interface pode apresentar a estrutura do painel e uma indicação de espera na área do relatório. O relatório aparece quando o servidor conclui a consulta correspondente.
O React Suspense delimita essa espera e permite apresentar uma alternativa visual. No App Router, o arquivo loading oferece uma convenção para o estado de carregamento de um segmento. O projeto pode delimitar regiões mais específicas para separar o conteúdo que demora. A posição dessas regiões afeta quais partes chegam juntas e quais podem aparecer antes.
Um indicador de espera acompanha a consulta; o tempo dela continua o mesmo. A interface de espera permanece visível durante a consulta. A aplicação ainda precisa investigar consultas repetidas, serviços externos lentos e respostas excessivas. O tempo até o primeiro conteúdo e o tempo até a página ficar completa descrevem momentos diferentes da experiência.
A infraestrutura participa do streaming
O servidor pode enviar a resposta em partes, mas um proxy intermediário pode acumulá-las antes de encaminhar ao navegador. Nesse caso, o comportamento observado fica parecido com uma resposta única no final. A documentação de self-hosting orienta conferir o tratamento do streaming nos proxies utilizados entre a aplicação e o navegador que acessa a página.
A resposta HTTP também impõe limites. Depois que cabeçalhos e partes do conteúdo foram enviados, o status já está definido. Erros tardios e conteúdo ausente precisam ser considerados nessa composição. A interface deve apresentar a falha de forma compreensível mesmo quando o envio inicial já aconteceu.
Você consegue observar essa diferença no navegador pela chegada dos trechos e pelo estado da rede. Em produção, o comportamento precisa ser conferido pelo endereço público, atravessando os mesmos proxies e serviços usados nas visitas. O caminho completo de uma requisição real inclui esses serviços, além da porta do processo.
Renderização não substitui cache nem interatividade
O cache controla a reutilização de conteúdo ou resultados. A renderização controla a produção da interface. Uma consulta sem cache pode participar de uma página com outras partes reutilizáveis. Uma resposta dinâmica pode conter componentes que também precisam de JavaScript no navegador para reagir ao clique.
A divisão entre componentes complementa essa leitura. Server Components preparam a interface no servidor. Client Components oferecem estado e eventos. O streaming envia partes da resposta à medida que ficam prontas. A atualização correta de um preço depois de uma edição também depende da invalidação e das consultas feitas pela aplicação.
Ao revisar uma aplicação, identifique a versão, as opções habilitadas e o caminho real da resposta. Essa leitura permite explicar o que está sendo preparado, o que foi reutilizado e qual parte ainda espera uma consulta. As dúvidas sobre o tema estão nas perguntas frequentes.