webextensions-geckodriver

$3

When testing WebExtensions you might want to automatically load them into Firefox and do functional testing with geckodriver.

$3

``
npm install --save-dev webextensions-geckodriver
`

$3

`js
const webExtensionsGeckoDriver = require('webextensions-geckodriver');
const webExtension = await webExtensionsGeckoDriver('/absolute/path/to/manifest.json');
`

Loads the WebExtension as Temporary Add-on into a new Firefox instance. See API docs for more details.

$3

manifest.json includes
`
"browser_action": {
"default_title": "Visit Example.com"
},
"applications": {
"gecko": {
"id": "@examplewebextension",
"strict_min_version": "57.0"
}
}
`

Test could look like this (using mocha):
`js
const path = require('path');
const assert = require('assert');

const webExtensionsGeckoDriver = require('webextensions-geckodriver');
const {webdriver} = webExtensionsGeckoDriver;

const manifestPath = path.resolve(path.join(__dirname, './path/to/manifest.json'));

describe('Example', () => {
let geckodriver;

before(async () => {
const webExtension = await webExtensionsGeckoDriver(manifestPath);
geckodriver = webExtension.geckodriver;
});

it('should have a Toolbar Button', async () => {
const button = await geckodriver.wait(webdriver.until.elementLocated(
// browser_actions automatically have applications.gecko.id as prefix
// special chars in the id are replaced with _
webdriver.By.id('_examplewebextension-browser-action')
), 1000);
assert.equal(await button.getAttribute('tooltiptext'), 'Visit Example.com');
});

after(() => {
geckodriver.quit();
});
});
`

Full executable example is in the example directory.

$3

#### Exported default function(path[, options])

path* , required, absolute path to the manifest.json file
options*