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