Logging

Sauce Mobile App Distribution gives you the ability to log all your network requests. It gives you an effortless way to monitor your app's network access.

Android

TestFairy.addNetworkEvent(URI uri, String method, int code, long startTimeMillis, long endTimeMillis, long requestSize, long responseSize, String errorMessage);

ExampleIf you are using OkHttp or Retrofit all you need to do is add CustomHttpInterceptor to your client:

// Be sure to import Sauce Mobile App Distribution
import com.testfairy.TestFairy;

public class CustomHttpInterceptor implements Interceptor {
    @Override
    public Response intercept(@NonNull Chain chain) throws IOException {

        Request request = chain.request();
        long startTimeMillis = System.currentTimeMillis();
        Long requestSize = request.body() != null ? request.body().contentLength() : 0;
        Response response;
        try {
            response = chain.proceed(request);
        } catch (IOException e) {
            long endTimeMillis = System.currentTimeMillis();
            TestFairy.addNetworkEvent(request.url().uri(), request.method(), -1, startTimeMillis, endTimeMillis, requestSize, -1, e.getMessage());
            throw e;
        }

        long endTimeMillis = System.currentTimeMillis();
        long responseSize = response.body() != null ? response.body().contentLength() : 0;
        TestFairy.addNetworkEvent(request.url().uri(), request.method(), response.code(), startTimeMillis, endTimeMillis, requestSize, responseSize, null);
        return response;
    }
}


OkHttpClient client = new OkHttpClient.Builder()
    .addInterceptor(new CustomHttpInterceptor())
    .build();

iOS Objective C

[TestFairy addNetwork:(NSURLSessionTask *)task error:(NSError *)error]

ExampleIf you are using NSURLConnection, all you need to do is add callback to your request at the beginning and end of the request.

note

If you have AFNetworking added to your project, network requests are automatically captured when enabled in your build settings.

// Be sure to import Sauce Mobile App Distribution
#import "TestFairy.h"

__block NSURLSessionTask *task = [[NSURLSession sharedSession] dataTaskWithURL:url completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
    // ...
    [TestFairy addNetwork:task error:error];
}];
[TestFairy addNetwork:task error:nil];
[task resume];

iOS Swift

TestFairy.addNetwork(<URLSessionTask>, error:<NSError>)

ExampleIf you are using URLConnection, all you need to do is add callback to your request at the beginning and end of the request:

var task: URLSessionTask? = nil
task = URLSession.shared.dataTask(with: URL(string:"")!) { (data, response, error) in
    TestFairy.addNetwork(task, error: error)
}
TestFairy.addNetwork(task, error: nil)
task?.resume()

With Alamofire:

import Alamofire

NotificationCenter.default.addObserver(forName: Request.didResume, object: nil, queue: nil) { (notification) in
    let info = notification.userInfo
    let request = info?["org.alamofire.notification.key.request"] as! Request
    request.tasks.forEach { TestFairy.addNetwork($0, error: nil) }
}

NotificationCenter.default.addObserver(forName: Request.didComplete, object: nil, queue: nil) { (notification) in
    let info = notification.userInfo
    let request = info?["org.alamofire.notification.key.request"] as! Request
    request.tasks.forEach { TestFairy.addNetwork($0, error: nil) }
}

React Native

ExampleSauce Mobile App Distribution supports network logging for Fetch API. Call the following method to start capturing network calls.

// Capture network logs
TestFairy.enableNetworkLogging(window);

// Capture network logs, including http headers and content
TestFairy.enableNetworkLogging(window, { includeHeaders: true, includeBodies: true });

// Disable network logging
TestFairy.disableNetworkLogging(window);

Exception Logging

Sauce Mobile App Distribution allows developers to log up to five exceptions or errors for a session.

note

It does not mark the sessions as crashed; it will only log the exception or error to the session.

Android

TestFairy.logThrowable(<throwable exception>);

Example

// Be sure to import Sauce Mobile App Distribution
import com.testfairy.TestFairy;

TestFairy.logThrowable(new Throwable("Some Message"));

iOS Objective C

[TestFairy logError:<NSError>];
[TestFairy logError:<NSError> stacktrace:<NSArray<NSString>>];

Example

// Be sure to import Sauce Mobile App Distribution
#import "TestFairy.h"

[TestFairy logError:[NSError errorWithDomain:@"com.your.domain" code:-1 userInfo:@{NSLocalizedDescriptionKey: @"Some Message"}]];

iOS Swift

TestFairy.logError(<NSError>)
TestFairy.logError(<NSError>, stacktrace:<[String]>)

Example

let error = NSError(domain: "com.your.domain", code: -1, userInfo: [NSLocalizedDescriptionKey : "Some Message"])
TestFairy.logError(error)

Cordova

TestFairy.logException(<Error>);

Example

var error = new Error("Some Message");
TestFairy.logException(error);

We recommend adding a listener to the window to capture error statements, automatically sending the exception to TestFairy sessions. One suggestion we have is to add a method that looks like this:

window.addEventListener("error", function(e) {
    TestFairy.logException(e);
});

React Native

TestFairy.logException(<Error>);

Example

// Be sure to import Sauce Mobile App Distribution
const TestFairy = require('react-native-testfairy');

var error = new Error("Some Message");
TestFairy.logException(error);

We recommend replacing the Global Handler with a custom method, automatically sending the exception to Sauce Mobile App Distribution sessions. One suggestion we have is to add a method that looks like this:

var ErrorUtils = require('ErrorUtils');
var originalGlobalHandler = ErrorUtils.getGlobalHandler();
ErrorUtils.setGlobalHandler((error, isFatal) => {
    TestFairy.logException(error);
    originalGlobalHandler.handleException(error, isFatal);
});

Nativescript

TestFairySDK.logException(<Error>);

Example

// Be sure to import Sauce Mobile App Distribution
import { TestFairySDK } from 'nativescript-testfairy';

var error = new Error("Some Message");
TestFairySDK.logException(error);

We recommend adding a listener to the window to capture error statements, automatically sending the exception to Sauce Mobile App Distribution sessions. One suggestion we have is to add a method that looks like this:

window.addEventListener("error", function(e) {
    TestFairy.logException(e);
});