101 lines
3.7 KiB
JavaScript
101 lines
3.7 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';
|
|
|
|
module.metadata = {
|
|
"stability": "experimental"
|
|
};
|
|
|
|
const { Ci } = require("chrome");
|
|
const XUL = 'http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul';
|
|
|
|
function eventTarget(frame) {
|
|
return getDocShell(frame).chromeEventHandler;
|
|
}
|
|
exports.eventTarget = eventTarget;
|
|
|
|
function getDocShell(frame) {
|
|
let { frameLoader } = frame.QueryInterface(Ci.nsIFrameLoaderOwner);
|
|
return frameLoader && frameLoader.docShell;
|
|
}
|
|
exports.getDocShell = getDocShell;
|
|
|
|
/**
|
|
* Creates a XUL `browser` element in a privileged document.
|
|
* @params {nsIDOMDocument} document
|
|
* @params {String} options.type
|
|
* By default is 'content' for possible values see:
|
|
* https://developer.mozilla.org/en/XUL/iframe#a-browser.type
|
|
* @params {String} options.uri
|
|
* URI of the document to be loaded into created frame.
|
|
* @params {Boolean} options.remote
|
|
* If `true` separate process will be used for this frame, also in such
|
|
* case all the following options are ignored.
|
|
* @params {Boolean} options.allowAuth
|
|
* Whether to allow auth dialogs. Defaults to `false`.
|
|
* @params {Boolean} options.allowJavascript
|
|
* Whether to allow Javascript execution. Defaults to `false`.
|
|
* @params {Boolean} options.allowPlugins
|
|
* Whether to allow plugin execution. Defaults to `false`.
|
|
*/
|
|
function create(target, options) {
|
|
target = target instanceof Ci.nsIDOMDocument ? target.documentElement :
|
|
target instanceof Ci.nsIDOMWindow ? target.document.documentElement :
|
|
target;
|
|
options = options || {};
|
|
let remote = options.remote || false;
|
|
let namespaceURI = options.namespaceURI || XUL;
|
|
let isXUL = namespaceURI === XUL;
|
|
let nodeName = isXUL && options.browser ? 'browser' : 'iframe';
|
|
let document = target.ownerDocument;
|
|
|
|
let frame = document.createElementNS(namespaceURI, nodeName);
|
|
// Type="content" is mandatory to enable stuff here:
|
|
// http://mxr.mozilla.org/mozilla-central/source/content/base/src/nsFrameLoader.cpp#1776
|
|
frame.setAttribute('type', options.type || 'content');
|
|
frame.setAttribute('src', options.uri || 'about:blank');
|
|
|
|
target.appendChild(frame);
|
|
|
|
// Load in separate process if `options.remote` is `true`.
|
|
// http://mxr.mozilla.org/mozilla-central/source/content/base/src/nsFrameLoader.cpp#1347
|
|
if (remote) {
|
|
if (isXUL) {
|
|
// We remove XBL binding to avoid execution of code that is not going to
|
|
// work because browser has no docShell attribute in remote mode
|
|
// (for example)
|
|
frame.setAttribute('style', '-moz-binding: none;');
|
|
frame.setAttribute('remote', 'true');
|
|
}
|
|
else {
|
|
frame.QueryInterface(Ci.nsIMozBrowserFrame);
|
|
frame.createRemoteFrameLoader(null);
|
|
}
|
|
}
|
|
|
|
|
|
|
|
// If browser is remote it won't have a `docShell`.
|
|
if (!remote) {
|
|
let docShell = getDocShell(frame);
|
|
docShell.allowAuth = options.allowAuth || false;
|
|
docShell.allowJavascript = options.allowJavascript || false;
|
|
docShell.allowPlugins = options.allowPlugins || false;
|
|
|
|
// Control whether the document can move/resize the window. Requires
|
|
// recently added platform capability, so we test to avoid exceptions
|
|
// in cases where capability is not present yet.
|
|
if ("allowWindowControl" in docShell && "allowWindowControl" in options)
|
|
docShell.allowWindowControl = !!options.allowWindowControl;
|
|
}
|
|
|
|
return frame;
|
|
}
|
|
exports.create = create;
|
|
|
|
function swapFrameLoaders(from, to)
|
|
from.QueryInterface(Ci.nsIFrameLoaderOwner).swapFrameLoaders(to)
|
|
exports.swapFrameLoaders = swapFrameLoaders;
|