断言
表达预期行为。
断言 是 CoddyKit 上的免费 Lua Academy 课时。 这是第 3 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Lua Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Lua Academy 课程共包含 4 节课。
断言的作用
断言是测试的核心。它陈述一个必须为真的事实。如果事实为真，测试会继续；如果不为真，busted 会附带有用的信息记录一次失败。
busted 使用 luassert 库，该库通过全局 assert 表访问。
assert.are.equal(4, 2 + 2)are.equal
assert.are.equal 使用 == 运算符检查相等性。第一个参数是期望值，第二个参数是实际值。
它适用于数字、字符串和布尔值，但对于表，它比较的是身份，而不是内容。
assert.are.equal("hello", greet())
assert.are.equal(10, count)使用 are.same 比较表
要深度比较表的内容，请使用 assert.are.same。它会递归检查两个表是否包含相等的值。
对于数据结构，请使用 same；对于基本类型或标识检查，请使用 equal。
assert.are.same({1, 2, 3}, split("1,2,3"))
assert.are.same({x = 1}, point)真值
assert.is_true 和 assert.is_false 会检查是否为确切的布尔值。assert.is_truthy 接受任何不是 nil 或 false 的值。
当您明确期望结果为布尔值时，请选择严格变体。
assert.is_true(user.active)
assert.is_truthy(find("x"))
assert.is_false(list:isEmpty())空值检查
assert.is_nil 会验证值是否为 nil，而 assert.is_not_nil 会验证值是否存在。在检查查找结果时，这些断言很常用。
与使用 equal 和 nil 比较相比，它们能更清楚地表达意图。
assert.is_nil(map["missing"])
assert.is_not_nil(map["found"])使用 is_not 取反
大多数断言都可以通过插入 is_not 或使用 are_not 形式来取反。这表示某个值必须不同。
例如，当两个值不同时，assert.are_not.equal 会通过。
assert.are_not.equal(1, 2)
assert.is_not_nil(result)测试错误
要断言代码会引发错误，请将代码封装在函数中，并将其传给 assert.has_error。busted 会调用该函数，并确认它是否抛出了错误。
您还可以将预期的字符串作为第二个参数传入，以检查错误消息。
assert.has_error(function()
withdraw(-5)
end, "amount must be positive")has_no.errors
相反的检查是 assert.has_no.errors。当封装的函数运行时没有引发错误时，它会通过。
即使您不检查函数的返回值，这也有助于确认正常流程的调用不会崩溃。
assert.has_no.errors(function()
parse("valid input")
end)自定义失败消息
您可以为大多数断言附加消息，以便更清楚地说明失败原因。请将消息作为额外参数传入，让报告解释预期结果。
清晰的消息可以将晦涩的失败转化为可采取行动的问题。
assert.is_true(ok, "login should succeed")使用修饰符进行匹配
luassert 提供了修饰符和匹配器，用于执行更丰富的检查。例如，assert.matches 会根据 Lua 模式检查字符串。
当输出可能变化、精确相等检查过于严格时，这种方式非常有用。
assert.matches("%d%d%d%d", get_year())
assert.matches("error", log_line, 1, true)选择合适的断言
请选择最具体的断言，以便清楚地表达意图。对于表，请使用 same；对于基本类型，请使用 equal；对于失败，请使用 has_error；对于布尔值，请使用真值检查。
具体的断言会生成更好的失败消息，从而加快调试速度。
describe("queue", function()
it("dequeues in order", function()
assert.are.same({"a", "b"}, q:drain())
end)
end)快速检查
测试您对 busted 断言的理解。
回顾
luassert 为 busted 提供了 assert 表。对于基本类型，请使用 are.equal；对于表的深度比较，请使用 are.same；在适当的情况下，请使用真值或空值检查。
使用 has_error 测试失败情况，使用 has_no.errors 测试成功情况。使用 is_not 取反，并添加消息以生成更清晰的报告。
常见问题解答
「断言」课时是免费的吗？
是的 — 「断言」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Lua Academy 课程的其余内容，请升级到 CoddyKit PRO。 Lua Academy 课程共包含 4 节课。
「断言」这节课中我会学到什么？
表达预期行为。 你通过在浏览器中直接运行的动手代码来练习 Lua Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Lua Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Lua Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 4 节。
「断言」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Lua Academy 课中编写并运行代码吗？
能。每节 Lua Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。