概述
从 WWDC 24 开始,苹果推出了全新的测试机制:Swift Testing。利用它我们可以大幅度简化之前"老态龙钟"的 XCTest 编码范式,并且使得单元测试更加灵动自由,更符合 Swift 语言的优雅品味。
在这里我们会和大家一起初涉并领略 Swift Testing 的测试之美。
在本篇博文中,您将学到如下内容:
- 概述
- [4. #expect 宏](#expect 宏)
- [5. #require 宏](#require 宏)
- [6. Swift Testing 目前的不足](#6. Swift Testing 目前的不足)
- 总结
测试为先,质量为王!无测试,不软件!
那还等什么呢?Let's testing!!!😉
4. #expect 宏
如果说前面介绍的 @Test 宏为测试奠定了基调,那么 #expect 宏则无疑是当之无愧的测试核心所在。
在以往"陈言老套"的 XCTest 体系中,我们往往需要用超多 XCTAssertXXX 之类的方法来验证测试通过与否:
记住这些"聚蚊成雷"般的方法可不是件容易的活。不过这一切在 Swift Testing 都不是事儿了,因为不管现实如何千变万化我们都只需一个 #expect 宏即可统统搞定!
swift
import Testing
func add(_ a: Int, _ b: Int) -> Int {
a + b
}
@Test func verifyAdd() {
let result = add(1, 2)
#expect(result == 3)
}
上面是 #expect 宏最简单的形式,即验证结果是否为真。如此这般,多个 #expect 连续助攻自然也是不在话下:
swift
@Test func verifyMagicNumber() {
let number = magicNumber()
#expect(number != 0)
#expect(number > 10)
#expect(number <= 100)
}
我们还可以利用 #expect 来验证被测试方法是否抛出错误、以及是否抛出指定错误:
swift
enum MyError: Error {
case invalidInput
}
func throwingFunction() throws {
throw MyError.invalidInput
}
@Test func verifyThrowingFunction() {
#expect(throws: MyError.self) {
try throwingFunction()
}
}
在上面的代码中,如果 throwingFunction 抛出 MyError 错误则表示测试通过!
我们还可以更进一步,细粒度控制方法抛出错误时的测试行为,比如仅当抛出指定 MyError.invalidInput 错误时才能使测试 Pass:
swift
@Test func verifyThrowingFunction() {
#expect {
try throwingFunction()
} throws: { error in
guard let myError = error as? MyError else {
return false
}
return myError == .invalidInput
}
}
Swift Testing 中 #expect 的能耐远不止于此,更多它的使用介绍请小伙伴们参考苹果官方开发文档。
5. #require 宏
除了 #expect 之外,在 Swift Testing 中还有另一个不可或缺的"超级助手",那就是 #require 宏:
简单来说,#require 宏的精妙之处在于它可以让我们立即判断条件是否满足,并提早结束测试。具体来说,它会在测试可选值(Optional Value)为 nil (或者其它条件不满足)时让测试失败并抛出错误。
swift
@Test func verifyOptionalFunc() throws {
let result = optionalFunc()
try #require(result != nil)
#expect(result! > 0)
}
还拿之前博文中 Item 的"栗子"来说,我们可以写一个验证 Model 中第一个 Item 名称的方法,不过由于我们忘记了创建 Model 中的 items,所以下面的测试会在 #require 那行抛出错误,因为此时 items 数组为空:
swift
@Test
func firstItemCheck() throws {
let model = Model.shared
let firstItem = try #require(model.items.first)
#expect(firstItem.name == "大熊猫侯佩")
}
失败的测试结果如下图所示:
更进一步,我们还可以利用 Issue 对象来记录测试遇到的任何问题,它们都会在测试日志中分毫不差的反映出来:
swift
@Test
func firstItemCheck() {
let model = Model.shared
do {
let firstItem = try #require(model.items.first)
#expect(firstItem.name == "大熊猫侯佩")
} catch {
Issue.record("Model 中没有任何数据,忘记创建了???")
}
}
测试 firstItemCheck() 方法依旧失败,不过此时我们可以在 Xcode 控制台中看到具体失败的信息:
现在,借助于 Swift Testing 中这些宏的"古道热肠",我们编写的单元测试必将大放异彩、拔山盖世!棒棒哒!💯
6. Swift Testing 目前的不足
虽然 Swift Testing 较之以前的 XCTest 测试系统有诸多好处,但我们仍不能完全否定后者。而且, Swift Testing 还缺失测试中至关重要的一环:UI 测试。
对于 WWDC 23 中推出 Swift 宏(Macros)的单元测试,目前我们也无法使用 Swift Testing 来完成,这不能不说是一个遗憾。
这些问题在 Swift Testing 2.0 中是否能够解决?Swift Testing 能否在 WWDC 25 里从 XCTest 中完全凤凰涅槃呢?让我们拭目以待吧!
想要系统学习 Swift 的小伙伴们,请来我的《Swift语言开发精讲》专栏逛一逛哦:
总结
在本篇博文中,我们继续讨论了 Swift Testing 中另外两个非常重要的宏:#expect 和 #require,我们还顺带介绍了目前 Swift Testing 的一个"短板"。至此 Swift Testing 测试大冒险圆满落幕啦!
感谢观赏,再会啦!😎