Source code
Revision control
Copy as Markdown
Other Tools
/* vim: set ts=2 sw=2 et tw=80: */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
const lazy = {};
ChromeUtils.defineESModuleGetters(lazy, {
PromptUtils: "resource://gre/modules/PromptUtils.sys.mjs",
BrowserUtils: "resource://gre/modules/BrowserUtils.sys.mjs",
});
ChromeUtils.defineLazyGetter(lazy, "gTabBrowserLocalization", function () {
return new Localization(["browser/tabbrowser.ftl"], true);
});
/**
* @typedef {Object} Dialog
*/
/**
* gBrowserDialogs weakly maps BrowsingContexts to a Map of their currently
* active Dialogs.
*
* @type {WeakMap<BrowsingContext, Dialog>}
*/
let gBrowserDialogs = new WeakMap();
export class PromptParent extends JSWindowActorParent {
didDestroy() {
// In the event that the subframe or tab crashed, make sure that
// we close any active Prompts.
this.forceClosePrompts();
}
/**
* Registers a new dialog to be tracked for a particular BrowsingContext.
* We need to track a dialog so that we can, for example, force-close the
* dialog if the originating subframe or tab unloads or crashes.
*
* @param {Dialog} dialog
* The dialog that will be shown to the user.
* @param {string} id
* A unique ID to differentiate multiple dialogs coming from the same
* BrowsingContext.
*/
registerDialog(dialog, id) {
let dialogs = gBrowserDialogs.get(this.browsingContext);
if (!dialogs) {
dialogs = new Map();
gBrowserDialogs.set(this.browsingContext, dialogs);
}
dialogs.set(id, dialog);
}
/**
* Removes a Prompt for a BrowsingContext with a particular ID from the registry.
* This needs to be done to avoid leaking <xul:browser>'s.
*
* @param {string} id
* A unique ID to differentiate multiple Prompts coming from the same
* BrowsingContext.
*/
unregisterPrompt(id) {
let dialogs = gBrowserDialogs.get(this.browsingContext);
dialogs?.delete(id);
}
/**
* Programmatically closes all Prompts for the current BrowsingContext.
*/
forceClosePrompts() {
let dialogs = gBrowserDialogs.get(this.browsingContext) || [];
for (let [, dialog] of dialogs) {
dialog?.abort();
}
}
isAboutAddonsOptionsPage(browsingContext) {
const { embedderWindowGlobal, name } = browsingContext;
if (!embedderWindowGlobal) {
// Return earlier if there is no embedder global, this is definitely
// not an about:addons extensions options page.
return false;
}
return (
embedderWindowGlobal.documentPrincipal.isSystemPrincipal &&
embedderWindowGlobal.documentURI.spec === "about:addons" &&
name === "addon-inline-options"
);
}
receiveMessage(message) {
switch (message.name) {
case "Prompt:Open":
if (!this.windowContext.isActiveInTab) {
return undefined;
}
return this.openPromptWithTabDialogBox(message.data);
}
return undefined;
}
/**
* Opens either a window prompt or TabDialogBox at the content or tab level
* for a BrowsingContext, and puts the associated browser in the modal state
* until the prompt is closed.
*
* @param {Object} args
* The arguments passed up from the BrowsingContext to be passed
* directly to the modal prompt.
* @return {Promise}
* Resolves when the modal prompt is dismissed.
* @resolves {Object}
* The arguments returned from the modal prompt.
*/
async openPromptWithTabDialogBox(args) {
const COMMON_DIALOG = "chrome://global/content/commonDialog.xhtml";
const SELECT_DIALOG = "chrome://global/content/selectDialog.xhtml";
let uri = args.promptType == "select" ? SELECT_DIALOG : COMMON_DIALOG;
let browsingContext = this.browsingContext.top;
let browser = browsingContext.embedderElement;
if (this.isAboutAddonsOptionsPage(browsingContext)) {
browser = browser.ownerGlobal.browsingContext.embedderElement;
}
let promptRequiresBrowser =
args.modalType === Services.prompt.MODAL_TYPE_TAB ||
args.modalType === Services.prompt.MODAL_TYPE_CONTENT;
if (promptRequiresBrowser && !browser) {
let modal_type =
args.modalType === Services.prompt.MODAL_TYPE_TAB ? "tab" : "content";
throw new Error(`Cannot ${modal_type}-prompt without a browser!`);
}
let win;
// If we are a chrome actor we can use the associated chrome win.
if (!browsingContext.isContent && browsingContext.window) {
win = browsingContext.window;
} else {
win = browser?.ownerGlobal;
}
// There's a requirement for prompts to be blocked if a window is
// passed and that window is hidden (eg, auth prompts are suppressed if the
// passed window is the hidden window).
if (win?.winUtils && !win.winUtils.isParentWindowMainWidgetVisible) {
throw new Error("Cannot open a prompt in a hidden window");
}
let swappedBrowser;
let cancelEventController = new AbortController();
let cancelEventSignal = cancelEventController.signal;
try {
if (browser) {
browser.enterModalState();
// If this tab gets moved to a new window, we will need
// to leave the modal state on the new browser, so
// keep track of the new browser.
browser.addEventListener(
"EndSwapDocShells",
event => {
swappedBrowser = event.detail;
},
{ signal: cancelEventSignal }
);
lazy.PromptUtils.fireDialogEvent(
win,
"DOMWillOpenModalDialog",
browser,
this.getOpenEventDetail(args)
);
}
args.promptAborted = false;
args.openedWithTabDialog = true;
args.owningBrowsingContext = this.browsingContext;
// Convert args object to a prop bag for the dialog to consume.
let bag;
if (promptRequiresBrowser && win?.gBrowser?.getTabDialogBox) {
// Tab or content level prompt
let dialogBox = win.gBrowser.getTabDialogBox(browser);
if (dialogBox._allowTabFocusByPromptPrincipal) {
this.addTabSwitchCheckboxToArgs(dialogBox, args);
}
let currentLocationsTabLabel;
let targetTab = win.gBrowser.getTabForBrowser(browser);
if (
!Services.prefs.getBoolPref(
"privacy.authPromptSpoofingProtection",
false
)
) {
args.isTopLevelCrossDomainAuth = false;
}
if (args.isTopLevelCrossDomainAuth && targetTab) {
// Set up the url bar with the url of the cross domain resource.
// onLocationChange will change the url back to the current browsers
// if we do not hold the state here.
// onLocationChange will favour currentAuthPromptURI over the current browsers uri
browser.currentAuthPromptURI = args.channel.URI;
if (browser == win.gBrowser.selectedBrowser) {
win.gURLBar.setURI();
}
// Set up the tab title for the cross domain resource.
// We need to remember the original tab title in case
// the load does not happen after the prompt, then we need to reset the tab title manually.
currentLocationsTabLabel = targetTab.label;
win.gBrowser.setTabLabelForAuthPrompts(
targetTab,
lazy.BrowserUtils.formatURIForDisplay(args.channel.URI)
);
}
bag = lazy.PromptUtils.objectToPropBag(args);
let promptID = args._remoteId;
try {
let { dialog, closedPromise } = dialogBox.open(
uri,
{
features: "resizable=no",
modalType: args.modalType,
allowFocusCheckbox: args.allowFocusCheckbox,
hideContent: args.isTopLevelCrossDomainAuth,
},
bag
);
dialog.promptID = promptID;
this.registerDialog(dialog, promptID);
await closedPromise;
} finally {
if (args.isTopLevelCrossDomainAuth) {
browser.currentAuthPromptURI = null;
// If the user is stopping the page load before answering the prompt, no navigation will happen after the prompt
// so we need to reset the uri and tab title here to the current browsers for that specific case
if (browser == win.gBrowser.selectedBrowser) {
win.gURLBar.setURI();
}
win.gBrowser.setTabLabelForAuthPrompts(
targetTab,
currentLocationsTabLabel
);
}
this.unregisterPrompt(promptID);
}
} else {
// Ensure we set the correct modal type at this point.
// If we use window prompts as a fallback it may not be set.
args.modalType = Services.prompt.MODAL_TYPE_WINDOW;
// Window prompt
bag = lazy.PromptUtils.objectToPropBag(args);
Services.ww.openWindow(
win,
uri,
"_blank",
"centerscreen,chrome,modal,titlebar",
bag
);
}
lazy.PromptUtils.propBagToObject(bag, args);
} finally {
cancelEventController.abort();
// If this tab has been moved to a new window, make sure
// to leave the modal state on the new browser.
let currentBrowser = swappedBrowser ?? browser;
if (currentBrowser) {
currentBrowser.maybeLeaveModalState();
lazy.PromptUtils.fireDialogEvent(
win,
"DOMModalDialogClosed",
currentBrowser,
this.getClosingEventDetail(args)
);
}
}
return args;
}
getClosingEventDetail(args) {
let details =
args.modalType === Services.prompt.MODAL_TYPE_CONTENT
? {
areLeaving: args.ok,
promptType: args.inPermitUnload ? "beforeunload" : args.promptType,
// If a prompt was not accepted, do not return the prompt value.
value: args.ok ? args.value : null,
}
: null;
return details;
}
getOpenEventDetail(args) {
let details =
args.modalType === Services.prompt.MODAL_TYPE_CONTENT
? {
inPermitUnload: args.inPermitUnload,
promptPrincipal: args.promptPrincipal,
tabPrompt: true,
}
: null;
return details;
}
/**
* Set properties on `args` needed by the dialog to allow tab switching for the
* page that opened the prompt.
*
* @param {TabDialogBox} dialogBox
* The dialog to show the tab-switch checkbox for.
* @param {Object} args
* The `args` object to set tab switching permission info on.
*/
addTabSwitchCheckboxToArgs(dialogBox, args) {
let allowTabFocusByPromptPrincipal =
dialogBox._allowTabFocusByPromptPrincipal;
if (
allowTabFocusByPromptPrincipal &&
args.modalType === Services.prompt.MODAL_TYPE_CONTENT
) {
let domain = allowTabFocusByPromptPrincipal.addonPolicy?.name;
try {
domain ||= allowTabFocusByPromptPrincipal.URI.displayHostPort;
} catch (ex) {
/* Ignore exceptions from fetching the display host/port. */
}
// If it's still empty, use `prePath` so we have *something* to show:
domain ||= allowTabFocusByPromptPrincipal.URI.prePath;
let [allowFocusMsg] = lazy.gTabBrowserLocalization.formatMessagesSync([
{
id: "tabbrowser-allow-dialogs-to-get-focus",
args: { domain },
},
]);
let labelAttr = allowFocusMsg.attributes.find(a => a.name == "label");
if (labelAttr) {
args.allowFocusCheckbox = true;
args.checkLabel = labelAttr.value;
}
}
}
}