Name
JavaArray — JavaScript representation of a Java array
Availability
Netscape 3 LiveConnect
Synopsis
javaarray
.length // The length of the arrayjavaarray
[index
] // Read or write an array element
Properties
-
length
A read-only integer that specifies the number of elements in the Java array represented by the JavaArray object.
Description
The JavaArray object is a JavaScript representation of a Java array
that allows JavaScript code to read and write the elements of the
array using familiar JavaScript array syntax. In addition, the
JavaArray object has a length
field that specifies
the number of elements in the Java array.
When reading and writing values from array elements, data conversion between JavaScript and Java representations is automatically handled by the system. See Chapter 22 for full details.
Usage
Note that Java arrays differ from JavaScript arrays in a couple of
important aspects. First, Java arrays have a fixed length that is
specified when they are created. For this reason, the JavaArray
length
field is read-only. The second difference
is that Java arrays are typed (i.e., their
elements must all be of the same type of data). Attempting to set an
array element to a value of the wrong type results in a JavaScript
error or exception.
Example
java.awt.Polygon
is a JavaClass object. We can
create a JavaObject representing an instance of the class like this:
p = new java.awt.Polygon( );
The object p
has properties
xpoints
and ypoints
, which are JavaArray objects representing ...
Get JavaScript: The Definitive Guide, Fourth Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.