Enum rquickjs::Error

#[non_exhaustive]
pub enum Error {
    Allocation,
    DuplicateExports,
    InvalidExport,
    InvalidString(NulError),
    InvalidCStr(FromBytesWithNulError),
    Utf8(Utf8Error),
    Io(Error),
    ClassBorrow(BorrowError),
    FunctionBorrow(BorrowError),
    Exception,
    FromJs {
        from: &'static str,
        to: &'static str,
        message: Option<String>,
    },
    IntoJs {
        from: &'static str,
        to: &'static str,
        message: Option<String>,
    },
    MissingArgs {
        expected: usize,
        given: usize,
    },
    TooManyArgs {
        expected: usize,
        given: usize,
    },
    Resolving {
        base: String,
        name: String,
        message: Option<String>,
    },
    Loading {
        name: String,
        message: Option<String>,
    },
    AsSlice(AsSliceError),
    UnrelatedRuntime,
    WouldBlock,
    Unknown,
}

Error type of the library.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Allocation

Could not allocate memory This is generally only triggered when out of memory.

DuplicateExports

A module defined two exported values with the same name.

InvalidExport

Tried to export a entry which was not previously declared.

InvalidString(NulError)

Found a string with a internal null byte while converting to C string.

InvalidCStr(FromBytesWithNulError)

Found a string with a internal null byte while converting to C string.

Utf8(Utf8Error)

String from rquickjs was not UTF-8

Io(Error)

An io error

ClassBorrow(BorrowError)

An error happened while trying to borrow a Rust class object.

FunctionBorrow(BorrowError)

An error happened while trying to borrow a Rust function.

Exception

An exception raised by QuickJS itself. The actual JavaScript value can be retrieved by calling Ctx::catch.

When returned from a callback the JavaScript will continue to unwind with the current error.

FromJs

Error converting from JavaScript to a Rust type.

Fields

from: &'static str

to: &'static str

message: Option<String>

IntoJs

Error converting to JavaScript from a Rust type.

Fields

from: &'static str

to: &'static str

message: Option<String>

MissingArgs

Error matching of function arguments

Fields

expected: usize

given: usize

TooManyArgs

Fields

expected: usize

given: usize

Resolving

Error when resolving js module

Fields

base: String

name: String

message: Option<String>

Loading

Error when loading js module

Fields

name: String

message: Option<String>

AsSlice(AsSliceError)

UnrelatedRuntime

Error when restoring a Persistent in a runtime other than the original runtime.

WouldBlock

An error returned by a blocked on promise if block on the promise would result in a dead lock.

Unknown

An error from QuickJS from which the specifics are unknown. Should eventually be removed as development progresses.

Implementations

impl Error

pub fn new_resolving<B, N>(base: B, name: N) -> Error

where String: From<B> + From<N>,

Create resolving error

pub fn new_resolving_message<B, N, M>(base: B, name: N, msg: M) -> Error

where String: From<B> + From<N> + From<M>,

Create resolving error with message

pub fn is_resolving(&self) -> bool

Returns whether the error is a resolving error

pub fn new_loading<N>(name: N) -> Error

where String: From<N>,

Create loading error

pub fn new_loading_message<N, M>(name: N, msg: M) -> Error

where String: From<N> + From<M>,

Create loading error

pub fn is_loading(&self) -> bool

Returns whether the error is a loading error

pub fn is_exception(&self) -> bool

Returns whether the error is a QuickJS generated exception.

pub fn new_from_js(from: &'static str, to: &'static str) -> Error

Create from JS conversion error

pub fn new_from_js_message<M>( from: &'static str, to: &'static str, msg: M ) -> Error

where String: From<M>,

Create from JS conversion error with message

pub fn new_into_js(from: &'static str, to: &'static str) -> Error

Create into JS conversion error

pub fn new_into_js_message<M>( from: &'static str, to: &'static str, msg: M ) -> Error

where String: From<M>,

Create into JS conversion error with message

pub fn is_from_js(&self) -> bool

Returns whether the error is a from JS conversion error

pub fn is_from_js_to_js(&self) -> bool

Returns whether the error is a from JS to JS type conversion error

pub fn is_into_js(&self) -> bool

Returns whether the error is an into JS conversion error

pub fn is_num_args(&self) -> bool

Return whether the error is an function args mismatch error

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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

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 From<AsSliceError> for Error

fn from(value: AsSliceError) -> Error

Converts to this type from the input type.

impl From<Error> for Error

fn from(error: Error) -> Error

Converts to this type from the input type.

impl From<FromBytesWithNulError> for Error

fn from(error: FromBytesWithNulError) -> Error

Converts to this type from the input type.

impl From<FromUtf8Error> for Error

fn from(error: FromUtf8Error) -> Error

Converts to this type from the input type.

impl From<NulError> for Error

fn from(error: NulError) -> Error

Converts to this type from the input type.

impl From<Utf8Error> for Error

fn from(error: Utf8Error) -> Error

Converts to this type from the input type.