tabs.create()

新しいタブを作ります。

これはPromiseを返す非同期関数です.

構文

js
var creating = browser.tabs.create(
  createProperties, // object
);

パラメーター

createProperties

新しいタブについてのプロパティを与えるオブジェクト。これらのプロパティについて詳しくはtabs.Tabを参照してください。

active省略可

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

cookieStoreId 省略可

文字列 。タブの 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省略可

整数値。新しくタブを作るウィンドウを指定します。デフォルトは現在開いているウィンドウ。

返り値

新しく作ったタブに関するtabs.Tabオブジェクトを引数に持つPromiseが返されます。URL が特権 URL であるなどして、タブが作られなかった場合は promise はエラーメッセージとともに reject されます。

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
create
active
cookieStoreId
discarded
index
muted
openInReaderMode
openerTabId
pinned
selected
title
url
windowId

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

"https://example.org" を新しいタブで開きます

js
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

メモ: この API は Chromium のchrome.tabs API に基づいています。 このドキュメントは tabs.json における Chromium のコードに基づいています。Microsoft Edge での実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。