Navigator: unregisterProtocolHandler() メソッド

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

Navigator の unregisterProtocolHandler() は、指定された URL スキームからプロトコルハンドラーを取り除きます。

このメソッドは registerProtocolHandler() の逆です。

構文

unregisterProtocolHandler(scheme, url)

scheme

このプロトコルハンドラーで登録解除する許可されているスキームの入った文字列。例えば、"sms" スキームを渡すと、SMSテキストメッセージリンク用のハンドラーを登録解除できます。

url

ハンドラーの URL の入った文字列。 この URL は、ハンドラーを登録する際に使用したものと一致させる必要があります（例えば、%s を記載する必要があります）。

なし (undefined)。

SecurityError DOMException

ユーザーエージェントが登録解除をブロックしました。以下の可能性があります。

SyntaxError DOMException

ハンドラー URL から %s プレースホルダーが欠落しています。

セキュリティ上の理由から、unregisterProtocolHandler() は登録解除できるスキームを制限しています。

カスタムスキームは、以下の条件を満たす限り、登録解除が可能です。

例えば、web+burger（下記の例にあるとおり）。

それ以外の場合、スキームは以下のいずれかである必要があります。

例えば、自分のウェブサイトが burgers.example.com で、web+burger: スキームがある場合、そのハンドラーを次のようにして登録解除することができます。

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

このスクリプトは、ハンドラー URL と同じオリジン（例えば、https://burgers.example.com の何れかのページ）から実行する必要があり、ハンドラーの URL は http または https でなければなりません。

Specification

Enable JavaScript to view this browser compatibility table.

Was this page helpful to you?

Yes No

This page was last modified on 2025年3月1日 by MDN contributors.