com.oracle.truffle.js.scriptengine

Class GraalJSScriptEngine

java.lang.Object

javax.script.AbstractScriptEngine

com.oracle.truffle.js.scriptengine.GraalJSScriptEngine

All Implemented Interfaces:

AutoCloseable, Compilable, Invocable, ScriptEngine

public final class GraalJSScriptEngine
extends AbstractScriptEngine
implements Compilable, Invocable, AutoCloseable

A Graal.JS implementation of the script engine. It provides access to the polyglot context using GraalJSScriptEngine.getPolyglotContext().

Field Summary

Fields inherited from class javax.script.AbstractScriptEngine

context

Fields inherited from interface javax.script.ScriptEngine

ARGV, ENGINE, ENGINE_VERSION, FILENAME, LANGUAGE, LANGUAGE_VERSION, NAME

Method Summary

Modifier and Type	Method and Description
void	close() Closes the current context and makes it unusable.
CompiledScript	compile(Reader reader)
CompiledScript	compile(String script)
static GraalJSScriptEngine	create() Creates a new GraalJSScriptEngine with default configuration.
static GraalJSScriptEngine	create(org.graalvm.polyglot.Engine engine, org.graalvm.polyglot.Context.Builder newContextConfig) Creates a new GraalJS script engine from a polyglot Engine instance with a base configuration for new polyglot Context instances.
Bindings	createBindings()
Object	eval(Reader reader, ScriptContext ctxt)
Object	eval(String script, ScriptContext ctxt)
GraalJSEngineFactory	getFactory()
<T> T	getInterface(Class<T> clasz)
<T> T	getInterface(Object thiz, Class<T> clasz)
org.graalvm.polyglot.Context	getPolyglotContext() Returns the polyglot context associated with the default ScriptContext of the engine.
org.graalvm.polyglot.Context	getPolyglotContext(ScriptContext ctxt) Returns the polyglot context associated with a ScriptContext.
org.graalvm.polyglot.Engine	getPolyglotEngine() Returns the polyglot engine associated with this script engine.
Object	invokeFunction(String name, Object... args)
Object	invokeMethod(Object thiz, String name, Object... args)
void	setBindings(Bindings bindings, int scope)

Methods inherited from class javax.script.AbstractScriptEngine

eval, eval, eval, eval, get, getBindings, getContext, getScriptContext, put, setContext

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

close

public void close()

Closes the current context and makes it unusable. Operations performed after closing will throw an IllegalStateException.

Specified by:

close in interface AutoCloseable

getPolyglotEngine

public org.graalvm.polyglot.Engine getPolyglotEngine()

Returns the polyglot engine associated with this script engine.

getPolyglotContext

public org.graalvm.polyglot.Context getPolyglotContext()

Returns the polyglot context associated with the default ScriptContext of the engine.

See Also:

to access the polyglot context of a particular context.

getPolyglotContext

public org.graalvm.polyglot.Context getPolyglotContext(ScriptContext ctxt)

Returns the polyglot context associated with a ScriptContext. If the context is not yet initialized then it will be initialized using the default context builder specified in GraalJSScriptEngine.create(Engine, org.graalvm.polyglot.Context.Builder).

createBindings

public Bindings createBindings()

Specified by:

createBindings in interface ScriptEngine

setBindings

public void setBindings(Bindings bindings,
                        int scope)

Specified by:

setBindings in interface ScriptEngine

Overrides:

setBindings in class AbstractScriptEngine

eval

public Object eval(Reader reader,
                   ScriptContext ctxt)
            throws ScriptException

Specified by:

eval in interface ScriptEngine

Throws:

ScriptException

eval

public Object eval(String script,
                   ScriptContext ctxt)
            throws ScriptException

Specified by:

eval in interface ScriptEngine

Throws:

ScriptException

getFactory

public GraalJSEngineFactory getFactory()

Specified by:

getFactory in interface ScriptEngine

invokeMethod

public Object invokeMethod(Object thiz,
                           String name,
                           Object... args)
                    throws ScriptException,
                           NoSuchMethodException

Specified by:

invokeMethod in interface Invocable

Throws:

ScriptException

NoSuchMethodException

invokeFunction

public Object invokeFunction(String name,
                             Object... args)
                      throws ScriptException,
                             NoSuchMethodException

Specified by:

invokeFunction in interface Invocable

Throws:

ScriptException

NoSuchMethodException

getInterface

public <T> T getInterface(Class<T> clasz)

Specified by:

getInterface in interface Invocable

getInterface

public <T> T getInterface(Object thiz,
                          Class<T> clasz)

Specified by:

getInterface in interface Invocable

compile

public CompiledScript compile(String script)
                       throws ScriptException

Specified by:

compile in interface Compilable

Throws:

ScriptException

compile

public CompiledScript compile(Reader reader)
                       throws ScriptException

Specified by:

compile in interface Compilable

Throws:

ScriptException

create

public static GraalJSScriptEngine create()

Creates a new GraalJSScriptEngine with default configuration.

See Also:

to customize the configuration.

create

public static GraalJSScriptEngine create(org.graalvm.polyglot.Engine engine,
                                         org.graalvm.polyglot.Context.Builder newContextConfig)

Creates a new GraalJS script engine from a polyglot Engine instance with a base configuration for new polyglot Context instances. Polyglot context instances can be accessed from ScriptContext instances using GraalJSScriptEngine.getPolyglotContext(). The out,err and in stream configuration are not inherited from the provided polyglot context config. Instead ScriptContext output and input streams are used.

Parameters:

engine - the engine to be used for context configurations or null if a default engine should be used.

newContextConfig - a base configuration to create new context instances or null if the default configuration should be used to construct new context instances.