Promises async e erros de rede

async/await organiza espera. Simule atraso e falha para treinar recado claro.

Trabalhe sobre uma cópia da pasta inicio do exemplo correspondente. Leia, digite, mude uma coisa, preveja o resultado, recarregue e confira. A referência completa fica na raiz da pasta do exemplo, no pacote anexo.

O que você pratica

• Explique o papel central desta etapa no exemplo 29-async.
• Implemente a versão inicio e descreva uma mudança que você testou.
• Qual erro comum deste capítulo você conseguiu provocar de propósito?

await em sequência

Espere um pouco, depois busque mural.json.

Falha simulada

O botão de falha lança Error de propósito. A UI deve mostrar a mensagem.

Não engolir erro

catch registra com console.error e fala com a pessoa.

Ler o exemplo completo

A referência desta etapa usa app.js, index.html, mural.json, styles.css. Abra primeiro o resultado pronto e identifique onde acontece await em sequência. Depois compare o mesmo ponto com a pasta inicio. Essa comparação mostra exatamente o que você precisa escrever, sem esconder partes indispensáveis do programa.

Diagnóstico guiado

Se o resultado não aparecer, confirme o arquivo aberto, salve a alteração e recarregue. Em seguida, abra o Console: leia a primeira mensagem de erro, confira o nome do arquivo e a linha indicada. Quando houver fetch, sirva a pasta apenas em 127.0.0.1; abrir por file:// não reproduz o pedido HTTP.

Critério de avanço

Avance quando conseguir explicar o papel de inicio, realizar uma mudança pequena e restaurar o exemplo sem copiar a resposta comentada.

Atividades

1. Na referência, onde aparece await em sequência e qual efeito você observa?
2. Na cópia inicio, mude apenas inicio. O que você prevê antes de executar novamente?
3. Provoque uma falha pequena nesta etapa. Qual mensagem ou comportamento ajudou você a encontrar a causa?

Respostas comentadas

Só abra depois de tentar.

Atividade 1. A resposta deve apontar o arquivo e ligar o trecho ao efeito visível. Compare com app.js, index.html, mural.json, styles.css.

Atividade 2. Registre o valor anterior, o novo valor e o resultado previsto. Depois confira; se houver diferença, explique o que o programa realmente fez.

Atividade 3. Uma boa investigação começa pela primeira mensagem do Console, pelo arquivo salvo e pelo caminho aberto. Corrija uma causa por vez e execute de novo.

Exemplo deste capítulo: pacote de exemplos/29-async/.

O arquivo completo

Referência do exemplo 29-async, reproduzida aqui para que você possa conferir sem sair da página.

index.html

<!DOCTYPE html>
<html lang="pt-BR">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Promises async e erros — Ateliê do Marco Zero</title>
  <link rel="stylesheet" href="styles.css">
</head>
<body>
  <a class="skip" href="#conteudo">Ir para o conteúdo</a>
  <header>
    <p class="tag">Ateliê do Marco Zero · Recife</p>
    <h1>Promises async e erros</h1>
  </header>
  <main id="conteudo">
    <p>Simula atraso e falha controlada ao buscar o mural.</p>
    <button type="button" id="ok">Buscar mural</button>
    <button type="button" id="falha" class="secondary">Simular falha</button>
    <pre class="saida" id="saida"></pre>

  </main>
  <footer>
    <p>Material de estudo. Conteúdo fictício. Servidor só em 127.0.0.1.</p>
  </footer>
  <script src="app.js"></script>
</body>
</html>

app.js

const saida = document.querySelector("#saida");

function esperar(ms) {
  return new Promise((resolve) => setTimeout(resolve, ms));
}

async function carregar(forcarErro) {
  saida.textContent = "Carregando…";
  await esperar(400);
  if (forcarErro) {
    throw new Error("Serviço do mural indisponível (simulado).");
  }
  const resp = await fetch("mural.json");
  if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
  return resp.json();
}

document.querySelector("#ok").addEventListener("click", async () => {
  try {
    const dados = await carregar(false);
    saida.textContent = `${dados.aviso}\nAtualizado: ${dados.atualizado}`;
  } catch (e) {
    saida.textContent = e.message;
  }
});

document.querySelector("#falha").addEventListener("click", async () => {
  try {
    await carregar(true);
  } catch (e) {
    saida.textContent = e.message;
  }
});