Эта страница переведена с помощью Cloud Translation API.

chrome.tabs

Описание

Используйте API chrome.tabs для взаимодействия с системой вкладок браузера. С помощью этого API можно создавать, изменять и переупорядочивать вкладки в браузере.

Обзор

API вкладок не только предлагает функции для управления вкладками и их работы, но также может определять язык вкладки, делать снимки экрана и взаимодействовать со скриптами содержимого вкладки.

Разрешения

Для использования большинства функций не требуется никаких разрешений. Например, создание новой вкладки, перезагрузка вкладки, переход по другому URL-адресу и т. д.

При работе с API вкладок разработчикам следует учитывать три разрешения.

Разрешение «вкладки»: Это разрешение не предоставляет доступ к пространству имён chrome.tabs . Вместо этого оно предоставляет расширению возможность вызывать tabs.query() для четырёх конфиденциальных свойств экземпляров tabs.Tab : url , pendingUrl , title и favIconUrl .
Разрешения хоста: Разрешения хоста позволяют расширению читать и запрашивать четыре конфиденциальных свойства tabs.Tab соответствующей вкладки. Расширение также может напрямую взаимодействовать с соответствующими вкладками, используя такие методы, как tabs.captureVisibleTab() , tabs.executeScript() , tabs.insertCSS() и tabs.removeCSS() .
Разрешение «activeTab»: activeTab предоставляет расширению временное разрешение хоста для текущей вкладки в ответ на вызов пользователя. В отличие от разрешений хоста, activeTab не выдаёт никаких предупреждений.

Манифест

Ниже приведены примеры того, как объявить каждое разрешение в манифесте :

  {
    "name": "My extension",
    ...
    "permissions": [
      "tabs"
    ],
    ...
  }

  {
    "name": "My extension",
    ...
    "host_permissions": [
      "http://*/*",
      "https://*/*"
    ],
    ...
  }

  {
    "name": "My extension",
    ...
    "permissions": [
      "activeTab"
    ],
    ...
  }

Варианты использования

В следующих разделах показаны некоторые распространенные варианты использования.

Открытие страницы расширения в новой вкладке

Распространенный шаблон для расширений — открытие страницы знакомства в новой вкладке после установки расширения. Следующий пример показывает, как это сделать.

фон.js:

chrome.runtime.onInstalled.addListener(({reason}) => {
  if (reason === 'install') {
    chrome.tabs.create({
      url: "onboarding.html"
    });
  }
});

Получить текущую вкладку

В этом примере показано, как сервис-воркер расширения может получить активную вкладку из текущего окна, находящегося в фокусе (или из последнего окна, находившегося в фокусе, если в фокусе нет окон Chrome). Обычно это текущая вкладка пользователя.

  async function getCurrentTab() {
    let queryOptions = { active: true, lastFocusedWindow: true };
    // `tab` will either be a `tabs.Tab` instance or `undefined`.
    let [tab] = await chrome.tabs.query(queryOptions);
    return tab;
  }

  function getCurrentTab(callback) {
    let queryOptions = { active: true, lastFocusedWindow: true };
    chrome.tabs.query(queryOptions, ([tab]) => {
      if (chrome.runtime.lastError)
      console.error(chrome.runtime.lastError);
      // `tab` will either be a `tabs.Tab` instance or `undefined`.
      callback(tab);
    });
  }

Отключить указанную вкладку

В этом примере показано, как расширение может отключить звук для определенной вкладки.

  async function toggleMuteState(tabId) {
    const tab = await chrome.tabs.get(tabId);
    const muted = !tab.mutedInfo.muted;
    await chrome.tabs.update(tabId, {muted});
    console.log(`Tab ${tab.id} is ${muted ? "muted" : "unmuted"}`);
  }

  function toggleMuteState(tabId) {
    chrome.tabs.get(tabId, async (tab) => {
      let muted = !tab.mutedInfo.muted;
      await chrome.tabs.update(tabId, { muted });
      console.log(`Tab ${tab.id} is ${ muted ? "muted" : "unmuted" }`);
    });
  }

При щелчке переместить текущую вкладку на первую позицию

В этом примере показано, как переместить вкладку во время перетаскивания. Хотя в этом примере используется chrome.tabs.move , вы можете использовать тот же шаблон ожидания для других вызовов, которые изменяют вкладки во время перетаскивания.

  chrome.tabs.onActivated.addListener(moveToFirstPosition);

  async function moveToFirstPosition(activeInfo) {
    try {
      await chrome.tabs.move(activeInfo.tabId, {index: 0});
      console.log("Success.");
    } catch (error) {
      if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {
        setTimeout(() => moveToFirstPosition(activeInfo), 50);
      } else {
        console.error(error);
      }
    }
  }

  chrome.tabs.onActivated.addListener(moveToFirstPositionMV2);

  function moveToFirstPositionMV2(activeInfo) {
    chrome.tabs.move(activeInfo.tabId, { index: 0 }, () => {
      if (chrome.runtime.lastError) {
        const error = chrome.runtime.lastError;
        if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {
          setTimeout(() => moveToFirstPositionMV2(activeInfo), 50);
        } else {
          console.error(error);
        }
      } else {
        console.log("Success.");
      }
    });
  }

Передать сообщение в скрипт содержимого выбранной вкладки

В этом примере показано, как сервис-воркер расширения может взаимодействовать со скриптами содержимого на определенных вкладках браузера с помощью tabs.sendMessage() .

function sendMessageToActiveTab(message) {
  const [tab] = await chrome.tabs.query({ active: true, lastFocusedWindow: true });
  const response = await chrome.tabs.sendMessage(tab.id, message);
  // TODO: Do something with the response.
}

Примеры расширений

Для дополнительных демонстраций расширений API вкладок ознакомьтесь с любым из следующих источников:

Типы

MutedInfo

Хром 46+

Состояние отключения звука вкладки и причина последнего изменения состояния.

Характеристики

