Asserções
Expresse o comportamento esperado.
Asserções é uma aula grátis de Lua Academy no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Lua Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Lua Academy inclui 4 aulas no total.
O que as asserções fazem
Uma asserção é o coração de um teste. Ela declara um fato que deve ser verdadeiro. Se for, o teste continua. Caso contrário, o busted registra uma falha com uma mensagem útil.
O busted usa a biblioteca luassert, acessada por meio da tabela global assert.
assert.are.equal(4, 2 + 2)are.equal
assert.are.equal verifica a igualdade com o operador ==. O primeiro argumento é o valor esperado, e o segundo é o valor real.
Isso funciona para números, cadeias de caracteres e booleanos, mas, para tabelas, compara a identidade, não o conteúdo.
assert.are.equal("hello", greet())
assert.are.equal(10, count)are.same para tabelas
Para comparar profundamente o conteúdo de tabelas, use assert.are.same. Ele verifica recursivamente se duas tabelas contêm valores iguais.
Use same para estruturas de dados e equal para valores primitivos ou verificações de identidade.
assert.are.same({1, 2, 3}, split("1,2,3"))
assert.are.same({x = 1}, point)Valores verdadeiros
assert.is_true e assert.is_false verificam valores booleanos exatos. assert.is_truthy aceita qualquer valor que não seja nil nem false.
Escolha a variante estrita quando esperar especificamente um resultado booleano.
assert.is_true(user.active)
assert.is_truthy(find("x"))
assert.is_false(list:isEmpty())Verificações de nil
assert.is_nil verifica se um valor é nil, enquanto assert.is_not_nil verifica se ele está presente. Essas verificações são comuns ao conferir buscas.
Elas deixam a intenção mais clara do que comparar com nil usando equal.
assert.is_nil(map["missing"])
assert.is_not_nil(map["found"])Negação com is_not
A maioria das asserções pode ser negada inserindo is_not ou usando a forma are_not. Isso expressa que algo deve ser diferente.
Por exemplo, assert.are_not.equal passa quando os dois valores são diferentes.
assert.are_not.equal(1, 2)
assert.is_not_nil(result)Testando erros
Para verificar se o código gera um erro, envolva-o em uma função e passe-a para assert.has_error. O busted chama a função e confirma que ela lançou um erro.
Você também pode verificar a mensagem de erro passando uma string esperada como segundo argumento.
assert.has_error(function()
withdraw(-5)
end, "amount must be positive")has_no.errors
A verificação oposta é assert.has_no.errors. Ela passa quando a função envolvida é executada sem gerar um erro.
Isso é útil para confirmar que uma chamada no fluxo de sucesso não falha, mesmo quando você não verifica o valor retornado.
assert.has_no.errors(function()
parse("valid input")
end)Mensagens de falha personalizadas
Você pode anexar uma mensagem à maioria das asserções para esclarecer as falhas. Passe-a como um argumento adicional para que o relatório explique o que era esperado.
Mensagens claras transformam uma falha enigmática em uma falha que permite agir.
assert.is_true(ok, "login should succeed")Correspondência com modificadores
O luassert fornece modificadores e comparadores para verificações mais elaboradas. Por exemplo, assert.matches testa uma string usando um padrão de Lua.
Isso é útil quando uma verificação de igualdade exata é rígida demais para uma saída variável.
assert.matches("%d%d%d%d", get_year())
assert.matches("error", log_line, 1, true)Escolhendo a asserção certa
Escolha a asserção mais específica para obter clareza. Use same para tabelas, equal para valores primitivos, has_error para falhas e verificações de veracidade para valores booleanos.
Asserções específicas produzem mensagens de falha melhores, o que acelera a depuração.
describe("queue", function()
it("dequeues in order", function()
assert.are.same({"a", "b"}, q:drain())
end)
end)Verificação rápida
Teste sua compreensão das asserções do busted.
Recapitulação
O luassert fornece a tabela assert do busted. Use are.equal para valores primitivos, are.same para comparações profundas de tabelas e verificações de veracidade ou de nil quando apropriado.
Teste as falhas com has_error e os casos bem-sucedidos com has_no.errors. Negue com is_not e adicione mensagens para obter relatórios mais claros.
Aprenda Lua com um tutor de IA — grátis
Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.
- Cursos
- 40
- Aulas
- 159
Perguntas Frequentes
A aula “Asserções” é grátis?
Sim — o texto completo de “Asserções” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Lua Academy, atualize para CoddyKit PRO. O curso de Lua Academy inclui 4 aulas no total.
O que vou aprender em “Asserções”?
Expresse o comportamento esperado. Você pratica Lua Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Lua Academy?
Nenhuma experiência prévia é necessária. Lua Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.
Quanto tempo leva a aula “Asserções”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Lua Academy?
Sim. Cada aula de Lua Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.