Struct Array 

#[repr(transparent)]
pub struct Array {
    pub obj: JsValue,
}

Fields

obj: JsValue

Implementations

impl Array

pub fn new() -> Array

Creates a new empty array.

impl Array

pub fn new_with_length(len: u32) -> Array

Creates a new array with the specified length (elements are initialized to undefined).

impl Array

pub fn at(&self, index: i32) -> JsValue

Retrieves the element at the index, counting from the end if negative (returns undefined if the index is out of range).

impl Array

pub fn get(&self, index: u32) -> JsValue

Retrieves the element at the index (returns undefined if the index is out of range).

impl Array

pub fn set(&self, index: u32, value: JsValue)

Sets the element at the index (auto-enlarges the array if the index is out of range).

impl Array

pub fn delete(&self, index: u32)

Deletes the element at the index (does nothing if the index is out of range).

The element at the index is set to undefined.

This does not resize the array, the array will still be the same length.

impl Array

pub fn from(val: &JsValue) -> Array

The Array.from() method creates a new, shallow-copied Array instance from an array-like or iterable object.

impl Array

pub fn copy_within(&self, target: i32, start: i32, end: i32) -> Array

The copyWithin() method shallow copies part of an array to another location in the same array and returns it, without modifying its size.

MDN documentation

impl Array

pub fn concat(&self, array: &Array) -> Array

The concat() method is used to merge two or more arrays. This method does not change the existing arrays, but instead returns a new array.

MDN documentation

impl Array

pub fn every( &self, predicate: &mut dyn FnMut(JsValue, u32, Array) -> bool, ) -> bool

The every() method tests whether all elements in the array pass the test implemented by the provided function.

MDN documentation

impl Array

pub fn fill(&self, value: &JsValue, start: u32, end: u32) -> Array

The fill() method fills all the elements of an array from a start index to an end index with a static value. The end index is not included.

MDN documentation

impl Array

pub fn filter( &self, predicate: &mut dyn FnMut(JsValue, u32, Array) -> bool, ) -> Array

The filter() method creates a new array with all elements that pass the test implemented by the provided function.

MDN documentation

impl Array

pub fn find( &self, predicate: &mut dyn FnMut(JsValue, u32, Array) -> bool, ) -> JsValue

The find() method returns the value of the first element in the array that satisfies the provided testing function. Otherwise undefined is returned.

MDN documentation

impl Array

pub fn find_index( &self, predicate: &mut dyn FnMut(JsValue, u32, Array) -> bool, ) -> i32

The findIndex() method returns the index of the first element in the array that satisfies the provided testing function. Otherwise -1 is returned.

MDN documentation

impl Array

pub fn find_last( &self, predicate: &mut dyn FnMut(JsValue, u32, Array) -> bool, ) -> JsValue

The findLast() method of Array instances iterates the array in reverse order and returns the value of the first element that satisfies the provided testing function. If no elements satisfy the testing function, undefined is returned.

MDN documentation

impl Array

pub fn find_last_index( &self, predicate: &mut dyn FnMut(JsValue, u32, Array) -> bool, ) -> i32

The findLastIndex() method of Array instances iterates the array in reverse order and returns the index of the first element that satisfies the provided testing function. If no elements satisfy the testing function, -1 is returned.

MDN documentation

impl Array

pub fn flat(&self, depth: i32) -> Array

The flat() method creates a new array with all sub-array elements concatenated into it recursively up to the specified depth.

MDN documentation

impl Array

pub fn flat_map( &self, callback: &mut dyn FnMut(JsValue, u32, Array) -> Vec<JsValue>, ) -> Array

The flatMap() method first maps each element using a mapping function, then flattens the result into a new array.

MDN documentation

impl Array

pub fn for_each(&self, callback: &mut dyn FnMut(JsValue, u32, Array))

The forEach() method executes a provided function once for each array element.

MDN documentation

impl Array

pub fn includes(&self, value: &JsValue, from_index: i32) -> bool

The includes() method determines whether an array includes a certain element, returning true or false as appropriate.

MDN documentation

impl Array

pub fn index_of(&self, value: &JsValue, from_index: i32) -> i32

The indexOf() method returns the first index at which a given element can be found in the array, or -1 if it is not present.

MDN documentation

impl Array

pub fn is_array(value: &JsValue) -> bool

The Array.isArray() method determines whether the passed value is an Array.

MDN documentation

impl Array

pub fn join(&self, delimiter: &str) -> JsString

The join() method joins all elements of an array (or an array-like object) into a string and returns this string.