extensionId
строка необязательная
Идентификатор расширения, изменившего состояние отключения звука. Не устанавливается, если расширение не было причиной последнего изменения состояния отключения звука.
приглушенный
булев
Отключен ли звук на вкладке (запрещено ли воспроизведение звука). Вкладка может быть отключена, даже если звук не воспроизводится или не воспроизводится в данный момент. Аналогично отображению индикатора «Звук отключен».
причина
MutedInfoReason необязательно
Причина отключения или включения звука на вкладке. Не устанавливается, если состояние отключения звука на вкладке никогда не менялось.

MutedInfoReason

Хром 46+

Событие, вызвавшее изменение состояния звука.

Перечисление

"пользователь"
Действие пользовательского ввода устанавливает отключенное состояние.

"захватывать"
Был запущен захват вкладки, что привело к принудительному изменению состояния звука.

"расширение"
Расширение, идентифицированное полем extensionId, устанавливает отключенное состояние.

Tab

Характеристики

активный
булев
Активна ли вкладка в своём окне. Это не обязательно означает, что окно находится в фокусе.
слышимый
логическое необязательное
Хром 45+
Издавал ли вкладка звук за последние несколько секунд (но он может быть не слышен, если звук отключен). Аналогично тому, отображается ли индикатор «Аудио динамика».
autoDiscardable
булев
Хром 54+
Может ли браузер автоматически закрывать вкладку при недостатке ресурсов.
выброшен
булев
Хром 54+
Удалённая вкладка. Удалённая вкладка — это вкладка, содержимое которой было выгружено из памяти, но всё ещё отображается на панели вкладок. Её содержимое будет загружено заново при следующей активации.
favIconUrl
строка необязательная
URL-адрес значка вкладки. Это свойство присутствует только в том случае, если у расширения есть разрешение "tabs" или разрешение на размещение страницы на хосте. Также может быть пустой строкой, если вкладка загружается.
замороженный
булев
Хром 132+
Заморожена ли вкладка. Замороженная вкладка не может выполнять задачи, включая обработчики событий и таймеры. Она отображается на панели вкладок, а её содержимое загружается в память. Она размораживается при активации.
groupId
число
Хром 88+
Идентификатор группы, к которой принадлежит вкладка.
высота
номер необязательно
Высота вкладки в пикселях.
выделено
булев
Выделена ли вкладка.
идентификатор
номер необязательно
Идентификатор вкладки. Идентификаторы вкладок уникальны в рамках сеанса браузера. В некоторых случаях вкладке может быть не назначен идентификатор, например, при запросе внешних вкладок с помощью API sessions , в этом случае идентификатор сеанса может присутствовать. Для приложений и окон инструментов разработчика идентификатор вкладки также можно задать как chrome.tabs.TAB_ID_NONE .
инкогнито
булев
Находится ли вкладка в окне в режиме инкогнито.
индекс
число
Отсчитываемый от нуля индекс вкладки в ее окне.
последний доступ
число
Хром 121+
Время последнего момента, когда вкладка стала активной в своем окне, отображается как количество миллисекунд с начала эпохи.
mutedInfo
MutedInfo (необязательно)
Хром 46+
Состояние отключения звука вкладки и причина последнего изменения состояния.
openerTabId
номер необязательно
Идентификатор вкладки, открывшей данную вкладку, если таковая имеется. Это свойство присутствует только в том случае, если открывающая вкладка всё ещё существует.
pendingUrl
строка необязательная
Хром 79+
URL-адрес, на который ведет вкладка, до её фиксации. Это свойство присутствует только в том случае, если у расширения есть разрешение "tabs" или разрешение хоста для страницы и есть ожидающая навигация.
закрепленный
булев
Закреплена ли вкладка.
выбранный
булев
Устаревший
Пожалуйста, используйте tabs.Tab.highlighted .
Выбрана ли вкладка.
sessionId
строка необязательная
Идентификатор сеанса, используемый для уникальной идентификации вкладки, полученной из API sessions .
статус
TabStatus необязательно
Статус загрузки вкладки.
заголовок
строка необязательная
Заголовок вкладки. Это свойство присутствует только в том случае, если у расширения есть разрешение "tabs" или разрешение на размещение страницы.
URL-адрес
строка необязательная
Последний зафиксированный URL основного фрейма вкладки. Это свойство присутствует только в том случае, если у расширения есть разрешение "tabs" или разрешение хоста для страницы. Может быть пустой строкой, если вкладка ещё не зафиксирована. См. также Tab.pendingUrl .
ширина
номер необязательно
Ширина вкладки в пикселях.
windowId
число
Идентификатор окна, содержащего вкладку.

TabStatus

Хром 44+

Статус загрузки вкладки.

Перечисление

"разгруженный"

"загрузка"

"полный"

WindowType

Хром 44+

Тип окна.

Перечисление

"нормальный"

"неожиданно возникнуть"

"панель"

"приложение"

"devtools"

ZoomSettings

Определяет, как и в каком диапазоне обрабатываются изменения масштаба на вкладке.

Характеристики

defaultZoomFactor
номер необязательно
Хром 43+
Используется для возврата уровня масштабирования по умолчанию для текущей вкладки при вызовах tabs.getZoomSettings.
режим
ZoomSettingsMode (необязательно)
Определяет, как обрабатываются изменения масштаба, т. е. какая сущность отвечает за фактическое масштабирование страницы; по умолчанию — automatic .
объем
ZoomSettingsScope (опционально)
Определяет, сохраняются ли изменения масштаба для исходного положения страницы или вступают в силу только для этой вкладки; по умолчанию применяется к per-origin в automatic режиме и per-tab в противном случае.

ZoomSettingsMode

Хром 44+

Определяет, как обрабатываются изменения масштаба, т. е. какая сущность отвечает за фактическое масштабирование страницы; по умолчанию — automatic .

Перечисление

"автоматический"
Изменения масштаба обрабатываются браузером автоматически.

"руководство"
Переопределяет автоматическую обработку изменения масштаба. Событие onZoomChange по-прежнему будет отправляться, и расширение обязано отслеживать это событие и вручную масштабировать страницу. Этот режим не поддерживает масштабирование per-origin , поэтому игнорирует настройку масштабирования scope и предполагает масштабирование per-tab .

