fune/devtools/client/shared/link.js
Christoph Kerschbaumer 64005a8818 Bug 1524970: Update more frontend code to explicitly pass a csp. r=Gijs,jdescottes
Differential Revision: https://phabricator.services.mozilla.com/D24959

--HG--
extra : moz-landing-system : lando
2019-03-27 16:38:01 +00:00

87 lines
2.6 KiB
JavaScript

/* 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
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
"use strict";
const Services = require("Services");
const { gDevTools } = require("devtools/client/framework/devtools");
const { TargetFactory } = require("devtools/client/framework/target");
/**
* Retrieve the most recent chrome window.
*/
function _getTopWindow() {
// Try the main application window, such as a browser window.
let win = Services.wm.getMostRecentWindow(gDevTools.chromeWindowType);
if (win && win.openWebLinkIn && win.openTrustedLinkIn) {
return win;
}
// For non-browser cases like Browser Toolbox, try any chrome window.
win = Services.wm.getMostRecentWindow(null);
if (win && win.openWebLinkIn && win.openTrustedLinkIn) {
return win;
}
return null;
}
/**
* Opens a |url| that does not require trusted access, such as a documentation page, in a
* new tab.
*
* @param {String} url
* The url to open.
* @param {Object} options
* Optional parameters, see documentation for openUILinkIn in utilityOverlay.js
*/
exports.openDocLink = async function(url, options) {
const top = _getTopWindow();
if (!top) {
return;
}
top.openWebLinkIn(url, "tab", options);
};
/**
* Opens a |url| controlled by web content in a new tab.
*
* If the current tab has an open toolbox, this will attempt to refine the
* `triggeringPrincipal` of the link using the tab's `contentPrincipal`. This is only an
* approximation, so bug 1467945 hopes to improve this.
*
* @param {String} url
* The url to open.
* @param {Object} options
* Optional parameters, see documentation for openUILinkIn in utilityOverlay.js
*/
exports.openContentLink = async function(url, options = {}) {
const top = _getTopWindow();
if (!top) {
return;
}
if (!options.triggeringPrincipal && top.gBrowser) {
const tab = top.gBrowser.selectedTab;
if (TargetFactory.isKnownTab(tab)) {
const target = await TargetFactory.forTab(tab);
options.triggeringPrincipal = target.contentPrincipal;
options.csp = target.csp;
}
}
top.openWebLinkIn(url, "tab", options);
};
/**
* Open a trusted |url| in a new tab using the SystemPrincipal.
*
* @param {String} url
* The url to open.
* @param {Object} options
* Optional parameters, see documentation for openUILinkIn in utilityOverlay.js
*/
exports.openTrustedLink = async function(url, options) {
const top = _getTopWindow();
if (!top) {
return;
}
top.openTrustedLinkIn(url, "tab", options);
};