summaryrefslogtreecommitdiffstats
path: root/testing/web-platform/tests/contacts/resources/helpers.js
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-19 01:47:29 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-19 01:47:29 +0000
commit0ebf5bdf043a27fd3dfb7f92e0cb63d88954c44d (patch)
treea31f07c9bcca9d56ce61e9a1ffd30ef350d513aa /testing/web-platform/tests/contacts/resources/helpers.js
parentInitial commit. (diff)
downloadfirefox-esr-0ebf5bdf043a27fd3dfb7f92e0cb63d88954c44d.tar.xz
firefox-esr-0ebf5bdf043a27fd3dfb7f92e0cb63d88954c44d.zip
Adding upstream version 115.8.0esr.upstream/115.8.0esr
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'testing/web-platform/tests/contacts/resources/helpers.js')
-rw-r--r--testing/web-platform/tests/contacts/resources/helpers.js41
1 files changed, 41 insertions, 0 deletions
diff --git a/testing/web-platform/tests/contacts/resources/helpers.js b/testing/web-platform/tests/contacts/resources/helpers.js
new file mode 100644
index 0000000000..8bac86b9b9
--- /dev/null
+++ b/testing/web-platform/tests/contacts/resources/helpers.js
@@ -0,0 +1,41 @@
+'use strict';
+
+// These tests rely on the User Agent providing an implementation of
+// platform contacts backends.
+//
+// In Chromium-based browsers this implementation is provided by a polyfill
+// in order to reduce the amount of test-only code shipped to users. To enable
+// these tests the browser must be run with these options:
+//
+// --enable-blink-features=MojoJS,MojoJSTest
+async function loadChromiumResources() {
+ await import('/resources/chromium/contacts_manager_mock.js');
+}
+
+// User Agents must provide their own implementation of `WebContacts`,
+// which must contain the following this interface:
+// class WebContactsTest {
+// /** @param {?Array<!ContactInfo>} contacts */
+// setSelectedContacts(contacts);
+// }
+async function createWebContactsTest() {
+ if (typeof WebContactsTest === 'undefined') {
+ if (isChromiumBased) {
+ await loadChromiumResources();
+ }
+ }
+ assert_implements(WebContactsTest, 'WebContactsTest is unavailable.');
+ return new WebContactsTest();
+}
+
+// Creates a Promise test for |func| given the |description|. The |func| will
+// be executed with `setSelectedContacts` which will allow tests to mock out
+// the result of calling navigator.contacts.select. `setSelectedContacts`
+// accepts a nullable Array of ContactInfos.
+function contactsTestWithUserActivation(func, description) {
+ promise_test(async test => {
+ const webContactsTest = await createWebContactsTest();
+ await window.test_driver.bless('request contacts');
+ return func(test, contacts => webContactsTest.setSelectedContacts(contacts));
+ }, description);
+}