"неполноценный"
Отключает масштабирование на вкладке. Вкладка возвращается к уровню масштабирования по умолчанию, и все попытки изменить масштаб игнорируются.

ZoomSettingsScope

Хром 44+

Определяет, сохраняются ли изменения масштаба для исходного положения страницы или вступают в силу только для этой вкладки; по умолчанию применяется к per-origin в automatic режиме и per-tab в противном случае.

Перечисление

"по происхождению"
Изменения масштаба сохраняются в исходной точке увеличенной страницы, то есть все остальные вкладки, переключенные в ту же исходную точку, также масштабируются. Более того, изменения масштаба per-origin сохраняются вместе с исходной точкой, что означает, что при переходе на другие страницы в той же исходной точке все они будут масштабированы с одинаковым коэффициентом масштабирования. Масштабирование per-origin доступно только в automatic режиме.

"на вкладку"
Изменения масштаба применяются только к этой вкладке, а изменения масштаба на других вкладках не влияют на масштаб этой вкладки. Кроме того, изменения масштаба per-tab сбрасываются при навигации; при навигации по вкладке страницы всегда загружаются с коэффициентами масштабирования per-origin .

Характеристики

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Хром 92+

Максимальное количество вызовов captureVisibleTab в секунду. captureVisibleTab — ресурсоемкая функция, и ее не следует вызывать слишком часто.

Ценить

TAB_ID_NONE

Хром 46+

Идентификатор, обозначающий отсутствие вкладки браузера.

Ценить

-1

TAB_INDEX_NONE

Хром 123+

Индекс, представляющий отсутствие индекса табуляции в tab_strip.

Ценить

-1

Методы

captureVisibleTab()

Обещать

chrome.tabs.captureVisibleTab(
  windowId?: number,
  options?: ImageDetails,
  callback?: function,
): Promise<string>

Захватывает видимую область активной вкладки в указанном окне. Для вызова этого метода расширение должно иметь разрешение <all_urls> или разрешение activeTab . Помимо сайтов, к которым расширения обычно имеют доступ, этот метод позволяет расширениям захватывать конфиденциальные сайты, доступ к которым в противном случае ограничен, включая страницы chrome:-scheme, страницы других расширений и URL-адреса data:. Захват этих конфиденциальных сайтов возможен только при наличии разрешения activeTab. URL-адреса файлов могут быть захвачены только в том случае, если расширению предоставлен доступ к файлам.

Параметры

windowId
номер необязательно
Целевое окно. По умолчанию — текущее окно .
параметры
ImageDetails (необязательно)
перезвонить
функция необязательна
Параметр callback выглядит так:
```
(dataUrl: string) => void
```
- dataUrl
  нить
  URL-адрес данных, кодирующий изображение видимой области захваченной вкладки. Может быть назначен свойству 'src' HTML-элемента img для отображения.

Возврат

Обещание<строка>
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

connect()

chrome.tabs.connect(
  tabId: number,
  connectInfo?: object,
): runtime.Port

Подключается к скрипту(ам) контента на указанной вкладке. Событие runtime.onConnect вызывается в каждом скрипте контента, запущенном на указанной вкладке для текущего расширения. Подробнее см. в разделе «Сообщения скрипта контента» .

Параметры

tabId
число
connectInfo
объект необязательный
- documentId
  строка необязательная
  Хром 106+
  Откройте порт для конкретного документа , идентифицированного по documentId , а не для всех фреймов на вкладке.
- frameId
  номер необязательно
  Откройте порт для конкретного фрейма , идентифицированного по frameId , а не для всех фреймов на вкладке.
- имя
  строка необязательная
  Передается в onConnect для скриптов содержимого, которые прослушивают событие подключения.

Возврат

runtime.Port
Порт, который можно использовать для связи со скриптами содержимого, работающими на указанной вкладке. Событие runtime.Port порта срабатывает, если вкладка закрывается или отсутствует.

create()

Обещать

chrome.tabs.create(
  createProperties: object,
  callback?: function,
): Promise<Tab>

Создает новую вкладку.

Параметры

createProperties
объект
- активный
  логическое необязательное
  Должна ли вкладка стать активной вкладкой в окне. Не влияет на то, находится ли окно в фокусе (см. windows.update ). Значение по умолчанию — true .
- индекс
  номер необязательно
  Положение вкладки в окне. Значение ограничено нулем и количеством вкладок в окне.
- openerTabId
  номер необязательно
  Идентификатор вкладки, открывшей данную вкладку. Если указано, открывающая вкладка должна находиться в том же окне, что и вновь созданная вкладка.
- закрепленный
  логическое необязательное
  Нужно ли закреплять вкладку. Значение по умолчанию — false
- выбранный
  логическое необязательное
  Устаревший
  Пожалуйста, используйте активный .
  Должна ли вкладка стать выбранной вкладкой в окне. Значение по умолчанию — true
