WebTransport: ready-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 schreibgeschützte ready-Eigenschaft des WebTransport-Interfaces gibt ein Promise zurück, das aufgelöst wird, wenn der Transport bereit zur Verwendung ist.

Dieses Promise wird erstellt, wenn das WebTransport-Objekt erstellt wird, und wird aufgelöst, wenn eine Verbindung hergestellt wird. Das Zugreifen oder Warten auf dieses Promise löst keine Aktion aus; es erlaubt lediglich, Aktionen zu ergreifen, wenn der Transport bereit ist, ähnlich wie beim Lauschen auf ein Ereignis.

Wert

Ein Promise, das mit undefined aufgelöst wird.

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-ready

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch