最も強力な低レベルモジュールは、「Chrome 権限」を使用して実行されます。この権限を使用すると、ホストシステムへの無制限のアクセス権を付与する、悪名高いComponents オブジェクトにアクセスできます。モジュールは、Components オブジェクトから、ブラウザが提供するほとんどの機能を実行できます。このような権限を取得するには、モジュールで以下のような文を使用して取得の意図を宣言する必要があります。
var {Cc, Ci} = require("chrome");require("chrome") によって返されるオブジェクトを、Mozilla JS 環境の「分割代入（destructuring assignment）」機能を使用して展開すると、通常のComponents.*
エイリアスが提供されます。
Cc
Components.classes のエイリアス
Ci
Components.interfaces のエイリアス
Cu
Components.utils のエイリアス
Cr
Components.results のエイリアス
Cm
Components.manager のエイリアス
components
Components 自体のエイリアス（小文字であることに注意してください）。このエイリアスから、通常あまり使用されないComponents.stack やComponents.isSuccessCode などのプロパティにアクセスできます。
注：require("chrome") 文は、Chrome 機能やComponents API にアクセスする唯一の方法です。Components オブジェクトには、モジュールから絶対アクセスしないでください。SDK ツールがモジュールコードの中にComponents への直接参照を発見した場合、警告が発生します。
Chrome 権限は、絶対に必要な場合以外、モジュールで使用しないでください。Chrome 権限を使用したモジュールは、セキュリティ面を慎重に確認する必要があります。このようなモジュールのバグは、ほとんどがセキュリティ上の危険要因となります。
マニフェストは、生成後の XPI に含まれているリストで、require() アクセスを要求したモジュールとアクセスを要求されたモジュールが記載されます。このリストにはまた、chrome アクセスを要求したモジュールも記録されています。このリストの生成にあたっては、含まれているすべてのモジュールでrequire(XYZ) 文がスキャンされ、それらが参照する "XYZ" 文字列が記録されます。
マニフェストの実装が完了すると、ランタイムローダーが機能して、マニフェストにリストされていないモジュールに対するrequire() が実際に禁止されます。同様に、Chrome 権限を要求したことがマニフェストに記録されているモジュール以外、Chrome 権限を取得できないようになります。これにより、実行コードに適用されているのと同じ権限の制約が確実に実現されるので、アドオンのレビュー効率が向上します（この作業が完了していない場合、モジュールがこの権限の制約を回避できることがあります）。
マニフェストは、完全な Javascript パーサではなく、単純な regexp ベースのスキャナによって作成されます。そのため、開発者は単一の静的文字列を持つ単純なrequire 文を 1 行に 1 つだけ記述するという規則に従う必要があります。スキャナがrequire の指定を検出できなかった場合、その指定はマニフェストに追加されず、実装後にランタイムコードで例外が発生することになります。
例えば、以下のコードはいずれもマニフェストスキャナによって検出されないので、require() 呼び出しによって指定したモジュールをインポートできず、実行時に例外が発生します。
// all of these will fail!var xhr = require("x"+"hr");var modname = "xpcom";var xpcom = require(modname);var one = require("one"); var two = require("two");つまり開発者は、モジュールで使用する権限を（セキュリティレビューアに対して）宣言する、それらの権限をモジュールのローカルのネームスペースにマッピングする方法を制御するという 2 つの目的で require() を使用します。したがってその点で、require() 文を明確にし、解析しやすくする必要があります。将来的には、権限のより詳細な表現を可能にするため、マニフェストのフォーマットから宣言部分を別ファイルに移すことが考えられています。
「cfx xpi」や「cfx run」など、マニフェストを作成するコマンドを実行すると、含まれているすべてのモジュールで、Cc/Ci エイリアス（または拡張形式Components.classes）がスキャンされます。拡張形式が検出された場合、または require("chrome") の記述と対応していない「Cc」などを検出した場合、警告が発生します。これらの警告は、開発者が適切なパターンを使用できるようにするためのガイドです。モジュール開発者は、警告に注意し、警告が発生しなくなるようにコードを訂正してください。
Privacy Policy | Legal Notices | Report Trademark Abuse | View Mobile Site
Except where otherwisenoted, content on this site is licensed under the
Creative Commons Attribution Share-Alike License v3.0 or any later version.