拡張機能に関連するユーティリティ。拡張機能のリソースパッケージのURLを取得したり、拡張機能のページの Window オブジェクトを取得したり、いろいろな設定の値を取得したりします。注意として、このモジュールのメッセージ APIs は非推奨で、 runtime モジュールの同様な API が好まれます。

extension.ViewType
拡張機能ビューの型

プロパティ

extension.lastError
同期型の拡張機能APIがエラーに終わった場合のコールバックの寿命をセットします。エラーが起きなかったら lastError は undefined.になります。
extension.inIncognitoContext
incognito タブ内でコンテンツスクリプトが実行されたり、 incognito プロセス内で拡張機能ページが実行されたら true になります。後者は 'split' incognito_behavior の場合だけです。

関数

extension.getURL()
拡張機能がインストールされたディレクトリーの相対パスを完全修飾 URL に変換する
extension.getViews()
今の拡張機能内で実行されているページの Window オブジェクトを返す
extension.getBackgroundPage()
今の拡張機能内で実行されているバックグラウンドページの Window オブジェクトを返す。拡張機能がバックグラウンドページを持たない場合は null を返す
extension.isAllowedIncognitoAccess()
拡張機能が Incognito-モード (ユーザーが制御する 'Incognito を許可' のチェックボックスで定義される) にアクセスする状態を取得する
extension.isAllowedFileSchemeAccess()
拡張機能が 'file://' スキーム(ユーザーが制御する 'File URLs のアクセスを許可' のチェックボックスで定義される) にアクセスする状態を取得する
extension.setUpdateUrlData()
拡張機能の更新URL内で使われる ap CGI パラメーターをセットする。この値はブラウザーのベンダーストアでホストされる拡張機能では無視される

イベント

extension.onRequest
拡張機能のプロセスかコンテンツスクリプトのいずれかからリクエストが送られた時に発火します
extension.onRequestExternal
その他の拡張機能からリクエストが送られた時に発火します

ブラウザ実装状況

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxOperaAndroid 版 Firefox
ViewTypeChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 45Opera 完全対応 ありFirefox Android 完全対応 48
getBackgroundPageChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45Opera 完全対応 ありFirefox Android 完全対応 48
getExtensionTabs
非推奨非標準
Chrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 未対応 なしFirefox Android 未対応 なし
getURL
非推奨非標準
Chrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45Opera 完全対応 ありFirefox Android 完全対応 48
getViewsChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 45
補足
完全対応 45
補足
補足 If this is called from a page that is part of a private browsing window, such as a sidebar in a private window or a popup opened from a private window, then its return value will not include the extension's background page.
Opera 完全対応 ありFirefox Android 完全対応 48
補足
完全対応 48
補足
補足 If this is called from a page that is part of a private browsing window, such as a sidebar in a private window or a popup opened from a private window, then its return value will not include the extension's background page.
inIncognitoContextChrome 完全対応 ありEdge 完全対応 17Firefox 完全対応 45Opera 完全対応 ありFirefox Android 完全対応 48
isAllowedFileSchemeAccessChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 48Opera 完全対応 ありFirefox Android 完全対応 48
isAllowedIncognitoAccessChrome 完全対応 ありEdge 完全対応 17Firefox 完全対応 48Opera 完全対応 ありFirefox Android 完全対応 48
lastErrorChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 47Opera 完全対応 ありFirefox Android 完全対応 48
onRequest
非推奨非標準
Chrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 完全対応 ありFirefox Android 未対応 なし
onRequestExternal
非推奨非標準
Chrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 完全対応 ありFirefox Android 未対応 なし
sendRequest
非推奨非標準
Chrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 未対応 なしFirefox Android 未対応 なし
setUpdateUrlDataChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 完全対応 ありFirefox Android 未対応 なし

凡例

完全対応  
完全対応
未対応  
未対応
非標準。ブラウザー間の互換性が低い可能性があります。
非標準。ブラウザー間の互換性が低い可能性があります。
非推奨。新しいウェブサイトでは使用しないでください。
非推奨。新しいウェブサイトでは使用しないでください。
実装ノートを参照してください。
実装ノートを参照してください。

Example extensions

謝辞

この API は Chromium の chrome.extension API に基づいています。また、このドキュメントは extension.jsonにおける Chromium のコードに基づいています。

Microsoft Edge での実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。

 

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

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