Struct ArrayBuffer 

pub struct ArrayBuffer<'js>(/* private fields */);

Rust representation of a JavaScript object of class ArrayBuffer.

Implementations

impl<'js> ArrayBuffer<'js>

pub fn new<T: Copy>(ctx: Ctx<'js>, src: impl Into<Vec<T>>) -> Result<Self>

Create array buffer from vector data

pub fn new_copy<T: Copy>(ctx: Ctx<'js>, src: impl AsRef<[T]>) -> Result<Self>

Create array buffer from slice

pub fn from_source<S>(ctx: Ctx<'js>, src: S) -> Result<Self>

where S: ArrayBufferSource + ParallelSend + 'static,

Create an ArrayBuffer from a source that owns its backing bytes.

The source is moved into the buffer; JS has exclusive mutable access until the buffer is collected, at which point the source is dropped. Using this with a shared-immutable source (Arc<[u8]>, bytes::Bytes, …) is unsound; use from_source_immutable for those.

pub fn from_source_shared<S>(ctx: Ctx<'js>, src: S) -> Result<Self>

where S: ArrayBufferSource + ParallelSend + 'static,

Create a SharedArrayBuffer from a source that owns its backing bytes.

See from_source for ownership semantics.

pub fn from_source_immutable<S>(ctx: Ctx<'js>, src: S) -> Result<Self>

where S: ArrayBufferSource + ParallelSend + 'static,

Create an ArrayBuffer that JS sees as immutable, backed by a possibly shared-immutable source.

JS writes throw, so it is sound for the caller to keep holding shared-immutable references to the backing store (Arc<[u8]>, bytes::Bytes, …).

pub fn len(&self) -> usize

Get the length of the array buffer in bytes.

pub fn is_empty(&self) -> bool

Returns whether an array buffer is empty.

pub unsafe fn as_bytes(&self) -> Option<&[u8]>

Returns the underlying bytes of the buffer,

Returns None if the array is detached.

Safety

The returned slice aliases memory owned by the JS engine. The caller must not run any JavaScript for as long as the slice is alive, since JS can write into, detach, or (for a resizable buffer) reallocate the backing store, invalidating the slice.

pub unsafe fn as_slice<T: TypedArrayItem>( &self, ) -> StdResult<&[T], AsSliceError>

Returns a slice if the buffer underlying buffer is properly aligned for the type and the buffer is not detached.

Safety

The returned slice aliases memory owned by the JS engine. The caller must not run any JavaScript for as long as the slice is alive, since JS can write into, detach, or (for a resizable buffer) reallocate the backing store, invalidating the slice.

pub fn detach(&mut self)

Detach array buffer

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

Reference to value

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

Convert into value

pub fn from_value(value: Value<'js>) -> Option<Self>

Convert from value

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

Reference as an object

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

Convert into an object

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

Convert from an object

pub fn as_raw(&self) -> Option<NonNull<[u8]>>

Returns a pointer to the underlying bytes of the buffer,

The returned pointer is only guaranteed valid until the next time JavaScript runs: JS can write through it, detach the buffer, or, for a resizable buffer, reallocate the backing store and free this pointer. Treat the pointer as invalidated after any call back into the engine.

Returns None if the buffer was already detached.

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>,

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 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 whether 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) -> Option<Object<'js>>

Get an object prototype

Objects can have no prototype, in this case this function will return null.

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

Set an object prototype

If called with None the function will set the prototype of the object to null.

This function will error if setting the prototype causes a cycle in the prototype chain.

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

Check instance of object

pub fn is_array_buffer(&self) -> bool

Returns whether the object is an instance of ArrayBuffer.

pub unsafe fn ref_array_buffer(&self) -> &ArrayBuffer<'_>

Interpret as ArrayBuffer

Safety

You should be sure that the object actually is the required type.

pub fn as_array_buffer(&self) -> Option<&ArrayBuffer<'_>>

Turn the object into an array buffer if the object is an instance of ArrayBuffer.

pub fn is_typed_array<T: TypedArrayItem>(&self) -> bool

pub unsafe fn ref_typed_array<'a, T: TypedArrayItem>( &'a self, ) -> &'a TypedArray<'js, T>

Interpret as TypedArray

Safety

You should be sure that the object actually is the required type.

pub fn as_typed_array<T: TypedArrayItem>(&self) -> Option<&TypedArray<'js, T>>

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

Reference to value

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

Returns a reference to the underlying super type.

pub fn ctx(&self) -> &Ctx<'js>

Returns the Ctx object associated with this value

pub fn instance_of<C: JsClass<'js>>(&self) -> bool

Returns if the object is of a certain Rust class.

pub fn into_class<C: JsClass<'js>>(&self) -> Result<Class<'js, C>, &Self>

Turn the object into the class if it is an instance of that class.

pub fn as_class<C: JsClass<'js>>(&self) -> Option<&Class<'js, C>>

Turn the object into the class if it is an instance of that class.

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

pub fn ctx(&self) -> &Ctx<'js>

Returns the Ctx object associated with this value.

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

Returns if the value is the JavaScript null value.

pub fn is_undefined(&self) -> bool

Returns if the value is the JavaScript undefined value.

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_constructor(&self) -> bool

Check if the value is a constructor function

pub fn is_promise(&self) -> bool

Check if the value is a promise.

pub fn is_exception(&self) -> bool

Check if the value is an exception

pub fn is_error(&self) -> bool

Check if the value is an error

pub fn is_uncatchable_error(&self) -> bool

Check if the value is an uncatchable error (e.g. from an interrupt handler)

pub fn is_big_int(&self) -> bool

Check if the value is a BigInt

pub fn is_proxy(&self) -> bool

Check if the value is a proxy

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 as_raw(&self) -> JSValue

Returns the raw C library JavaScript value.

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>

Interpret as String

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 reinterpret as String

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

Interpret as Symbol

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 reinterpret as Symbol

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

Interpret as Object

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 reinterpret as Object

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

Interpret as Function

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 reinterpret as Function

pub unsafe fn ref_constructor(&self) -> &Constructor<'js>

Interpret as Constructor

Safety

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

pub fn as_constructor(&self) -> Option<&Constructor<'js>>

Try reinterpret as Constructor

pub unsafe fn ref_promise(&self) -> &Promise<'js>

Interpret as Promise

Safety

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

pub fn as_promise(&self) -> Option<&Promise<'js>>

Try reinterpret as Promise

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

Interpret as Array

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 reinterpret as Array

pub unsafe fn ref_exception(&self) -> &Exception<'js>

Interpret as Exception

Safety

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

pub fn as_exception(&self) -> Option<&Exception<'js>>

Try reinterpret as Exception

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

Interpret as BigInt

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 reinterpret as BigInt

pub unsafe fn ref_proxy(&self) -> &Proxy<'js>

Interpret as Proxy

Safety

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

pub fn as_proxy(&self) -> Option<&Proxy<'js>>

Try reinterpret as Proxy

Trait Implementations

impl<'js> AsRef<Object<'js>> for ArrayBuffer<'js>

fn as_ref(&self) -> &Object<'js>

Converts this type into a shared reference of the (usually inferred) input type.

impl<'js> AsRef<Value<'js>> for ArrayBuffer<'js>

fn as_ref(&self) -> &Value<'js>

Converts this type into a shared reference of the (usually inferred) input type.

impl<'js> Clone for ArrayBuffer<'js>

fn clone(&self) -> ArrayBuffer<'js>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'js> Debug for ArrayBuffer<'js>

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

Formats the value using the given formatter.

impl<'js> Deref for ArrayBuffer<'js>

type Target = Object<'js>

The resulting type after dereferencing.

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

Dereferences the value.

impl<'js> Eq for ArrayBuffer<'js>

impl<'js> FromJs<'js> for ArrayBuffer<'js>

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

impl<'js> Hash for ArrayBuffer<'js>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'js> IntoJs<'js> for ArrayBuffer<'js>

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

impl<'js> JsLifetime<'js> for ArrayBuffer<'js>

type Changed<'to> = ArrayBuffer<'to>

The target which has the same type as a Self but with another lifetime 't

impl<'js> PartialEq for ArrayBuffer<'js>

fn eq(&self, other: &ArrayBuffer<'js>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<'js> StructuralPartialEq for ArrayBuffer<'js>

impl<'js> Trace<'js> for ArrayBuffer<'js>

fn trace<'a>(&self, tracer: Tracer<'a, 'js>)

impl<'js, T> TryFrom<ArrayBuffer<'js>> for TypedArray<'js, T>

where T: TypedArrayItem,

type Error = Error

The type returned in the event of a conversion error.

fn try_from(ab: ArrayBuffer<'js>) -> Result<Self>

Performs the conversion.

impl<'js, T> TryFrom<TypedArray<'js, T>> for ArrayBuffer<'js>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(ta: TypedArray<'js, T>) -> Result<Self>

Performs the conversion.