Deze pagina is vertaald door de Cloud Translation API.

Registratie van URL-protocolhandler voor PWA's, Registratie van URL-protocolhandler voor PWA's

Laat geïnstalleerde PWA's koppelingen afhandelen die een specifiek protocol gebruiken voor een meer geïntegreerde ervaring.

Thomas Steiner

Achtergrondinformatie over schema's (ook wel protocollen genoemd)

Een Uniform Resource Identifier (URI) is een compacte reeks tekens die een abstracte of fysieke resource identificeert. Elke URI begint met een schemanaam die verwijst naar een specificatie voor het toewijzen van identifiers binnen dat schema. De URI-syntaxis is als zodanig een gefedereerd en uitbreidbaar naamgevingssysteem waarbij de specificatie van elk schema de syntaxis en semantiek van identifiers die dat schema gebruiken, verder kan beperken. Schema's worden ook wel protocollen genoemd. Hieronder vindt u enkele voorbeelden van schema's.

tel:+1-816-555-1212
mailto:[email protected]
news:comp.infosystems.www.servers.unix
https://web.dev/

De term Uniform Resource Locator (URL) verwijst naar de subset van URI's die, naast het identificeren van een resource, een manier bieden om de resource te lokaliseren door het primaire toegangsmechanisme ervan te beschrijven (bijvoorbeeld de netwerklocatie).

Achtergrondinformatie over de `registerProtocolHandler()` methode

Met de Navigator -methode registerProtocolHandler() (alleen voor beveiligde content) kunnen sites registreren dat ze bepaalde URL-schema's kunnen openen of verwerken. Daarom moeten sites de methode als volgt aanroepen: navigator.registerProtocolHandler(scheme, url) . De twee parameters worden als volgt gedefinieerd:

scheme : Een tekenreeks die het protocol bevat dat de site wil verwerken.
url : Een tekenreeks met de URL van de handler. Deze URL moet %s bevatten als tijdelijke aanduiding die wordt vervangen door de geëscapete URL die moet worden afgehandeld.

Het schema moet een van de veilige schema's zijn (bijvoorbeeld mailto , bitcoin of magnet ) of beginnen met web+ , gevolgd door ten minste een of meer kleine ASCII-letters na het voorvoegsel web+ , bijvoorbeeld web+coffee .

Om dit duidelijker te maken, volgt hier een concreet voorbeeld van de stroom:

De gebruiker bezoekt een site op https://coffeeshop.example.com/ die de volgende aanroep doet: navigator.registerProtocolHandler('web+coffee', 'coffee?type=%s') .
Later, tijdens een bezoek aan https://randomsite.example.com/ , klikt de gebruiker op een link zoals <a href="web+coffee:latte-macchiato">All about latte macchiato</a> .
Hierdoor navigeert de browser naar de volgende URL: https://coffeeshop.example.com/coffee?type=web%2Bcoffee%3A%2F%2Flatte-macchiato . De URL-gedecodeerde zoekreeks luidt dan ?type=web+coffee://latte-macchiato .

Waar het bij protocolverwerking om draait

Het huidige mechanisme voor de registratie van URL-protocolhandlers voor PWA's biedt protocolhandlerregistratie aan als onderdeel van een PWA-installatie via het manifest. Nadat een PWA als protocolhandler is geregistreerd en een gebruiker op een hyperlink met een specifiek schema klikt, zoals mailto , bitcoin of web+music vanuit een browser of een platformspecifieke app, opent de geregistreerde PWA en ontvangt de URL. Het is belangrijk om op te merken dat zowel de voorgestelde manifestgebaseerde registratie als de traditionele registerProtocolHandler() in de praktijk een zeer vergelijkbare rol spelen, terwijl ze toch de mogelijkheid bieden voor aanvullende gebruikerservaringen:

Overeenkomsten zijn onder meer de vereisten ten aanzien van de lijst met regelingen die geregistreerd mogen worden, de naam en het formaat van parameters, enzovoort.
Verschillen in de manifestgebaseerde registratie zijn subtiel, maar kunnen nuttig zijn om de ervaring voor PWA-gebruikers te verbeteren. Zo vereist manifestgebaseerde PWA-registratie mogelijk geen extra actie van de gebruiker, afgezien van de door de gebruiker geïnitieerde installatie van de PWA.

Gebruiksscenario's

In een tekstverwerkingsprogramma (PWA) komt de gebruiker in een document een link naar een presentatie tegen, zoals web+presentations://deck2378465 . Wanneer de gebruiker op de link klikt, opent de presentatie-PWA automatisch in de juiste resolutie en worden de dia's weergegeven.
In een platformspecifieke chat-app ontvangt de gebruiker in een chatbericht een link naar een magnet -URL. Zodra hij op de link klikt, wordt een geïnstalleerde torrent-PWA gestart en begint deze te downloaden.
De gebruiker heeft een muziekstreaming-PWA geïnstalleerd. Wanneer een vriend een link naar een nummer deelt, zoals web+music://songid=1234&time=0:13 , en de gebruiker erop klikt, wordt de muziekstreaming-PWA automatisch gestart in een zelfstandig venster.

Hoe u URL-protocolhandlerregistratie voor PWA's gebruikt

De API voor de registratie van URL-protocolhandlers is nauw gemodelleerd naar navigator.registerProtocolHandler() . Deze keer wordt de informatie declaratief doorgegeven via het webapp-manifest in een nieuwe eigenschap genaamd "protocol_handlers" Deze eigenschap accepteert een array met objecten met de twee vereiste sleutels "protocol" en "url" . Het onderstaande codefragment laat zien hoe u web+tea en web+coffee registreert. De waarden zijn strings die de URL van de handler bevatten met de vereiste tijdelijke aanduiding %s voor de geëscapete URL.

{
  "protocol_handlers": [
    {
      "protocol": "web+tea",
      "url": "/tea?type=%s"
    },
    {
      "protocol": "web+coffee",
      "url": "/coffee?type=%s"
    }
  ]
}

Meerdere apps registreren zich voor hetzelfde protocol

Als meerdere applicaties zich registreren als handlers voor hetzelfde schema, bijvoorbeeld het mailto protocol, toont het besturingssysteem de gebruiker een keuzemenu en laat het de gebruiker kiezen welke van de geregistreerde handlers hij/zij wil gebruiken.

Dezelfde app registreert zich voor meerdere protocollen

Dezelfde app kan zichzelf registreren voor meerdere protocollen, zoals u in het bovenstaande codevoorbeeld kunt zien.

App-updates en handlerregistratie

Handlerregistraties worden gesynchroniseerd met de meest recente manifestversie die door de app wordt geleverd. Er zijn twee gevallen:

Een update die nieuwe handlers toevoegt, activeert de handlerregistratie (los van de app-installatie).
Een update die handlers verwijdert, zorgt ervoor dat de handler wordt verwijderd (los van het verwijderen van de app).

Foutopsporing in protocolhandler in DevTools

Navigeer naar de sectie Protocolhandlers via het deelvenster Toepassing > Manifest . Hier kunt u alle beschikbare protocollen bekijken en testen.