创建新窗口。
When you create the window, you can:
This is an asynchronous function that returns a
Promise
.
var creating = browser.windows.create(
createData
// optional object
)
createData
可选
对象
.
allowScriptsToClose
可选
boolean
. When the window is opened, it will contain a single tab, or more than one tab if
url
is given and includes an array containing more than one URL. By default scripts running in these pages are not allowed to close their tab using
window.close()
. If you include
allowScriptsToClose
and set it to
true
, then this default behavior is changed, so scripts can close their tabs. Note that:
url
point to
extension pages
(that is, they are pages included with this extension and loaded with the "moz-extension:" protocol) then scripts
are
by default allowed to close those tabs.
cookieStoreId
可选
integer
. If present, specifies the
CookieStoreId
for all tabs that will be created when the window is opened.
focused
可选
boolean
。若
true
, the new window will be focused. If
false
, the new window will be opened in the background and the currently focused window will stay focused. Defaults to
true
.
height
可选
integer
. The height in pixels of the new window, including the frame. If not specified defaults to a natural height.
incognito
可选
boolean
. Whether the new window should be an incognito (private) window. Note that if you specify
incognito
and
tabId
, the ID must refer to a private tab — that is, you can't move a non-private tab to a private window.
left
可选
integer
. The number of pixels to position the new window from the left edge of the screen. If not specified, the new window is offset naturally from the last focused window. This value is ignored for panels. (In Firefox, this value currently is ignored for popups (bug 1271047) but can be set using browser.windows.update().)
state
可选
A
windows.WindowState
value. The initial state of the window. The
minimized
,
maximized
and,
fullscreen
states cannot be combined with
left
,
top
,
width
，或
height
.
tabId
可选
integer
. If included, moves a tab of the specified ID from an existing window into the new window.
titlePreface
可选
string
. Use this to add a string to the beginning of the browser window's title. Depending on the underlying operating system, this might not work on browser windows that don't have a title (such as about:blank in Firefox).
top
可选
integer
. The number of pixels to position the new window from the top edge of the screen. If not specified, the new window is offset naturally from the last focused window. This value is ignored for panels. (In Firefox, this value currently is ignored for popups (bug 1271047) but can be set using browser.windows.update().)
type
可选
A
windows.CreateType
value. Specifies what type of browser window to create. Specify
panel
or
popup
here to open a window without any of the normal browser UI (address bar, toolbar, etc).
url
可选
string
or
array
of
string
s. A URL or array of URLs to open as tabs in the window. Fully-qualified URLs must include a scheme (i.e.
http://www.google.com
, not
www.google.com
). Relative URLs will be relative to the current page within the extension. Defaults to the New Tab Page.
width
可选
integer
. The width in pixels of the new window, including the frame. If not specified defaults to a natural width.
A
Promise
that will be fulfilled with a
windows.Window
object containing the details of the new window. This
Window
object will always have its
tabs
property set, unlike the
Window
objects returned from
windows.get()
and similar APIs, which only contain
tabs
若
populate
option is passed. If any error occurs, the promise will be rejected with an error message.
Open a window containing two tabs:
function onCreated(windowInfo) {
console.log(`Created window: ${windowInfo.id}`);
}
function onError(error) {
console.log(`Error: ${error}`);
}
browser.browserAction.onClicked.addListener((tab) => {
var creating = browser.windows.create({
url: ["https://developer.mozilla.org",
"https://addons.mozilla.org"]
});
creating.then(onCreated, onError);
});
Open a window when the user clicks a browser action, and move the currently active tab into it:
function onCreated(windowInfo) {
console.log(`Created window: ${windowInfo.id}`);
}
function onError(error) {
console.log(`Error: ${error}`);
}
browser.browserAction.onClicked.addListener((tab) => {
var creating = browser.windows.create({
tabId: tab.id
});
creating.then(onCreated, onError);
});
Open a small panel-style window, and load a locally-packaged file into it:
function onCreated(windowInfo) {
console.log(`Created window: ${windowInfo.id}`);
}
function onError(error) {
console.log(`Error: ${error}`);
}
browser.browserAction.onClicked.addListener((tab) => {
var popupURL = browser.extension.getURL("popup/popup.html");
var creating = browser.windows.create({
url: popupURL,
type: "popup",
height: 200,
width: 200
});
creating.then(onCreated, onError);
});
BCD tables only load in the browser
注意：
This API is based on Chromium's
chrome.windows
API. This documentation is derived from
windows.json
in the Chromium code.
Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.
最后修改： , 由 MDN 贡献者