A condição verificada pelo código
Uma asserção é uma verificação executável de uma condição que deveria ser verdadeira naquele ponto do programa. Em um teste, ela confronta o resultado obtido com o esperado. A falha sinaliza que essa expectativa não foi atendida, conforme o comportamento da função de asserção utilizada.
No Node.js, o módulo node:assert oferece funções para comparar valores ou verificar se uma função lança um erro. Você escolhe a verificação de acordo com o comportamento que pretende testar.
Comparação do tamanho de uma lista
Este exemplo didático usa uma lista com dois itens para verificar a expectativa de que ela teria três:
const assert = require('node:assert/strict')const itens = ['arquivo.txt', 'imagem.png']
assert.strictEqual(itens.length, 3)A propriedade length fornece o número 2, que difere do esperado 3. Por isso, a chamada lança um AssertionError. O teste verifica somente o tamanho da lista, sem examinar o nome ou o conteúdo dos itens.
O efeito da falha varia entre implementações. Em C, a macro assert habilitada escreve um diagnóstico na saída de erros e chama abort quando a expressão é falsa. Com NDEBUG definido ao incluir assert.h, a verificação é retirada. Uma validação necessária para recusar uma entrada inválida precisa continuar funcionando nessa compilação.
Dúvidas frequentes
Perguntas frequentes sobre asserção
- Uma asserção pode substituir a validação de uma entrada?
- A validação de uma entrada precisa prever valores inválidos e definir uma resposta para eles. Uma asserção verifica uma expectativa do código e pode interromper a execução quando ela falha. Em C, ela pode até ser desativada na compilação.
- Toda asserção compara valores da mesma forma?
- O módulo node:assert oferece funções para verificações diferentes. strictEqual compara dois valores sem converter uma string em número. Para comparar a estrutura de objetos, há funções como deepStrictEqual.
- O que acontece com assert em C quando NDEBUG está definido?
- Quando NDEBUG está definido ao incluir assert.h, a macro assert não gera código nem avalia a expressão. Por isso, uma ação necessária ao programa deve ficar fora dessa expressão.
Para continuar
Recursos relacionados
Documentação
Linux: verificações com assert em C
Manual do projeto Linux man-pages sobre a macro assert, o encerramento por abort e o efeito de NDEBUG.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Sessão prática para você investigar uma falha de teste no editor e no terminal com orientação técnica ao vivo.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
O desenvolvimento com agentes exige compreender o comportamento da aplicação e conferir o resultado das alterações.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.