Sanyanggae LogoSanyanggae

💻 Web & Front

Ilhas de servidor Astro: adiar apenas as partes necessárias de uma página estática

Entenda server:defer, o adaptador de servidor e o fallback, com verificações antes da aplicação.

사냥개 (Sanyanggae)Publicado Atualizado 8 min de leitura

Este artigo é uma tradução do original em coreano. Original em coreano · Revisão da tradução: Revisão por IA

Diagrama explicativo: HTML inicial · Ilhas de servidor · Fallback e resposta. Ilhas de servidor Astro: adiar apenas as partes necessárias de uma página estática
SANYANGGAE · Diagrama explicativo · HTML inicial · Ilhas de servidor · Fallback e resposta.

A descrição de um produto pode ser igual para todos, mas o endereço de entrega depende da pessoa conectada. Uma consulta lenta deve atrasar também a descrição? Uma livraria fictícia ajuda a decidir como separar conteúdo comum e regiões pessoais. São as ilhas de servidor do Astro, com papel diferente das ilhas cliente que fazem botões funcionar no navegador.

1. Separar o documento inicial das regiões posteriores

A documentação oficial das ilhas de servidor Astro explica como adiar a renderização de um componente no servidor e receber o resultado em outra requisição. O HTML inicial traz conteúdo principal e indicação de espera; a resposta separada substitui a região. É necessário um adaptador que atenda requisições no servidor.

Mantenha título, autor e apresentação do livro no documento comum e considere adiar apenas o resumo do endereço. Assim, é possível ler sobre o livro enquanto se espera. Se o botão de pagamento depende da compreensão do total, desenhe também a relação entre preço e ação de pagar. Cortar elementos visuais em caixas pequenas não completa a separação funcional.

O sucesso depende do que aparece primeiro. Deixar o documento quase vazio e adiar a maior parte faz o visitante aguardar vários indicadores. Liste primeiro perguntas da tela inicial e informações que podem chegar depois. Ilhas deslocam a espera; não aceleram automaticamente a consulta ao banco de dados.

2. Projetar o fallback como parte da tela pronta

Este pequeno exemplo mostra o uso. Pressupõe UserDelivery e adaptador implementados separadamente.

---
import UserDelivery from '../components/UserDelivery.astro';
---
<UserDelivery server:defer>
  <p slot="fallback">Consultando o endereço de entrega.</p>
</UserDelivery>

O fallback é conteúdo inicial que alguém lê, não decoração passageira. Reserve espaço próximo ao tamanho final do cartão e explique a espera. Mostrar “Entrega disponível” sem dados pode contrariar a resposta real. Diferencie visualmente estado desconhecido e resultado confirmado.

Quem não entrou na conta pode precisar de “Entre para consultar seu endereço salvo”. Rede lenta e ausência de autenticação são estados diferentes. Defina textos e caminhos separados para reduzir frases provisórias de desenvolvimento na tela publicada.

3. Manter pequenas as fronteiras dos dados

Passe somente valores necessários à exibição e consulta. Enviar todo o histórico de pedidos para imprimir um nome sugere reduzir dependências primeiro. Alguns valores podem estar no conteúdo público; outros só devem ser consultados após autenticação. Revise juntos o caminho de transmissão e o alcance exibido.

A requisição da ilha tem contexto de execução separado. Se a lógica exige o endereço da página atual, considere passar explicitamente o caminho desde a página original. Supor que a URL interna seja a do produto pode produzir recomendações e links de retorno incorretos. Confira requisições reais nas ferramentas de desenvolvimento.

Imagine um identificador de livro e dados identificadores do usuário. Use o livro em recomendações comuns e processe o usuário no servidor conforme autenticação. Transmissão criptografada não substitui autorização no servidor. Documente separadamente onde entra o dado e onde se decide o acesso final.

4. Ajustar o cache ao público da resposta

Apresentação comum e endereço pessoal dificilmente usam a mesma política. O guia de cache HTTP da MDN diferencia cache compartilhado e privado. Pergunte quem pode ver a resposta antes de apenas verificar se os dados são iguais.

Abra a mesma página em duas contas de teste e confirme que o endereço da primeira não aparece na segunda. Veja também voltar e atualizar após sair da conta. O teste considera servidor de cache, navegador e autenticação da aplicação em conjunto. Ler só o componente não demonstra segurança.

Até recomendações compartilháveis precisam de atualização quando mudam. Decida se aceita conteúdo antigo brevemente ou se uma edição administrativa exige substituição imediata. Em vez de “ativar cache”, registre alvo, armazenamento, desatualização tolerada e invalidação para facilitar a revisão.

5. Testar primeiro lentidão e falhas

Não avalie a página após uma única carga normal. Atrase a consulta, provoque falha e altere a sessão, examinando cada tela. O texto principal continua legível? O carregamento empurra continuamente o próximo botão? Ações dependentes de informação que falhou continuam possíveis?

Situação de testeEstado que o visitante deve entender
Consulta de endereço lentaO que espera e se pode ler outro conteúdo
Sem autenticaçãoSe aparecem orientação de entrada e explicação comum
Falha na consultaSe há recuperação em vez de tela vazia
Troca de contaSe desaparecem os dados do usuário anterior

Se várias ilhas esperam resultados entre si, reveja a separação. Consultar frete depois do endereço e só então mostrar pagamento pode encadear esperas. Agrupar informações em uma tarefa de servidor ou consultar quando solicitado pode ser melhor. Mais partes separadas não garantem boa estrutura.

6. Comparar ganhos nas mesmas condições

Registre separadamente primeiro texto visível, endereço completo, possibilidade de interação e erros. Documento rápido com grande deslocamento do cartão ou pagamento atrasado pode mudar a experiência em outra direção. Anote o que os casos lentos esperavam, além da média.

Perguntas específicas ajudam a escolher: “É possível ler a apresentação mesmo se esta informação atrasar?” orienta mais que “O site é estático?”. Confira o ambiente com o guia Astro de renderização sob demanda e teste uma pequena região pessoal até em falhas reais.

Fontes e referências

Este artigo explica informações de fontes públicas. A citação de uma instituição não implica revisão nem aprovação por ela.

Editora e contato

Outros artigos sobre o tema