windows.create()

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

• store-collected-images
• window-manipulator