Object
必須 いいえ
  "chrome_url_overrides" : {
    "newtab": "my-new-tab.html"
  }

chrome_url_overrides キーを使って、通常はブラウザー自身が行っているいろいろなページへの文書の置き換えをカスタムすることができます。

構文

chrome_url_overrides キーは次のプロパティを持つオブジェクトです:

名前 説明
bookmark String

ブックマークに出てくるページへの置き換えを提供します。

history String

履歴に出てくるページへの置き換えを提供します。

newtab String

"新規タブ" ページに出てくる文書の置き換えを提供します。これはユーザーが新しいタブを開いてまだ文書を読み込んでない時のページです: 例えば、 Ctrl/Command+T のキーボードショートカットで。

置き換えは HTML ファイルへの URL として与えられます。ファイルは拡張機能に同梱する必要があります: ここにはリモートの URL を指定できません。拡張機能のルートフォルダーから相対的に、次のように指定できます: "path/to/newtab.html".

文書は通常のウェブページと同様に CSS と JavaScript をロードできます。 ページ内で実行する JavaScript はバックグラウンドスクリプトと同じように privileged "browser.*" APIs のアクセスを得ます。

ページに <title> を入れるのは良い習慣で、そうしないとタブのタイトルは "moz-extension://..." の URL になるでしょう。

よくあるユースケースはユーザーに新しいタブページを定義できるようにすることです: これをするには、ユーザーが定義したページにナビゲートするカスタムの新規タブページを提供します。

2 つ以上の拡張機能がいずれもカスタムの新規タブページを定義する場合、インストールや有効化された最後の分の値を使われます。

ブラウザーのホームページを上書きするには、代わりに"chrome_settings_overrides" を使います。

すべてのプロパティはローカライズ可能です

"chrome_url_overrides" : {
  "newtab": "my-new-tab.html"
}

ブラウザ実装状況

ChromeEdgeFirefoxFirefox for AndroidOpera
基本対応 あり1554 なし なし
newtab あり115541 なし なし
bookmarks あり なし なし なし なし
history あり なし なし なし なし

1. If two or more extensions both define a custom new tab page, then in Firefox the first extension to run wins. In Chrome the last extension wins.

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

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