---
title: XCTExpectFailure
framework: xctest
role: symbol
role_heading: Function
path: xctest/xctexpectfailure
---

# XCTExpectFailure

Instructs the test to expect a failure in an upcoming assertion.

## Declaration

```occ
extern void XCTExpectFailure(NSString *failureReason);
```

## See Also

### Expected Failures

- [XCTExpectedFailure](xctest/xctexpectedfailure.md)
- [XCTExpectedFailure.Options](xctest/xctexpectedfailure/options.md)
- [XCTExpectFailureInBlock](xctest/xctexpectfailureinblock.md)
- [XCTExpectFailureWithOptions](xctest/xctexpectfailurewithoptions.md)
- [XCTExpectFailureWithOptionsInBlock](xctest/xctexpectfailurewithoptionsinblock.md)