Enum WebGlInitError 

pub enum WebGlInitError {
    CanvasNotFound(String),
    CanvasQuery(JsValue),
    ContextUnavailable,
    ContextLookup(JsValue),
    ContextCast,
}

Errors that can occur while initializing a WebGlRenderer.

WebGL context acquisition is synchronous, so the failure modes are far fewer than WebGpuInitError: the canvas must resolve and the browser must hand back a WebGl2RenderingContext. Each variant maps to one specific failure mode; the caller decides how to surface it (typically via Console::error on the example side).

Variants

CanvasNotFound(String)

document.querySelector(canvas_selector) returned None.

The canvas element is not in the DOM yet (or its selector is wrong). Carries the selector string that was queried.

CanvasQuery(JsValue)

document.querySelector(canvas_selector) threw an exception.

ContextUnavailable

canvas.get_context("webgl2") returned None.

The browser does not support WebGL 2, or the canvas is already bound to a different context type.

ContextLookup(JsValue)

canvas.get_context("webgl2") threw an exception.

ContextCast

The object returned by canvas.get_context("webgl2") could not be cast to WebGl2RenderingContext.

Implementations

impl WebGlInitError

Implements WebGlInitError diagnostic helpers.

pub fn code(&self) -> &'static str

Returns a short, machine-readable identifier for this error variant.

Suitable for use as a stable error code in logs or telemetry.

Returns

• &'static str - The error code (e.g. \"WEBGL_CONTEXT_UNAVAILABLE\").

pub fn js_error(&self) -> Option<&JsValue>

Returns the underlying JS error value if this variant carries one.

Returns

• Option<&JsValue> - The captured JS error, if any.

Trait Implementations

impl Clone for WebGlInitError

fn clone(&self) -> WebGlInitError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for WebGlInitError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for WebGlInitError

Implements std::fmt::Display for WebGlInitError.

The formatted message includes the variant code plus a human-readable description; variants carrying a JS error append its rendered form.

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for WebGlInitError

Implements the standard std::error::Error trait for WebGlInitError.

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.