MDN documentation

impl Array

pub fn last_index_of(&self, value: &JsValue, from_index: i32) -> i32

The lastIndexOf() method returns the last index at which a given element can be found in the array, or -1 if it is not present. The array is searched backwards, starting at fromIndex.

MDN documentation

impl Array

pub fn length(&self) -> u32

The length property of an object which is an instance of type Array sets or returns the number of elements in that array. The value is an unsigned, 32-bit integer that is always numerically greater than the highest index in the array.

MDN documentation

impl Array

pub fn set_length(&self, value: u32)

Sets the length of the array.

If it is set to less than the current length of the array, it will shrink the array.

If it is set to more than the current length of the array, it will increase the length of the array, filling the new space with empty slots.

MDN documentation

impl Array

pub fn map( &self, predicate: &mut dyn FnMut(JsValue, u32, Array) -> JsValue, ) -> Array

map() calls a provided callback function once for each element in an array, in order, and constructs a new array from the results. callback is invoked only for indexes of the array which have assigned values, including undefined. It is not called for missing elements of the array (that is, indexes that have never been set, which have been deleted or which have never been assigned a value).

MDN documentation

impl Array

pub fn of1(a: &JsValue) -> Array

The Array.of() method creates a new Array instance with a variable number of arguments, regardless of number or type of the arguments.

The difference between Array.of() and the Array constructor is in the handling of integer arguments: Array.of(7) creates an array with a single element, 7, whereas Array(7) creates an empty array with a length property of 7 (Note: this implies an array of 7 empty slots, not slots with actual undefined values).

MDN documentation

Notes

There are a few bindings to of in js-sys: of1, of2, etc… with different arities.

impl Array

pub fn of2(a: &JsValue, b: &JsValue) -> Array

MDN documentation

impl Array

pub fn of3(a: &JsValue, b: &JsValue, c: &JsValue) -> Array

MDN documentation

impl Array

pub fn of4(a: &JsValue, b: &JsValue, c: &JsValue, d: &JsValue) -> Array

MDN documentation

impl Array

pub fn of5( a: &JsValue, b: &JsValue, c: &JsValue, d: &JsValue, e: &JsValue, ) -> Array

MDN documentation

impl Array

pub fn pop(&self) -> JsValue

The pop() method removes the last element from an array and returns that element. This method changes the length of the array.

MDN documentation

impl Array

pub fn push(&self, value: &JsValue) -> u32

The push() method adds one or more elements to the end of an array and returns the new length of the array.

MDN documentation

impl Array

pub fn reduce( &self, predicate: &mut dyn FnMut(JsValue, JsValue, u32, Array) -> JsValue, initial_value: &JsValue, ) -> JsValue

The reduce() method applies a function against an accumulator and each element in the array (from left to right) to reduce it to a single value.

MDN documentation

impl Array

pub fn reduce_right( &self, predicate: &mut dyn FnMut(JsValue, JsValue, u32, Array) -> JsValue, initial_value: &JsValue, ) -> JsValue

The reduceRight() method applies a function against an accumulator and each value of the array (from right-to-left) to reduce it to a single value.

MDN documentation

impl Array

pub fn reverse(&self) -> Array

The reverse() method reverses an array in place. The first array element becomes the last, and the last array element becomes the first.

MDN documentation

impl Array

pub fn shift(&self) -> JsValue

The shift() method removes the first element from an array and returns that removed element. This method changes the length of the array.

MDN documentation

impl Array

pub fn slice(&self, start: u32, end: u32) -> Array

The slice() method returns a shallow copy of a portion of an array into a new array object selected from begin to end (end not included). The original array will not be modified.

MDN documentation

impl Array

pub fn some(&self, predicate: &mut dyn FnMut(JsValue) -> bool) -> bool

The some() method tests whether at least one element in the array passes the test implemented by the provided function. Note: This method returns false for any condition put on an empty array. MDN documentation

impl Array

pub fn sort(&self) -> Array

The sort() method sorts the elements of an array in place and returns the array. The sort is not necessarily stable. The default sort order is according to string Unicode code points.

The time and space complexity of the sort cannot be guaranteed as it is implementation dependent.

MDN documentation

impl Array

pub fn splice(&self, start: u32, delete_count: u32, item: &JsValue) -> Array

The splice() method changes the contents of an array by removing existing elements and/or adding new elements.

MDN documentation

impl Array

pub fn to_locale_string(&self, locales: &JsValue, options: &JsValue) -> JsString

