tabs.create()

createProperties

object. Свойства новой вкладки. Чтобы узнать больше о свойствах, обратитесь к документации tabs.Tab.

active Необязательно

boolean. Станет ли вкладка активной во всплывающем окне. Если false, это не окажет влияния. Не влияет на фокусировку окна (см. windows.update). По умолчанию true.

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

string. Используется для создания вкладки с идентификатором хранилища cookies cookieStoreId. Этот параметр доступен только если у расширения есть разрешение "cookies" разрешение.

discarded Необязательно

boolean. Создаёт и делает вкладку видимой в строке вкладок без загрузки содержимого в память, состояние, известное как «отброшенная». Содержимое вкладки загружается при её активации.

index Необязательно

integer. Позиция вкладки в окне. Указанное значение будет ограничено от 0 до количества вкладок в окне.

muted Необязательно

boolean. Будет ли вкладка немым. По умолчанию false.

openerTabId Необязательно

integer. Идентификатор вкладки, которая открыла эту вкладку. Если указано, открывающая вкладка должна находиться в том же окне, что и новая вкладка.

openInReaderMode Необязательно

boolean. Если true, открыть эту вкладку в режиме чтения. По умолчанию false.

pinned Необязательно

boolean. Будет ли вкладка закреплённой. По умолчанию false.

selected Необязательно

boolean. Будет ли вкладка выделенной во всплывающем окне. По умолчанию true.

Предупреждение: Это свойство устарело и не поддерживается в Firefox. Используйте active вместо него.

title Необязательно

string. Заголовок вкладки. Разрешено только, если вкладка создана с discarded установленным на true.

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

string. URL для начальной навигации вкладки. По умолчанию — новая вкладка.

Полные URL-адреса должны содержать схему (например, 'http://www.google.com' а не 'www.google.com').

По соображениям безопасности в Firefox это может быть не привилегированный URL. Следовательно, ввод следующих URL-адресов завершится ошибкой:

• URL-адреса chrome:
• URL-адреса javascript:
• URL-адреса data:
• URL-адреса file: (т.е., файлы на файловой системе. Однако для использования файла, упакованного в расширение, см. ниже)
• Привилегированные URL-адреса about: (например, about:config, about:addons, about:debugging). Непривилегированные URL-адреса (например, about:blank) разрешены.
• Новая вкладка (about:newtab) может быть открыта, если значение URL не указано.

Чтобы загрузить страницу, входящую в состав вашего расширения, укажите абсолютный URL, начиная с файла manifest.json расширения. Например: '/path/to/my-page.html'. Если вы опустите ведущий "/", URL обрабатывается как относительный URL, и различные браузеры могут создавать разные абсолютные URL.

windowId Необязательно

integer. Окно, в котором создать новую вкладку. По умолчанию — текущее окно.

A Promise, которое будет выполнено с объектом tabs.Tab, содержащим подробности о созданной вкладке. Если вкладка не может быть создана (например, потому что url использовал привилегированную схему), promise отклонится с сообщением об ошибке.

Возвращаемый promise browser.tabs.create() разрешается, как только вкладка будет создана. Вкладка может всё ещё загружаться. Чтобы определить, когда загрузка вкладки завершится, прослушайте событие tabs.onUpdated или webNavigation.onCompleted, прежде чем вызывать tabs.create.

Открыть "https://example.org" в новой вкладке:

function onCreated(tab) {
  console.log(`Created new tab: ${tab.id}`)
}

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

browser.browserAction.onClicked.addListener(() => {
  let creating = browser.tabs.create({
    url:"https://example.org"
  });
  creating.then(onCreated, onError);
});

• commands
• contextual-identities
• find-across-tabs
• firefox-code-search
• open-my-page-button
• permissions
• store-collected-images
• tabs-tabs-tabs