/** * Helpers for password manager mochitest-plain tests. */ /* import-globals-from ../../../../../toolkit/components/satchel/test/satchel_common.js */ const { LoginTestUtils } = SpecialPowers.ChromeUtils.import( "resource://testing-common/LoginTestUtils.jsm" ); const Services = SpecialPowers.Services; // Setup LoginTestUtils to report assertions to the mochitest harness. LoginTestUtils.setAssertReporter( SpecialPowers.wrapCallback((err, message, stack) => { SimpleTest.record(!err, err ? err.message : message, null, stack); }) ); const { LoginHelper } = SpecialPowers.ChromeUtils.import( "resource://gre/modules/LoginHelper.jsm" ); const { LENGTH: GENERATED_PASSWORD_LENGTH, REGEX: GENERATED_PASSWORD_REGEX, } = LoginTestUtils.generation; const LOGIN_FIELD_UTILS = LoginTestUtils.loginField; const TESTS_DIR = "/tests/toolkit/components/passwordmgr/test/"; // Depending on pref state we either show auth prompts as windows or on tab level. let authPromptModalType = SpecialPowers.Services.prefs.getIntPref( "prompts.modalType.httpAuth" ); // Whether the auth prompt is a commonDialog.xhtml or a TabModalPrompt let authPromptIsCommonDialog = authPromptModalType === SpecialPowers.Services.prompt.MODAL_TYPE_WINDOW || (authPromptModalType === SpecialPowers.Services.prompt.MODAL_TYPE_TAB && SpecialPowers.Services.prefs.getBoolPref( "prompts.tabChromePromptSubDialog", false )); /** * Recreate a DOM tree using the outerHTML to ensure that any event listeners * and internal state for the elements are removed. */ function recreateTree(element) { // eslint-disable-next-line no-unsanitized/property, no-self-assign element.outerHTML = element.outerHTML; } function _checkArrayValues(actualValues, expectedValues, msg) { is( actualValues.length, expectedValues.length, "Checking array values: " + msg ); for (let i = 0; i < expectedValues.length; i++) { is(actualValues[i], expectedValues[i], msg + " Checking array entry #" + i); } } /** * Check autocomplete popup results to ensure that expected * *labels* are being shown correctly as items in the popup. */ function checkAutoCompleteResults(actualValues, expectedValues, hostname, msg) { if (hostname === null) { _checkArrayValues(actualValues, expectedValues, msg); return; } is( typeof hostname, "string", "checkAutoCompleteResults: hostname must be a string" ); isnot( actualValues.length, 0, "There should be items in the autocomplete popup: " + JSON.stringify(actualValues) ); // Check the footer first. let footerResult = actualValues[actualValues.length - 1]; is(footerResult, "View Saved Logins", "the footer text is shown correctly"); if (actualValues.length == 1) { is( expectedValues.length, 0, "If only the footer is present then there should be no expectedValues" ); info("Only the footer is present in the popup"); return; } // Check the rest of the autocomplete item values. _checkArrayValues(actualValues.slice(0, -1), expectedValues, msg); } function getIframeBrowsingContext(window, iframeNumber = 0) { let bc = SpecialPowers.wrap(window).windowGlobalChild.browsingContext; return SpecialPowers.unwrap(bc.children[iframeNumber]); } /** * Set input values via setUserInput to emulate user input * and distinguish them from declarative or script-assigned values */ function setUserInputValues(parentNode, selectorValues, userInput = true) { for (let [selector, newValue] of Object.entries(selectorValues)) { info(`setUserInputValues, selector: ${selector}`); try { let field = SpecialPowers.wrap(parentNode.querySelector(selector)); if (field.value == newValue) { // we don't get an input event if the new value == the old field.value += "#"; } if (userInput) { field.setUserInput(newValue); } else { field.value = newValue; } } catch (ex) { info(ex.message); info(ex.stack); ok( false, `setUserInputValues: Couldn't set value of field: ${ex.message}` ); } } } /** * @param {Function} [aFilterFn = undefined] Function to filter out irrelevant submissions. * @return {Promise} resolving when a relevant form submission was processed. */ function getSubmitMessage(aFilterFn = undefined) { info("getSubmitMessage"); return new Promise((resolve, reject) => { PWMGR_COMMON_PARENT.addMessageListener( "formSubmissionProcessed", function processed(...args) { if (aFilterFn && !aFilterFn(...args)) { // This submission isn't the one we're waiting for. return; } info("got formSubmissionProcessed"); PWMGR_COMMON_PARENT.removeMessageListener( "formSubmissionProcessed", processed ); resolve(args[0]); } ); }); } /** * @return {Promise} resolves when a onPasswordEditedOrGenerated message is received at the parent */ function getPasswordEditedMessage() { info("getPasswordEditedMessage"); return new Promise((resolve, reject) => { PWMGR_COMMON_PARENT.addMessageListener( "passwordEditedOrGenerated", function listener(...args) { info("got passwordEditedOrGenerated"); PWMGR_COMMON_PARENT.removeMessageListener( "passwordEditedOrGenerated", listener ); resolve(args[0]); } ); }); } /** * Check for expected username/password in form. * @see `checkForm` below for a similar function. */ function checkLoginForm( usernameField, expectedUsername, passwordField, expectedPassword ) { let formID = usernameField.parentNode.id; is( usernameField.value, expectedUsername, "Checking " + formID + " username is: " + expectedUsername ); is( passwordField.value, expectedPassword, "Checking " + formID + " password is: " + expectedPassword ); } function checkLoginFormInFrame( iframeBC, usernameFieldId, expectedUsername, passwordFieldId, expectedPassword ) { return SpecialPowers.spawn( iframeBC, [usernameFieldId, expectedUsername, passwordFieldId, expectedPassword], ( usernameFieldIdF, expectedUsernameF, passwordFieldIdF, expectedPasswordF ) => { let usernameField = this.content.document.getElementById( usernameFieldIdF ); let passwordField = this.content.document.getElementById( passwordFieldIdF ); let formID = usernameField.parentNode.id; Assert.equal( usernameField.value, expectedUsernameF, "Checking " + formID + " username is: " + expectedUsernameF ); Assert.equal( passwordField.value, expectedPasswordF, "Checking " + formID + " password is: " + expectedPasswordF ); } ); } async function checkUnmodifiedFormInFrame(bc, formNum) { return SpecialPowers.spawn(bc, [formNum], formNumF => { let form = this.content.document.getElementById(`form${formNumF}`); ok(form, "Locating form " + formNumF); for (var i = 0; i < form.elements.length; i++) { var ele = form.elements[i]; // No point in checking form submit/reset buttons. if (ele.type == "submit" || ele.type == "reset") { continue; } is( ele.value, ele.defaultValue, "Test to default value of field " + ele.name + " in form " + formNumF ); } }); } /** * Check a form for expected values even if it is in a different top level window * or process. If an argument is null, a field's expected value will be the default * value. * * Similar to the checkForm helper, but it works across (cross-origin) frames. * *