Observer Notifications

by 2 contributors:

オブザーバの項目

以下はアプリケーションの中で監視 (observe)できる項目 (topics)です。特に断りのない限りオブザーバサービスを使って項目に登録します。

アプリケーションの起動

これらは起動時に監視できる項目です (出現順に並んでいます)。

項目 説明
xpcom-startup xpcom が初期化されたときに呼ばれます。この時点では大半のものは利用できません。この項目をみるにはカテゴリマネージャに登録しなくてはいけません。
app-startup アプリケーションの起動の一般的なイベント。この項目をみるにはカテゴリマネージャに登録しなくてはいけません。
profile-do-change これはプロファイルが選択された後に発火 (fire) します。このイベントが起こるまではユーザ設定やブックマーク、プロファイルフォルダを使うもの全てにアクセスできないでしょう。このイベントはプロファイルの移行後に毎回起こります。
profile-after-change これは profile-do-change の全てのオブサーバが通知された後に発火します。
final-ui-startup アプリケーションの最初のウィンドウが表示される直前にトリガされます。
sessionstore-windows-restored すべての初期ブラウザウィンドウが開かれたことを示すために、セッション復元処理によって送られます。この通知の後にはウィンドウは開かれ、chrome はロードされていますが、ウィンドウ内のタブはまだ復元中である可能性があることに注意してください。


アプリケーションの終了

これらは終了時に監視できる項目です (出現順に並んでいます)。

項目 説明
quit-application-requested 何かがアプリケーションの終了を要求したとき。この時点では終了を取り消すことができます。
quit-application-granted 全てのオブザーバが終了に同意した。
quit-application アプリケーションがまさに終了しようとしている。
profile-change-teardown 終了の一部分で、この時点ではまだプロファイルのデータは利用可能です。
profile-before-change プロファイルが失われる直前に呼ばれます。
xpcom-shutdown これは終了です。この時点では大半のものは利用できないでしょう。

IO 通知

これらの項目は IO サービスを監視して有用な情報を得るために使用します。

項目 説明
offline-requested アプリケーションがオフライン状態に移行できるかどうかを問い合わせるために呼ばれます。オフラインへの移行はキャンセル可能です。

註: あなたのコードがオフラインへの移行をキャンセルする場合には、必ずその旨をユーザに通知してください。

network:offline-about-to-go-offline すべてのネットワーク IO がオフライン状態になる直前に呼ばれます。
network:offline-status-changed オフライン状態が変更したときに呼ばれます。通知のデータ (data)は "offline" か "online" のどちらかで、新しい状態を示します。

HTTP リクエスト

これらは HTTP リクエストの間に監視できる項目です (HTTP リクエストヘッダを設定するサンドボックス内の HTTP 接続を作成する を参照してください)。両方ともサブジェクトパラメータとして nsIHttpChannel が渡されます。

項目 説明
http-on-modify-request http リクエストが作られたときに呼ばれます。通信路 (channel)はヘッダーなどの変更などが可能です。
http-on-examine-response Web サーバからのレスポンスを受け取った後に呼ばれます。通信路上でヘッダーが利用可能です。

これらの項目は Cookie が変更 (追加、変更、クリア、もしくは削除) されたか、Cookie の設定がブラウザによって拒否されたことを示します。詳しくは nsICookieService を参照して下さい。

項目 説明
cookie-changedCookie が変更 (追加、変更、クリア、もしくは削除) された時に呼ばれます。
cookie-rejectedCookie の設定が (ユーザ設定に従って) ブラウザによって拒否された時に呼ばれます。

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

Contributors to this page: Shoot, Taken
最終更新者: Shoot,