拡張機能に関連するユーティリティ。拡張機能のリソースパッケージの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
その他の拡張機能からリクエストが送られた時に発火します

ブラウザ実装状況

ChromeEdgeFirefoxFirefox for AndroidOpera
ViewType 有り 無し4548 有り
getBackgroundPage 有り 有り4548 有り
getExtensionTabs 有り 無し 無し 無し 無し
getURL 有り 有り4548 有り
getViews 有り 有り45 *48 * 有り
inIncognitoContext 有り 無し4548 有り
isAllowedFileSchemeAccess 有り 無し4848 有り
isAllowedIncognitoAccess 有り 無し4848 有り
lastError 有り 無し4748 有り
onRequest 有り 無し 無し 無し 有り
onRequestExternal 有り 無し 無し 無し 有り
sendRequest 有り 無し 無し 無し 無し
setUpdateUrlData 有り 無し 無し 無し 有り

Example extensions

謝辞

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

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

 

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

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