Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é Componente de servidor?

    Um componente de servidor executa no servidor e não envia a implementação ao navegador. Ele prepara a interface e entrega o resultado ao cliente.

    Também chamado de: Server Component, React Server Component, RSC

    StayCloudVPS 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.

    Aproveitar a Black Friday

    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

    Um componente de servidor é uma parte da interface React que executa apenas no servidor. O código dele não é enviado ao navegador. O servidor prepara o resultado e o entrega junto da resposta, e a interface aparece sem carregar aquela implementação no cliente.

    No App Router do Next.js, páginas e layouts são componentes de servidor por padrão. A diretiva use client marca a entrada de uma parte que precisa executar no navegador. A divisão acompanha o comportamento da tela, não o tamanho do arquivo.

    O que o componente pode fazer

    Um componente de servidor pode ser assíncrono e consultar uma API ou um banco antes de montar a interface. Ele não usa estado, efeitos ou APIs do navegador. O código da consulta fica no servidor, o que evita enviar credenciais ao cliente.

    O exemplo abaixo prepara uma lista de produtos no servidor:

    export default async function Catalogo() {
    const produtos = await listarProdutos()
    return (
    <ul>
    {produtos.map((produto) => (
    <li key={produto.id}>{produto.nome}</li>
    ))}
    </ul>
    )
    }

    O navegador recebe a lista renderizada. A função listarProdutos e a credencial usada por ela permanecem no servidor. O resultado, porém, faz parte da resposta: os nomes enviados ficam visíveis para os visitantes que abrirem a página.

    Onde entra o componente cliente

    Um seletor de quantidade, um botão de favoritos ou um campo com validação instantânea precisam de estado e eventos. Esses trechos recebem a diretiva use client e também integram o JavaScript do navegador. O componente de servidor entrega as informações iniciais por propriedades.

    'use client'
    import { useState } from 'react'
    export function Quantidade({ inicial }) {
    const [valor, setValor] = useState(inicial)
    return (
    <button onClick={() => setValor(valor + 1)}>
    {valor}
    </button>
    )
    }

    As propriedades enviadas precisam ser serializáveis. Um objeto de conexão com o banco, uma função interna ou uma instância de biblioteca não atravessa esse limite. O componente de servidor seleciona os campos que a parte interativa precisa e monta um objeto simples.

    A diretiva no lugar certo

    A diretiva use client marca um módulo e os módulos que ele importa. Colocá-la no topo de um layout envia ao navegador código em quantidade acima do necessário. Um botão isolado costuma ser suficiente para concentrar a interatividade.

    A composição com children permite manter a consulta no servidor e a moldura interativa no cliente. O servidor prepara o conteúdo, e o componente cliente define onde ele aparece. Essa divisão reduz o JavaScript sem tirar a interação.

    Segurança não é automática

    O fato de o código executar no servidor não libera a leitura de qualquer registro. A consulta precisa conferir se a sessão pode acessar aquela fatura ou aquele perfil. A separação de ambientes protege a implementação, e a autorização protege a informação.

    A resposta também precisa ser seletiva. Um componente que devolve o registro inteiro pode expor campos internos que a tela não mostra. Ocultar com CSS não remove o valor do HTML. A seleção das colunas acompanha o que a interface realmente precisa.

    Relação com a renderização

    A renderização define o momento de preparação da resposta, com renderização sob demanda, cache ou geração prévia. O componente de servidor define onde o código executa. São duas dimensões diferentes, e a rota escolhe a combinação conforme o framework.

    No Next.js, a primeira visita pode gerar HTML no servidor e depois hidratar as partes interativas. O componente de servidor não participa dessa hidratação, porque a implementação dele não chegou ao navegador.

    Dúvidas frequentes

    Perguntas frequentes sobre Componente de servidor

    Componente de servidor é a mesma coisa que renderização no servidor?
    Não. A renderização no servidor produz o HTML da página. O componente de servidor define um tipo de componente que executa apenas no servidor e não integra o JavaScript enviado ao navegador. Os dois conceitos se combinam no Next.js.
    Posso usar useState num componente de servidor?
    Não. Estado, efeitos e APIs do navegador pertencem ao componente cliente. Quando a interface precisa de interação, uma parte marcada com use client assume esse trecho e recebe as informações por propriedades.
    O código do componente de servidor pode conter segredo?
    A implementação não vai para o navegador, mas os valores enviados como propriedades e o conteúdo renderizado fazem parte da resposta. Credenciais ficam no servidor; a seleção dos campos e a autorização da consulta continuam necessárias.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    Ao revisar uma aplicação no App Router, você separa o que consulta o banco no servidor do que precisa de estado e eventos no navegador.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano