---
title: "testSuiteWillStart(_:)"
framework: xctest
role: symbol
role_heading: Instance Method
path: "xctest/xctestobservation/testsuitewillstart(_:)"
---

# testSuiteWillStart(_:)

Notifies the observer immediately before a test suite begins executing.

## Declaration

```swift
optional func testSuiteWillStart(_ testSuite: XCTestSuite)
```

## Parameters

- `testSuite`: The test suite that is about to start. Additional information about the suite can be retrieved from the test suite’s associated doc://com.apple.xctest/documentation/XCTest/XCTestRun.

## See Also

### Observation Methods

- [testBundleWillStart(_:)](xctest/xctestobservation/testbundlewillstart(_:).md)
- [testCaseWillStart(_:)](xctest/xctestobservation/testcasewillstart(_:).md)
- [testCase(_:didRecord:)](xctest/xctestobservation/testcase(_:didrecord:)-4cou6.md)
- [testCase(_:didRecord:)](xctest/xctestobservation/testcase(_:didrecord:)-8k955.md)
- [testCase(_:didFailWithDescription:inFile:atLine:)](xctest/xctestobservation/testcase(_:didfailwithdescription:infile:atline:).md)
- [testCaseDidFinish(_:)](xctest/xctestobservation/testcasedidfinish(_:).md)
- [testSuite(_:didRecord:)](xctest/xctestobservation/testsuite(_:didrecord:)-3rk9k.md)
- [testSuite(_:didRecord:)](xctest/xctestobservation/testsuite(_:didrecord:)-1xjkv.md)
- [testSuite(_:didFailWithDescription:inFile:atLine:)](xctest/xctestobservation/testsuite(_:didfailwithdescription:infile:atline:).md)
- [testSuiteDidFinish(_:)](xctest/xctestobservation/testsuitedidfinish(_:).md)
- [testBundleDidFinish(_:)](xctest/xctestobservation/testbundledidfinish(_:).md)