The toLocaleString() method returns a string representing the elements of the array. The elements are converted to Strings using their toLocaleString methods and these Strings are separated by a locale-specific String (such as a comma “,”).

MDN documentation

impl Array

pub fn to_string(&self) -> JsString

The toString() method returns a string representing the specified array and its elements.

MDN documentation

impl Array

pub fn unshift(&self, value: &JsValue) -> u32

The unshift() method adds one or more elements to the beginning of an array and returns the new length of the array.

MDN documentation

impl Array

pub fn iter(&self) -> ArrayIter<'_>

Returns an iterator over the values of the JS array.

pub fn to_vec(&self) -> Vec<JsValue>

Converts the JS array into a new Vec.

impl Array

pub fn keys(&self) -> Iterator

The keys() method returns a new Array Iterator object that contains the keys for each index in the array.

MDN documentation

impl Array

pub fn entries(&self) -> Iterator

The entries() method returns a new Array Iterator object that contains the key/value pairs for each index in the array.

MDN documentation

impl Array

pub fn values(&self) -> Iterator

The values() method returns a new Array Iterator object that contains the values for each index in the array.

MDN documentation

Methods from Deref<Target = Object>

pub fn constructor(&self) -> Function

The constructor property returns a reference to the Object constructor function that created the instance object.

MDN documentation

pub fn has_own_property(&self, property: &JsValue) -> bool

The hasOwnProperty() method returns a boolean indicating whether the object has the specified property as its own property (as opposed to inheriting it).

MDN documentation

pub fn is_prototype_of(&self, value: &JsValue) -> bool

The isPrototypeOf() method checks if an object exists in another object’s prototype chain.

MDN documentation

pub fn property_is_enumerable(&self, property: &JsValue) -> bool

The propertyIsEnumerable() method returns a Boolean indicating whether the specified property is enumerable.

MDN documentation

pub fn to_locale_string(&self) -> JsString

The toLocaleString() method returns a string representing the object. This method is meant to be overridden by derived objects for locale-specific purposes.

MDN documentation

pub fn to_string(&self) -> JsString

The toString() method returns a string representing the object.

MDN documentation

pub fn value_of(&self) -> Object

The valueOf() method returns the primitive value of the specified object.

MDN documentation

Methods from Deref<Target = JsValue>

pub const NULL: JsValue

pub const UNDEFINED: JsValue

pub const TRUE: JsValue

pub const FALSE: JsValue

pub fn id(&self) -> u64

Get the heap ID for this value.

This is used internally for encoding values to send to JS.

pub fn unchecked_into_f64(&self) -> f64

Returns the value as f64 without type checking. Used by serde-wasm-bindgen for numeric conversions.

pub fn has_type<T>(&self) -> bool

where T: JsCast,

Check if this value is an instance of a specific JS type.

pub fn checked_div(&self, rhs: &JsValue) -> JsValue

Checked division.

pub fn pow(&self, rhs: &JsValue) -> JsValue

Power operation.

pub fn bit_and(&self, rhs: &JsValue) -> JsValue

Bitwise AND.

pub fn bit_or(&self, rhs: &JsValue) -> JsValue

Bitwise OR.

pub fn bit_xor(&self, rhs: &JsValue) -> JsValue

Bitwise XOR.

pub fn bit_not(&self) -> JsValue

Bitwise NOT.

pub fn shl(&self, rhs: &JsValue) -> JsValue

Left shift.

pub fn shr(&self, rhs: &JsValue) -> JsValue

Signed right shift.

pub fn unsigned_shr(&self, rhs: &JsValue) -> u32

Unsigned right shift.

pub fn add(&self, rhs: &JsValue) -> JsValue

Add.

pub fn sub(&self, rhs: &JsValue) -> JsValue

Subtract.

pub fn mul(&self, rhs: &JsValue) -> JsValue

Multiply.

pub fn div(&self, rhs: &JsValue) -> JsValue

Divide.

pub fn rem(&self, rhs: &JsValue) -> JsValue

Remainder.

pub fn neg(&self) -> JsValue

Negate.

pub fn lt(&self, rhs: &JsValue) -> bool

Less than comparison.

pub fn le(&self, rhs: &JsValue) -> bool

Less than or equal comparison.

pub fn gt(&self, rhs: &JsValue) -> bool

Greater than comparison.

pub fn ge(&self, rhs: &JsValue) -> bool

Greater than or equal comparison.

pub fn loose_eq(&self, rhs: &JsValue) -> bool

Loose equality (==).

pub fn is_falsy(&self) -> bool

Check if this value is a falsy value in JavaScript.

