Skip to content

Latest commit

 

History

History
80 lines (65 loc) · 5.05 KB

index.md

File metadata and controls

80 lines (65 loc) · 5.05 KB
Raw
title slug
extension
Mozilla/Add-ons/WebExtensions/API/extension

{{AddonSidebar}}

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

型

  • {{WebExtAPIRef("extension.ViewType")}}
    • : 拡張機能ビューの型

プロパティ

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

関数

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

イベント

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

ブラウザーの互換性

{{Compat("webextensions.api.extension")}}

{{WebExtExamples("h2")}}

メモ: この API は Chromium の chrome.extension API に基づいています。また、このドキュメントは extension.jsonにおける Chromium のコードに基づいています。Microsoft Edge での実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。