インスタンスメソッド

provideScope(for:testCase:performing:)

指定されたテストまたはテストケースに関連する関数呼び出しのカスタム実行スコープを提供します。

 func provideScope(
     for test: Test,
     testCase:  Test.Case?,
     performing function: () async throws -> Void
 ) async throws
 

必須

パラメータ

test

function (関数) がカプセル化するテスト。

testCase

function (関数) がカプセル化するテストケース（存在する場合）。スイートで呼び出された場合、この引数の値は nil になります。

function

実行する関数。test がテストスイートを表す場合、この関数はそのスイート内のすべてのテストの実行をカプセル化します。test がテスト関数を表す場合、この関数はそのテスト関数の本体となります（テスト関数がパラメータ化されている場合は、すべてのケースを含みます）。

議論

テストライブラリは、テスト実行の準備として、まずそのテストに適用されているすべての特性（包含スイートから継承されたものも含む）を検索します。まず、継承されたスイートの特性を外側から内側へと並べ替え、テストが関数の場合は、その関数に直接適用されているすべての特性を適用順（左から右）に追加します。次に、scopeProvider(for:testCase:) を呼び出して、各特性のスコーププロバイダ（存在する場合）を問い合わせます。最後に、nil 以外のすべてのスコーププロバイダに対してこのメソッドを呼び出し、function の呼び出し前後に任意の処理を実行する機会を与えます。

このメソッドは、戻る前に function を一度呼び出すか、カスタムスコープを提供できない場合はエラーを throw する必要があります。

このメソッドによって記録される問題は、test に関連しています。