tabs

ブラウザーのタブシステムとやりとりします。

この API を使って開いているタブの一覧を取得したり、いろいろな条件でフィルターしたり、タブを開き、更新し、移動し、再読み込みし、削除できます。この API ではタブのコンテンツに直接アクセスできませんが、JavaScript と CSS をタブに挿入することは、tabs.executeScript()tabs.insertCSS() API を使ってできます。

この API の大半の使用に特別なパーミッションは要りませんが:

あるいは、これらのパーミッションを一時的に取得することもできますが、それは現在アクティブなタブで明示的なユーザーアクションへの応答する場合のみで、"activeTab" パーミッションを要求することで可能です。

タブ操作の多くはタブ ID を使います。タブ ID はブラウザーセッションの単一のタブごとにユニークである保証がされています。ブラウザーが再起動したら、タブ ID を再利用できて、実際そうします。ブラウザーの再起動をまたいでタブ情報を関連づけるには sessions.setTabValue() を使います。

tabs.MutedInfoReason

タブがミュートされている、またはミュートが解除されている理由を示す。

tabs.MutedInfo

タブがミュートされているかを示す真理値と、最後の変更の理由からなるオブジェクト。

tabs.PageSettings

tabs.saveAsPDF()メソッドにおいて、どのように PDF を描画するかを制御する。

tabs.Tab

タブについての情報を含む。

tabs.TabStatus

タブの読み込み状況を示す。

tabs.WindowType

タブを所有しているウィンドウのタイプを示す。

tabs.ZoomSettingsMode

ズームがブラウザーによるものか、拡張機能によるものか、またはズームが許可されていないのかを示す。

tabs.ZoomSettingsScope

あるページのズームが、同一生成元の別ページにも適用されるか、タブ内でのみかを示す。

tabs.ZoomSettings

ズーム設定mode, scopeとデフォルトのズーム要因を示す。

プロパティ

tabs.TAB_ID_NONE

ブラウザーのタブでないタブに対する特殊な ID(Windows の開発ツールなど)。

関数

tabs.captureTab()

あるタブの可視エリアの画像をエンコードしたデータ URI を作成します。

tabs.captureVisibleTab()

特定のウィンドウのアクティブなタブの可視エリアの画像をエンコードしたデータ URI を作成します。

tabs.connect()

あるタブにおいて、バックグラウンドスクリプト(またはその他ポップアップやオプションページのスクリプトなど特権スクリプト)と content scripts 間でのメッセージのやり取り用の経路を確保します。

tabs.create()

新しいタブを作る。

tabs.detectLanguage()

タブのコンテンツの言語を検出する

tabs.discard()

1 つ以上のタブを破棄する。

tabs.duplicate()

タブを複製する。

tabs.executeScript()

ページに JavaScript コードを挿入する。

tabs.get()

特定のタブについて情報を取り出す。

tabs.getAllInWindow() 非推奨;

特定のウィンドウ内のすべてのタブについての情報を取り出す。

tabs.getCurrent()

スクリプトが実行されているタブについての情報を tabs.Tab オブジェクトとして取り出す。

tabs.getSelected() 非推奨;

あるウィンドウにおいてタブが選択されているかを得る。

tabs.getZoom()

あるタブについてズーム要因を得る。

tabs.getZoomSettings()

あるタブについてズーム設定を得る。

tabs.goForward()

可能な場合、次のページへ進む。

tabs.goBack()

可能な場合、前のページへ戻る。

tabs.hide() Experimental

1 つ以上のタブを隠す。

tabs.highlight()

1 つ以上のタブをハイライトする。

tabs.insertCSS()

CSS をページに挿入する。

tabs.move()

2 つ以上のタブを同じ、あるいは異なるウィンドウの任意のポジションへ移動させる。

tabs.moveInSuccession()

タブグループの継承関係を編集する。

tabs.print()

開いているタブのコンテンツを印刷する。

tabs.printPreview()

開いているタブの印刷プレビューを開く。

tabs.query()

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

tabs.reload()

タブをリロードする。キャッシュを回避することもできる。

tabs.remove()

1つ以上のタブを閉じる。

tabs.removeCSS()

以前にtabs.insertCSS()を呼び出して挿入されている CSS を削除する。

tabs.saveAsPDF()

現在のページを PDF として保存する。

tabs.sendMessage()

あるタブのコンテンツスクリプトへ、1つのメッセージを送信する。

tabs.sendRequest() 非推奨;

あるタブのコンテンツスクリプトへ、単一のリクエストを送信する。非推奨: 代わりに tabs.sendMessage() を使用してください。

tabs.setZoom()

あるタブをズームする。

tabs.setZoomSettings()

あるタブについてズーム設定をする。

tabs.show() Experimental

hiddenで隠されたタブを表示する。

tabs.toggleReaderMode()

あるタブについてのリーダーモードへのトグル。

tabs.update()

新しい URL に案内、もしくはタブの他のプロパティを修正する。

イベント

tabs.onActivated

ウィンドウ内でアクティブなタブが変わったときに発火。このイベントが発火した段階ではまだタブの URL はセットされているとは限らない。

tabs.onActiveChanged 非推奨;

ウィンドウの中の選択されたタブが変更されたときに発火。非推奨: 代わりにtabs.onActivatedを利用してください。

tabs.onAttached

タブがウィンドウに引っ付けられたとき、例えばウィンドウ間で移動されたときに発火。

tabs.onCreated

タブが作られたときに発火。このイベントが発火した段階ではまだタブの URL はセットされているとは限らない。

tabs.onDetached

タブがウィンドウから切り離されたときに発火。例えば、ウィンドウのない場所へタブを移動させたときなど。

tabs.onHighlightChanged 非推奨;

ウィンドウ内でハイライトまたは選択されたタブが変更したときに発火。非推奨: 代わりにtabs.onHighlightedを使用してください。

tabs.onHighlighted

ウィンドウ内でハイライトまたは選択されたタブが変更したときに発火。

tabs.onMoved

ウィンドウ内にタブが移動したときに発火する。

tabs.onRemoved

タブが閉じられたときに発火する。

tabs.onReplaced

プリレンダリングによってタブが他のタブに置き換えられたときに発火。

tabs.onSelectionChanged 非推奨;

ウィンドウ内で選択されているタブが変わったときに発火。非推奨: 代わりにtabs.onActivatedを使用してください。

tabs.onUpdated

タブが更新されたときに発火する。

tabs.onZoomChange

タブがズームされたときに発火する。

ブラウザーの互換性

BCD tables only load in the browser

Example extensions

メモ: This API is based on Chromium's chrome.tabs API. This documentation is derived from tabs.json in the Chromium code.Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.