Struct rquickjs_core::Exception

#[repr(transparent)]
pub struct Exception<'js>(_);

A javascript instance of Error

Will turn into a error when converted to javascript but won’t autmatically be thrown.

Implementations

impl<'js> Exception<'js>

pub fn into_object(self) -> Object<'js>

Turns the exception into the underlying object.

pub fn as_object(&self) -> &Object<'js>

Returns a reference to the underlying object.

pub fn into_value(self) -> Value<'js>

Turns the exception into a generic javascript value.

pub fn from_object(obj: Object<'js>) -> Option<Self>

Creates an exception from an object if it is an instance of error.

pub fn from_message(ctx: Ctx<'js>, message: &str) -> Result<Self>

Creates a new exception with a give message.

pub fn from_message_location( ctx: Ctx<'js>, message: &str, file: &str, line: i32 ) -> Result<Self>

Creates a new exception with a give message, file name and line number.

pub fn message(&self) -> Option<String>

Returns the message of the error.

Same as retrieving error.message in javascript.

pub fn file(&self) -> Option<String>

Returns the file name from with the error originated..

Same as retrieving error.fileName in javascript.

pub fn line(&self) -> Option<i32>

Returns the file line from with the error originated..

Same as retrieving error.lineNumber in javascript.

pub fn stack(&self) -> Option<String>

Returns the error stack.

Same as retrieving error.stack in javascript.

pub fn throw_message(ctx: Ctx<'js>, message: &str) -> Error

Throws a new generic error.

Equivalent to:

let (Ok(e) | Err(e)) = Exception::from_message(ctx, message).map(|x| x.throw());
e

pub fn throw_message_location( ctx: Ctx<'js>, message: &str, file: &str, line: i32 ) -> Error

Throws a new generic error with a file name and line number.

pub fn throw_syntax(ctx: Ctx<'js>, message: &str) -> Error

Throws a new syntax error.

pub fn throw_type(ctx: Ctx<'js>, message: &str) -> Error

Throws a new type error.

pub fn throw_reference(ctx: Ctx<'js>, message: &str) -> Error

Throws a new reference error.

pub fn throw_range(ctx: Ctx<'js>, message: &str) -> Error

Throws a new range error.

pub fn throw_internal(ctx: Ctx<'js>, message: &str) -> Error

Throws a new internal error.

pub fn throw(self) -> Error

Sets the exception as the current error an returns Error::Exception

Methods from Deref<Target = Object<'js>>

pub fn prop<K, V, P>(&self, key: K, prop: V) -> Result<()>where K: IntoAtom<'js>, V: AsProperty<'js, P>,

Available on crate feature properties only.

Define a property of an object

// Define readonly property without value
obj.prop("no_val", ()).unwrap();
// Define readonly property with value
obj.prop("ro_str", "Some const text").unwrap();
// Define readonly property with value and make it to be writable
obj.prop("ro_str2", Property::from("Some const text").writable()).unwrap();
// Define readonly property using getter and make it to be enumerable
obj.prop("ro_str_get", Accessor::from(|| "Some readable text").enumerable()).unwrap();
// Define readonly property using getter and setter
obj.prop("ro_str_get_set",
    Accessor::from(|| "Some text")
        .set(|new_val: String| { /* do something */ })
).unwrap();

pub fn init_def<T>(&self) -> Result<()>where T: ObjectDef,

Initialize an object using ObjectDef

pub fn get<K: IntoAtom<'js>, V: FromJs<'js>>(&self, k: K) -> Result<V>

Get a new value

pub fn contains_key<K>(&self, k: K) -> Result<bool>where K: IntoAtom<'js>,

check wether the object contains a certain key.

pub fn set<K: IntoAtom<'js>, V: IntoJs<'js>>( &self, key: K, value: V ) -> Result<()>

Set a member of an object to a certain value

pub fn remove<K: IntoAtom<'js>>(&self, key: K) -> Result<()>

Remove a member of an object

pub fn is_empty(&self) -> bool

Check the object for empty

pub fn len(&self) -> usize

Get the number of properties

pub fn keys<K: FromAtom<'js>>(&self) -> ObjectKeysIter<'js, K>

Get own string enumerable property names of an object

pub fn own_keys<K: FromAtom<'js>>( &self, filter: Filter ) -> ObjectKeysIter<'js, K>

Get own property names of an object

pub fn props<K: FromAtom<'js>, V: FromJs<'js>>(&self) -> ObjectIter<'js, K, V>

Get own string enumerable properties of an object

pub fn own_props<K: FromAtom<'js>, V: FromJs<'js>>( &self, filter: Filter ) -> ObjectIter<'js, K, V>

Get own properties of an object

pub fn values<K: FromAtom<'js>>(&self) -> ObjectValuesIter<'js, K>

Get own string enumerable property values of an object

pub fn own_values<K: FromAtom<'js>>( &self, filter: Filter ) -> ObjectValuesIter<'js, K>

Get own property values of an object

pub fn get_prototype(&self) -> Result<Object<'js>>

Get an object prototype

pub fn set_prototype(&self, proto: &Object<'js>) -> Result<()>

Set an object prototype

pub fn is_instance_of(&self, class: impl AsRef<Value<'js>>) -> bool

Check instance of object

pub fn as_value(&self) -> &Value<'js>

Reference to value

pub fn instance_of<C: ClassDef>(&self) -> bool

Available on crate feature classes only.

Check the object for instance of

Methods from Deref<Target = Value<'js>>

pub fn as_bool(&self) -> Option<bool>

Try get bool from value

pub fn as_int(&self) -> Option<i32>

Try get int from value

pub fn as_float(&self) -> Option<f64>

Try get float from value

pub fn as_number(&self) -> Option<f64>

Try get any number from value

pub fn is_null(&self) -> bool

pub fn is_undefined(&self) -> bool

pub fn is_bool(&self) -> bool

Check if the value is a bool

pub fn is_int(&self) -> bool

Check if the value is an int

pub fn is_float(&self) -> bool

Check if the value is a float

pub fn is_number(&self) -> bool

Check if the value is an any number

pub fn is_string(&self) -> bool

Check if the value is a string

pub fn is_symbol(&self) -> bool

Check if the value is a symbol

pub fn is_object(&self) -> bool

Check if the value is an object

pub fn is_module(&self) -> bool

Check if the value is a module

pub fn is_array(&self) -> bool

Check if the value is an array

pub fn is_function(&self) -> bool

Check if the value is a function

pub fn is_error(&self) -> bool

Check if the value is an error

pub fn as_value(&self) -> &Self

Reference as value

pub fn get<T: FromJs<'js>>(&self) -> Result<T>

Convert from value to specified type

pub fn type_of(&self) -> Type

Get the type of value

pub fn type_name(&self) -> &'static str

Get the name of type

pub unsafe fn ref_string(&self) -> &String<'js>

Interprete as

Safety

You should be sure that the value already is of required type before to do it.

pub fn as_string(&self) -> Option<&String<'js>>

Try reinterprete as

pub unsafe fn ref_symbol(&self) -> &Symbol<'js>

Interprete as

Safety

You should be sure that the value already is of required type before to do it.

pub fn as_symbol(&self) -> Option<&Symbol<'js>>

Try reinterprete as

pub unsafe fn ref_object(&self) -> &Object<'js>

Interprete as

Safety

You should be sure that the value already is of required type before to do it.

pub fn as_object(&self) -> Option<&Object<'js>>

Try reinterprete as

pub unsafe fn ref_array(&self) -> &Array<'js>

Interprete as

Safety

You should be sure that the value already is of required type before to do it.

pub fn as_array(&self) -> Option<&Array<'js>>

Try reinterprete as

pub unsafe fn ref_function(&self) -> &Function<'js>

Interprete as

Safety

You should be sure that the value already is of required type before to do it.

pub fn as_function(&self) -> Option<&Function<'js>>

Try reinterprete as

pub unsafe fn ref_big_int(&self) -> &BigInt<'js>

Interprete as

Safety

You should be sure that the value already is of required type before to do it.

pub fn as_big_int(&self) -> Option<&BigInt<'js>>

Try reinterprete as

Trait Implementations

impl Debug for Exception<'_>

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

Formats the value using the given formatter.

impl<'js> Deref for Exception<'js>

type Target = Object<'js>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Display for Exception<'_>

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

Formats the value using the given formatter.

impl<'js> FromJs<'js> for Exception<'js>

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

impl<'js> IntoJs<'js> for Exception<'js>

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