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

ブラウザ実装状況

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxOperaAndroid 版 Firefox
基本対応Chrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 54Opera 未対応 なしFirefox Android 未対応 なし
newtabChrome 完全対応 あり
補足
完全対応 あり
補足
補足 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.
Edge 未対応 なしFirefox 完全対応 54
補足
完全対応 54
補足
補足 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.
Opera 未対応 なしFirefox Android 未対応 なし
bookmarksChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 未対応 なしFirefox Android 未対応 なし
historyChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 未対応 なしFirefox Android 未対応 なし

凡例

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

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

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