description

# toJS property

JSArray<T> get toJS

Converts this List to a JSArray by either casting, unwrapping, or cloning the List.

Note

Depending on whether code is compiled to JavaScript or Wasm, this conversion will have different semantics.

When compiling to JavaScript, the core List is a JavaScript `Array`, and therefore this getter simply casts. If the List is not a core List e.g. a user-defined list, this getter throws with a cast error.

When compiling to Wasm, this List is a wrapper around an `Array` if it was converted via JSArrayToList.toDart. If it's a wrapper, this getter unwraps it and returns the `Array`. If it's instantiated in Dart, this getter clones this List's values into a new JSArray.

Avoid assuming that modifications to this List will affect the returned JSArray and vice versa in all compilers unless it was first converted via JSArrayToList.toDart.

## Implementation

    external JSArray<T> get toJS;