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 WebTransport angibt.

Oder, im Fall eines unerwarteten Abschlusses, wie z.B. eines Netzwerkausfalls, wird das Promise mit einem Fehler abgelehnt.

Beispiele

js
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

Siehe auch