JSArray<T extends JSAny?> extension type

A JavaScript Array.

Because JSArray is an extension type, T is only a static guarantee and the array does not necessarily only contain T elements. For example:

@JS()
external JSArray<JSNumber> get array;

array is not actually checked to ensure it contains instances of JSNumber when called.

T may introduce additional checking elsewhere, however. When accessing elements of JSArray with type T, there is a check to ensure the element is a T to ensure soundness. Similarly, when converting to a List<T>, casts may be introduced to ensure that it is indeed a List<T>.

on
  • JSArrayRepType
Implemented types
Available extensions
Annotations
  • @JS('Array')

Constructors

JSArray()
Creates an empty JavaScript Array.
JSArray.withLength(int length)
Creates a JavaScript Array of size length with no elements.

Properties

hashCode → int
The hash code for this object.
no setterinherited
length ↔ int
The length in elements of this Array.
getter/setter pair
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited
operator [](int position) → T
The value at position in this Array.
operator []=(int position, T value) → void
Sets the value at position in this Array.

Static Methods

from<T extends JSAny>(JSObject arrayLike) → JSArray<T>
Creates a new, shallow-copied JavaScript Array instance from a JavaScript iterable or array-like object.