- URL-адрес
  строка необязательная
  URL-адрес для первоначального перехода на вкладку. Полные URL-адреса должны включать схему (например, «http://www.google.com», а не «www.google.com»). Относительные URL-адреса указываются относительно текущей страницы в расширении. По умолчанию используется страница новой вкладки.
- windowId
  номер необязательно
  Окно, в котором будет создана новая вкладка. По умолчанию — текущее окно .
перезвонить
функция необязательна
Параметр callback выглядит так:
```
(tab: Tab) => void
```
- вкладка
  Вкладка
  Созданная вкладка.

Возврат

Обещание< Tab >
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

detectLanguage()

Обещать

chrome.tabs.detectLanguage(
  tabId?: number,
  callback?: function,
): Promise<string>

Определяет основной язык содержимого на вкладке.

Параметры

tabId
номер необязательно
По умолчанию активная вкладка текущего окна .
перезвонить
функция необязательна
Параметр callback выглядит так:
```
(language: string) => void
```
- язык
  нить
  Код языка ISO, например en или fr . Полный список языков, поддерживаемых этим методом, см. в таблице kLanguageInfoTable . Проверяются столбцы со второго по четвёртый, и возвращается первое ненулевое значение, за исключением упрощённого китайского языка, для которого возвращается zh-CN . Для неизвестного/неопределённого языка возвращается und .

Возврат

Обещание<строка>
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

discard()

Обещание Chrome 54+

chrome.tabs.discard(
  tabId?: number,
  callback?: function,
): Promise<Tab | undefined>

Удаляет вкладку из памяти. Удалённые вкладки остаются на панели вкладок и загружаются заново при активации.

Параметры

tabId
номер необязательно
Идентификатор вкладки, которую нужно удалить. Если этот параметр указан, вкладка удаляется, если она не активна или уже удалена. Если этот параметр не указан, браузер удаляет наименее важную вкладку. Это может привести к ошибке, если нет вкладок, которые можно удалить.
перезвонить
функция необязательна
Параметр callback выглядит так:
```
(tab?: Tab) => void
```
- вкладка
  Вкладка необязательна
  Отброшенная вкладка, если она была успешно отброшена; в противном случае не определено.

Возврат

Обещание< Tab | не определено>
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

duplicate()

Обещать

chrome.tabs.duplicate(
  tabId: number,
  callback?: function,
): Promise<Tab | undefined>

Дублирует вкладку.

Параметры

tabId
число
Идентификатор вкладки, которую нужно дублировать.
перезвонить
функция необязательна
Параметр callback выглядит так:
```
(tab?: Tab) => void
```
- вкладка
  Вкладка необязательна
  Подробная информация о дублированной вкладке. Свойства url , pendingUrl , title и favIconUrl включаются в объект tabs.Tab только в том случае, если расширение имеет разрешение "tabs" или разрешение хоста для страницы.

Возврат

Обещание< Tab | не определено>
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

executeScript()

Обещание ≤ MV2 Устарело с Chrome 91

chrome.tabs.executeScript(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
): Promise<any[] | undefined>

Заменено на scripting.executeScript в Manifest V3.

Внедряет код JavaScript на страницу. Подробнее см. в разделе «Программное внедрение» в документации по скриптам контента.

Параметры

tabId
номер необязательно
Идентификатор вкладки, в которой будет запущен скрипт; по умолчанию это активная вкладка текущего окна.
подробности
InjectDetails
Подробная информация о скрипте для запуска. Необходимо задать либо код, либо свойство файла, но оба одновременно задать нельзя.
перезвонить
функция необязательна
Параметр callback выглядит так:
```
(result?: any[]) => void
```
- результат
  любой[] необязательный
  Результат работы скрипта в каждом внедренном кадре.

Возврат

Обещание<любой[] | неопределенный>
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

get()

Обещать

chrome.tabs.get(
  tabId: number,
  callback?: function,
): Promise<Tab>

Возвращает сведения об указанной вкладке.

Параметры

tabId
число
перезвонить
функция необязательна
Параметр callback выглядит так:
```
(tab: Tab) => void
```
- вкладка
  Вкладка

Возврат

Обещание< Tab >
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getAllInWindow()

Обещание ≤ MV2 Устаревшее

chrome.tabs.getAllInWindow(
  windowId?: number,
  callback?: function,
): Promise<Tab[]>

Пожалуйста, используйте tabs.query {windowId: windowId} .

Получает сведения обо всех вкладках в указанном окне.

Параметры

windowId
номер необязательно
По умолчанию используется текущее окно .
перезвонить
функция необязательна
Параметр callback выглядит так:
```
(tabs: Tab[]) => void
```
- вкладки
  Вкладка []

Возврат

Обещание< Tab []>
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getCurrent()

Обещать

chrome.tabs.getCurrent(
  callback?: function,
): Promise<Tab | undefined>

Возвращает вкладку, из которой выполняется вызов этого скрипта. Возвращает значение undefined если вызывается из контекста, отличного от вкладки (например, фоновой страницы или всплывающего окна).

Параметры

перезвонить
функция необязательна
Параметр callback выглядит так:
```
(tab?: Tab) => void
```
- вкладка
  Вкладка необязательна

Возврат

Обещание< Tab | не определено>
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getSelected()

Обещание ≤ MV2 Устаревшее

chrome.tabs.getSelected(
  windowId?: number,
  callback?: function,
): Promise<Tab>

Пожалуйста, используйте tabs.query {active: true} .

Возвращает вкладку, выбранную в указанном окне.

Параметры

windowId
номер необязательно
По умолчанию используется текущее окно .
перезвонить
функция необязательна
Параметр callback выглядит так:
```
(tab: Tab) => void
```
- вкладка
  Вкладка

Возврат

Обещание< Tab >
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getZoom()

Обещать

chrome.tabs.getZoom(
  tabId?: number,
  callback?: function,
): Promise<number>

Получает текущий коэффициент масштабирования указанной вкладки.

Параметры

tabId
номер необязательно
Идентификатор вкладки, из которой необходимо получить текущий коэффициент масштабирования; по умолчанию — активная вкладка текущего окна.
перезвонить
функция необязательна
Параметр callback выглядит так:
```
(zoomFactor: number) => void
```
- zoomFactor
  число
  Текущий коэффициент масштабирования вкладки.

Возврат

Обещание<номер>
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getZoomSettings()

Обещать

chrome.tabs.getZoomSettings(
  tabId?: number,
  callback?: function,
): Promise<ZoomSettings>

Получает текущие настройки масштабирования указанной вкладки.

Параметры

tabId
номер необязательно
Идентификатор вкладки, из которой необходимо получить текущие настройки масштаба; по умолчанию — активная вкладка текущего окна.
перезвонить
функция необязательна
Параметр callback выглядит так:
```
(zoomSettings: ZoomSettings) => void
```
- ZoomSettings
  ZoomSettings
  Текущие настройки масштабирования вкладки.

Возврат

Обещание< Настройки Zoom >
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

goBack()

Обещание Chrome 72+

chrome.tabs.goBack(
  tabId?: number,
  callback?: function,
): Promise<void>

Вернитесь на предыдущую страницу, если она доступна.

Параметры

tabId
номер необязательно
Идентификатор вкладки для возврата назад; по умолчанию — выбранная вкладка текущего окна.
перезвонить
функция необязательна
Параметр callback выглядит так:
```
() => void
```

Возврат

Обещание<void>
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

goForward()

Обещание Chrome 72+

chrome.tabs.goForward(
  tabId?: number,
  callback?: function,
): Promise<void>

Перейдите на следующую страницу, если она доступна.

Параметры

tabId
номер необязательно
Идентификатор вкладки для перехода вперед; по умолчанию — выбранная вкладка текущего окна.
перезвонить
функция необязательна
Параметр callback выглядит так:
```
() => void
```

Возврат

Обещание<void>
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

group()

Обещание Chrome 88+

chrome.tabs.group(
  options: object,
  callback?: function,
): Promise<number>

Добавляет одну или несколько вкладок в указанную группу или, если группа не указана, добавляет указанные вкладки во вновь созданную группу.

Параметры

параметры
объект
- createProperties
  объект необязательный
  Конфигурации для создания группы. Невозможно использовать, если groupId уже указан.
  - windowId
    номер необязательно
    Окно новой группы. По умолчанию — текущее окно.
- groupId
  номер необязательно
  Идентификатор группы, в которую нужно добавить вкладки. Если не указан, будет создана новая группа.
- tabIds
  число | [число, ...число[]]
  Идентификатор вкладки или список идентификаторов вкладок для добавления в указанную группу.
перезвонить
функция необязательна
Параметр callback выглядит так:
```
(groupId: number) => void
```
- groupId
  число
  Идентификатор группы, в которую были добавлены вкладки.

Возврат

Обещание<номер>
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

highlight()

Обещать

chrome.tabs.highlight(
  highlightInfo: object,
  callback?: function,
): Promise<windows.Window>

Выделяет указанные вкладки и фокусируется на первой из группы. Не выполняет никаких действий, если указанная вкладка активна.

Параметры

highlightInfo
объект
- вкладки
  номер | номер[]
  Один или несколько индексов вкладок для выделения.
- windowId
  номер необязательно
  Окно, содержащее вкладки.
перезвонить
функция необязательна
Параметр callback выглядит так:
```
(window: Window) => void
```
- окно
  Окно
  Содержит сведения об окне, вкладки которого были выделены.

Возврат

Обещание< windows.Window >
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

insertCSS()

Обещание ≤ MV2 Устарело с Chrome 91

chrome.tabs.insertCSS(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
): Promise<void>

Заменено на scripting.insertCSS в Manifest V3.

Внедряет CSS на страницу. Стили, вставленные этим методом, можно удалить с помощью scripting.removeCSS . Подробнее см. в разделе о программном внедрении в документации по скриптам контента.

Параметры

tabId
номер необязательно
Идентификатор вкладки, в которую следует вставить CSS; по умолчанию это активная вкладка текущего окна.
подробности
InjectDetails
Подробная информация о CSS-тексте для вставки. Необходимо задать либо код, либо свойство файла, но оба одновременно задать нельзя.
перезвонить
функция необязательна
Параметр callback выглядит так:
```
() => void
```

Возврат

Обещание<void>
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

move()

Обещать

chrome.tabs.move(
  tabIds: number | number[],
  moveProperties: object,
  callback?: function,
): Promise<Tab | Tab[]>

Перемещает одну или несколько вкладок на новое место в пределах окна или в новое окно. Обратите внимание, что вкладки можно перемещать только в обычные окна (window.type === "normal") и из них.

Параметры

tabIds
номер | номер[]
Идентификатор вкладки или список идентификаторов вкладок для перемещения.
moveProperties
объект
- индекс
  число
  Позиция, в которую следует переместить окно. Используйте -1 , чтобы поместить вкладку в конец окна.
- windowId
  номер необязательно
  По умолчанию используется окно, в котором в данный момент находится вкладка.
перезвонить
функция необязательна
Параметр callback выглядит так:
```
(tabs: Tab | Tab[]) => void
```
- вкладки
  Вкладка | Вкладка []
  Подробная информация о перемещенных вкладках.

Возврат

Обещание< Tab | Tab []>
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

query()

Обещать

chrome.tabs.query(
  queryInfo: object,
  callback?: function,
): Promise<Tab[]>

Получает все вкладки, имеющие указанные свойства, или все вкладки, если свойства не указаны.

Параметры

queryInfo
объект
- активный
  логическое необязательное
  Активны ли вкладки в своих окнах.
- слышимый
  логическое необязательное
  Хром 45+
  Слышны ли вкладки.
- autoDiscardable
  логическое необязательное
  Хром 54+
  Может ли браузер автоматически закрывать вкладки при нехватке ресурсов.
- текущее окно
  логическое необязательное
  Находятся ли вкладки в текущем окне .
- выброшен
  логическое необязательное
  Хром 54+
  Удалены ли вкладки. Удалённая вкладка — это вкладка, содержимое которой было выгружено из памяти, но всё ещё отображается на панели вкладок. Её содержимое будет загружено заново при следующей активации.
- замороженный
  логическое необязательное
  Хром 132+
  Заморожены ли вкладки. Замороженная вкладка не может выполнять задачи, включая обработчики событий и таймеры. Она отображается на панели вкладок, а её содержимое загружается в память. Она размораживается при активации.
- groupId
  номер необязательно
  Хром 88+
  Идентификатор группы, в которой находятся вкладки, или tabGroups.TAB_GROUP_ID_NONE для несгруппированных вкладок.
- выделено
  логическое необязательное
  Подсвечиваются ли вкладки.
- индекс
  номер необязательно
  Положение вкладок в окнах.
- lastFocusedWindow
  логическое необязательное
  Находятся ли вкладки в последнем активном окне.
- приглушенный
  логическое необязательное
  Хром 45+
  Отключены ли вкладки.
- закрепленный
  логическое необязательное
  Закреплены ли вкладки.
- splitViewId
  номер необязательно
  Хром 140+
  Идентификатор разделенного представления, в котором находятся вкладки, или tabs.SPLIT_VIEW_ID_NONE для вкладок, которые не находятся в разделенном представлении.
- статус
  TabStatus необязательно
  Статус загрузки вкладки.
- заголовок
  строка необязательная
  Сопоставлять заголовки страниц с шаблоном. Это свойство игнорируется, если у расширения нет разрешения "tabs" или разрешений на размещение страницы.
- URL-адрес
  строка | строка[] необязательно
  Сопоставьте вкладки с одним или несколькими шаблонами URL . Идентификаторы фрагментов не сопоставляются. Это свойство игнорируется, если у расширения нет разрешения "tabs" или разрешений на хост для страницы.
- windowId
  номер необязательно
  Идентификатор родительского окна или windows.WINDOW_ID_CURRENT для текущего окна .
- Тип окна
  WindowType необязательно
  Тип окна, в котором находятся вкладки.
перезвонить
функция необязательна
Параметр callback выглядит так:
```
(result: Tab[]) => void
```
- результат
  Вкладка []

Возврат

Обещание< Tab []>
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

reload()

Обещать

chrome.tabs.reload(
  tabId?: number,
  reloadProperties?: object,
  callback?: function,
): Promise<void>

Перезагрузить вкладку.

Параметры

tabId
номер необязательно
Идентификатор вкладки для перезагрузки; по умолчанию — выбранная вкладка текущего окна.
reloadProperties
объект необязательный
- bypassCache
  логическое необязательное
  Обходить ли локальное кэширование. Значение по умолчанию — false .
перезвонить
функция необязательна
Параметр callback выглядит так:
```
() => void
```

Возврат

Обещание<void>
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

remove()

Обещать

chrome.tabs.remove(
  tabIds: number | number[],
  callback?: function,
): Promise<void>

Закрывает одну или несколько вкладок.

Параметры

tabIds
номер | номер[]
Идентификатор вкладки или список идентификаторов вкладок, которые необходимо закрыть.
перезвонить
функция необязательна
Параметр callback выглядит так:
```
() => void
```

Возврат

Обещание<void>
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

removeCSS()

Обещание Chrome 87+ ≤ MV2 Устарело с Chrome 91

chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
): Promise<void>

