windows.create()

创建一个新的窗口。

当你创建一个窗口时，你可以：

加载一个或多个新的标签到该窗口中。
将一个现有窗口的。标签移动到新的窗口中
设置窗口的大小和位置
创建一个面板样式的窗口，它没有浏览器的默认样式（地址栏，工具栏等）
设置窗口的多种属性，像是获得焦点或是为隐私窗口。

这是一个异步的方法返回一个 Promise.

语法

var creating = browser.windows.create(
  createData, // optional object
);

参数

createData可选

object.

url可选: 字符串或字符串数组。一个 URL 或都 URL 数组要在该窗口中打开成标签页的。完整的需要包括 scheme (像。http://www.google.com, not www.google.com). 相对路径将相对于该拓展中的当前页。默认为打开新标签页。
tabId可选: integer. 如果设置了该值，将该 tab 从一个现有的窗口中移到新窗口中。
left可选: integer. 窗口左边到屏幕左边缘的距离。如果没有设定，新窗口将按上一个焦点窗口定位水平位置。对于 panel 样式窗口，该值不起作用。
top可选: 窗口顶部到屏幕的顶部距离。如果没有设定，新窗口将按上一个焦点窗口定位垂直位置。对于 panel 样式窗口，该值不起作用。
width可选: integer. 新窗口的宽度，包含框架。未设定则使用默认宽度。
height可选: integer. 新窗口的高度，包含框架。未设定则使用默认高度。
focused可选: boolean.如果为true, 新窗口将获取焦点。否则新窗口当在后台打开并且当前焦点窗口继续保持焦点。默认为 true
incognito可选: boolean。是否打开为一个隐私窗口。如果设定为隐私窗口并且引入了 tabId, 则 tabId 对应的标签必须是一个隐私标签— 即不能把一个不是隐私标签的标签页移动到隐私窗口中。
type可选: 一windows.CreateType 值，表示创建窗口的类型。panel 或者popup 样式将打开一个没有默认浏览器样式的窗口 (地址栏，工具栏等）。
state可选: 一个 windows.WindowState 值，窗口的祲状态。最小化、最大化、全屏状态不能与left, top, width, or height属性一起使用。

一个 Promise 其中传入一个包含新窗口细节的 windows.Window 对象。这个windows.Window 有自己的 tabs 属性集 ,而不像 windows.get()返回的窗口对象和相似的 API, 如果传递了 populate 项其仅仅包含 tabs. 如果发生了错误 promise will be rejected with an error message.

示例

打开一个包含两个标签的窗口

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);
});

当用户点击一个 browser action 打开一个窗口，并且将当前活跃的标签移动其中

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);
});

打开一个小面板样式的窗口，并且加载一个本地包中的文件到其中

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.

语法

参数

返回值

示例

浏览器兼容性

示例扩展