Enum rquickjs_core::Error

#[non_exhaustive]
pub enum Error {
    Allocation,
    DuplicateExports,
    InvalidString(NulError),
    InvalidCStr(FromBytesWithNulError),
    Utf8(Utf8Error),
    Io(IoError),
    Exception,
    FromJs {
        from: &'static str,
        to: &'static str,
        message: Option<StdString>,
    },
    IntoJs {
        from: &'static str,
        to: &'static str,
        message: Option<StdString>,
    },
    NumArgs {
        expected: Range<usize>,
        given: usize,
    },
    Resolving {
        base: StdString,
        name: StdString,
        message: Option<StdString>,
    },
    Loading {
        name: StdString,
        message: Option<StdString>,
    },
    UnrelatedRuntime,
    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.

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(IoError)

An io error

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

Fields

from: &'static str

to: &'static str

message: Option<StdString>

Error converting from javascript to a rust type.

IntoJs

Fields

from: &'static str

to: &'static str

message: Option<StdString>

Error converting to javascript from a rust type.

NumArgs

Fields

expected: Range<usize>

given: usize

Error matching of function arguments

Resolving

Fields

base: StdString

name: StdString

message: Option<StdString>

Error when resolving js module

Loading

Fields

name: StdString

message: Option<StdString>

Error when loading js module

UnrelatedRuntime

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

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) -> Selfwhere StdString: From<B> + From<N>,

Create resolving error

pub fn new_resolving_message<B, N, M>(base: B, name: N, msg: M) -> Selfwhere StdString: 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) -> Selfwhere StdString: From<N>,

Create loading error

pub fn new_loading_message<N, M>(name: N, msg: M) -> Selfwhere StdString: 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) -> Self

Create from JS conversion error

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

Create from JS conversion error with message

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

Create into JS conversion error

pub fn new_into_js_message<M>( from: &'static str, to: &'static str, msg: M ) -> Selfwhere StdString: 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 new_num_args(expected: Range<usize>, given: usize) -> Self

Create function args mismatch 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

Formats the value using the given formatter.

impl Display for Error

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

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, demand: &mut Demand<'a>)

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

Provides type based access to context intended for error reports.

impl From<Error> for Error

fn from(error: IoError) -> Self

Converts to this type from the input type.

impl From<FromBytesWithNulError> for Error

fn from(error: FromBytesWithNulError) -> Self

Converts to this type from the input type.

impl From<FromUtf8Error> for Error

fn from(error: FromUtf8Error) -> Self

Converts to this type from the input type.

impl From<NulError> for Error

fn from(error: NulError) -> Self

Converts to this type from the input type.

impl From<Utf8Error> for Error

fn from(error: Utf8Error) -> Self

Converts to this type from the input type.