pub fn is_truthy(&self) -> bool

Check if this value is a truthy value in JavaScript.

pub fn is_object(&self) -> bool

Check if this value is an object.

pub fn is_function(&self) -> bool

Check if this value is a function.

pub fn is_string(&self) -> bool

Check if this value is a string.

pub fn is_symbol(&self) -> bool

Check if this value is a symbol.

pub fn is_bigint(&self) -> bool

Check if this value is a bigint.

pub fn is_undefined(&self) -> bool

Check if this value is undefined.

pub fn is_null(&self) -> bool

Check if this value is null.

pub fn js_typeof(&self) -> JsValue

Get the typeof this value as a string.

pub fn js_in(&self, obj: &JsValue) -> bool

Check if this value has a property with the given name.

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

Get the value as a bool.

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

Get the value as an f64.

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

Get the value as a string.

pub fn as_debug_string(&self) -> String

Get a debug string representation of the value.

Trait Implementations

impl AsRef<Array> for Array

fn as_ref(&self) -> &Array

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

impl AsRef<JsValue> for Array

fn as_ref(&self) -> &JsValue

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

impl AsRef<Object> for Array

fn as_ref(&self) -> &Object

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

impl BatchableResult for Array

fn try_placeholder(batch: &mut Runtime) -> Option<Self>

Returns Some(placeholder) for opaque types that can be batched, None for types that require flushing to get the actual value.

impl BinaryDecode for Array

fn decode(decoder: &mut DecodedData<'_>) -> Result<Self, DecodeError>

impl BinaryEncode for &Array

fn encode(self, encoder: &mut EncodedData)

impl BinaryEncode for Array

fn encode(self, encoder: &mut EncodedData)

impl Clone for Array

fn clone(&self) -> Array

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Array

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

Formats the value using the given formatter.

impl Default for Array

fn default() -> Self

Returns the “default value” for a type.

impl Deref for Array

type Target = Object

The resulting type after dereferencing.

fn deref(&self) -> &Object

Dereferences the value.

impl EncodeTypeDef for Array

fn encode_type_def(buf: &mut Vec<u8>)

Encode this type’s definition into the buffer. For primitives, this is just the TypeTag byte. For callbacks, this includes param count, param types, and return type.

impl<A> Extend<A> for Array

where A: AsRef<JsValue>,

fn extend<T>(&mut self, iter: T)

where T: IntoIterator<Item = A>,

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

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

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

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

Reserves capacity in a collection for the given number of additional elements.

impl From<&Array> for JsValue

fn from(val: &Array) -> Self

Converts to this type from the input type.

impl From<&Array> for Object

fn from(val: &Array) -> Object

Converts to this type from the input type.

impl From<Array> for JsValue

fn from(val: Array) -> Self

Converts to this type from the input type.

impl From<Array> for Object

fn from(val: Array) -> Object

Converts to this type from the input type.

impl From<JsValue> for Array

fn from(val: JsValue) -> Self

Converts to this type from the input type.

impl<A> FromIterator<A> for Array

where A: AsRef<JsValue>,

fn from_iter<T>(iter: T) -> Array

where T: IntoIterator<Item = A>,

Creates a value from an iterator.

impl IntoIterator for Array

type Item = JsValue

The type of the elements being iterated over.

type IntoIter = ArrayIntoIter

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl JsCast for Array

fn instanceof(__val: &JsValue) -> bool

Check if a JsValue is an instance of this type.

fn is_type_of(__val: &JsValue) -> bool

Performs a dynamic type check to see whether the JsValue provided is a value of this type.

fn unchecked_from_js(val: JsValue) -> Self

Unchecked cast from JsValue to this type.

fn unchecked_from_js_ref(val: &JsValue) -> &Self

Unchecked cast from a JsValue reference to a reference of this type.

fn has_type<T>(&self) -> bool

where T: JsCast,

Test whether this JS value has a type T.

fn dyn_into<T>(self) -> Result<T, Self>

where T: JsCast,

Try to cast this value to type T.

fn dyn_ref<T>(&self) -> Option<&T>

where T: JsCast,

Try to get a reference to type T from this value.

fn is_instance_of<T>(&self) -> bool

where T: JsCast,

Test whether this JS value is an instance of the type T.

fn unchecked_into<T>(self) -> T

where T: JsCast,

Unchecked cast to another type.

fn unchecked_ref<T>(&self) -> &T

where T: JsCast,

Unchecked cast to a reference of another type.

impl PartialEq for Array

fn eq(&self, other: &Array) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Array

impl StructuralPartialEq for Array