Заменено на scripting.removeCSS в Manifest V3.

Удаляет со страницы CSS, который ранее был внедрен с помощью вызова scripting.insertCSS .

Параметры

tabId
номер необязательно
Идентификатор вкладки, из которой необходимо удалить CSS; по умолчанию — активная вкладка текущего окна.
подробности
DeleteInjectionDetails
Подробная информация о CSS-тексте, который нужно удалить. Необходимо задать либо код, либо свойство файла, но оба одновременно задать нельзя.
перезвонить
функция необязательна
Параметр callback выглядит так:
```
() => void
```

Возврат

Обещание<void>
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

sendMessage()

Обещать

chrome.tabs.sendMessage(
  tabId: number,
  message: any,
  options?: object,
  callback?: function,
): Promise<any>

Отправляет одно сообщение скрипту(ам) контента на указанной вкладке с необязательным обратным вызовом, который запускается при получении ответа. Событие runtime.onMessage активируется в каждом скрипте контента, запущенном на указанной вкладке для текущего расширения.

Параметры

tabId
число
сообщение
любой
Сообщение для отправки. Это сообщение должно быть объектом, поддерживающим формат JSON.
параметры
объект необязательный
- documentId
  строка необязательная
  Хром 106+
  Отправить сообщение определенному документу , идентифицированному по documentId , а не всем фреймам на вкладке.
