Back to Content

WebTransportError

files/en-us/web/api/webtransporterror/index.md

latest1.9 KB
Original Source

{{APIRef("WebTransport API")}}{{SecureContext_Header}} {{AvailableInWorkers}}

The WebTransportError interface of the {{domxref("WebTransport API", "WebTransport API", "", "nocode")}} represents an error related to the API, which can arise from server errors, network connection problems, or client-initiated abort operations (for example, arising from a {{domxref("WritableStream.abort()")}} call).

{{InheritanceDiagram}}

Constructor

  • {{domxref("WebTransportError.WebTransportError", "WebTransportError()")}}
    • : Creates a new WebTransportError object instance.

Instance properties

Inherits properties from its parent, {{DOMxRef("DOMException")}}.

  • {{domxref("WebTransportError.source", "source")}} {{ReadOnlyInline}}
    • : Returns an enumerated value indicating the source of the error—can be either stream or session.
  • {{domxref("WebTransportError.streamErrorCode", "streamErrorCode")}} {{ReadOnlyInline}}
    • : Returns a number in the range 0-255 indicating the application protocol error code for this error, or null if one is not available.

Examples

js
const url = "not-a-url";

async function initTransport(url) {
  try {
    // Initialize transport connection
    const transport = new WebTransport(url);

    // The connection can be used once ready fulfills
    await transport.ready;

    // …
  } catch (error) {
    const msg = `Transport initialization failed.
                 Reason: ${error.message}.
                 Source: ${error.source}.
                 Error code: ${error.streamErrorCode}.`;
    console.log(msg);
  }
}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also