frame/utils

Provides helper functions for working with platform internals like frames and browsers.

Usage

Module exports create function that takes the nsIDOMDocument of a privileged document and creates a browser element in its documentElement:

let { open } = require('sdk/window/utils');
let { create } = require('sdk/frame/utils');
let window = open('data:text/html,Foo');
let frame = create(window.document);

Optionally create can be passed set of options to configure created frame even further.

Execution of scripts may easily be enabled:

let { open } = require('sdk/window/utils');
let { create } = require('sdk/frame/utils');
let window = open('data:text/html,top');
let frame = create(window.document, {
  uri: 'data:text/html,<script>console.log("running");</script>',
  allowJavascript: true
});
}

Globals

Functions

create(document, options)

Creates a XUL browser element in a privileged document.

Parameters

document : nsIDOMDocument

options : object
Optional options:

Returns

frame : The new browser element.