- frameId
  номер необязательно
  Отправить сообщение определенному фрейму, идентифицированному по frameId , а не всем фреймам на вкладке.
перезвонить
функция необязательна
Хром 99+
Параметр callback выглядит так:
```
(response: any) => void
```
- ответ
  любой
  Объект ответа JSON, отправленный обработчиком сообщения. Если при подключении к указанной вкладке возникает ошибка, функция обратного вызова вызывается без аргументов, а runtime.lastError записывается сообщение об ошибке.

Возврат

Обещание<любое>
Хром 99+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

sendRequest()

Обещание ≤ MV2 Устаревшее

chrome.tabs.sendRequest(
  tabId: number,
  request: any,
  callback?: function,
): Promise<any>

Используйте runtime.sendMessage .

Отправляет один запрос к скрипту(ам) контента на указанной вкладке с необязательным обратным вызовом, который запускается при получении ответа. Событие extension.onRequest активируется в каждом скрипте контента, запущенном на указанной вкладке для текущего расширения.

Параметры

tabId
число
запрос
любой
перезвонить
функция необязательна
Хром 99+
Параметр callback выглядит так:
```
(response: any) => void
```
- ответ
  любой
  Объект ответа JSON, отправленный обработчиком запроса. Если при подключении к указанной вкладке возникает ошибка, функция обратного вызова вызывается без аргументов, а runtime.lastError записывается сообщение об ошибке.

Возврат

Обещание<любое>
Хром 99+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

setZoom()

Обещать

chrome.tabs.setZoom(
  tabId?: number,
  zoomFactor: number,
  callback?: function,
): Promise<void>

Увеличивает указанную вкладку.

Параметры

tabId
номер необязательно
Идентификатор вкладки для масштабирования; по умолчанию — активная вкладка текущего окна.
zoomFactor
число
Новый коэффициент масштабирования. Значение 0 устанавливает текущий коэффициент масштабирования по умолчанию для вкладки. Значения больше 0 задают коэффициент масштабирования (возможно, отличный от коэффициента по умолчанию) для вкладки.
перезвонить
функция необязательна
Параметр callback выглядит так:
```
() => void
```

Возврат

Обещание<void>
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

setZoomSettings()

Обещать

chrome.tabs.setZoomSettings(
  tabId?: number,
  zoomSettings: ZoomSettings,
  callback?: function,
): Promise<void>

