Server Components e interatividade no Next.js
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
Server Components executam a preparação da interface no servidor e não enviam sua implementação ao navegador. Client Components acrescentam estado, eventos e APIs do navegador às partes interativas.
Sumário da página
Duas partes da mesma interface
No App Router, páginas e layouts são Server Components por padrão. Eles podem executar operações assíncronas para consultar uma API ou um banco antes de produzir a interface. O código que faz essa consulta não precisa integrar o JavaScript entregue ao navegador. O resultado da consulta, porém, pode fazer parte da resposta visível e precisa ser selecionado com cuidado.
Um catálogo oferece um exemplo concreto. O servidor consulta o nome, o preço e a disponibilidade de um produto. O navegador recebe essas informações para apresentar a página. A credencial usada na consulta continua no servidor, desde que não seja incluída na resposta ou num módulo enviado ao cliente. A aplicação também precisa conferir quais registros aquela sessão pode consultar.
Um Client Component participa da mesma tela quando existe interação. Um seletor de quantidade usa estado. Um botão de favoritos responde a um evento. Uma integração com armazenamento do navegador usa APIs que só existem naquele ambiente. A diretiva use client declara a entrada dessa parte interativa no conjunto de módulos do cliente.
A divisão segue os módulos importados
A diretiva de cliente delimita quais módulos participam da execução no navegador. Os arquivos importados por essa entrada participam do conjunto de código do cliente. Colocar a diretiva num componente muito alto pode enviar JavaScript de partes que poderiam permanecer no servidor. Um botão isolado costuma exigir uma área menor de interatividade do que um layout inteiro.
Um componente exibido dentro de uma parte interativa pode ser preparado no servidor e chegar pronto como children ou outra propriedade apropriada. O servidor monta esse conteúdo e a parte interativa define como apresentá-lo. Importar diretamente uma implementação de servidor dentro de um módulo cliente é outro assunto.
As propriedades enviadas do servidor ao componente cliente precisam ser serializáveis pelos mecanismos do React. Você não envia qualquer objeto de conexão, função interna ou instância de biblioteca como se fosse um texto. A representação da interface e as referências especiais suportadas pelo framework têm contratos próprios. Uma integração precisa respeitar esses contratos para a renderização funcionar.
Servidor
Consulta o produto autorizado e prepara a interface.
Resposta
Entrega HTML e a representação dos componentes.
Cliente
Conecta eventos ao seletor de quantidade e ao botão.
Client Component também pode receber HTML inicial
A palavra cliente descreve a capacidade de executar interatividade no navegador. Na primeira visita, o Next.js pode usar os componentes para produzir HTML inicial no servidor e entregar a apresentação antes de habilitar os eventos.
A hidratação conecta o JavaScript à estrutura inicial dos componentes interativos. Até essa ligação terminar, um controle pode aparecer visualmente sem ter seu comportamento completo. Por isso, o projeto precisa observar o que acontece durante a primeira carga e com conexões lentas. O botão visível indica que o HTML chegou; o clique começa a ser tratado quando a hidratação termina.
Nas navegações seguintes, o framework pode atualizar a interface com a representação recebida do servidor e preservar partes compartilhadas. O resultado depende da rota, do cache e dos componentes envolvidos. Você acompanha a troca de página observando tanto a resposta da rede quanto os estados que permanecem na tela depois da navegação.
Segredos e informações pessoais
A possibilidade de consultar um banco no servidor é útil para manter credenciais fora do conjunto de código do cliente. Isso não equivale a permissão automática para ler qualquer registro. Uma sessão pode estar autenticada e ainda não ter acesso à compra solicitada. A consulta precisa verificar a relação entre a identidade e o registro.
O mesmo cuidado vale para o objeto enviado à interface. Uma consulta pode retornar campos internos, observações privadas ou tokens que o componente visual não precisa. Selecionar somente os campos necessários limita a informação entregue à sessão. Ocultar um campo com CSS esconde apenas a apresentação: o conteúdo continua na resposta enviada ao navegador.
Módulos exclusivos do servidor podem usar as proteções de importação apresentadas pela documentação. Elas ajudam a detectar o uso incorreto de uma implementação numa parte cliente. Ainda assim, um teste de autorização e a inspeção da resposta continuam necessários. A separação de ambientes protege a implementação, enquanto a seleção da resposta protege a informação que sai dela.
Catálogo com consultas e filtros separados
Uma página de produto pode manter a consulta no servidor e usar um componente cliente pequeno para quantidade e favoritos. Um painel pode preparar a lista de compras no servidor e deixar ordenação local numa tabela interativa. A composição acompanha o comportamento real da tela, evitando levar uma biblioteca inteira ao navegador apenas para apresentar texto.
Uma interface muito interativa pode continuar exigindo bastante JavaScript. Gráficos, editores e controles complexos têm processamento próprio. Server Components reduzem o JavaScript de apresentação; o trabalho desses controles continua no navegador. Você identifica o conjunto enviado ao cliente e observa o custo de cada parte antes de atribuir toda a experiência ao framework.
A renderização define quando a resposta é preparada e como ela chega. A divisão servidor e cliente define onde cada componente pode executar suas funções. São dimensões relacionadas, com efeitos diferentes sobre a aplicação. As dúvidas sobre as duas partes estão nas perguntas frequentes.