Navigator: unregisterProtocolHandler() метод

Метод Navigator unregisterProtocolHandler() удаляет обработчик протокола для заданного URL-адреса схемы.

Этот метод является обратным к registerProtocolHandler().

scheme

Строка, содержащая разрешённую схему в обработчике протокола, который будет аннулирован. Например, вы можете аннулировать обработчик для ссылок сообщений SMS, передав схему "sms".

url

Строка, содержащая URL-адрес обработчика. %s.

None (undefined).

SecurityError DOMException

Пользовательский агент заблокировал отмену регистрации. Это может произойти, если:

• Схема (протокол) недействительна, например, схема, обрабатываемая самим браузером (https:, about:, и т. д.)
• Происхождение URL-адреса обработчика не совпадает с происхождением страницы, вызывающей этот API.
• Браузер требует, чтобы эта функция вызывалась из безопасного контекста.
• Браузер требует, чтобы URL-адрес обработчика был по HTTPS.

SyntaxError DOMException

Отсутствует %s маркер в URL-адресе обработчика.

По соображениям безопасности unregisterProtocolHandler() ограничивает схемы, которые могут быть аннулированы.

Пользовательская схема может быть аннулирована, если:

• Имя пользовательской схемы начинается с web+
• Имя пользовательской схемы содержит как минимум 1 букву после префикса web+
• Имя пользовательской схемы содержит только строчные латинские буквы.

Например, web+burger, как показано в примере ниже.

В противном случае схема должна быть одной из следующих:

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

Если ваш сайт burgers.example.com, и у вас есть схема web+burger: вы можете аннулировать обработчик для неё так:

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

Этот скрипт должен выполняться из того же источника, что и URL-адрес обработчика (поэтому любая страница по https://burgers.example.com), а URL-адрес обработчика должен быть http или https.