Задаёт параметры масштабирования для указанной вкладки, определяющие, как будут обрабатываться изменения масштаба. При переходе по вкладке эти настройки сбрасываются к значениям по умолчанию.

Параметры

tabId
номер необязательно
Идентификатор вкладки, для которой необходимо изменить настройки масштаба; по умолчанию это активная вкладка текущего окна.
ZoomSettings
ZoomSettings
Определяет, как и в каком диапазоне обрабатываются изменения масштаба.
перезвонить
функция необязательна
Параметр callback выглядит так:
```
() => void
```

Возврат

Обещание<void>
Хром 88+
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

ungroup()

Обещание Chrome 88+

chrome.tabs.ungroup(
  tabIds: number | [number, ...number[]],
  callback?: function,
): Promise<void>

Удаляет одну или несколько вкладок из соответствующих групп. Если какие-либо группы становятся пустыми, они удаляются.

Параметры

tabIds
число | [число, ...число[]]
Идентификатор вкладки или список идентификаторов вкладок, которые следует удалить из соответствующих групп.
перезвонить
функция необязательна
Параметр callback выглядит так:
```
() => void
```

Возврат

Обещание<void>
Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

update()

Обещать

chrome.tabs.update(
  tabId?: number,
  updateProperties: object,
  callback?: function,
): Promise<Tab | undefined>

Изменяет свойства вкладки. Свойства, не указанные в updateProperties , не изменяются.

Параметры

tabId
номер необязательно
По умолчанию используется выбранная вкладка текущего окна .
updateProperties
объект
- активный
  логическое необязательное
  Должна ли вкладка быть активной. Не влияет на то, находится ли окно в фокусе (см. windows.update ).
- autoDiscardable
  логическое необязательное
  Хром 54+
  Должна ли вкладка автоматически закрываться браузером при низком уровне ресурсов.
- выделено
  логическое необязательное
  Добавляет или удаляет вкладку из текущего выбора.
- приглушенный
  логическое необязательное
  Хром 45+
  Должен ли звук на вкладке быть отключен.
- openTabId
  номер необязательно
  Идентификатор вкладки, которая открыла эту вкладку. Если указано, вкладка открытия должна находиться в том же окне, что и эта вкладка.
- закрепленный
  логическое значение необязательно
  Должна ли быть закреплена вкладка.
- выбранный
  логическое значение необязательно
  Устаревший
  Пожалуйста, используйте выделенный .
  Следует ли выбирать вкладку.
- URL-адрес
  строка необязательна
  URL-адрес для перехода по вкладке. URL-адреса JavaScript не поддерживаются; вместо этого используйте scripting.executeScript .
перезвонить
функция необязательна
Параметр callback выглядит так:
```
(tab?: Tab) => void
```
- вкладка
  Вкладка необязательна
  Подробности об обновленной вкладке. Свойства url , pendingUrl , title и favIconUrl включаются в объект tabs.Tab только в том случае, если расширение имеет разрешение "tabs" или разрешения хоста для страницы.

Возврат

Обещание< Вкладка | не определено>
Хром 88+
Промисы поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

События

onActivated

chrome.tabs.onActivated.addListener(
  callback: function,
)

Срабатывает при изменении активной вкладки в окне. Обратите внимание, что URL-адрес вкладки может не быть установлен во время запуска этого события, но вы можете прослушивать события onUpdated, чтобы получать уведомления, когда URL-адрес установлен.

Параметры

перезвонить
функция
Параметр callback выглядит так:
```
(activeInfo: object) => void
```
- активинфо
  объект
  - tabId
    число
    Идентификатор вкладки, которая стала активной.
  - идентификатор окна
    число
    Идентификатор окна, внутри которого изменилась активная вкладка.

onActiveChanged

≤ MV2 устарел

chrome.tabs.onActiveChanged.addListener(
  callback: function,
)

Пожалуйста, используйте tabs.onActivated .

Срабатывает при изменении выбранной вкладки в окне. Обратите внимание, что URL-адрес вкладки может не быть установлен во время запуска этого события, но вы можете прослушивать события tabs.onUpdated , чтобы получать уведомления, когда URL-адрес установлен.

Параметры

перезвонить
функция
Параметр callback выглядит так:
```
(tabId: number, selectInfo: object) => void
```
- tabId
  число
- выберитеИнформация
  объект
  - идентификатор окна
    число
    Идентификатор окна, внутри которого изменилась выбранная вкладка.

onAttached

chrome.tabs.onAttached.addListener(
  callback: function,
)

Вызывается, когда к окну прикреплена вкладка; например, потому что он был перемещен между окнами.

Параметры

перезвонить
функция
Параметр callback выглядит так:
```
(tabId: number, attachInfo: object) => void
```
- tabId
  число
- AttachInfo
  объект
  - новая позиция
    число
  - новыйWindowId
    число

onCreated

chrome.tabs.onCreated.addListener(
  callback: function,
)

Вызывается при создании вкладки. Обратите внимание, что URL-адрес вкладки и членство в группе вкладок могут быть не установлены во время запуска этого события, но вы можете прослушивать события onUpdated, чтобы получать уведомления, когда URL-адрес установлен или вкладка добавляется в группу вкладок.

Параметры

перезвонить
функция
Параметр callback выглядит так:
```
(tab: Tab) => void
```
- вкладка
  Вкладка

onDetached

chrome.tabs.onDetached.addListener(
  callback: function,
)

Вызывается, когда вкладка отделена от окна; например, потому что он был перемещен между окнами.

Параметры

перезвонить
функция
Параметр callback выглядит так:
```
(tabId: number, detachInfo: object) => void
```
- tabId
  число
- отсоединитьинформацию
  объект
  - старая позиция
    число
  - старыйWindowId
    число

onHighlightChanged

≤ MV2 устарел

chrome.tabs.onHighlightChanged.addListener(
  callback: function,
)

Пожалуйста, используйте tabs.onHighlighted .

Вызывается при изменении выделенных или выбранных вкладок в окне.

Параметры

