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 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<'_>) -> FmtResult

Formats the WebGlInitError via the supplied formatter.

Arguments

• &mut Formatter<'_> - The formatter receiving the formatted output.

Returns

• FmtResult - Result of the formatting operation.