WebTransport: `closed`-Eigenschaft
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
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 closed schreibgeschützte Eigenschaft der WebTransport-Schnittstelle gibt ein Promise zurück, das aufgelöst wird, wenn der Transport geschlossen wird.
Dieses Promise wird erstellt, wenn das WebTransport-Objekt erstellt wird, und wird aufgelöst, wenn der Transport auf irgendeine Weise geschlossen wird, z.B. durch Aufrufen der close()-Methode, wenn die Verbindung fehlschlägt, oder wenn die Verbindung vom Server geschlossen wird. Das Zugreifen auf oder das Warten auf dieses Promise löst keine Aktion aus; es ermöglicht nur Maßnahmen, wenn der Transport geschlossen wird, ähnlich wie das Zuhören eines Ereignisses.
Wert
Ein Promise, das zu einem Objekt aufgelöst wird, das die folgenden Eigenschaften enthält:
closeCode-
Eine Zahl, die den Fehlercode für den Fehler darstellt.
reason-
Ein String, der den Grund für das Schließen des
WebTransportangibt.
Oder, im Fall eines unerwarteten Abschlusses, wie z.B. eines Netzwerkausfalls, wird das Promise mit einem Fehler abgelehnt.
Beispiele
const url = "https://example.com:4999/wt";
async function initTransport(url) {
// Initialize transport connection
const transport = new WebTransport(url);
// The connection can be used once ready fulfills
await transport.ready;
// …
}
// …
async function closeTransport(transport) {
// Respond to connection closing
try {
await transport.closed;
console.log(`The HTTP/3 connection to ${url} closed gracefully.`);
} catch (error) {
console.error(`The HTTP/3 connection to ${url} closed due to ${error}.`);
}
}
Spezifikationen
| Specification |
|---|
| WebTransport # dom-webtransport-closed |
Browser-Kompatibilität
Loading…