MockUIAlertController

MockUIAlertController lets you mock iOS alerts and action sheets for unit tests, based on the UIAlertController introduced for iOS 8.

(For old UIAlertView or UIActionSheet mocking, use MockUIAlertViewActionSheet.)

No actual alerts are presented. This means:

The workflow doesn't pause for an action to be selected
Tests are blazing fast.

For more discussion, see my blog post How to Test UIAlertControllers and Control Swizzling.

Adding it to your project

CocoaPods

Add the following to your Podfile, changing "MyTests" to the name of your test target:

target :MyTests, :exclusive => true do
  pod 'MockUIAlertController', '~> 1.0'
end

Carthage

Add the following to your Cartfile:

github "jonreid/MockUIAlertController" ~> 1.0

Building It Yourself

Make sure to take everything from Source/MockUIAlertController.

Writing Tests

What do I need to change in production code?

Nothing.

How do I test an alert controller?

#import <MockUIAlertController/QCOMockAlertVerifier.h>
Instantiate a QCOMockAlertVerifier before the execution phase of the test.
Invoke the code to create and present your alert or action sheet.

Information about the alert or action sheet is then available through the QCOMockAlertVerifier.

For example, here's a test verifying the title. sut is the system under test in the test fixture.

- (void)testShowAlert_AlertShouldHaveTitle
{
    QCOMockAlertVerifier *alertVerifier = [[QCOMockAlertVerifier alloc] init];

    [sut showAlert:nil];

    XCTAssertEqualObjects(alertVerifier.title, @"Title");
}

How can I invoke the block associated with a UIAlertAction?

Go through the steps above to present your alert or action sheet using QCOMockAlertController. Then call -executeActionForButtonWithTitle: on your QCOMockAlertVerifier with the button title. For example:

- (void)testShowAlert_ExecutingActionForOKButton_ShouldDoSomething
{
    QCOMockAlertVerifier *alertVerifier = [[QCOMockAlertVerifier alloc] init];

    [sut showAlert:nil];
    [alertVerifier executeActionForButtonWithTitle:@"OK"];

    // Now assert what you want
}

Can I see some examples?

See the sample app. Run it on both phone & pad to see what it does, then read the ViewController tests.

batesyuk / MockUIAlertController