WebTransport: protocol-Eigenschaft
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die schreibgeschützte protocol-Eigenschaft der WebTransport-Schnittstelle gibt das anwendungsspezifische Protokoll zurück, das vom Server ausgewählt wurde.
Der Wert wird aus den im protocols-Konstruktor-Option angebotenen Protokollen ausgewählt.
Beachten Sie, dass der Wert festgelegt wird, sobald das ready-Versprechen erfüllt ist.
Es ist der leere String, wenn protocols nicht verwendet wurde oder wenn der Server sich entschieden hat, keines der angebotenen Protokolle auszuwählen.
Wert
Ein String.
Standardmäßig "".
Beispiele
Anfordern und Lesen eines ausgehandelten Protokolls
Dieses Beispiel zeigt, wie Sie eine Reihe von Protokollkandidaten anfordern und das vom Server ausgewählte zurücklesen können.
const url = "https://example.com:4999/wt";
async function initTransport(url) {
const transport = new WebTransport(url, {
protocols: ["chat", "file-transfer"],
});
try {
// The connection can be used once ready fulfills
await transport.ready;
console.log(transport.protocol); // e.g. "chat", or "" if none was selected
return transport;
} catch (error) {
// Ready may reject if the offered protocols aren't supported
console.error(`Connection failed: ${error}`);
}
}
initTransport(url);
Spezifikationen
| Spezifikation |
|---|
| WebTransport # dom-webtransport-protocol |