<aside> 🧪

Página de teste. Versão prática do Capítulo III no projeto chape-sistema. Continue no mesmo repositório dos capítulos anteriores.

</aside>

💬 Contexto: A secretaria deixou a impressão das carteirinhas rodando no fim do expediente. Na manhã seguinte, só uma carteirinha tinha saído da impressora — e na tela, um monte de texto vermelho que ninguém entendeu.

Quem documenta bem uma falha começa sabendo ler o que o sistema está dizendo.


💡 Lendo uma mensagem de erro (stack trace)

Quando um programa JavaScript quebra, o Node.js mostra um stack trace. Parece assustador, mas ele responde quase todas as perguntas do registro de falha:

/projeto/src/frete.js:7                                  ← 📍 ARQUIVO e LINHA
  const total = pedido.itens.length * 5;
                             ^                           ← 📍 ONDE na linha

TypeError: Cannot read properties of undefined (reading 'length')   ← 💥 O QUE aconteceu
    at calcularFrete (/projeto/src/frete.js:7:30)        ← 🔎 em qual FUNÇÃO
    at Object.<anonymous> (/projeto/index.js:12:3)       ← 🔎 QUEM chamou a função

Leitura: na linha 7 de frete.js, dentro de calcularFrete, o código tentou ler .length de algo que era undefined — ou seja, pedido.itens não existia.

<aside> 💡

O stack trace mostra o sintoma (onde quebrou). A causa raiz (por que itens não existia?) ainda precisa ser investigada — é aí que entram os 5 Porquês.

</aside>


💻 Exercício 1 — A impressora que parou na primeira carteirinha

Formato: Duplas | ~40 minutos

Preparação: em src/dados.js, acrescente endereco: { cidade: 'Chapecó' } só nos registros da Ana e da Carla (foram cadastradas no balcão; os outros vieram do app novo, que não pede endereço). Depois crie os dois arquivos abaixo.

src/carteirinha-impressa.js

// Monta o texto impresso na carteirinha física do sócio
function textoCarteirinha(socio) {
  const cidade = socio.endereco.cidade.toUpperCase();
  return `${socio.nome.toUpperCase()} — SÓCIO ${socio.plano.toUpperCase()} — ${cidade}`;
}

module.exports = { textoCarteirinha };

imprimir-carteirinhas.js

const { socios } = require('./src/dados');
const { textoCarteirinha } = require('./src/carteirinha-impressa');

for (const socio of socios) {
  console.log(textoCarteirinha(socio));
}

Rode node imprimir-carteirinhas.js e reproduza a falha.