A Karma plugin. Launch any browser on TestingBot!
npm install karma-testingbot-launcher
 
  
> Run your tests on the TestingBot browser cloud!
Install karma-testingbot-launcher as a devDependency in your package.json:
``bash`
npm install karma-testingbot-launcher --save-dev
This launcher is used to run your tests across many browsers and platforms on TestingBot. Typically this runner is used in a CI (Continuous Integration) system.
To use and configure this launcher, you will need to add two properties to your top-level Karma config, testingbot and customLaunchers, set the browsers array to use TestingBot browsers, and add the testingbot reporter.
The testingbot object defines global properties for each browser/platform while the customLaunchers object configures individual browsers. The testingbot reporter will send back the test success state to https://testingbot.com. Here is a sample Karma config to get the launcher running:
`js
module.exports = function(config) {
// Check out https://testingbot.com/support/getting-started/browsers.html for all browser possibilities
var customLaunchers = {
TB_chrome: {
base: 'TestingBot',
browserName: 'chrome',
platform: 'Windows 7',
version: '35'
},
TB_firefox: {
base: 'TestingBot',
browserName: 'firefox',
version: '30'
}
}
config.set({
// The rest of your karma config is here
// ...
testingbot: {
testName: 'Web App Unit Tests'
},
customLaunchers: customLaunchers,
browsers: Object.keys(customLaunchers),
reporters: ['dots', 'testingbot'],
singleRun: true
})
}
`
Note: this config assumes that process.env.TB_KEY and process.env.TB_SECRET are set.
config properties shared across all browsers
Default: process.env.TB_KEYYour TestingBot api key, you can sign up here.
$3
Type: String
Default: process.env.TB_SECRETYour TestingBot api secret which you will see on your account page.
$3
Type: Boolean
Default: trueIf
true, TestingBot Tunnel will be started automatically. Set this to false if you are launching tests locally and want to start TestingBot manually.$3
Type: Object
Default:
`js
{
apiKey: 'apiKey',
apiSecret: 'apiSecret',
tunnelIdentifier: 'tunnelId' //optional
}
`Options to send to TestingBot. Check here for all available options.
$3
Type: String
default: hub.testingbot.com$3
Type: Number
default: 80$3
Type: String
Default: One of the following environment variables:
process.env.BUILD_NUMBER
process.env.BUILD_TAG
process.env.CI_BUILD_NUMBER
process.env.CI_BUILD_TAG
process.env.TRAVIS_BUILD_NUMBER
process.env.CIRCLE_BUILD_NUM
process.env.DRONE_BUILD_NUMBERID of the build currently running. This should be set by your CI.
$3
Type: String
Default: 'Karma test'Name of the unit test group you are running.
$3
Type: Array of StringsTags to use for filtering jobs in your TestingBot account.
$3
Type: StringTestingBot Tunnel can proxy multiple sessions, this is an id of a tunnel session.
$3
Type: Boolean
Default: falseSet to
true if you want to record a video of your Karma session.$3
Type: Boolean
Default: trueSet to
false if you don't want to record screenshots.$3
Type: String
Default: nullControl who can view job details.
customLaunchers config propertiesThe
customLaunchers object has browser names as keys and configs as values. Documented below are the different properties which you can configure for each browser/platform combo.Note: You can learn about the available browser/platform combos on the TestingBot browsers page.
$3
Type: String
Required: trueThis defines the base configuration for the launcher. In this case it should always be
TestingBot so that browsers can use the base TestingBot config defined at the root testingbot property.$3
Type: String
Required: trueName of the browser.
$3
Type: String
Default: Latest browser version for all browsersVersion of the browser to use.
$3
Type: String
Default: 'Linux' for Firefox/Chrome, 'Windows 7' for IE/SafariName of platform to run browser on.
$3
Type: String
Default: 'portrait'Accepted values:
'portrait' || 'landscape'`Set this string if your unit tests need to run on a particular mobile device orientation for Android Browser or iOS Safari.
You can find more information on our website regarding TestingBot Tunnel and Karma.