public class

JsArray

extends JavaScriptObject
java.lang.Object
   ↳ com.google.gwt.core.client.JavaScriptObject
     ↳ com.google.gwt.core.client.JsArray<T extends com.google.gwt.core.client.JavaScriptObject>

Class Overview

A simple wrapper around a homogeneous native array of JavaScriptObject values. This class may not be directly instantiated, and can only be returned from a native method. For example, native JsArray getNativeArray() /*-{ return [ { x: 0, y: 1}, { x: 2, y: 3}, { x: 4, y: 5}, ]; }-* /;

Summary

Protected Constructors
JsArray()
Public Methods
final T get(int index)
Gets the object at a given index.
final String join(String separator)
Convert each element of the array to a String and join them with a comma separator.
final String join()
Convert each element of the array to a String and join them with a comma separator.
final int length()
Gets the length of the array.
final void push(T value)
Pushes the given value onto the end of the array.
final void set(int index, T value)
Sets the object value at a given index.
final void setLength(int newLength)
Reset the length of the array.
final T shift()
Shifts the first value off the array.
final void unshift(T value)
Shifts a value onto the beginning of the array.
[Expand]
Inherited Methods
From class com.google.gwt.core.client.JavaScriptObject
From class java.lang.Object

Protected Constructors

protected JsArray ()

Public Methods

public final T get (int index)

Gets the object at a given index.

Parameters
index the index to be retrieved
Returns
  • the object at the given index, or null if none exists

public final String join (String separator)

Convert each element of the array to a String and join them with a comma separator. The value returned from this method may vary between browsers based on how JavaScript values are converted into strings.

public final String join ()

Convert each element of the array to a String and join them with a comma separator. The value returned from this method may vary between browsers based on how JavaScript values are converted into strings.

public final int length ()

Gets the length of the array.

Returns
  • the array length

public final void push (T value)

Pushes the given value onto the end of the array.

public final void set (int index, T value)

Sets the object value at a given index. If the index is out of bounds, the value will still be set. The array's length will be updated to encompass the bounds implied by the added object.

Parameters
index the index to be set
value the object to be stored

public final void setLength (int newLength)

Reset the length of the array.

Parameters
newLength the new length of the array

public final T shift ()

Shifts the first value off the array.

Returns
  • the shifted value

public final void unshift (T value)

Shifts a value onto the beginning of the array.

Parameters
value the value to the stored