summaryrefslogtreecommitdiffstats
path: root/testing/specialpowers/content/AppTestDelegate.sys.mjs
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-19 00:47:55 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-19 00:47:55 +0000
commit26a029d407be480d791972afb5975cf62c9360a6 (patch)
treef435a8308119effd964b339f76abb83a57c29483 /testing/specialpowers/content/AppTestDelegate.sys.mjs
parentInitial commit. (diff)
downloadfirefox-26a029d407be480d791972afb5975cf62c9360a6.tar.xz
firefox-26a029d407be480d791972afb5975cf62c9360a6.zip
Adding upstream version 124.0.1.upstream/124.0.1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'testing/specialpowers/content/AppTestDelegate.sys.mjs')
-rw-r--r--testing/specialpowers/content/AppTestDelegate.sys.mjs89
1 files changed, 89 insertions, 0 deletions
diff --git a/testing/specialpowers/content/AppTestDelegate.sys.mjs b/testing/specialpowers/content/AppTestDelegate.sys.mjs
new file mode 100644
index 0000000000..e2c2b60daf
--- /dev/null
+++ b/testing/specialpowers/content/AppTestDelegate.sys.mjs
@@ -0,0 +1,89 @@
+/* Any copyright is dedicated to the Public Domain.
+ * http://creativecommons.org/publicdomain/zero/1.0/ */
+
+/**
+ * This file offers the test helpers that are directly exposed to mochitests.
+ * Their implementations are in app-specific "AppUiTestDelegate.sys.mjs" files.
+ *
+ * For documentation, see AppTestDelegateParent.sys.mjs.
+ * For documentation on the methods of AppUiTestDelegate, see below.
+ */
+
+class AppTestDelegateImplementation {
+ actor(window) {
+ return window.windowGlobalChild.getActor("AppTestDelegate");
+ }
+
+ /**
+ * Click on the pageAction button, to open its popup, or to trigger
+ * pageAction.onClicked if there is no popup.
+ */
+ clickPageAction(window, extension) {
+ return this.actor(window).sendQuery("clickPageAction", {
+ extensionId: extension.id,
+ });
+ }
+
+ /**
+ * Click on the browserAction button, to open its popup, or to trigger
+ * browserAction.onClicked if there is no popup.
+ */
+ clickBrowserAction(window, extension) {
+ return this.actor(window).sendQuery("clickBrowserAction", {
+ extensionId: extension.id,
+ });
+ }
+
+ /**
+ * Close the browserAction popup, if any.
+ * Do not use this for pageAction popups, use closePageAction instead.
+ */
+ closeBrowserAction(window, extension) {
+ return this.actor(window).sendQuery("closeBrowserAction", {
+ extensionId: extension.id,
+ });
+ }
+
+ /**
+ * Close the pageAction popup, if any.
+ * Do not use this for browserAction popups, use closeBrowserAction instead.
+ */
+ closePageAction(window, extension) {
+ return this.actor(window).sendQuery("closePageAction", {
+ extensionId: extension.id,
+ });
+ }
+
+ /**
+ * Wait for the pageAction or browserAction/action popup panel to open.
+ * This must be called BEFORE any attempt to open the popup.
+ */
+ awaitExtensionPanel(window, extension) {
+ return this.actor(window).sendQuery("awaitExtensionPanel", {
+ extensionId: extension.id,
+ });
+ }
+
+ /**
+ * Open a tab with the given url in the given window.
+ * Returns an opaque object that can be passed to AppTestDelegate.removeTab.
+ */
+ async openNewForegroundTab(window, url, waitForLoad = true) {
+ const tabId = await this.actor(window).sendQuery("openNewForegroundTab", {
+ url,
+ waitForLoad,
+ });
+ // Note: this id is only meaningful to AppTestDelegate and independent of
+ // any other concept of "tab id".
+ return { id: tabId };
+ }
+
+ /**
+ * Close a tab opened by AppTestDelegate.openNewForegroundTab.
+ */
+ removeTab(window, tab) {
+ return this.actor(window).sendQuery("removeTab", { tabId: tab.id });
+ }
+}
+
+export var AppTestDelegate = new AppTestDelegateImplementation();