chrome.tabs

説明

chrome.tabs API を使用して、ブラウザのタブシステムを操作します。この API を使用すると、ブラウザのタブの作成、変更、並べ替えを行うことができます。

概要

Tabs API は、タブを操作、管理する機能を提供するだけでなく、 タブの言語を確認し、スクリーンショットを撮ります。 タブのコンテンツ スクリプトとやり取りする。

注: Tabs API は Service Worker と拡張機能のページで使用可能ですが、コンテンツ スクリプトでは使用できません。

権限

ほとんどの機能は権限がなくても使用できます。たとえば、新しいタブの作成、 タブの再読み込み、別の URL への移動など

Tabs API を使用する際にデベロッパーが知っておくべき 3 つの権限があります。

「タブ」権限

この権限では、chrome.tabs Namespace にはアクセスできません。代わりに、 4 つのパケットに対して tabs.query() を呼び出す機能を拡張機能に与えます。 tabs.Tab インスタンスの機密プロパティ: url、pendingUrl、title、 favIconUrl。

ホストの権限

ホスト権限により、拡張機能は一致するタブの 4 つの機密情報を読み取り、クエリできる 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"
    ],
    ...
  }

ユースケース

以降のセクションでは、一般的なユースケースについて説明します。

拡張機能のページを新しいタブで開いている

拡張機能の一般的なパターンは、拡張機能の起動時にオンボーディング ページを新しいタブで開くことです。 インストールされています。次の例は、これを行う方法を示しています。

background.js:

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

成功: この例では権限は必要ありません。

現在のタブを取得する

この例では、拡張機能の Service Worker が 現在フォーカスされているウィンドウ（フォーカスされている 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);
      }
    }
  }

成功: Promise コンテキストで catch(error) を使用すると、発生しなかったエラーを chrome.runtime.lastError チェックボックスがオフになっている。

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

選択したタブのコンテンツ スクリプトにメッセージを渡す

この例では、拡張機能の Service Worker が 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.
}

拡張機能の例

Tabs API 拡張機能のデモについては、以下をご覧ください。

• Manifest V2 - Tabs API 拡張機能。
• Manifest V3 - タブ マネージャー。

型

MutedInfo

Chrome 46 以降

タブのミュート状態と、最後に状態が変化した理由。

プロパティ

• extensionId

  文字列（省略可）

  ミュート状態を変更した拡張機能の ID。ミュート状態が最後に変更された理由が拡張機能ではない場合は設定されません。

• ミュート中

  ブール値

  タブがミュートされているか（音声が再生されないか）。タブが再生されていない場合や、現在音声を再生していない場合でも、タブがミュートされる場合があります。これは、「ミュート中」の音声インジケーターが点灯しています。

• reason

  MutedInfoReason オプション

  タブがミュートまたはミュート解除された理由。タブのミュート状態が一度も変更されていない場合は、設定されません。

MutedInfoReason

Chrome 46 以降

ミュート状態の変化を引き起こしたイベント。

列挙型

"user"
ユーザー入力アクションでミュート状態を設定します。

"capture"
タブのキャプチャが開始され、ミュート状態の変更が強制されました。

"extension"
extensionId フィールドで識別される拡張機能で、ミュート状態を設定します。

Tab

プロパティ

• アクティブ

  ブール値

  そのタブがウィンドウ内でアクティブかどうか。必ずしもウィンドウがフォーカスされているとは限りません。

• Audible

  ブール値（省略可）

  Chrome 45 以降

  過去数秒間にタブから音が聞こえていたかどうか（ミュートになっていると、音が聞こえないことがあります）。これは、「スピーカーの音声」が表示されます。

• autoDiscardable

  ブール値

  Chrome 54 以降

  リソースが少ない場合にブラウザが自動的にタブを破棄できるようにするかどうかを指定します。

• 破棄されました

  ブール値

  Chrome 54 以降

  タブが破棄されるかどうか。破棄されたタブとは、コンテンツがメモリからアンロードされたものの、タブバーには表示されている状態です。内容は、次回有効になったときに再読み込みされます。

• favIconUrl

  文字列（省略可）

  タブのファビコンの URL。このプロパティは、拡張機能のマニフェストに "tabs" 権限が含まれている場合にのみ表示されます。タブが読み込まれている場合は空の文字列にすることもできます。

• groupId

  数値

  Chrome 88 以降

  タブが属するグループの ID。

• height

  数値（省略可）

  タブの高さ（ピクセル単位）。

• 強調表示

  ブール値

  タブがハイライト表示されているかどうか。

• id

  数値（省略可）

  タブの ID。タブ ID はブラウザ セッション内で一意です。状況によっては、タブに ID が割り当てられないことがあります。たとえば、sessions API を使用して外部タブをクエリする場合、セッション ID が存在することがあります。アプリと DevTools ウィンドウのタブ ID を chrome.tabs.TAB_ID_NONE に設定することもできます。

• シークレット モード

  ブール値

  タブがシークレット ウィンドウかどうか

• index

  数値

  ウィンドウ内のタブのゼロベースのインデックス。

