Swift Testingについて

Swift Testingについて

Swiftを使用してコードをテストするための新しいパッケージ、Swift Testingが登場しました。このパッケージの新しいパワフルなAPIの構成要素、一般的なテストワークフローでの応用方法、XCTestおよびオープンソースSwiftとの関連性について解説します。

関連する章
- 0:00 - Introduction
- 0:59 - Agenda
- 1:20 - Building blocks
- 1:58 - Building blocks: @Test functions
- 3:07 - Building blocks: Expectations (#expect and #require)
- 6:02 - Building blocks: Traits
- 6:49 - Building blocks: @Suite types
- 8:34 - Building blocks: Designed for Swift
- 9:14 - Common workflows
- 9:29 - Common workflows: Tests with conditions
- 10:56 - Common workflows: Tests with common characteristics
- 13:13 - Common workflows: Tests with different arguments
- 17:35 - Swift Testing and XCTest
- 21:52 - Open source
- 23:29 - Wrap up
リソース
関連ビデオ

WWDC24
- Swift Testingの詳細
ダウンロード

こんにちは Stuart Montgomeryです本セッションでは Swift Testingをご紹介します優れたユーザー体験を実現するには品質と信頼性が重要です自動テストは長期にわたりソフトウェアの品質を高めて維持するための実績のある方法ですそこで今年はまったく新しいツールセットを導入して Swiftコードのテストをこれまで以上に簡単かつ強力にします Swift Testingは Swiftでコードのテストを行うためのオープンソースのパッケージですテストの記述と整理を行うための強力な機能が含まれています失敗が発生した時には実用的な詳細情報を提供し大規模なコードベースにも洗練された方法で対応します
Swift Testingは Swift向けに設計され並列処理やマクロなどの最新機能に対応しています LinuxやWindowsなどのすべての主要プラットフォームをサポートしていますまた開発プロセスがオープンであるためその進化にあらゆるユーザーとコミュニティが貢献することができますこのセッションでまず最初にお話しするのは知っておくべき基本概念である Swift Testingの構成要素についてです続いて一般的なワークフローをいくつかご紹介しますテストをカスタマイズする方法や異なる引数でテストを繰り返す方法などです Swift TestingとXCTestの関係性についても説明しますそして最後にお話しするのがオープンソースコミュニティにおけるこの新しいプロジェクトの役割についてですではまず Swift Testingの構成要素を見ていきましょうこれまでにアプリのテストを記述したことがない場合は最初にテストバンドルターゲットをプロジェクトに追加します > > の順に選択します
次にセクションのを検索します
Xcode 16のこのテンプレートでは Swift Testingがテストシステムとしてデフォルトで選択されます新しいターゲットの名前を指定しをクリックするだけですこのアプリにはテストターゲットがあるので最初のテストはそこに記述しますまず Testingモジュールをインポートします
次にグローバル関数を記述します
そしてこれに@Test属性を追加します
@Test属性は1つ目の構成要素ですこれは関数がテストであることを示しますこの属性を追加すると Xcodeで認識され実行ボタンが横に表示されますテスト関数は @Test属性を持つ通常のSwift関数ですグローバル関数でも型内のメソッドでもかまいません asyncやthrowsとしてマークでき必要に応じてグローバルアクターに分離することもできます次にテストを作り実際に検証してみるために関数の本体にコードを記述しましょうこのテストではビデオファイルのメタデータが期待通りであることを確認しますまず確認したいビデオと期待されるメタデータを初期化します
これらの型はこのアプリのモジュールで宣言されているためここでエラーが出ます最初にこれをインポートする必要があります
注意点ですがこのインポートでは小文字の@testable属性を使います
これはSwift Testingに固有ではなく一般的な言語機能ですがアクセスレベルがinternalであるこのような型を参照できるようになります次に#expectマクロを使用してビデオのメタデータが正しいか確認します
#expectマクロは expectationを実行しますこれが Swift Testingの2つ目の構成要素です
#expectマクロなどで expectationを実行することで期待される条件が満たされているか検証できますこれには通常の式と言語演算子を使えます失敗した場合はソースコードと部分式の値をキャプチャします最初のテストを実行してどうなるか見てみましょう
赤いXアイコンで示されているように失敗したようですテストの失敗メッセージをクリックしを選択するとこの行で何が間違っていたのか詳しく確認できます
この結果ビューには詳細として #expectマクロに渡された式と部分式の値が表示されますメタデータを展開するとそのプロパティを比較できます
再生時間と解像度のフィールドがどちらも一致していないようですこれを見て思いあたる点があります Videoの型が初期化後にメタデータを読み込んでいないのではないかと思いますこれを修正するには分割エディタで Videoイニシャライザに移動しプロパティが代入されているのを確認します
ではテストを再実行しましょう
今度は成功しました良かったです #expectマクロはとても柔軟です演算子やメソッド呼び出しを含む任意の式を渡すことができ失敗した場合は詳細な結果が表示されます例をいくつか紹介します ==演算子を使用でき失敗した場合は左辺と右辺がキャプチャされ表示されます .isEmptyなどのプロパティにアクセスできます配列上の.containsなどのメソッドを呼び出すこともできますご覧のようにエラー時は数値配列の内容が自動的に表示されますこうした操作のために特別なAPIを学ぶ必要はありません #expectマクロを使うだけです
expectationが失敗した場合は早期にテストを終了したい時もあるでしょうその場合は#requireマクロを使えます必須のexpectationは通常のexpectationと似ていますただし tryキーワードがあり式がfalseの場合はエラーがスローされテストは失敗となりそれ以上先に進みません #requireマクロのもう1つの使い方はオプションの値の安全なアンラップを試行し nilの場合はテストを停止することです
この例では #requireマクロを使用してコレクションの .firstプロパティにアクセスしそのあと要素のプロパティをチェックしています「first」プロパティはオプションですがテストの2行目はその値に依存しているためこのテストは早期に停止しますアンラップされた値がnilの場合は続行しても意味がないからです必須のexpectationはこのパターンに最適なツールです
テストをプロジェクトにコミットする前にその目的を明確にしましょうそのためには @Test属性でカスタムの表示名を渡しますこの名前は Test NavigatorやXcodeのほかの場所に表示されます
表示名は特性の一例ですがこの特性が 3つ目の構成要素です
特性には次のような機能がありますテストに関する説明情報を追加できますテストの実行タイミングや実行の有無をカスタマイズできますまたテストの動作を変更できます
例をいくつか紹介します表示名による情報の追加に加え関連するバグの参照やカスタムタグの追加もできます特定の条件でのみテストを実行したい場合は特性を使ってそれを制御できます一部の特性はテストの実際の動作に影響を与えます時間制限を設定したり 1つずつ実行したりできます
最初のテストが作成できたので Videoの型の別の側面を検証する 2つ目のテストを追加しましょう今度は Xcode 16に組み込まれたテストスニペットを使用して空のテスト関数をすばやく追加しましょう
このテストはratingという名前にします
そして本体で先ほどと同様にビデオを作成し #expectで contentRatingがデフォルト値であることを検証します
これら2つのテストをグループ化するとプロジェクト内で見つけやすくなりますそこでテストを1つの構造体にラップしますこれはVideoTestsという名前にします
これを行うとすぐに階層がTest Navigatorに反映されクリックしてグループで実行することもできます複数のテストを含むこのような型はテストスイートと呼ばれこれが最後の 4つ目の構成要素ですスイートを使って関連するテスト関数やほかのスイートをグループ化できます @Suite属性を使用して明示的に注釈をつけることができますが @Test関数または@Suiteを含むすべての型は暗黙的にそれ自体が@Suiteと見なされますスイートにはインスタンスプロパティを格納できます initまたはdeinitを使用して各テストの前後にロジックを実行できます意図しないステートの共有を防ぐために含まれている@Test関数のインスタンスごとに個別の@Suiteインスタンスが作成されます
この2つのテストは同じ形で始まりますつまりビデオを作成するための最初のコード行は同じですこれらのテストをスイートにまとめたので繰り返しを減らせますそこで目的の行を取り出してこのようにストアドプロパティに配置します
これで 2つ目のテストから目的の行を削除できます
各テスト関数はそれを含むスイート型の新しいインスタンスで呼び出されるためそれぞれ独自のビデオインスタンスを取得し誤ってステートを共有することはありません
では構成要素をおさらいしましょうテスト関数 expectation 特性スイートについてお話ししましたこれらの要素は次のように Swiftになじむよう設計されています
テスト関数は async/awaitとアクター分離をサポートして Swiftの並列処理とシームレスに連携します
expectationでも async/awaitを使用でき組み込みの言語演算子をすべて利用できます
expectationと特性では Swiftマクロを利用しているため失敗時の詳細な結果を確認できテストごとの情報をコードで直接指定できます
スイートでは値セマンティクスを備えており構造体を使用してステートを分離することが推奨されます
ではこれらの構成要素をテストでよくある問題に適用し対処するためのワークフローを見ていきましょう
テストを実行するタイミングの制御共通点があるテストの関連づけ毎回異なる引数でのテストの繰り返しについて説明します
まずは条件付きのテストです
テストによっては特定のデバイスや環境など実行の条件に制約がある場合がありますその場合は .enabled(if: ...)などの条件特性を適用できます
テストを実行する前に評価する条件を渡し条件がfalseの場合テストはスキップとしてマークされますまたテストを実行しないようにしたい場合もあるでしょうこの場合は .disabled(...)特性を使用できますテスト関数のコメントアウトといった他の手法よりもテストの無効化をおすすめしますテスト内のコードがまだコンパイルできることを確認できるからです
.disabled(...)特性ではコメントを受け付けるのでテストが無効された理由を説明するのに使えますコメントは常に構造化された結果に表示されるため CIシステムの可視性が確保できます
多くの場合テストを無効にする理由はバグ追跡システムで追跡されている問題にありますコメントに加えて .bug(...)特性を他の特性とともに含めて URLで関連する問題を参照できますこれによりそのバグ特性を Xcode 16のテストレポートで確認しクリックしてそのURLにアクセスできます
テストの本体全体が特定バージョンのOSでしか動作しない場合 @available(...)属性をそのテストに配置してどのバージョンで実行するかを制御できます #availableを使用して実行時にチェックするのではなく @available(...)属性を使います @available(...)属性によりテスト用ライブラリでテストにOSバージョンの条件があることが認識されそれを結果により正確に反映できるようになります
次に共通の特性を持つテストを異なるスイートやファイル内のものも含め関連づける方法について説明します Swift Testingではカスタムタグをテストに割り当てられますこのプロジェクトではすでにタグを使っています Test Navigatorの下部にタグがすべて表示されます
これらの各タグが適用されているテストを表示するには新しいモードに切り替えます
先に作成したテストの1つにタグを適用してみます
これを行うには @Test属性を使用して tags特性をテストに追加します
このテストではデータの書式設定ロジックを検証しますこのプロジェクトには書式設定に関連する別のテストがすでにあるので
このテストにも formattingタグを追加しましょう
これにより Test Navigatorでこのタグの下にテストが表示されます
同様にデータの書式設定を検証するテストをもう1つ作成したのでここに追加します
この2つのテストはビデオ情報の書式設定に関するものなのでサブスイートにグループ化しましょう
これで formattingタグを @Suiteまで移動できますこれに含まれるすべてのテストにこのタグが継承されます
最後にこのタグを各@Test関数から削除できますタグが継承されたからです
共通点があるテストにはタグを関連づけることができます例えば特定の機能やサブシステムを検証するすべてのテストに共通のタグを適用できますこれにより特定のタグを使用してすべてのテストを実行できますまたテストレポートでフィルタリングしたり同じタグを持つ複数のテストが失敗し始めた時などに情報を確認することもできます
異なるファイルスイートターゲットのテストにタグを適用できます複数のプロジェクトでのタグの共有もできます
Swift Testingではテストプランにテストを含めるか除外するかを決める時にテストの特定の名前ではなくタグを使用します
最良の結果を得るためにはそれぞれの状況に最も適したタイプの特性を必ず使用しますすべてのシナリオでタグを使うわけではありません例えば実行時の条件を表現する場合は先ほど説明したように .enabled(if ...)を使用します
Xcodeでのテストタグの使用について詳しくは「Go further with Swift Testing」をご覧ください
最後に紹介するワークフローは特に興味深い内容です毎回引数を変えてテストを繰り返すものですこれがなぜ役立つのか具体例を見ていきますこのプロジェクトには各ビデオで言及されている大陸の数を確認するテストが複数あります各テストは同様のパターンに従います新しいvideoLibraryを作成し
名前でビデオを検索し #expectマクロを使用して言及されている大陸の数を確認します
これらのテストは機能しますが多くの繰り返しが必要でテスト対象のビデオが増えるほど重複するコードも増えるため保守が難しくなりますまたこのパターンを使う時は各テストに一意の関数名をつける必要がありますがこれらの名前はわかりにくいのでテスト対象のビデオの名前と一致しなくなる可能性もあります代わりにパラメータ化テストという機能を使用すればすべてのテストを 1つのテストとして記述できますこの1つ目のテストをパラメータ化テストに変換します
最初のステップとしてパラメータをシグネチャに追加します
これを行うとすぐにエラーが生成されこのテストに渡す引数を指定する必要があると表示されます修正しましょう
とりあえず 3つのビデオの名前だけを入力します
ここでは引数を読みやすくするために複数の行に分けていますが好きなように書式設定できます最後のステップとして検索対象となるビデオの名前をテストに渡す引数に置き換えます
これでテスト対象が複数のビデオになったので名前を一般化しましょう
テストの完全名にパラメータラベルが含まれるようになりました
ただし必要に応じて表示名やほかの特性を引数の前に渡して指定することもできます
ではテストを実行してどうなるか見てみましょう
できました成功した結果としてTest Navigatorでそれぞれのビデオが個別のテストのように下に表示されていますこの構造によりとても簡単に引数の追加やテスト範囲の拡大ができます残りのビデオをすべてリストに追加しましょう新しいビデオもいくつかあります
この時点で古い@Test関数は不要になったので削除できます
再度テストを実行し今度も成功するか確認しましょう
最後のほうに追加した新しいビデオの1つが原因で失敗しているようです引数をクリックすると詳細と失敗したexpectationを確認できます
この問題を調べるにはデバッガを使って再実行すると便利ですが時間を節約するために失敗した引数だけを再実行してみましょう Xcode 16では引数を個別に実行できるようになりました Test Navigatorで実行ボタンをクリックするだけですただしその前にブレークポイントをテストの先頭に追加しましょう
もう一度実行してみます
デバッガに表示されるvideoNameは「Scotland Coast」なのでまさに目的の引数を使用してこのテストを実行していることがわかりますここからデバッグをさらに進めて失敗の原因を特定できます概念的にはパラメータ化テストは単一のテストを for…inループで複数回繰り返すのに似ていますこの例ではvideoNamesの配列がありこれをループ処理してテストを実行しますただし for...inループのこうした使い方には欠点がいくつかあります
パラメータ化テストでは各引数の詳細を結果で明確に確認できます引数を個別に再実行できるためきめ細かなデバッグが可能ですまた各引数を並列処理してより効率的に実行できるためすばやく結果を得ることができます
パラメータ化テストはここで説明した方法よりも高度な使い方ができます例えば 2組の入力のすべての組み合わせをテストできます「Go further with Swift Testing」で詳細をご確認ください
このパターンを使ったテストがある場合はパラメータ化テスト関数に変換するのが最善です関数にパラメータを追加し
for...inループを削除して
引数を@Test属性まで移動すれば完了です
次に Swift TestingとXCTestの関係性についてお話ししましょう XCTestをすでに利用している場合はこの新しいテストシステムとの比較やテストの移行方法について疑問に思うかもしれません Swift Testingには XCTestと似ている点もありますが注意すべき重要な違いもいくつかありますすでに説明した構成要素のうちの 3つを比較してみましょうテスト機能 expectation スイートです
XCTestのテストは名前が「test」で始まるメソッドです一方 Swift Testingではテストを @Test属性で明示的に指定するため曖昧さがありません
Swift Testingでは様々な関数がサポートされておりインスタンスメソッドを型で使えるのはもちろん静的関数やグローバル関数も必要に応じて使用できます XCTestとは異なり Swift Testingでは特性を使えるのでテストごとまたはスイートごとに情報を指定できます
また Swift Testingでは別のアプローチで並列化を行います Swift並列処理を使用してインプロセスで動作し iPhoneやApple Watchなどの物理デバイスをサポートします
expectationは 2つのシステム間で大きく異なります XCTestではこの概念はアサーションと呼ばれ XCTAssertで始まる多くの関数を使ってその機能を表します Swift Testingのアプローチは別であり 2つの基本的なマクロである #expectと#requireのみ使用します
多くの専用の関数を使う代わりに通常の式と言語演算子を #expectまたは#requireに渡すことができます
例えば ==を使用して等価性をチェックしたり大なり演算子を使って 2つの値を比較できます
また反対の演算子で expectationを否定するのも簡単です
テストの失敗後にテストを停止する時も処理方法が異なります XCTestでは continueAfterFailureプロパティに falseを指定しそれに続くアサーションが失敗するとテストが停止します
Swift Testingでは #expectの代わりに#requireを使用して必須のexpectationにすることができ失敗するとエラーがスローされますこれによりどのexpectationでテストを停止するか選択できテストの進行に合わせて切り替えることもできます
スイートの型については XCTestがサポートするのはクラスだけで XCTestCaseから継承する必要があります
Swift Testingでは構造体アクタークラスを使用できます推奨の方法である構造体では値セマンティクスを使用して意図しないステートの共有によるバグを回避できます
スイートは@Suite属性で明示的に示すこともできますがテスト関数やネストされたスイートを含むすべての型に対して暗黙的に設定されますこの属性が必要となるのは表示名やほかの特性を指定する時だけです
各テストの実行前にロジックを実行する場合 XCTestではsetUpメソッドを使いますが Swift Testingでは型のイニシャライザを使い asyncまたはthrowsにできます
各テストの後にロジックを実行する必要がある場合はデイニシャライザを指定できますデイニシャライザを使えるのはスイートの型がアクターかクラスの時だけでそれがスイートに構造体ではなく参照型を使う最も一般的な理由です
最後に Swift Testingではネストされた型によってテストをサブグループにグループ化できます
XCTestとSwift Testingのテストは単一のターゲットで共存できるため移行する場合は段階的に進めることができ新しいターゲットを最初に作成する必要はありません
同様の構造を持つ複数のXCTestメソッドを移行する場合は 1つのパラメータ化テストにそれらのメソッドを統合できますこれは先ほど説明した通りですテストメソッドが1つしかない XCTestクラスについてはグローバルの@Test関数に移行することを検討してくださいまたテストに名前をつける時に先頭に「test」という語は不要です
次のようなテストでは XCTestを引き続き使用してください XCUIApplicationなどの UI自動化APIや XCTMetricなどの性能テストAPIを使ったテストですこれらは Swift Testingのサポート対象外です
Objective-Cでしか記述できないテストにも XCTestを使用する必要がありますが Swift Testingを使用すると別の言語で記述されたコードを検証するテストを Swiftで作成できます最後に Swift Testingのテストから XCTestアサーション関数を呼び出すことや逆に XCTestから#expectマクロを呼び出すのは避けてください
「Migrating a test from XCTest」のドキュメントをご覧くださいアサーションの変換や非同期待機状態の処理などについて様々な詳細情報が記載されています
以上 Swift Testingの機能について説明しその使い方をいくつか紹介しましたこの新しいパッケージはまだ始まったばかりでありコミュニティで進化し続けていくことをとても楽しみにしています Swift Testingはオープンソースとして GitHubでホストされています最近発表された Swiftlang Organizationに近日中に移行しますこれはSwift並列処理をサポートする AppleのすべてのOSに加えて LinuxやWindowsでも動作しますそして注目点としてこれらすべてのプラットフォームに共通するコードベースを備えています複数の実装を抱えるXCTestに比べて大きな改善ですそのためプラットフォーム間でテストを移動しても一貫性のある動作となり異なるプラットフォームでも機能の同等性が高くなります
Swift Testingは Swiftエコシステムの主なツールとIDEに統合されていますコマンドラインの Swift Package Manager Xcode 16 最新版のSwift Extensionに対応した VS Codeと連携します
Swift Testingのコマンドラインでの使用を見てみましょうこのシンプルなパッケージは Xcode 16の新規パッケージ用のテンプレートを使って作成したものですターミナルから「swift test」と入力すればこのパッケージのテストを実行できます
XCTestとSwift Testingの両方のテストが実行されます成功と失敗の結果が色分けされた出力で表示され Xcodeの場合と同様に詳細な失敗メッセージも示されます Swift Testingにはオープンな機能提案プロセスがありその進化について Swift Forumsで意見を交換しています機能提案の作成や共同提出ドキュメントの改善バグレポートの提出などを通じてぜひご参加くださいあらゆる貢献を歓迎いたします以上 Swift Testingのご紹介でした expectationやパラメータ化テストなどの強力な機能を使用してコードの品質を高め特性を使用してテストをカスタマイズし GitHubとフォーラムに参加してこのパッケージの未来を形作りましょう「Go further with Swift Testing」もぜひチェックしてテストを改善するための様々な方法をご確認くださいご視聴ありがとうございました

import Testing

@Test func videoMetadata() {
    // ...
}

2:35 - Validate an expected condition using #expect

import Testing
@testable import DestinationVideo

@Test func videoMetadata() {
    let video = Video(fileName: "By the Lake.mov")
    let expectedMetadata = Metadata(duration: .seconds(90))
    #expect(video.metadata == expectedMetadata)
}

4:24 - Fix a bug in the code being tested

// In `Video.init(...)`
self.metadata = Metadata(forContentsOfUrl: url)

6:06 - Add a display name to a @Test function

@Test("Check video metadata") func videoMetadata() {
    let video = Video(fileName: "By the Lake.mov")
    let expectedMetadata = Metadata(duration: .seconds(90))
    #expect(video.metadata == expectedMetadata)
}

6:58 - Add a second @Test function

@Test func rating() async throws {
    let video = Video(fileName: "By the Lake.mov")
    #expect(video.contentRating == "G")
}

7:18 - Organize @Test functions into a suite type

struct VideoTests {

    @Test("Check video metadata") func videoMetadata() {
        let video = Video(fileName: "By the Lake.mov")
        let expectedMetadata = Metadata(duration: .seconds(90))
        #expect(video.metadata == expectedMetadata)
    }

    @Test func rating() async throws {
        let video = Video(fileName: "By the Lake.mov")
        #expect(video.contentRating == "G")
    }

}

8:04 - Factor a common value into a stored property in the suite

struct VideoTests {
    let video = Video(fileName: "By the Lake.mov")

    @Test("Check video metadata") func videoMetadata() {
        let expectedMetadata = Metadata(duration: .seconds(90))
        #expect(video.metadata == expectedMetadata)
    }

    @Test func rating() async throws {
        #expect(video.contentRating == "G")
    }

}

9:32 - Specify a runtime condition trait for a @Test function

@Test(.enabled(if: AppFeatures.isCommentingEnabled))
func videoCommenting() {
    // ...
}

9:49 - Unconditionally disable a @Test function

@Test(.disabled("Due to a known crash"))
func example() {
    // ...
}

10:15 - Include a bug trait with a URL along with other traits

@Test(.disabled("Due to a known crash"),
      .bug("example.org/bugs/1234", "Program crashes at <symbol>"))
func example() {
    // ...
}

10:33 - Conditionalize a test based on OS version

@Test
@available(macOS 15, *)
func usesNewAPIs() {
    // ...
}

10:42 - Prefer @available on @Test function instead of #available within the function

// ❌ Avoid checking availability at runtime using #available
@Test func hasRuntimeVersionCheck() {
    guard #available(macOS 15, *) else { return }

    // ...
}

// ✅ Prefer @available attribute on test function
@Test
@available(macOS 15, *)
func usesNewAPIs() {
    // ...
}

11:22 - Add a tag to a @Test function

@Test(.tags(.formatting)) func rating() async throws {
    #expect(video.contentRating == "G")
}

11:48 - Add another data formatting-related test with the same tag

@Test(.tags(.formatting)) func formattedDuration() async throws {
    let videoLibrary = try await VideoLibrary()
    let video = try #require(await videoLibrary.video(named: "By the Lake"))
    #expect(video.formattedDuration == "0m 19s")
}

11:56 - Group related tests into a sub-suite

struct MetadataPresentation {
    let video = Video(fileName: "By the Lake.mov")

    @Test(.tags(.formatting)) func rating() async throws {
        #expect(video.contentRating == "G")
    }

    @Test(.tags(.formatting)) func formattedDuration() async throws {
        let videoLibrary = try await VideoLibrary()
        let video = try #require(await videoLibrary.video(named: "By the Lake"))
        #expect(video.formattedDuration == "0m 19s")
    }
}

12:05 - Move common tags trait to @Suite attribute, so the suite's @Test functions will inherit the tag

@Suite(.tags(.formatting))
struct MetadataPresentation {
    let video = Video(fileName: "By the Lake.mov")

    @Test func rating() async throws {
        #expect(video.contentRating == "G")
    }

    @Test func formattedDuration() async throws {
        let videoLibrary = try await VideoLibrary()
        let video = try #require(await videoLibrary.video(named: "By the Lake"))
        #expect(video.formattedDuration == "0m 19s")
    }
}

13:27 - Example of some repetitive tests which can be consolidated into a parameterized @Test function

struct VideoContinentsTests {

    @Test func mentionsFor_A_Beach() async throws {
        let videoLibrary = try await VideoLibrary()
        let video = try #require(await videoLibrary.video(named: "A Beach"))
        #expect(!video.mentionedContinents.isEmpty)
        #expect(video.mentionedContinents.count <= 3)
    }

    @Test func mentionsFor_By_the_Lake() async throws {
        let videoLibrary = try await VideoLibrary()
        let video = try #require(await videoLibrary.video(named: "By the Lake"))
        #expect(!video.mentionedContinents.isEmpty)
        #expect(video.mentionedContinents.count <= 3)
    }

    @Test func mentionsFor_Camping_in_the_Woods() async throws {
        let videoLibrary = try await VideoLibrary()
        let video = try #require(await videoLibrary.video(named: "Camping in the Woods"))
        #expect(!video.mentionedContinents.isEmpty)
        #expect(video.mentionedContinents.count <= 3)
    }

    // ...and more, similar test functions
}

14:07 - Refactor several similar tests into a parameterized @Test function

struct VideoContinentsTests {

    @Test("Number of mentioned continents", arguments: [
        "A Beach",
        "By the Lake",
        "Camping in the Woods",
        "The Rolling Hills",
        "Ocean Breeze",
        "Patagonia Lake",
        "Scotland Coast",
        "China Paddy Field",
    ])
    func mentionedContinentCounts(videoName: String) async throws {
        let videoLibrary = try await VideoLibrary()
        let video = try #require(await videoLibrary.video(named: videoName))
        #expect(!video.mentionedContinents.isEmpty)
        #expect(video.mentionedContinents.count <= 3)
    }

}

16:29 - Example of using a for…in loop to repeat a test, instead of a parameterized @Test function (not recommended)

// Using a for…in loop to repeat a test (not recommended)
@Test func mentionedContinentCounts() async throws {
    let videoNames = [
        "A Beach",
        "By the Lake",
        "Camping in the Woods",
    ]

    let videoLibrary = try await VideoLibrary()
    for videoName in videoNames {
        let video = try #require(await videoLibrary.video(named: videoName))
        #expect(!video.mentionedContinents.isEmpty)
        #expect(video.mentionedContinents.count <= 3)
    }
}

17:15 - Refactor a test using a for…in loop into a parameterized @Test function

@Test(arguments: [
    "A Beach",
    "By the Lake",
    "Camping in the Woods",
])
func mentionedContinentCounts(videoName: String) async throws {
    let videoLibrary = try await VideoLibrary()
    let video = try #require(await videoLibrary.video(named: videoName))
    #expect(!video.mentionedContinents.isEmpty)
    #expect(video.mentionedContinents.count <= 3)
}

22:47 - A newly-created Swift package with two simple @Test functions

import Testing
@testable import MyLibrary

@Test func example() throws {
    #expect("abc" == "abc")
}

@Test func failingExample() throws {
    #expect(123 == 456)
}

22:56 - Running all tests for the package from Terminal
```
> swift test
```

特定のトピックをお探しの場合は、上にトピックを入力すると、関連するトピックにすばやく移動できます。

クエリの送信中にエラーが発生しました。インターネット接続を確認して、もう一度お試しください。

関連する章

リソース

関連ビデオ

WWDC24