Navigator.mozSetMessageHandler()

この API は Firefox OS 上で ウェブコンテンツまたは高度の権限を持つアプリより利用できます。

概要

アプリケーションはこのメソッドを使って、システムからのメッセージを処理してそれに反応する関数を登録できます。

どのアプリケーションをどのメッセージに対して登録することもできますが、対応する許可設定があるアプリケーションにのみ送信されるメッセージもあります。例えば sms-received メッセージは sms の許可設定があるアプリケーションにのみ送信されます。

システムメッセージは DOM イベントとは反対に、アプリケーションにそのハンドラーがない場合にはキューに残り続けます。アプリケーションにキューに入ったメッセージがあるかは、引数として適切なタイプを渡して navigator.mozHasPendingMessage() を呼ぶことでチェックできます。メッセージハンドラーが設定されると、キューにある全メッセージが非同期にアプリケーションに渡されます。

構文

navigator.mozSetMessageHandler(type, handler);

引数

 
type
type は、登録するハンドラーがどの種類のメッセージ用かを表す文字列です。
handler
システムがメッセージを送信するとハンドラーが呼ばれます。ハンドラーが受け取る引数はメッセージタイプによって決まります。

メッセージタイプ

現在、Firefox OS では以下のメッセージを登録できます。

メッセージ名 ハンドラーのシグニチャー 許可設定
activity f( MozActivityRequestHandler request )  
alarm f( object unknown ) alarms
bluetooth-cancel f( object unknown ) bluetooth
bluetooth-dialer-command f( object unknown ) bluetooth
bluetooth-hfp-status-changed f( object unknown ) bluetooth
bluetooth-opp-transfer-start f( object unknown ) bluetooth
bluetooth-opp-transfer-complete f( object unknown ) bluetooth
bluetooth-opp-receiving-file-confirmation f( object unknown ) bluetooth
bluetooth-opp-update-progress f( object unknown ) bluetooth
bluetooth-pairedstatuschanged f( object unknown ) bluetooth
bluetooth-requestconfirmation f( object unknown ) bluetooth
bluetooth-requestpincode f( object unknown ) bluetooth
bluetooth-requestpasskey f( object unknown ) bluetooth
headset-button f( object unknown )  
icc-stkcommand f( object command ) settings
notification f( object unknown )  
push f( object registration ) push
push-register f (  ) push
sms-received f( SmsMessage sms ) sms
sms-sent f( SmsMessage sms ) sms
telephony-call-ended f( object call ) telephony
telephony-new-call f( ) telephony
ussd-received f( object ussd ) mobileconnection
wappush-received f( object wappush ) wappush

仕様

仕様 状態
Unknown 草案 システムメッセージングのインターフェイスを定義。

ブラウザー互換性

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 未サポート 未サポート 未サポート 未サポート 未サポート
Feature Android Firefox OS Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support 未サポート 1.0 未サポート 未サポート 未サポート 未サポート

関連項目

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

 このページの貢献者: chrisdavidmills, fscholz, KitaitiMakoto
 最終更新者: KitaitiMakoto,