• lastAccessed

  数値

  Chrome 121 以降

  エポックからのミリ秒単位で表した、最後にタブにアクセスした時刻。

• mutedInfo

  MutedInfo オプション

  Chrome 46 以降

  タブのミュート状態と、最後に状態が変化した理由。

• openerTabId

  数値（省略可）

  このタブを開いたタブの ID（存在する場合）。このプロパティは、オープナー タブがまだ存在する場合にのみ存在します。

• pendingUrl

  文字列（省略可）

  Chrome 79 以降

  commit 前のタブの移動先 URL。このプロパティは、拡張機能のマニフェストに "tabs" 権限が含まれ、ナビゲーションが保留中である場合にのみ存在します。

• 固定中

  ブール値

  タブが固定されているかどうか。

• 選択済み

  ブール値

  <ph type="x-smartling-placeholder"></ph> 非推奨

  tabs.Tab.highlighted を使用してください。

  タブが選択されているかどうか。

• sessionId

  文字列（省略可）

  sessions API から取得したタブを一意に識別するために使用されるセッション ID。

• status

  TabStatus（省略可）

  タブの読み込みステータス。

• title

  文字列（省略可）

  タブのタイトル。このプロパティは、拡張機能のマニフェストに "tabs" 権限が含まれている場合にのみ表示されます。

• URL

  文字列（省略可）

  タブのメインフレームで最後に commit された URL。このプロパティは、拡張機能のマニフェストに "tabs" 権限が含まれている場合のみ存在します。タブがまだ commit されていない場合は空の文字列になります。Tab.pendingUrl もご覧ください。

• 幅

  数値（省略可）

  タブの幅（ピクセル単位）。

• windowId

  数値

  タブを含むウィンドウの ID。

TabStatus

Chrome 44 以降

タブの読み込みステータス。

列挙型

「アンロード」

"loading"

「完了」

WindowType

Chrome 44 以降

ウィンドウのタイプ。

列挙型

「normal」

"popup"

「panel」

「アプリ」

devtools

ZoomSettings

タブのズーム変更がどのように処理され、どのスコープで処理されるかを定義します。

プロパティ

• defaultZoomFactor

  数値（省略可）

  Chrome 43 以降

  tab.getZoomSettings の呼び出しで現在のタブのデフォルトのズームレベルを返すために使用されます。

• モード

  ZoomSettingsMode optional

  ズームの変更の処理方法、つまりページの実際のスケーリングはどのエンティティが担当するかを定義します。デフォルトは automatic です。

• スコープ

  ZoomSettingsScope（省略可）

  ズームの変更をページの原点で維持するか、このタブでのみ有効にするかを定義します。デフォルトは、automatic モードの場合は per-origin、それ以外の場合は per-tab です。

ZoomSettingsMode

Chrome 44 以降

ズームの変更の処理方法、つまりページの実際のスケーリングはどのエンティティが担当するかを定義します。デフォルトは automatic です。

列挙型

"automatic"
ズームの変更はブラウザによって自動的に処理されます。

"manual"
ズーム変更の自動処理をオーバーライドします。onZoomChange イベントは引き続きディスパッチされるため、このイベントをリッスンしてページを手動でスケーリングするのは拡張機能の役割です。このモードでは per-origin ズームがサポートされないため、scope ズーム設定は無視され、per-tab とみなされます。

"disabled"
タブでのすべてのズームを無効にします。タブがデフォルトのズームレベルに戻り、試行したズーム変更はすべて無視されます。

ZoomSettingsScope

Chrome 44 以降

ズームの変更をページの原点で維持するか、このタブでのみ有効にするかを定義します。デフォルトは、automatic モードの場合は per-origin、それ以外の場合は per-tab です。

列挙型

"per-origin"
ズームの変更はズームしたページの原点で維持されます。つまり、同じ原点に移動する他のすべてのタブもズームされます。さらに、per-origin ズームの変更は原点で保存されます。つまり、同じ原点の他のページに移動するときに、すべて同じズーム倍率にズームされます。per-origin スコープは、automatic モードでのみ使用できます。

"タブごと"
ズームの変更はこのタブにのみ反映されます。他のタブでのズームの変更は、このタブのズームには影響しません。また、ナビゲーション時に per-tab のズーム変更がリセットされます。タブを操作すると、常に per-origin のズーム倍率でページが読み込まれます。

プロパティ

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chrome 92 以降

1 秒あたりに captureVisibleTab を呼び出せる最大回数。captureVisibleTab はコストがかかるため、頻繁に呼び出しないようにしてください。

値

2

TAB_ID_NONE

Chrome 46 以降

ブラウザタブがないことを表す ID。

値

-1

TAB_INDEX_NONE

Chrome 123 以降

tab_strip にタブ インデックスが存在しないことを表すインデックス。

値

-1

メソッド

captureVisibleTab()

<ph type="x-smartling-placeholder"></ph> 約束

chrome.tabs.captureVisibleTab(
  windowId?: number,
  options?: ImageDetails,
  callback?: function,
)

