関数

withKnownIssue(_:isIntermittent:source
Location:_:)

その実行中に発生することが予想される既知の問題を持つ関数を呼び出します。

func withKnownIssue(
    _ comment: Commnent? = nil,
    isIntermittent: Bool = false,
    sourceLocation: SourceLocation = #_sourceLocation,
    _ body: () throws -> Void
)

パラメータ

comment

既知の問題を説明するオプションのコメント。

isIntermittent

既知の問題が断続的に発生するかどうか。この引数が true で、既知の問題が発生しない場合は、二次的な問題は記録されません。

sourceLocation

記録された問題の原因となるソースの場所。

body

呼び出すべき関数。

以下で言及

XCTest からのテストの移行

議論

この関数は、テストが失敗しないはずの問題が 1 つ以上記録されることが分かっている場合に使用します。例えば:

@Test func example() {
  withKnownIssue {
    try flakyCall()
  }
}

body によって throw されるすべてのエラーは既知の問題として捕捉されるため、この関数は throw しません。一部のエラーまたは問題のみが既知の状態で発生し、他のエラーまたは問題が引き続きテストの失敗を引き起こす場合は、代わりに withKnownIssue(_:isIntermittent:sourceLocation:_:when:matching:) を使用してください。

以下も見よ

関連する文書

テストを実行するときに、問題を既知としてマークします。

テストで既知の問題を記録する

func withKnownIssue(Comment?, isIntermittent: Bool, isolation: isolated (any Actor)?, sourceLocation: SourceLocation, () async throws -> Void) async

その実行中に発生することが予想される既知の問題を持つ関数を呼び出します。

func withKnownIssue(Comment?, isIntermittent: Bool, sourceLocation: SourceLocation, () throws -> Void, when: () -> Bool, matching: KnownIssueMatcher) rethrows

その実行中に発生することが予想される既知の問題を持つ関数を呼び出します。

func withKnownIssue(Comment?, isIntermittent: Bool, isolation: isolated (any Actor)?, sourceLocation: SourceLocation, () async throws -> Void, when: () async -> Bool, matching: KnownIssueMatcher) async rethrows

その実行中に発生することが予想される既知の問題を持つ関数を呼び出します。

typealias KnownIssueMatcher

既知の問題と一致させるために使用される関数。