プロトコル


Trait


テスト関数またはテストスイートに追加できる特性を記述するプロトコル。


iOS iPadOS Mac Catalyst macOS tvOS visionOS

watchOS Swift 6.0+ Xcode 16.0+

protocol Trait : Sendable






概観


テストライブラリは、テスト関数やテストスイートに追加できる多数の特性を定義しています。TestTrait または SuiteTrait に準拠した型を作成することで、独自の特性を定義することができます。


TestTrait

テスト関数に追加する特性では、この型に準拠します。


SuiteTrait

テストスイートに追加する特性では、この型に準拠します。


TestTraitSuiteTrait の両方に準拠する特性を追加すると、テスト関数とテストスイートに特性を追加できます。





テストの有効化と無効化


static func enabled(if: @autoclosure () throws -> Bool, Comment?, sourceLocation: SourceLocation) -> Self

false を返す場合にテストを無効にする条件特性を構築します。


static func enabled(Comment?, sourceLocation: SourceLocation, () async throws -> Bool) -> Self

false を返す場合にテストを無効にする条件特性を構築します。


static func disabled(Comment?, sourceLocation: SourceLocation) -> Self

テストを無条件に無効にする条件特性を構築します。


static func disabled(if: @autoclosure () throws -> Bool, Comment?, sourceLocation: SourceLocation) -> Self

その値が true の場合にテストを無効にする条件特性を構築します。


static func disabled(Comment?, sourceLocation: SourceLocation, () async throws -> Bool) -> Self

その値が true の場合にテストを無効にする条件特性を構築します。



テストの実行方法を制御する


static func timeLimit(TimeLimitTrait.Duration) -> Self

テストの実行時間が長すぎる場合にタイムアウトする時間制限特性を構築します。


static var serialized: ParallelizationTrait

適用されたテストを連続処理化する特性。



テストの分類と情報の追加


static func tags(Tag...) -> Self

テストに適用するタグのリストを作成します。


var comments: [Comment]

この特性に対するユーザー提供のコメント。

必須 デフォルトの実装が提供されます。



関連するバグ


static func bug(String, Comment?) -> Self

テストで追跡するバグを構築します。


static func bug(String?, id: String, Comment?) -> Self

テストで追跡するバグを構築します。


static func bug(String?, id: some Numeric, Comment?) -> Self

テストで追跡するバグを構築します。



テストまたはスイートの前後にコードを実行する


protocol TestScoping

テストスイートまたはテスト関数を実行する前後にカスタムコードを実行するようにテストランナーに指示するプロトコル。


func scopeProvider(for: Test, testCase: Test.Case?) -> Self.TestScopeProvider?

指定されたテストとオプションのテストケースのこの特性のスコーププロバイダーを取得します。

必須 デフォルトの実装が提供されます。


associatedtype TestScopeProvider : TestScoping = Never

この特性のテストスコーププロバイダーの型。

必須


func prepare(for: Test) async throws

この特性を持つテストを実行する準備をします。

必須 デフォルトの実装が提供されます。





関連


以下からの継承


Sendable

SendableMetatype



以下により継承


SuiteTrait

TestTrait



準拠する型


Bug

Comment

ConditionTrait

ParallelizationTrait

Tag.List

TimeLimitTrait





以下も見よ


カスタム特性の作成


protocol TestTrait

テスト関数に追加できる特性を記述するプロトコル。


protocol SuiteTrait

テストスイートに追加できる特性を記述するプロトコル。


protocol TestTrait

テストスイートまたはテスト関数を実行する前または後にカスタムコードを実行するようにテスト実行者に指示するプロトコル。














トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