Skip to main content


To add the TestFairy plugin to your Ioic 3 project, follow the instructions below.


Run the following commands from your application root folder:

ionic cordova plugin add com.testfairy.cordova-plugin

Alternatively, you can install it directly from GitHub:

ionic cordova plugin add


To upgrade your plugin, run the following:

ionic cordova plugin update com.testfairy.cordova-plugin


Initialize TestFairy with your App Token by calling TestFairy.begin. Your APP TOKEN is available at

We recommend invoking TestFairy.begin from platform.ready() in src/app/app.component.ts. Also, declare TestFairy at the top of the file.

import { Component } from '@angular/core';
import { Platform } from 'ionic-angular';
import { StatusBar } from '@ionic-native/status-bar';
import { SplashScreen } from '@ionic-native/splash-screen';

import { HomePage } from '../pages/home/home';

// Declare the TestFairy instance
declare var TestFairy: any;

templateUrl: 'app.html'
export class MyApp {
rootPage:any = HomePage;

constructor(platform: Platform, statusBar: StatusBar, splashScreen: SplashScreen) {
platform.ready().then(() => {
TestFairy.begin(APP TOKEN);
// Okay, so the platform is ready and our plugins are available.
// Here you can do any higher level native things you might need.

We do not support plugin mocking or browser development. During your development phase, we recommend checking for the existence of TestFairy on the window object before invoking any methods on the TestFairy object, for example

// Check if TestFairy is available (will be undefined in browser)
if ((<any>window).TestFairy) {
TestFairy.begin(APP TOKEN);

Identifying Your Users

See the SDK Documentation /testfairy/sdk/identifying-users#cordova for more information.

Session Attributes

See the SDK Documentation /testfairy/sdk/session-attributes#cordova for more information.

Remote Logging

See the SDK Documentation /testfairy/sdk/remote-logging#cordova for more information.

Where To Go From Here?

Congratulations. You've successfully integrated TestFairy into your Ionic project. Visit your dashboard, to see your app listed.

  • Look at the API documentation for other calls to the TestFairy plugin.

  • Follow the project on GitHub for updates, bug reports, or to contribute to the project.