tabs.create()
新しいタブを作ります。
これはPromise
を返す非同期関数です.
構文
var creating = browser.tabs.create(
createProperties, // object
);
パラメーター
createProperties
-
新しいタブについてのプロパティを与える
オブジェクト
。これらのプロパティについて詳しくはtabs.Tab
を参照してください。active
省略可-
タブをアクティブにするかどうかを
真理値
で指定します。ウィンドウがフォーカスされているかには影響されません(windows.update
も参照)。デフォルト値はtrue
. -
文字列
。タブの cookie store ID がcookieStoreId
のタブを作るときに使用します。このオプションは拡張機能が"cookies"
permissionを持つときのみ使用できます。 index
省略可-
整数値
。ウィンドウ中のタブの位置を指定します。数値はゼロからウィンドウ内のタブの数までです。 openerTabId
省略可-
整数値
。開くタブの ID を指定します。指定した場合、開く側のタブは新しいタブと同じウィンドウにある必要があります。 openInReaderMode
省略可-
真理値
。もしtrue
であればリーダーモードで開かれます。 デフォルトはfalse
。 pinned
省略可-
真理値
。タブをピン留めするかを指定します。デフォルトはfalse
。 selected
省略可-
真理値
。ウィンドウ内で選択されるかどうかを指定します。デフォルトはtrue
。警告: このプロパティは非推奨です。Firefox ではサポートされません。代わりに
active
を使用してください。 url
省略可-
文字列
。はじめに開く URL を指定します。デフォルトは新しいタブ。 スキームを含む完全な URL を指定します。(例えば 'www.google.com' → 'http://www.google.com'). セキュリティの観点から Firefox では特権 URL は使用できません。- chrome: URL
- javascript: URL
- data: URL
- file: URL(ファイルシステム上のファイルなど。拡張機能内にパッケージ化されたファイルは指定できます。下部を参照してください)
- 特権 about: URL (例、
about:config
,about:addons
,about:debugging
)。ただし非特権 URL (about:blank
) は使用できます。 - 新しいタブ (
about:newtab
) は URL を指定しなければ開かれます。
拡張機能内のファイルをロードするためには manifest.json ファイルからの絶対パスで指定します。(例: '/path/to/my-page.html')。もし'/'を省略すると相対パスとして解釈されます。またブラウザーによっては、また異なった絶対パスとして解釈されます。
windowId
省略可-
整数値
。新しくタブを作るウィンドウを指定します。デフォルトは現在開いているウィンドウ。
返り値
ブラウザーの互換性
BCD tables only load in the browser
例
"https://example.org" を新しいタブで開きます
function onCreated(tab) {
console.log(`Created new tab: ${tab.id}`);
}
function onError(error) {
console.log(`Error: ${error}`);
}
browser.browserAction.onClicked.addListener(function () {
var creating = browser.tabs.create({
url: "https://example.org",
});
creating.then(onCreated, onError);
});
Example extensions
- commands
- contextual-identities
- find-across-tabs
- firefox-code-search
- open-my-page-button
- permissions
- store-collected-images
- tabs-tabs-tabs
メモ:
この API は Chromium のchrome.tabs
API に基づいています。 このドキュメントは tabs.json
における Chromium のコードに基づいています。Microsoft Edge での実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。