chrome_url_overrides

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"
}

ブラウザ実装状況

BCD tables only load in the browser