Observer Notifications
出典: MDC
目次 |
[編集] オブザーバの項目
以下はアプリケーションの中で監視 (observe) できる項目 (topics) です。特に断りのない限りオブザーバサービスを使って項目に登録します。
[編集] アプリケーションの起動
これらは起動時に監視できる項目です (出現順に並んでいます)。
| 項目 | 説明 |
|---|---|
| xpcom-startup | xpcom が初期化されたときに呼ばれます。この時点では大半のものは利用できません。この項目をみるにはカテゴリマネージャに登録しなくてはいけません。 |
| app-startup | アプリケーションの起動の一般的なイベント。この項目をみるにはカテゴリマネージャに登録しなくてはいけません。 |
| profile-do-change | これはプロファイルが選択された後に発火 (fire) します。このイベントが起こるまではユーザ設定やブックマーク、プロファイルフォルダを使うもの全てにアクセスできないでしょう。このイベントはプロファイルの移行後に毎回起こります。 |
| profile-after-change | これは profile-do-change の全てのオブサーバが通知された後に発火します。 |
| final-ui-startup | アプリケーションの最初のウィンドウが表示される直前にトリガされます。 |
| sessionstore-windows-restored | Firefox 3 の新機能 すべての初期ブラウザウィンドウが開かれたことを示すために、セッション復元処理によって送られます。この通知の後にはウィンドウは開かれ、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 が変更 (追加、変更、クリア、もしくは削除) されたか、Cookie の設定がブラウザによって拒否されたことを示します。詳しくは nsICookieService を参照して下さい。
| 項目 | 説明 |
|---|---|
| cookie-changed | Cookie が変更 (追加、変更、クリア、もしくは削除) された時に呼ばれます。 |
| cookie-rejected | Cookie の設定が (ユーザ設定に従って) ブラウザによって拒否された時に呼ばれます。 |
カテゴリ: Extensions | XPCOM