Enum rquickjs_core::Error

#[non_exhaustive]
pub enum Error {
    Allocation,
    InvalidString(NulError),
    Utf8(Utf8Error),
    Io(IoError),
    Exception {
        message: StdString,
        file: StdString,
        line: i32,
        stack: StdString,
    },
    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.

InvalidString(NulError)

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

Fields

message: StdString

file: StdString

line: i32

stack: StdString

An exception raised by quickjs itself.

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

Create resolving error

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

Create loading error

pub fn new_loading_message<N, M>(name: N, msg: M) -> Self where
    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
) -> Self where
    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
) -> Self where
    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 self, req: &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<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.

impl<'js> FromJs<'js> for Error

fn from_js(ctx: Ctx<'js>, value: Value<'js>) -> Result<Self>

impl<'js> IntoJs<'js> for &Error

fn into_js(self, ctx: Ctx<'js>) -> Result<Value<'js>>