Unit Testing Objective-C asychronous block-based API
March 10, 2014Unit Testing Objective-C block-based API
We are starting to utilize more Unit Testing for business logic and behavior design that’s going on under the hood in our apps.
Using Objective-C blocks for asynchronous operations in Apple’s Cocoa framework is an increasingly popular pattern. Built-in libraries such as Core Animation & Core Motion and 3rd-party libraries like AFNetworking utilize blocks extensively for asynchronous callbacks.
NSDictionary *params = @{@"id":@2}; [[MLStore sharedStore] GETWithParameters:params completionBlock:^void(id responseObject, NSError *err) { // do something with responseObject passed by block XCTAssert(responseObject != nil, @"GET response should not be nil."); }];
This will succeed every time because, most likely, the test case will have terminated by the time the block completes/returns to the caller. The test never fails because the Assert will never even be evaluated. So what’s the solution? Stack Overflow to the rescue!
My favorite (and simplest to understand, in my opinion) answer from that SO question is to use Grand Central Dispatch and the built-in semaphore constructs.
NSInterval TIMEOUT = 5.0; // create a semaphore with initial value of 0 dispatch_semaphore_t sem = dispatch_semaphore_create(0); [myConcurrentAPI doSomethingWithCompletion:^(id data, NSError *error) { // check error and do stuff with data dispatch_semaphore_signal(sem); // signal to OS to release/decrement semaphore }]; // check for the Semaphore signal but keep executing the main // run loop for TIMEOUT seconds while (dispatch_semaphore_wait(sem, DISPATCH_TIME_NOW)) { [[NSRunLoop currentRunLoop] runMode:NSDefaultRunLoopMode beforeDate:[NSDate dateWithTimeIntervalSinceNow:TIMEOUT]]; }
The program will execute the method with the aynchronous block, then stick at the while loop but continue executing the main run loop (i.e. not blocking execution of the main or other threads.) Once the block returns/completes, it signals the semaphore (a little bit of shared memory managed by the runtime/operating system) and your test method continues or completes.
If you need test multiple async calls in the same method, I recommend creating a new semaphore variable each time – don’t reuse an exisiting one.
Here are three C preprocessor macros that simplify the code a bit. You still need to provide a variable name but semicolons are optional.
#define SemaphoreSetup(SEM_NAME) dispatch_semaphore_t SEM_NAME = dispatch_semaphore_create(0); #define SemaphoreSignal(SEM_NAME) dispatch_semaphore_signal(SEM_NAME); #define SemaphoreWait(SEM_NAME) while (dispatch_semaphore_wait(SEM_NAME, DISPATCH_TIME_NOW)) { [[NSRunLoop currentRunLoop] runMode:NSDefaultRunLoopMode beforeDate:[NSDate dateWithTimeIntervalSinceNow:TIMEOUT]]; } /* Then use like this */ SemaphoreSetup(sem) [[MLStore sharedStore] GETWithParameters:params completionBlock:^void(id responseObject, NSError *err) { // do something with responseObject passed by block XCTAssert(responseObject != nil, @"GET response should not be nil."); SemaphoreSignal(sem) }]; SemaphoreWait(sem)
Happy Testing!
Looking for more like this?
Sign up for our monthly newsletter to receive helpful articles, case studies, and stories from our team.
![The value of AR for business leaders (and when not to bother)](https://gratis-creeper.transforms.svdcdn.com/staging/blog/vision-pro-thumbnail.jpg?w=1080&h=1080&auto=compress%2Cformat&fit=crop&dm=1713966581&s=3a15322fcde2cb162de374485e5e8dfe)
The value of AR for business leaders (and when not to bother)
April 24, 2024Should you leverage AR for your new digital products? Should you build an app for Apple’s Vision Pro? Discover four common use cases for AR and when to focus your energy elsewhere.
Read more![Business Model Canvas: Helping business leaders create meaningful digital products](https://gratis-creeper.transforms.svdcdn.com/staging/blog/business-model-canvas-banner.png?w=2134&h=2134&auto=compress%2Cformat&fit=crop&dm=1708017446&s=6819f217da230139bcb0d54fb1fbc189)
Business Model Canvas: Helping business leaders create meaningful digital products
January 17, 2024When it comes to custom software, it’s easy to feel stuck between needing to deliver value quickly, while also ensuring meaningful, long-lasting results. Learn why the Business Model Canvas can help you identify the right digital product for your business needs.
Read more![Why Use Flutter?](https://gratis-creeper.transforms.svdcdn.com/staging/blog/1544607_blog-post-social-image_011723.png?w=696&h=320&q=75&auto=format&fit=crop&dm=1708017377&s=5bfd33f9da9e880381ff782f72d11661)
Why Use Flutter?
January 18, 2023We discuss Flutter, a framework for building Android and iOS apps with a single codebase, created by Google in 2018. Given the increasing popularity of smartphones and mobile-first experiences, it is essential to cover not only Android and iOS platforms but also the mobile-first web.
Read more