Enum WebGl2InitError 

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

Why a WebGl2Backend could not be constructed.

WebGL reports context-creation failure by returning null rather than by throwing, so the three ways it fails, a missing canvas, a non-matching selector, and a browser with no WebGL 2 support, would otherwise all collapse into one opaque None.

Variants

CanvasNotFound(String)

The configured selector matched no element in the document.

CanvasQuery(String)

The selector could not be evaluated, because the document has no body yet or the selector is not valid.

ContextLookup(String)

getContext("webgl2") threw rather than returning None.

ContextUnavailable

getContext("webgl2") returned None, which means the browser has no WebGL 2 support, or the canvas already holds a context of a different kind.

ContextCast

A webgl2 context was returned but was not a WebGL2RenderingContext, which should not be reachable.

Implementations

impl WebGl2InitError

Implements diagnostic helpers on WebGl2InitError.

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").

Trait Implementations

impl Clone for WebGl2InitError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WebGl2InitError

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

Formats the value using the given formatter.

impl Display for WebGl2InitError

Implements the formatted message for WebGl2InitError.

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

Formats the WebGl2InitError via the supplied formatter.

Arguments

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

Returns

• fmt::Result - Result of the formatting operation.

impl Eq for WebGl2InitError

impl Error for WebGl2InitError

Registers both WebGL error types as standard Error values.

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.

impl Hash for WebGl2InitError

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for WebGl2InitError

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for WebGl2InitError