registerProtocolHandler

Navigator の registerProtocolHandler() メソッドは、ウェブサイトが自身を特定のプロトコルのハンドラー候補として登録できるようにします。

ブラウザーはハンドラーのドメインとプロトコルが現在のサイトと一致する場合のみ、プロトコルハンドラーの登録を許可します。加えて、 registerProtocolHandler() の使用にあたり、安全なコンテキスト (つまり HTTPS で読み込まれたページ) を要求するようになりつつあります。

ブラウザーによってはこれらの制限を上書きする方法が提供されるかもしれません。

構文

navigator.registerProtocolHandler(protocol, url, title);

パラメーター

protocol

サイトが処理したいプロトコルを指定する文字列。例えば SMS のテキストメッセージリンクを処理するには、 "sms" スキームを処理するように登録します。

url

ハンドラーの URL を指定する文字列。この文字列には、処理される文書の URL をエスケープした者で置き換えられるプレイスホルダー "%s" を含めてください。この URL は本物の URL のほか、電話番号、メールアドレスなどにすることもできます。

メモ: ハンドラー URL のスキームは "http" もしくは "https" でなければなりません。ブラウザーによってはセキュリティのため、 HTTPS の URL であることを求めるため、そうするべきです。

title

ユーザーが読むことができるプロトコルハンドラーのタイトル。これは必要に応じて、インターフェイスオブジェクトでユーザーに表示されます。

例外

SecurityError

ユーザーエージェントがプロトコルハンドラーの登録をブロックした。無効なスキームが指定された場合、例えば "http" が指定されているが、明白なセキュリティ上の問題があり登録させられない、またはブラウザーがこの関数を安全なコンテキストから呼び出すことを要求している、あるいはハンドラーの URL が HTTPS であることを要求している、といった場合にこの例外が発生します。

SyntaxError

指定されたハンドラー URL に "%s" が含まれていない。

許可されたスキーム

セキュリティ上の理由により registerProtocolHandler() は登録可能なスキームに制限を設けています。カスタムスキームの場合、 "web+" で始まり、 "web+" を含め5文字以上であり、小文字の ASCII 文字のみで構成されているものが登録可能です。例えば下の 例 で使われている "web+burger" などが挙げられます。

もしくは、以下のホワイトリストに挙げられているスキームでなければなりません:

例

ウェブアプリケーションが http://burgers.example.com にある場合、次のようにして "web+burger" リンクを処理するプロトコルハンドラーを登録できます:

navigator.registerProtocolHandler("web+burger",
                                  "https://burgers.example.com/?burger=%s",
                                  "Burger handler");

このようにハンドラーを登録することで、web+burger:// リンクを通してユーザーをあなたのウェブアプリケーションに移動させることができます。リンクに含まれていたハンバーガーの情報はURLへ埋め込む形で渡されます。このスクリプトは同じドメイン (ここでは burgers.example.com 内のページ) で実行されなければならず、第 2 引数のスキームは http と https のどちらか (ここでは https) でなければならないことを思い出してください。

あなたのコードがプロトコルハンドラーを登録しようとしていることはユーザーに通知され、ユーザーは登録を許可するかどうか決めることができます。以下のスクリーンショットは google.co.uk での例です。

仕様書

ブラウザーの対応

関連情報

• ウェブベースのプロトコルハンドラー
• Navigator.registerContentHandler()
• Mozilla Webdev の RegisterProtocolHandler Enhancing the Federated Web
• Web Application APIs - Custom scheme and content handlers