Change Log for Rhino

Release candidate 2 for Rhino 1.6R1

Release overview

Rhino 1.6R1 is the new major release of Rhino. It supports ECMAScript for XML (E4X) as specified by ECMA 357 standard. E4X is a set of language extensions adding native XML support for JavaScript without affecting the existing code base. E4X example demonstrates various E4X constructions and their usage in JavaScript code.

This version of Rhino should be binary compatible with the current embeddings that use only public API unless the code use the previously deperected classes as documented below. Please report any incompatibilitiy issues to Bugzilla.

E4X implementation

The E4X code was donated to the Rhino project by BEA and developed by staff from BEA and AgileDelta.

It uses XMLBeans library to implement E4X runtime. The implementation was tested against versions 1.0.2 and 1.0.3 of XMLBeans. Please make sure that xbean.jar is avaialble on the classpath if you use E4X in your scripts.

See Bugzilla 242805 for details.

Other changes

Common root for Rhino execeptions

Now all Rhino execption classes are derived from org.mozilla.javascript.RhinoException which extends java.lang.RuntimeException. The class gives the uniform way to access information about the script origin of the exception and simplifies execption handling in Rhino embeddings.

See Bugzilla 244492 for details.

Removal of code complexity limits in the interpreter

The interpreter mode in Rhino does not limit any longer the script size or code complexity. It should be possible to execute any script as long as JVM resources allow so.

See Bugzilla 244014 and Bugzilla 256339 for details.

Tail call elimination in the interpreter

The interpreter mode in Rhino implements tail call elimination to avoid excessive stack space consumption when a function returns result of a call to another function.

See Bugzilla 257128.

Experimental support for continuations in the interpreter

The interpreter mode in Rhino contains an experimental support for continuations. It is based on the original implementation of Christopher Oliver and ideas from SISC project. To enable the continuation support make sure that the interpreter mode is selected when you use Rhino through setting the optimization level to -1 or if you use shell by passing -opt -1 to the shell command line.

Please note that the details of implementation and Java and JavaScript API for continuations may change in future in incompatible way.

See Bugzilla 258844.

JavaImporter constructor

JavaImporter is a new global constructor that allows to omit explicit package names when scripting Java:

var SwingGui = JavaImporter(Packages.javax.swing,
                            Packages.javax.swing.event,
                            Packages.javax.swing.border,
                            java.awt.event,
                            java.awt.Point,
                            java.awt.Rectangle,
                            java.awt.Dimension);
...

with (SwingGui) {
    var mybutton = new JButton(test);
    var mypoint = new Point(10, 10);
    var myframe = new JFrame();
...
}

Previously such functionality was available only to embeddings that used org.mozilla.javascript.ImporterTopLevel class as the top level scope. The class provides additional importPackage() and importClass() global functions but their extensive usage has tendency to pollute the global name space with names of Java classes

See Bugzilla 245882 for details.

Context customization API

See Bugzilla 245882 for details.

Support for Date.now()

Date.now() function which is a SpiderMonkey extension to ECMAScript standard is available now in Rhino. The function returns number of milliseconds passed since 1970-01-01 00:00:00 UTC.

Removal of deprecated classes

The following classes that were deprecated in Rhino 1.5R5 are no longer available in Rhino 1.6R1:

• org.mozilla.javascript.ClassNameHelper
• org.mozilla.javascript.ClassRepository