DieNavigator-MethodeunregisterProtocolHandler() entfernt einen Protokoll-Handler für ein bestimmtes URL-Schema.

Diese Methode ist das Gegenstück zuregisterProtocolHandler().

Syntax

unregisterProtocolHandler(scheme, url)

Parameter

scheme

Ein String, der daszugelassene Schema im Protokoll-Handler enthält, das abgemeldet wird.Zum Beispiel können Sie den Handler für SMS-Textnachrichten-Links abmelden, indem Sie das Schema"sms" übergeben.

url

Ein String, der die URL des Handlers enthält.Diese URL sollte mit derjenigen übereinstimmen, die zur Registrierung des Handlers verwendet wurde (z.B. muss sie%s enthalten).

Rückgabewert

Keiner (undefined).

Ausnahmen

SecurityErrorDOMException

Der Benutzeragent hat die Abmeldung blockiert.Dies könnte passieren, wenn:

• Das Schema (Protokoll) ungültig ist, wie ein Schema, das der Browser selbst verwaltet (https:,about:, etc.)
• DerUrsprung der Handler-URL stimmt nicht mit dem Ursprung der Seite überein, die diese API aufruft.
• Der Browser erfordert, dass diese Funktion aus einem sicheren Kontext aufgerufen wird.
• Der Browser erfordert, dass die URL des Handlers über HTTPS erfolgt.

SyntaxErrorDOMException

Der%s-Platzhalter fehlt in der Handler-URL.

Zugelassene Schemas

Aus Sicherheitsgründen beschränktunregisterProtocolHandler(), welche Schemas abgemeldet werden können.

Einbenutzerdefiniertes Schema kann abgemeldet werden, solange:

• Der Name des benutzerdefinierten Schemas mitweb+ beginnt.
• Der Name des benutzerdefinierten Schemas mindestens einen Buchstaben nach demweb+-Präfix enthält.
• Der Name des benutzerdefinierten Schemas nur Kleinbuchstaben aus dem ASCII-Zeichensatz enthält.

Zum Beispielweb+burger, wie imBeispiel unten gezeigt.

Andernfalls muss das Schema eines der folgenden sein:

• bitcoin
• ftp
• ftps
• geo
• im
• irc
• ircs
• magnet
• mailto
• matrix
• mms
• news
• nntp
• openpgp4fpr
• sftp
• sip
• sms
• smsto
• ssh
• tel
• urn
• webcal
• wtai
• xmpp

Beispiele

Wenn Ihre Seiteburgers.example.com ist und Sie einweb+burger:-Schema haben, können Sie den Handler dafür so abmelden:

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

Dieses Skript muss vom gleichen Ursprung wie die Handler-URL ausgeführt werden (also von jeder Seite unterhttps://burgers.example.com), und die Handler-URL musshttp oderhttps sein.

Spezifikationen

Browser-Kompatibilität