gecko-dev/toolkit/components/extensions/test/mochitest/head.js
Agi Sferro 41c023ef42 Bug 1681360 - Add mochitest ApiTestDelegate. r=robwu,esawin
This change adds a new mochitest-only helper called `AppTestDelegate`. This
helper will provide primitives that are not normally available at the toolkit
level.

Each app can implement the `AppUiTestDelegate` API to provide the primitives.
This is done so that we can ensure compatibility of the Extension API across
implementations.

The initial set of APIs is as follows:

```
class TestDelegate {
    clickPageAction(window, extensionId);
    closePageAction(window, extensionId);
    clickBrowserAction(window, extensionId);
    closeBrowserAction(window, extensionId);
    awaitExtensionPanel(window, extensionId);
    // Returns a unique identifier for the tab
    openNewForegroundTab(window, url, waitForLoad);
    // tabId must be the identifier from openNewForegroundTab
    removeTab(tabId);
}
```

Differential Revision: https://phabricator.services.mozilla.com/D99170
2021-02-04 02:19:05 +00:00

127 lines
3.2 KiB
JavaScript

"use strict";
/* exported AppConstants, Assert, AppTestDelegate */
var { AppConstants } = SpecialPowers.Cu.import(
"resource://gre/modules/AppConstants.jsm",
{}
);
var { AppTestDelegate } = SpecialPowers.Cu.import(
"resource://specialpowers/AppTestDelegate.jsm",
{}
);
let remote = SpecialPowers.getBoolPref("extensions.webextensions.remote");
if (remote) {
// We don't want to reset this at the end of the test, so that we don't have
// to spawn a new extension child process for each test unit.
SpecialPowers.setIntPref("dom.ipc.keepProcessesAlive.extension", 1);
}
{
let chromeScript = SpecialPowers.loadChromeScript(
SimpleTest.getTestFileURL("chrome_cleanup_script.js")
);
SimpleTest.registerCleanupFunction(async () => {
await new Promise(resolve => setTimeout(resolve, 0));
chromeScript.sendAsyncMessage("check-cleanup");
let results = await chromeScript.promiseOneMessage("cleanup-results");
chromeScript.destroy();
if (results.extraWindows.length || results.extraTabs.length) {
ok(
false,
`Test left extra windows or tabs: ${JSON.stringify(results)}\n`
);
}
});
}
let Assert = {
// Cut-down version based on Assert.jsm. Only supports regexp and objects as
// the expected variables.
rejects(promise, expected, msg) {
return promise.then(
() => {
ok(false, msg);
},
actual => {
let matched = false;
if (Object.prototype.toString.call(expected) == "[object RegExp]") {
if (expected.test(actual)) {
matched = true;
}
} else if (actual instanceof expected) {
matched = true;
}
if (matched) {
ok(true, msg);
} else {
ok(false, `Unexpected exception for "${msg}": ${actual}`);
}
}
);
},
};
/* exported waitForLoad */
function waitForLoad(win) {
return new Promise(resolve => {
win.addEventListener(
"load",
function() {
resolve();
},
{ capture: true, once: true }
);
});
}
/* exported loadChromeScript */
function loadChromeScript(fn) {
let wrapper = `
const {Services} = Cu.import("resource://gre/modules/Services.jsm", {});
(${fn.toString()})();`;
return SpecialPowers.loadChromeScript(new Function(wrapper));
}
/* exported consoleMonitor */
let consoleMonitor = {
start(messages) {
this.chromeScript = SpecialPowers.loadChromeScript(
SimpleTest.getTestFileURL("mochitest_console.js")
);
this.chromeScript.sendAsyncMessage("consoleStart", messages);
},
async finished() {
let done = this.chromeScript.promiseOneMessage("consoleDone").then(done => {
this.chromeScript.destroy();
return done;
});
this.chromeScript.sendAsyncMessage("waitForConsole");
let test = await done;
ok(test.ok, test.message);
},
};
/* exported waitForState */
function waitForState(sw, state) {
return new Promise(resolve => {
if (sw.state === state) {
return resolve();
}
sw.addEventListener("statechange", function onStateChange() {
if (sw.state === state) {
sw.removeEventListener("statechange", onStateChange);
resolve();
}
});
});
}