この翻訳は不完全です。英語から この記事を翻訳 してください。

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

この関数は Promise を返す非同期関数です。

構文

var querying = browser.tabs.query(
  queryInfo             // object
)

パラメータ

queryInfo
object. query() 関数はここで指定されたプロパティにマッチするタブだけを取得します。 このプロパティについての詳細は tabs.Tab を参照してください。
activeOptional
boolean. 各ウインドウの中でアクティブかどうか。
audibleOptional
boolean. 音が鳴らされているか。
autoDiscardableOptional
boolean. リソースが少なくなったときにブラウザーによって自動的にdiscardできるか。
cookieStoreId Optional
string. Use this to return only tabs whose cookie store ID is cookieStoreId. This option is only available if the extension has the "cookies" permission.
currentWindowOptional
boolean. カレントウインドウの中のタブか。
discardedOptional
boolean. タブがdiscardされているか。 discardされたタブはコンテンツがメモリからアンロードされているが、タブの一覧には表示されたままになります。コンテンツはタブが次にアクティブになったときにリロードされます。
highlightedOptional
boolean. ハイライトされているか。
indexOptional
integer. ウィンドウの中での位置。
mutedOptional
boolean. ミュートにされているか。
lastFocusedWindowOptional
boolean. 最後にフォーカスされたウインドウのタブか。
openerTabIdOptional
integer. そのタブを開いたタブのID。
pinnedOptional
boolean. ピン留めされているか。
statusOptional
tabs.TabStatus. ロードが完了しているか。
titleOptional
string. ページのタイトル。
urlOptional
string or array of string. Match tabs against one or more match patterns. Note that fragment identifiers are not matched.
windowIdOptional
integer. そのウインドウのID。カレントウインドウの場合は、 windows.WINDOW_ID_CURRENT
windowTypeOptional
tabs.WindowType. そのタブの属するウインドウの種類。

戻り値

A Promise that will be fulfilled with an array of tabs.Tab objects, containing infomation about each matching tab. If any error occurs, the promise will be rejected with an error message.

ブラウザ実装状況

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxOperaAndroid 版 Firefox
基本対応Chrome 完全対応 ありEdge 完全対応 14
補足
完全対応 14
補足
補足 The panel, app, devtools and popup values for WindowType are not supported.
Firefox 完全対応 45Opera 完全対応 ありFirefox Android 完全対応 54
queryInfo.activeChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45Opera 完全対応 ありFirefox Android 完全対応 54
queryInfo.audibleChrome 完全対応 45Edge 未対応 なしFirefox 完全対応 45Opera 完全対応 32Firefox Android 完全対応 54
queryInfo.autoDiscardableChrome 完全対応 54Edge 未対応 なしFirefox 未対応 なしOpera 完全対応 41Firefox Android 未対応 なし
queryInfo.cookieStoreIdChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 52Opera 未対応 なしFirefox Android 未対応 なし
queryInfo.currentWindowChrome 完全対応 19Edge 完全対応 14Firefox 完全対応 45Opera 完全対応 15Firefox Android 完全対応 54
queryInfo.discardedChrome 完全対応 54Edge 未対応 なしFirefox 完全対応 57Opera 完全対応 41Firefox Android 完全対応 57
queryInfo.highlightedChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 60
補足
完全対応 60
補足
補足 Treated as an alias for queryInfo.active.
Opera 完全対応 ありFirefox Android 完全対応 61
補足
完全対応 61
補足
補足 Treated as an alias for queryInfo.active.
未対応 60 — 61
補足
補足 Treated as an alias for queryInfo.active except when an extension has a popup open. In this situation, queryInfo.highlighted will return the popup, while queryInfo.active will return the tab that was selected before the popup opened.
queryInfo.indexChrome 完全対応 18Edge 完全対応 14Firefox 完全対応 45Opera 完全対応 15Firefox Android 完全対応 54
queryInfo.lastFocusedWindowChrome 完全対応 19Edge 完全対応 14Firefox 完全対応 45Opera 完全対応 15Firefox Android 完全対応 54
queryInfo.mutedChrome 完全対応 45Edge 未対応 なしFirefox 完全対応 45Opera 完全対応 32Firefox Android 完全対応 54
queryInfo.openerTabIdChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 57Opera 完全対応 ありFirefox Android 未対応 なし
queryInfo.pinnedChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 45Opera 完全対応 ありFirefox Android 完全対応 54
queryInfo.statusChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45Opera 完全対応 ありFirefox Android 完全対応 54
queryInfo.titleChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45Opera 完全対応 ありFirefox Android 完全対応 54
queryInfo.urlChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45
補足
完全対応 45
補足
補足 Fails if the extension doesn't have the tabs permission.
補足 Before Firefox 56, moz-extension:// URLs were not allowed.
Opera 完全対応 ありFirefox Android 完全対応 54
補足
完全対応 54
補足
補足 Fails if the extension doesn't have the tabs permission.
補足 Before Firefox 56, moz-extension:// URLs were not allowed.
queryInfo.windowIdChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45Opera 完全対応 ありFirefox Android 完全対応 54
queryInfo.windowTypeChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45Opera 完全対応 ありFirefox Android 完全対応 54

凡例

完全対応  
完全対応
未対応  
未対応
実装ノートを参照してください。
実装ノートを参照してください。

全てのタブを取得する例:

function logTabs(tabs) {
  for (let tab of tabs) {
    // tab.url requires the `tabs` permission
    console.log(tab.url);
  }
}

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

var querying = browser.tabs.query({});
querying.then(logTabs, onError);

カレントウインドウの全てのタブを取得する例:

function logTabs(tabs) {
  for (let tab of tabs) {
    // tab.url requires the `tabs` permission
    console.log(tab.url);
  }
}

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

var querying = browser.tabs.query({currentWindow: true});
querying.then(logTabs, onError);

カレントウインドウのアクティブなタブを取得する例:

function logTabs(tabs) {
  for (let tab of tabs) {
    // tab.url requires the `tabs` permission
    console.log(tab.url);
  }
}

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

var querying = browser.tabs.query({currentWindow: true, active: true});
querying.then(logTabs, onError);

"mozilla.org" またはそのサブドメイン下のHTTP/HTTPS URLを開いている全てのタブを取得する例:

function logTabs(tabs) {
  for (let tab of tabs) {
    // tab.url requires the `tabs` permission
    console.log(tab.url);
  }
}

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

var querying = browser.tabs.query({url: "*://*.mozilla.org/*"});
querying.then(logTabs, onError);

moz-extension:// URLを開いている全てのタブを取得する例:

function logTabs(tabs) {
  console.log(tabs);
  for (let tab of tabs) {
    // tab.url requires the `tabs` permission
    console.log(tab.url);
  }
}

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

var querying = browser.tabs.query({url: "moz-extension://*/*"});
querying.then(logTabs, onError);

この拡張機能のURLを開いている全てのタブを取得する例:

function logTabs(tabs) {
  console.log(tabs);
  for (let tab of tabs) {
    // tab.url requires the `tabs` permission
    console.log(tab.url);
  }
}

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

var querying = browser.tabs.query({url: browser.extension.getURL("*")});
querying.then(logTabs, onError);

Example extensions

Acknowledgements

この API は Chromiums の chrome.tabs APIに基づいています。 This documentation is derived from tabs.json in the Chromium code.

Microsoft Edge での実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。

ドキュメントのタグと貢献者

このページの貢献者: hadayan0
最終更新者: hadayan0,