Enum DomError 

pub enum DomError {
    NodeNotFound(NodeId),
    NoRootElement,
    InvalidSelector(String),
    InvalidClassToken(String),
    UnknownAtom(AtomId),
    TreeInvariant(&'static str),
}

Why a DOM operation could not be performed.

Deliberately narrow. Most of blitz-script’s operations are tolerant where the DOM specification is strict: reading an attribute off a node that is not an element yields “absent” rather than throwing, and removing a child that is not a child removes it from wherever it actually is. Those behaviours are copied rather than corrected, so they do not appear here. What does appear is every case where blitz-script itself raises, plus the tree invariants it asserts with expect.

Variants

NodeNotFound(NodeId)

The node id does not name a node in this document.

Only produced where blitz-script would panic rather than return.

NoRootElement

The document has no root element, so there is nothing to answer with.

InvalidSelector(String)

A selector string could not be parsed.

blitz-script swallows this: querySelector returns null, matches returns false, closest searches an empty match set. This crate surfaces it instead, and the reparenting diff for each of those call sites is a trailing .ok().flatten() or .unwrap_or_default().

InvalidClassToken(String)

A classList token was empty or contained ASCII whitespace.

blitz-script raises a SyntaxError here; this is the same case.

UnknownAtom(AtomId)

An AtomId was resolved against an interner that did not mint it.

TreeInvariant(&'static str)

A structural invariant the operation relies on did not hold.

compare_document_position is the only current source: it walks to a common ancestor and then indexes into it, and blitz-script asserts both steps with expect. A facade must not take the process down over a malformed tree, so the assertion becomes this.

Trait Implementations

impl Clone for DomError

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 DomError

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

Formats the value using the given formatter.

impl Display for DomError

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

Formats the value using the given formatter.

impl Eq for DomError

impl Error for DomError

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 PartialEq for DomError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DomError