指定されたウィンドウで現在アクティブなタブの表示領域をキャプチャします。このメソッドを呼び出すには、拡張機能に &lt;all_urls&gt; 権限または activeTab 権限のいずれかが必要です。この方法では、拡張機能が通常アクセスできるサイトに加えて、chrome:-scheme ページや、その他の拡張機能などの制限されている機密性の高いサイトもキャプチャできます。ページ、データ: URL です。これらの機密性の高いサイトは、activeTab 権限でのみキャプチャできます。拡張機能にファイル アクセス権が付与されている場合にのみ、ファイルの URL を取得できます。

パラメータ

• windowId

  数値（省略可）

  ターゲット ウィンドウ。デフォルトは現在のウィンドウです。

• オプション

  ImageDetails 省略可

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  (dataUrl: string) => void

  • dataUrl

    文字列

    キャプチャしたタブの表示領域の画像をエンコードしたデータ URL。'src' に割り当てることができる。表示する HTML img 要素のプロパティです。

戻り値

• Promise<文字列>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

connect()

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

指定されたタブのコンテンツ スクリプトに接続します。runtime.onConnect イベントは、現在の拡張機能の指定されたタブで実行されている各コンテンツ スクリプトで呼び出されます。詳しくは、コンテンツ スクリプトのメッセージングをご覧ください。

パラメータ

• tabId

  数値

• connectInfo

  オブジェクト（省略可）

  • documentId

    文字列（省略可）

    Chrome 106 以降

    タブのすべてのフレームではなく、documentId で識別される特定のドキュメントにポートを開きます。

  • frameId

    数値（省略可）

    タブ内のすべてのフレームではなく、frameId で識別される特定のフレームにポートを開きます。

  • name

    文字列（省略可）

    接続イベントをリッスンしているコンテンツ スクリプトのために onConnect に渡されます。

戻り値

• runtime.Port

  指定されたタブで実行されているコンテンツ スクリプトとの通信に使用できるポート。タブが閉じられたか、タブが存在しない場合は、ポートの runtime.Port イベントが発生します。

create()

<ph type="x-smartling-placeholder"></ph> 約束

chrome.tabs.create(
  createProperties: object,
  callback?: function,
)

新しいタブを作成します。

パラメータ

• createProperties

  オブジェクト

  • アクティブ

    ブール値（省略可）

    タブをウィンドウ内のアクティブなタブにするかどうかを指定します。ウィンドウがフォーカスされているかどうかには影響しません（windows.update を参照）。デフォルトは true です。

  • index

    数値（省略可）

    ウィンドウ内でのタブの位置。指定された値は、0 からウィンドウ内のタブ数までの範囲に制限されます。

  • openerTabId

    数値（省略可）

    このタブを開いたタブの ID。指定する場合、オープナー タブは新しく作成されたタブと同じウィンドウ内にある必要があります。

  • 固定中

    ブール値（省略可）

    タブを固定するかどうか。デフォルトは false です

  • 選択済み

    ブール値（省略可）

    <ph type="x-smartling-placeholder"></ph> 非推奨

    [有効] を使用してください。

    タブをウィンドウで選択されるタブにするかどうかを指定します。デフォルトは true です

  • URL

    文字列（省略可）

    最初にタブを移動する URL。完全修飾 URL にはスキーム（例:「www.google.com」ではなく「http://www.google.com」とします）。相対 URL は、拡張機能内の現在のページを基準とします。デフォルトは新しいタブページです。

  • windowId

    数値（省略可）

    新しいタブを作成するウィンドウ。デフォルトは現在のウィンドウです。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  (tab: Tab) => void

  • タブ

    Tab

    [作成済み] タブ。

戻り値

• Promise <Tab>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

detectLanguage()

<ph type="x-smartling-placeholder"></ph> 約束

chrome.tabs.detectLanguage(
  tabId?: number,
  callback?: function,
)

タブ内のコンテンツの主要言語を検出します。

パラメータ

• tabId

  数値（省略可）

  デフォルトは、現在のウィンドウのアクティブなタブです。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  (language: string) => void

  • language

    文字列

    ISO 言語コード（en、fr など）。このメソッドでサポートされている言語の一覧については、kLanguageInfoTable をご覧ください。2 列目から 4 列目までが確認され、最初の NULL 以外の値が返されます。ただし、zh-CN が返される簡体字中国語は除きます。不明または未定義の言語の場合は、und が返されます。

戻り値

• Promise<文字列>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

discard()

<ph type="x-smartling-placeholder"></ph> 約束 Chrome 54 以降 をご覧ください。

chrome.tabs.discard(
  tabId?: number,
  callback?: function,
)

メモリからタブを破棄します。破棄されたタブはタブバーに表示され、有効にすると再読み込みされます。

パラメータ

• tabId

  数値（省略可）

  破棄するタブの ID。指定すると、タブがアクティブであるかすでに破棄されていない限り、タブは破棄されます。省略すると、ブラウザは最も重要でないタブを破棄します。破棄可能なタブが存在しない場合は、失敗する可能性があります。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  (tab?: Tab) => void

  • タブ

    タブ （省略可）

    破棄されたタブ（正常に破棄された場合）。それ以外の場合は未定義になります。

戻り値

