windows.create()

createData Необязательный

object.

allowScriptsToClose Необязательный

boolean. Когда окно открывается, оно будет содержать одну вкладку или более одной, если url указано и включает массив, содержащий более одного URL. По умолчанию скрипты, выполняющиеся на этих страницах, не могут закрывать свою вкладку с помощью window.close(). Если вы включите allowScriptsToClose и установите его в значение true, то это поведение по умолчанию изменяется, и скрипты смогут закрывать свои вкладки. Обратите внимание, что:

• это относится только к вкладкам, открытым при создании окна. Если пользователь откроет в этом окне дополнительные вкладки, скрипты не смогут закрыть эти новые вкладки.
• если URL(ы), указанные в url, указывают на страницы расширений (то есть, это страницы, включенные в это расширение и загруженные с протоколом "moz-extension:"), то скрипты по умолчанию разрешено закрывать эти вкладки.

cookieStoreId Необязательный

integer. Если указано, задаёт CookieStoreId для всех вкладок, которые будут созданы при открытии окна.

focused Необязательный

boolean. Если true, новое окно получит фокус. Если false, новое окно откроется в фоновом режиме, и фокус останется на текущем окне. По умолчанию true.

height Необязательный

integer. Высота нового окна в пикселях, включая рамку. Если не указано, используется значение по умолчанию.

incognito Необязательный

boolean. Определяет, должно ли новое окно быть окном инкогнито (приватным). Обратите внимание, что если вы указываете incognito и tabId, ID должен относиться к приватной вкладке — то есть, вы не можете переместить не-приватную вкладку в приватное окно.

left Необязательный

integer. Количество пикселей для позиционирования нового окна от левого края экрана. Если не указано, новое окно позиционируется относительно последнего активного окна. Это значение игнорируется для панелей. (В Firefox это значение игнорируется для всплывающих окон (баг 1271047), но может быть установлено с помощью browser.windows.update().)

state Необязательный

Значение windows.WindowState. Начальное состояние окна. Состояния minimized, maximized и fullscreen нельзя комбинировать со состояниями left, top, width или height.

tabId Необязательный

integer. Если указано, переместит вкладку с указанным ID из существующего окна в новое окно.

titlePreface Необязательный

string. Используйте для добавления строки в начало заголовка окна браузера. В зависимости от операционной системы, это может не сработать в окнах браузера без заголовка (например, about:blank в Firefox).

top Необязательный

integer. Количество пикселей для позиционирования нового окна от верхнего края экрана. Если не указано, новое окно позиционируется относительно последнего активного окна. Это значение игнорируется для панелей. (В Firefox это значение игнорируется для всплывающих окон (баг 1271047), но может быть установлено с помощью browser.windows.update().)

type Необязательный

Значение windows.CreateType. Указывает тип окна браузера. Укажите panel или popup для открытия окна без стандартного интерфейса браузера (строка адреса, панель инструментов и т. д.).

url Необязательный

string или array strings. URL или массив URL-адресов для открытия вкладок в окне. Полные URL-адреса должны включать схему (например, http://www.google.com, а не www.google.com). Относительные URL-адреса будут относиться к текущей странице внутри расширения. По умолчанию открывается новая вкладка.

width Необязательный

integer. Ширина нового окна в пикселях, включая рамку. Если не указано, используется значение по умолчанию.

A Promise, которая будет выполнена с объектом windows.Window, содержащим детали нового окна. Этот объект Window всегда будет иметь свойство tabs, в отличие от объектов Window возвращаемых из windows.get() и аналогичных API, которые содержат tabs только если передан параметр populate. При возникновении ошибки, промис будет отклонен с сообщением об ошибке.

Открыть окно с двумя вкладками:

function onCreated(windowInfo) {
  console.log(`Created window: ${windowInfo.id}`);
}

function onError(error) {
  console.log(`Error: ${error}`);
}

browser.browserAction.onClicked.addListener((tab) => {
  let creating = browser.windows.create({
    url: ["https://developer.mozilla.org",
          "https://addons.mozilla.org"]
  });
  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) => {
  let 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) => {

  let popupURL = browser.extension.getURL("popup/popup.html");

  let creating = browser.windows.create({
    url: popupURL,
    type: "popup",
    height: 200,
    width: 200
  });
  creating.then(onCreated, onError);

});

• store-collected-images
• window-manipulator

• window.open