перезвонить
функция
Параметр callback выглядит так:
```
(selectInfo: object) => void
```
- выберитеИнформация
  объект
  - tabIds
    число[]
    Все выделенные вкладки в окне.
  - идентификатор окна
    число
    Окно, вкладки которого менялись.

onHighlighted

chrome.tabs.onHighlighted.addListener(
  callback: function,
)

Вызывается при изменении выделенных или выбранных вкладок в окне.

Параметры

перезвонить
функция
Параметр callback выглядит так:
```
(highlightInfo: object) => void
```
- ВыделитеИнформацию
  объект
  - tabIds
    число[]
    Все выделенные вкладки в окне.
  - идентификатор окна
    число
    Окно, вкладки которого менялись.

onMoved

chrome.tabs.onMoved.addListener(
  callback: function,
)

Вызывается при перемещении вкладки внутри окна. Запускается только одно событие перемещения, представляющее вкладку, которую непосредственно переместил пользователь. События перемещения не запускаются для других вкладок, которые должны перемещаться в ответ на перемещение вкладки вручную. Это событие не вызывается при перемещении вкладки между окнами; подробности см. в tabs.onDetached .

Параметры

перезвонить
функция
Параметр callback выглядит так:
```
(tabId: number, moveInfo: object) => void
```
- tabId
  число
- moveInfo
  объект
  - отиндекс
    число
  - toIndex
    число
  - идентификатор окна
    число

onRemoved

chrome.tabs.onRemoved.addListener(
  callback: function,
)

Вызывается при закрытии вкладки.

Параметры

перезвонить
функция
Параметр callback выглядит так:
```
(tabId: number, removeInfo: object) => void
```
- tabId
  число
- удалитьинформацию
  объект
  - isWindowClosing
    булев
    Истинно, когда вкладка была закрыта, поскольку ее родительское окно было закрыто.
  - идентификатор окна
    число
    Окно, вкладка которого закрыта.

onReplaced

chrome.tabs.onReplaced.addListener(
  callback: function,
)

Вызывается, когда вкладка заменяется другой вкладкой из-за предварительной отрисовки или мгновенного отображения.

Параметры

перезвонить
функция
Параметр callback выглядит так:
```
(addedTabId: number, removedTabId: number) => void
```
- добавленныйTabId
  число
- удаленныйTabId
  число

onSelectionChanged

≤ MV2 устарел

chrome.tabs.onSelectionChanged.addListener(
  callback: function,
)

Пожалуйста, используйте tabs.onActivated .

Срабатывает при изменении выбранной вкладки в окне.

Параметры

перезвонить
функция
Параметр callback выглядит так:
```
(tabId: number, selectInfo: object) => void
```
- tabId
  число
- выберитеИнформация
  объект
  - идентификатор окна
    число
    Идентификатор окна, внутри которого изменилась выбранная вкладка.

onUpdated

chrome.tabs.onUpdated.addListener(
  callback: function,
)

Вызывается при обновлении вкладки.

Параметры

перезвонить
функция
Параметр callback выглядит так:
```
(tabId: number, changeInfo: object, tab: Tab) => void
```
- tabId
  число
- изменениеИнформация
  объект
  - слышимый
    логическое значение необязательно
    Хром 45+
    Новое звуковое состояние вкладки.
  - автосбрасываемый
    логическое значение необязательно
    Хром 54+
    Новое состояние автоматического удаления вкладки.
  - выброшен
    логическое значение необязательно
    Хром 54+
    Новое отброшенное состояние вкладки.
  - favIconUrl
    строка необязательна
    Новый URL-адрес значка вкладки.
  - замороженный
    логическое значение необязательно
    Хром 132+
    Новое замороженное состояние вкладки.
  - идентификатор группы
    номер необязательно
    Хром 88+
    Новая группа вкладки.
  - mutedInfo
    MutedInfo необязательно
    Хром 46+
    Новое отключенное состояние вкладки и причина изменения.
  - закрепленный
    логическое значение необязательно
    Новое закрепленное состояние вкладки.
  - сплитвиевид
    номер необязательно
    Хром 140+
    Новый разделенный вид вкладки.
  - статус
    TabStatus необязательно
    Статус загрузки вкладки.
  - заголовок
    строка необязательна
    Хром 48+
    Новое название вкладки.
  - URL-адрес
    строка необязательна
    URL-адрес вкладки, если он изменился.
- вкладка
  Вкладка

onZoomChange

chrome.tabs.onZoomChange.addListener(
  callback: function,
)

Вызывается при масштабировании вкладки.

Параметры

перезвонить
функция
Параметр callback выглядит так:
```
(ZoomChangeInfo: object) => void
```
- ZoomChangeИнформация
  объект
  - новыйZoomFactor
    число
  - старыйZoomFactor
    число
  - tabId
    число
  - зумНастройки
    Настройки масштабирования

chrome.tabs Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Описание

Обзор

Разрешения

Манифест

Варианты использования

Открытие страницы расширения в новой вкладке

Получить текущую вкладку

Отключить указанную вкладку

При щелчке переместить текущую вкладку на первую позицию

Передать сообщение в скрипт содержимого выбранной вкладки

Примеры расширений

Типы

MutedInfo

Характеристики

MutedInfoReason

Перечисление

Tab

Характеристики

TabStatus

Перечисление

WindowType

Перечисление

ZoomSettings

Характеристики

ZoomSettingsMode

Перечисление

ZoomSettingsScope

Перечисление

Характеристики

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Ценить

TAB_ID_NONE

Ценить

TAB_INDEX_NONE

Ценить

Методы

captureVisibleTab()

Параметры

Возврат

connect()

Параметры

Возврат

create()

Параметры

Возврат

detectLanguage()

Параметры

Возврат

discard()

Параметры

Возврат

duplicate()

Параметры

Возврат

executeScript()

Параметры

Возврат

get()

Параметры

Возврат

getAllInWindow()

Параметры

Возврат

getCurrent()

Параметры

Возврат

getSelected()

Параметры

Возврат

getZoom()

Параметры

Возврат

getZoomSettings()

Параметры

Возврат

goBack()

Параметры

Возврат

goForward()

chrome.tabs