Programação JavaScript, contratos e debugging

Abra uma tabela de casos no seu caderno: um item de 9999 centavos, um item de 10000 e um de 10001. Preveja o frete sem olhar o código. Acrescente duas linhas distintas cuja soma alcance 10000; esse caso verifica acumulação, não apenas comparação. Agora liste entradas recusadas: quantidade zero, negativa, fracionária, texto, NaN e Infinity. O caso de lista vazia exige uma escolha: esta cotação a recusa porque uma compra sem itens não tem significado no fluxo proposto.

Escreva o contrato do preço: inteiro positivo em centavos por unidade. Não use o nome genérico valor quando ele puder significar preço da linha ou da unidade. Defina também o retorno: dois campos numéricos, sem texto monetário formatado. A apresentação pode gerar R$ 100,00 depois, mas a função não deve misturar cálculo e mensagem. Essa separação evita um teste frágil que compara uma frase inteira para descobrir se o frete foi calculado corretamente.

Crie inteiroPositivo para centralizar a decisão sobre números. Em seguida, cotar verifica a coleção, percorre seus itens e acrescenta cada parcial. A helper não substitui todas as verificações: sku tem contrato textual, enquanto o resultado da multiplicação exige outra checagem de intervalo. Não normalize o sku alterando o objeto recebido; somente verificar que o texto não é vazio basta neste exemplo. Uma normalização comercial precisaria de política própria sobre maiúsculas e caracteres permitidos.

Antes da execução, descreva o valor de total após cada linha do caso com dois itens. Compare sua previsão com o resultado. Se você colocou o acumulador dentro do laço, verá que o primeiro subtotal desaparece. Corrija a posição e explique a invariante: total soma somente os itens já validados. O cálculo termina devolvendo um novo objeto; isso permite testar preservação da entrada com um snapshot JSON simples. Neste domínio só há campos básicos serializáveis; não extrapole esse snapshot como verificador universal de objetos.

Execute a solução e confirme que as asserções terminam sem erro. Faça então uma alteração deliberada: troque >= por >. O caso de 10000 deve falhar. Leia a diferença exibida e identifique qual valor esperado veio da política. Restaure o operador. Não capture o erro para imprimir sucesso, pois isso eliminaria justamente a evidência de que o teste protege o requisito. A documentação de assert distingue os métodos de comparação e de exigência de exceção.

↗ Node.js24: Assert

Acrescente um teste com duas linhas cujo total é 10000, outro com sku vazio e outro com um preço tão grande que a multiplicação perde segurança. Para cada um, escreva o defeito que ele detectaria. Se você adicionar uma condição somente porque o código atual a contém, talvez esteja testando a implementação em vez do contrato. Um requisito justificável, como não apresentar valor monetário inexato, dá razão independente ao teste de overflow.

Investigue também o que a cotação não garante. Um preço validado pode estar desatualizado; um sku não vazio pode não existir no catálogo; o cliente pode tentar modificar o preço recebido. Em uma aplicação real, o servidor consulta valores autorizados e associa a identidade à operação. Aqui queremos dominar a função e seus limites, não fabricar uma autorização implícita. Entregue o contrato, os casos anotados e uma explicação do erro provocado. A rubrica considera forte uma solução que detecta fronteira, tipo, acumulação e mutação; somente o caso nominal é evidência insuficiente.