• Promise <タブ |未定義>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

duplicate()

<ph type="x-smartling-placeholder"></ph> 約束

chrome.tabs.duplicate(
  tabId: number,
  callback?: function,
)

タブを複製します。

パラメータ

• tabId

  数値

  複製するタブの ID。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  (tab?: Tab) => void

  • タブ

    タブ （省略可）

    重複するタブの詳細。"tabs" 権限がリクエストされていない場合、tabs.Tab オブジェクトに url、pendingUrl、title、favIconUrl は含まれません。

戻り値

• Promise <タブ |未定義>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

executeScript()

<ph type="x-smartling-placeholder"></ph> 約束 &amp;leq;MV2 Chrome 91 以降非推奨

chrome.tabs.executeScript(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

Manifest V3 では scripting.executeScript に置き換え。

JavaScript コードをページに挿入します。詳しくは、コンテンツ スクリプトのドキュメントのプログラマティック インジェクション セクションをご覧ください。

パラメータ

• tabId

  数値（省略可）

  スクリプトを実行するタブの ID。デフォルトは、現在のウィンドウのアクティブなタブです。

• 詳細

  InjectDetails

  実行するスクリプトの詳細。コードまたはファイル プロパティのどちらかを設定する必要がありますが、両方を同時に設定することはできません。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  (result?: any[]) => void

  • 件の結果

    any[] 省略可

    挿入されたすべてのフレーム内のスクリプトの結果。

戻り値

• Promise&lt;any[] |未定義>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

get()

<ph type="x-smartling-placeholder"></ph> 約束

chrome.tabs.get(
  tabId: number,
  callback?: function,
)

指定されたタブの詳細を取得します。

パラメータ

• tabId

  数値

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  (tab: Tab) => void

  • タブ

    Tab

戻り値

• Promise <Tab>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

getAllInWindow()

<ph type="x-smartling-placeholder"></ph> 約束 &amp;leq;MV2 非推奨

chrome.tabs.getAllInWindow(
  windowId?: number,
  callback?: function,
)

tabs.query {windowId: windowId} を使用してください。

指定されたウィンドウ内のすべてのタブの詳細を取得します。

パラメータ

• windowId

  数値（省略可）

  デフォルトは現在のウィンドウです。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  (tabs: Tab[]) => void

  • タブ

    タブ[]

戻り値

• Promise<Tab[]>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

getCurrent()

<ph type="x-smartling-placeholder"></ph> 約束

chrome.tabs.getCurrent(
  callback?: function,
)

このスクリプト呼び出しが行われているタブを取得します。タブ以外のコンテキスト（バックグラウンド ページやポップアップ ビューなど）から呼び出された場合は undefined を返します。

パラメータ

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  (tab?: Tab) => void

  • タブ

    タブ （省略可）

戻り値

• Promise <タブ |未定義>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

getSelected()

<ph type="x-smartling-placeholder"></ph> 約束 &amp;leq;MV2 非推奨

chrome.tabs.getSelected(
  windowId?: number,
  callback?: function,
)

tabs.query {active: true} を使用してください。

指定されたウィンドウで選択されているタブを取得します。

パラメータ

• windowId

  数値（省略可）

  デフォルトは現在のウィンドウです。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  (tab: Tab) => void

  • タブ

    Tab

戻り値

• Promise <Tab>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

getZoom()

<ph type="x-smartling-placeholder"></ph> 約束

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

指定されたタブの現在のズーム倍率を取得します。

パラメータ

• tabId

  数値（省略可）

  現在のズーム倍率を取得するタブの ID。デフォルトは、現在のウィンドウのアクティブなタブです。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  (zoomFactor: number) => void

  • zoomFactor

    数値

    タブの現在のズーム倍率。

戻り値

• Promise&lt;number&gt;

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

getZoomSettings()

<ph type="x-smartling-placeholder"></ph> 約束

chrome.tabs.getZoomSettings(
  tabId?: number,
  callback?: function,
)

指定されたタブの現在のズーム設定を取得します。

パラメータ

• tabId

  数値（省略可）

  現在のズーム設定を取得するタブの ID。デフォルトは、現在のウィンドウのアクティブなタブです。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  (zoomSettings: ZoomSettings) => void

  • zoomSettings

    ZoomSettings

    タブの現在のズーム設定。

戻り値

• Promise&lt;ZoomSettings&gt;

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

goBack()

<ph type="x-smartling-placeholder"></ph> 約束 Chrome 72 以降 をご覧ください。

chrome.tabs.goBack(
  tabId?: number,
  callback?: function,
)

前のページがある場合は、前のページに戻ります。

パラメータ

• tabId

  数値（省略可）

  戻るタブの ID。デフォルトは、現在のウィンドウの選択されているタブです。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  () => void

戻り値

• 約束 <void>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

goForward()

<ph type="x-smartling-placeholder"></ph> 約束 Chrome 72 以降 をご覧ください。

chrome.tabs.goForward(
  tabId?: number,
  callback?: function,
)

次のページがある場合は、次のページに進みます。

パラメータ

• tabId

  数値（省略可）

  次に進むタブの ID。デフォルトは、現在のウィンドウの選択されているタブです。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  () => void

戻り値

• 約束 <void>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

group()

<ph type="x-smartling-placeholder"></ph> 約束 Chrome 88 以降 をご覧ください。

chrome.tabs.group(
  options: object,
  callback?: function,
)

指定したグループに 1 つ以上のタブを追加します。グループが指定されていない場合は、指定したタブを新しく作成されたグループに追加します。

パラメータ

• オプション

  オブジェクト

  • createProperties

    オブジェクト（省略可）

    グループを作成するための構成。groupId がすでに指定されている場合は使用できません。

    • windowId

      数値（省略可）

      新しいグループのウィンドウ。デフォルトは現在のウィンドウです。

  • groupId

    数値（省略可）

    タブを追加するグループの ID。指定しない場合、新しいグループが作成されます。

  • tabIds

    数値 |[数値, ...数値 []]

    指定されたグループに追加するタブ ID またはタブ ID のリスト。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  (groupId: number) => void

  • groupId

    数値

    タブが追加されたグループの ID。

戻り値

• Promise&lt;number&gt;

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

highlight()

<ph type="x-smartling-placeholder"></ph> 約束

chrome.tabs.highlight(
  highlightInfo: object,
  callback?: function,
)

指定したタブをハイライト表示し、グループの最初のタブにフォーカスします。指定したタブが現在アクティブであれば、何も起こらないように見えます。

パラメータ

• highlightInfo

  オブジェクト

  • タブ

    数値 |数値 []

    ハイライト表示する 1 つ以上のタブ インデックス。

  • windowId

    数値（省略可）

    タブを含むウィンドウ。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  (window: Window) => void

  • 窓

    窓

    タブがハイライト表示されているウィンドウの詳細が含まれます。

戻り値

• Promise&lt;windows.Window&gt;

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

insertCSS()

<ph type="x-smartling-placeholder"></ph> 約束 &amp;leq;MV2 Chrome 91 以降非推奨

chrome.tabs.insertCSS(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

Manifest V3 では scripting.insertCSS に置き換え。

CSS をページに挿入します。このメソッドで挿入されたスタイルは、scripting.removeCSS で削除できます。詳しくは、コンテンツ スクリプトのドキュメントのプログラマティック インジェクション セクションをご覧ください。

パラメータ

• tabId

  数値（省略可）

  CSS を挿入するタブの ID です。デフォルトは、現在のウィンドウのアクティブなタブです。

• 詳細

  InjectDetails

  挿入する CSS テキストの詳細。コードまたはファイル プロパティのどちらかを設定する必要がありますが、両方を同時に設定することはできません。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  () => void

戻り値

• 約束 <void>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

move()

<ph type="x-smartling-placeholder"></ph> 約束

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

1 つ以上のタブをウィンドウ内の新しい位置、または新しいウィンドウに移動します。タブは、通常 (window.type === "normal") ウィンドウ間でのみ移動できます。

パラメータ

• tabIds

  数値 |数値 []

  移動するタブ ID またはタブ ID のリスト。

• moveProperties

  オブジェクト

  • index

    数値

    ウィンドウの移動先の位置。-1 を使用して、タブをウィンドウの最後に配置します。

  • windowId

    数値（省略可）

    デフォルトでは、タブが現在表示されているウィンドウになります。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  (tabs: Tab | Tab[]) => void

  • タブ

    タブ |タブ[]

    移動されたタブの詳細。

戻り値

• Promise <タブ |タブ[]>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

query()

<ph type="x-smartling-placeholder"></ph> 約束

chrome.tabs.query(
  queryInfo: object,
  callback?: function,
)

指定されたプロパティを持つすべてのタブを取得します。プロパティが指定されていない場合は、すべてのタブを取得します。

パラメータ

• queryInfo

  オブジェクト

  • アクティブ

    ブール値（省略可）

    ウィンドウでタブがアクティブかどうか。

  • Audible

    ブール値（省略可）

    Chrome 45 以降

    タブの音声が聞こえるかどうか。

  • autoDiscardable

    ブール値（省略可）

    Chrome 54 以降

    リソースが少ない場合にブラウザが自動的にタブを破棄できるようにするかどうかを指定します。

  • currentWindow

    ブール値（省略可）

    タブが現在のウィンドウにあるかどうか。

  • 破棄されました

    ブール値（省略可）

    Chrome 54 以降

    タブが破棄されるかどうか。破棄されたタブとは、コンテンツがメモリからアンロードされたものの、タブバーには表示されている状態です。内容は、次回有効になったときに再読み込みされます。

  • groupId

    数値（省略可）

    Chrome 88 以降

    タブが属するグループの ID。グループ化されていないタブの場合は tabGroups.TAB_GROUP_ID_NONE。

  • 強調表示

    ブール値（省略可）

    タブをハイライト表示するかどうか。

  • index

    数値（省略可）

    ウィンドウ内のタブの位置。

  • lastFocusedWindow

    ブール値（省略可）

    最後にフォーカスしたウィンドウにタブがあるかどうか。

  • ミュート中

    ブール値（省略可）

    Chrome 45 以降

    タブをミュートするかどうか。

  • 固定中

    ブール値（省略可）

    タブが固定されているかどうか。

  • status

    TabStatus（省略可）

    タブの読み込みステータス。

  • title

    文字列（省略可）

    ページのタイトルとパターンを照合します。拡張機能に "tabs" 権限がない場合、このプロパティは無視されます。

  • URL

    string |文字列 [] 省略可

    タブを 1 つ以上の URL パターンと照合します。フラグメント識別子が一致しません。拡張機能に "tabs" 権限がない場合、このプロパティは無視されます。

  • windowId

    数値（省略可）

    親ウィンドウの ID、または現在のウィンドウの場合は windows.WINDOW_ID_CURRENT。

  • windowType

    WindowType（省略可）

    タブが表示されるウィンドウのタイプ。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  (result: Tab[]) => void

  • 件の結果

    タブ[]

戻り値

• Promise<Tab[]>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

reload()

<ph type="x-smartling-placeholder"></ph> 約束

chrome.tabs.reload(
  tabId?: number,
  reloadProperties?: object,
  callback?: function,
)

タブを再読み込みする。

パラメータ

• tabId

  数値（省略可）

  再読み込みするタブの ID。デフォルトは、現在のウィンドウの選択されているタブです。

• reloadProperties

  オブジェクト（省略可）

  • bypassCache

    ブール値（省略可）

    ローカル キャッシュをバイパスするかどうか。デフォルトは false です。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  () => void

戻り値

• 約束 <void>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

remove()

<ph type="x-smartling-placeholder"></ph> 約束

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

1 つ以上のタブを閉じます。

パラメータ

• tabIds

  数値 |数値 []

  閉じるタブ ID またはタブ ID のリスト。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  () => void

戻り値

• 約束 <void>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

removeCSS()

<ph type="x-smartling-placeholder"></ph> 約束 Chrome 87 以降 &amp;leq;MV2 Chrome 91 以降非推奨

chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
)

Manifest V3 では scripting.removeCSS に置き換え。

以前に scripting.insertCSS の呼び出しによって挿入されたページ CSS から削除します。

パラメータ

• tabId

  数値（省略可）

  CSS を削除するタブの ID です。デフォルトは、現在のウィンドウのアクティブなタブです。

• 詳細

  DeleteInjectionDetails

  削除する CSS テキストの詳細です。コードまたはファイル プロパティのどちらかを設定する必要がありますが、両方を同時に設定することはできません。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  () => void

戻り値

• 約束 <void>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

sendMessage()

<ph type="x-smartling-placeholder"></ph> 約束

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

指定されたタブのコンテンツ スクリプトに単一のメッセージを送信します。応答が返されたときに実行されるコールバックも指定できます（オプション）。runtime.onMessage イベントは、現在の拡張機能の指定されたタブで実行されている各コンテンツ スクリプトで呼び出されます。

パラメータ

• tabId

  数値

• メッセージ

  任意

  送信するメッセージ。このメッセージは JSON 可能なオブジェクトである必要があります。

• オプション

  オブジェクト（省略可）

  • documentId

    文字列（省略可）

    Chrome 106 以降

    タブのすべてのフレームではなく、documentId で識別される特定のドキュメントにメッセージを送信します。

  • frameId

    数値（省略可）

    タブ内のすべてのフレームではなく、frameId で識別される特定のフレームにメッセージを送信します。

• callback

  関数（省略可）

  Chrome 99 以降

  callback パラメータは次のようになります。

  (response: any) => void

  • レスポンス

    任意

    メッセージのハンドラによって送信された JSON レスポンス オブジェクト。指定されたタブへの接続中にエラーが発生した場合、コールバックは引数なしで呼び出され、runtime.lastError がエラー メッセージに設定されます。

戻り値

• <任意> を約束する

  Chrome 99 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

sendRequest()

<ph type="x-smartling-placeholder"></ph> 約束 &amp;leq;MV2 非推奨

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

runtime.sendMessage を使用してください。

指定されたタブのコンテンツ スクリプトに単一のリクエストを送信し、レスポンスが返されたときに実行するコールバックを任意で含めます。extension.onRequest イベントは、現在の拡張機能の指定されたタブで実行されている各コンテンツ スクリプトで呼び出されます。

パラメータ

• tabId

  数値

• request

  任意

• callback

  関数（省略可）

  Chrome 99 以降

  callback パラメータは次のようになります。

  (response: any) => void

  • レスポンス

    任意

    リクエストのハンドラによって送信された JSON レスポンス オブジェクト。指定されたタブへの接続中にエラーが発生した場合、コールバックは引数なしで呼び出され、runtime.lastError がエラー メッセージに設定されます。

戻り値

• <任意> を約束する

  Chrome 99 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

setZoom()

<ph type="x-smartling-placeholder"></ph> 約束

chrome.tabs.setZoom(
  tabId?: number,
  zoomFactor: number,
  callback?: function,
)

指定したタブをズームします。

パラメータ

• tabId

  数値（省略可）

  ズームするタブの ID。デフォルトは、現在のウィンドウのアクティブなタブです。

• zoomFactor

  数値

  新しいズーム倍率です。値 0 は、タブの現在のデフォルトのズーム倍率に設定されます。値が 0 より大きい場合は、タブのズーム倍率を指定します（デフォルトではありません）。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  () => void

戻り値

• 約束 <void>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

setZoomSettings()

<ph type="x-smartling-placeholder"></ph> 約束

chrome.tabs.setZoomSettings(
  tabId?: number,
  zoomSettings: ZoomSettings,
  callback?: function,
)

指定したタブにズーム設定を設定し、ズーム変更の処理方法を定義します。これらの設定は、タブを操作するとデフォルトにリセットされます。

パラメータ

• tabId

  数値（省略可）

  ズーム設定を変更するタブの ID。デフォルトは、現在のウィンドウのアクティブなタブです。

• zoomSettings

  ZoomSettings

  ズームの変更の処理方法と対象のスコープを定義します。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  () => void

戻り値

• 約束 <void>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

ungroup()

<ph type="x-smartling-placeholder"></ph> 約束 Chrome 88 以降 をご覧ください。

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

1 つ以上のタブをそれぞれのグループから削除します。空のグループは削除されます。

パラメータ

• tabIds

  数値 |[数値, ...数値 []]

  それぞれのグループから削除するタブ ID またはタブ ID のリスト。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  () => void

戻り値

• 約束 <void>

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

update()

<ph type="x-smartling-placeholder"></ph> 約束

chrome.tabs.update(
  tabId?: number,
  updateProperties: object,
  callback?: function,
)

タブのプロパティを変更します。updateProperties で指定されていないプロパティは変更されません。

パラメータ

• tabId

  数値（省略可）

  デフォルトは、現在のウィンドウで選択されているタブです。

• updateProperties

  オブジェクト

  • アクティブ

    ブール値（省略可）

    タブを有効にするかどうか。ウィンドウがフォーカスされているかどうかには影響しません（windows.update を参照）。

  • autoDiscardable

    ブール値（省略可）

    Chrome 54 以降

    リソースが少ない場合にブラウザがタブを自動的に破棄するかどうか。

  • 強調表示

    ブール値（省略可）

    現在の選択範囲からタブを追加または削除します。

  • ミュート中

    ブール値（省略可）

    Chrome 45 以降

    タブをミュートするかどうか。

  • openerTabId

    数値（省略可）

    このタブを開いたタブの ID。指定する場合、オープナー タブはこのタブと同じウィンドウ内にある必要があります。

  • 固定中

    ブール値（省略可）

    タブを固定するかどうか。

  • 選択済み

    ブール値（省略可）

    <ph type="x-smartling-placeholder"></ph> 非推奨

    ハイライト表示されたものを使用してください。

    タブを選択するかどうか。

  • URL

    文字列（省略可）

    タブの移動先となる URL。JavaScript URL はサポートされていません。代わりに scripting.executeScript を使用してください。

• callback

  関数（省略可）

  callback パラメータは次のようになります。

  (tab?: Tab) => void

  • タブ

    タブ （省略可）

    更新されたタブの詳細。"tabs" 権限がリクエストされていない場合、tabs.Tab オブジェクトに url、pendingUrl、title、favIconUrl は含まれません。

戻り値

• Promise <タブ |未定義>

  Chrome 88 以降

  Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

イベント

onActivated

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

ウィンドウ内のアクティブなタブが変更されたときに呼び出されます。このイベントが発生した時点でタブの URL が設定されていなくても、onUpdated イベントをリッスンして URL が設定されたときに通知を受け取ることができます。

パラメータ

• callback

  関数

  callback パラメータは次のようになります。

  (activeInfo: object) => void

  • activeInfo

    オブジェクト

    • tabId

      数値

      アクティブになったタブの ID。

    • windowId

      数値

      アクティブなタブ内で変更されたウィンドウの ID。

onActiveChanged

<ph type="x-smartling-placeholder"></ph> &amp;leq;MV2 非推奨

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

tabs.onActivated を使用してください。

ウィンドウで選択されているタブが変更されたときに起動します。このイベントの発生時にタブの URL が設定されていなくても、tabs.onUpdated イベントをリッスンして、URL が設定されたときに通知を受け取ることができます。

パラメータ

• callback

  関数

  callback パラメータは次のようになります。

  (tabId: number, selectInfo: object) => void

  • tabId

    数値

  • selectInfo

    オブジェクト

    • windowId

      数値

      選択したタブ内で変更されるウィンドウの ID。

onAttached

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

タブがウィンドウにアタッチされたときに呼び出されます。たとえばウィンドウ間で移動したためです

パラメータ

• callback

  関数

  callback パラメータは次のようになります。

  (tabId: number, attachInfo: object) => void

  • tabId

    数値

  • attachInfo

    オブジェクト

    • newPosition

      数値

    • newWindowId

      数値

onCreated

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

タブの作成時に呼び出されます。このイベント発生時にタブの URL とタブグループのメンバーシップが設定されない場合もありますが、onUpdated イベントをリッスンして、URL が設定されたときやタブがタブグループに追加されたときに通知を受け取ることができます。

パラメータ

• callback

  関数

  callback パラメータは次のようになります。

  (tab: Tab) => void

  • タブ

    Tab

onDetached

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

タブがウィンドウからデタッチされたときに呼び出されます。たとえばウィンドウ間で移動したためです

パラメータ

• callback

  関数

  callback パラメータは次のようになります。

  (tabId: number, detachInfo: object) => void

  • tabId

    数値

  • detachInfo

    オブジェクト

    • oldPosition

      数値

    • oldWindowId

      数値

onHighlightChanged

<ph type="x-smartling-placeholder"></ph> &amp;leq;MV2 非推奨

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

tabs.onHighlighted を使用してください。

ウィンドウ内でハイライト表示または選択されたタブが変更されたときに呼び出されます。

パラメータ

• callback

  関数

  callback パラメータは次のようになります。

  (selectInfo: object) => void

  • selectInfo

    オブジェクト

    • tabIds

      数値 []

      ウィンドウ内でハイライト表示されているすべてのタブ。

    • windowId

      数値

      タブが変更されたウィンドウ。

onHighlighted

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

ウィンドウ内でハイライト表示または選択されたタブが変更されたときに呼び出されます。

パラメータ

• callback

  関数

  callback パラメータは次のようになります。

  (highlightInfo: object) => void

  • highlightInfo

    オブジェクト

    • tabIds

      数値 []

      ウィンドウ内でハイライト表示されているすべてのタブ。

    • windowId

      数値

      タブが変更されたウィンドウ。

onMoved

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

ウィンドウ内でタブが移動されたときに呼び出されます。移動イベントが 1 つだけ発生し、ユーザーが直接移動したタブを表します。手動で移動したタブに応じて移動する必要がある他のタブでは、移動イベントは発生しません。このイベントは、ウィンドウ間でタブを移動しても呼び出されません。詳しくは、tabs.onDetached をご覧ください。

パラメータ

• callback

  関数

  callback パラメータは次のようになります。

  (tabId: number, moveInfo: object) => void

  • tabId

    数値

  • moveInfo

    オブジェクト

    • fromIndex

      数値

    • toIndex

      数値

    • windowId

      数値

onRemoved

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

タブが閉じられたときに呼び出されます。

パラメータ

• callback

  関数

  callback パラメータは次のようになります。

  (tabId: number, removeInfo: object) => void

  • tabId

    数値

  • removeInfo

    オブジェクト

    • isWindowClosing

      ブール値

      親ウィンドウが閉じられたためにタブが閉じられた場合は true。

    • windowId

      数値

      タブが閉じられたウィンドウ。

onReplaced

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

事前レンダリングまたはインスタントによりタブが別のタブに置き換えられたときに呼び出されます。

パラメータ

• callback

  関数

  callback パラメータは次のようになります。

  (addedTabId: number, removedTabId: number) => void

  • addedTabId

    数値

  • removedTabId

    数値

onSelectionChanged

<ph type="x-smartling-placeholder"></ph> &amp;leq;MV2 非推奨

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

tabs.onActivated を使用してください。

ウィンドウで選択されているタブが変更されたときに起動します。

パラメータ

• callback

  関数

  callback パラメータは次のようになります。

  (tabId: number, selectInfo: object) => void

  • tabId

    数値

  • selectInfo

    オブジェクト

    • windowId

      数値

      選択したタブ内で変更されるウィンドウの ID。

onUpdated

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

タブが更新されたときに呼び出されます。

パラメータ

• callback

  関数

  callback パラメータは次のようになります。

  (tabId: number, changeInfo: object, tab: Tab) => void

  • tabId

    数値

  • changeInfo

    オブジェクト

    • Audible

      ブール値（省略可）

      Chrome 45 以降

      タブの新しい聴取可能な状態。

    • autoDiscardable

      ブール値（省略可）

      Chrome 54 以降

      タブの新しい自動破棄可能な状態。

    • 破棄されました

      ブール値（省略可）

      Chrome 54 以降

      タブの新しい破棄状態。

    • favIconUrl

      文字列（省略可）

      タブの新しいファビコンの URL。

    • groupId

      数値（省略可）

      Chrome 88 以降

      タブの新しいグループ。

    • mutedInfo

      MutedInfo オプション

      Chrome 46 以降

      タブの新しいミュート状態と変更理由。

    • 固定中

      ブール値（省略可）

      タブの新しい固定状態。

    • status

      TabStatus（省略可）

      タブの読み込みステータス。

    • title

      文字列（省略可）

      Chrome 48 以降

      タブの新しいタイトル。

    • URL

      文字列（省略可）

      タブの URL（変更されている場合）。

  • タブ

    Tab

onZoomChange

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

タブがズームされたときに呼び出されます。

パラメータ

• callback

  関数

  callback パラメータは次のようになります。

  (ZoomChangeInfo: object) => void

  • ZoomChangeInfo

    オブジェクト

    • newZoomFactor

      数値

    • oldZoomFactor

      数値

    • tabId

      数値

    • zoomSettings

      ZoomSettings