com.oracle.truffle.js.parser

Class GraalJSEvaluator

java.lang.Object

com.oracle.truffle.js.parser.GraalJSEvaluator

All Implemented Interfaces:

JSParser, Evaluator

public final class GraalJSEvaluator
extends Object
implements JSParser

This is the main external entry into the GraalJS parser. The GraalJS parser is derived from the Oracle Nashorn JavaScript parser (http://openjdk.java.net/projects/nashorn/).

Field Summary

Fields inherited from interface com.oracle.truffle.js.runtime.Evaluator

EVAL_AT_SOURCE_NAME_PREFIX, EVAL_SOURCE_NAME, FUNCTION_SOURCE_NAME, MODULE_EVAL_SUFFIX, MODULE_LINK_SUFFIX, TS_EVAL_SOURCE_NAME

Constructor Summary

Constructors

Constructor and Description
GraalJSEvaluator()

Method Summary

Modifier and Type	Method and Description
void	checkFunctionSyntax(JSContext context, JSParserOptions parserOptions, String parameterList, String body, boolean generator, boolean async, String sourceName)
JSModuleData	envParseModule(JSRealm realm, com.oracle.truffle.api.source.Source source) Like Evaluator.parseModule(JSContext, Source), but parses the source via TruffleLanguage.Env in order to make use of Truffle code caching.
ScriptNode	evalCompile(JSContext context, String sourceCode, String name) Parses a script string.
Object	getDefaultNodeFactory() Returns the NodeFactory used by this parser instance to create AST nodes.
JSDynamicObject	getModuleNamespace(JSModuleRecord moduleRecord)
JSModuleRecord	hostResolveImportedModule(JSContext context, ScriptOrModule referrer, Module.ModuleRequest moduleRequest)
static Supplier<ScriptNode>	internalParseForTiming(JSContext context, com.oracle.truffle.api.source.Source source) Parses source to intermediate AST and returns a closure for the translation to Truffle AST.
Object	moduleEvaluation(JSRealm realm, JSModuleRecord moduleRecord)
void	moduleLinking(JSRealm realm, JSModuleRecord moduleRecord)
Integer[]	parseDate(JSRealm realm, String date, boolean extraLenient)
ScriptNode	parseDirectEval(JSContext context, com.oracle.truffle.api.nodes.Node lastNode, com.oracle.truffle.api.source.Source source, Object evalEnv) Evaluate direct eval.
ScriptNode	parseEval(JSContext context, com.oracle.truffle.api.nodes.Node lastNode, com.oracle.truffle.api.source.Source source, ScriptOrModule activeScriptOrModule) Evaluate indirect eval.
Expression	parseExpression(JSContext context, String sourceString)
ScriptNode	parseFunction(JSContext context, String parameterList, String body, boolean generatorFunction, boolean asyncFunction, String sourceName, ScriptOrModule activeScriptOrModule) Evaluate Function(parameterList, body).
JavaScriptNode	parseInlineScript(JSContext context, com.oracle.truffle.api.source.Source source, com.oracle.truffle.api.frame.MaterializedFrame lexicalContextFrame, boolean isStrict, com.oracle.truffle.api.nodes.Node locationNode) Creates a script that will be evaluated in a specified lexical context.
JSModuleRecord	parseJSONModule(JSRealm realm, com.oracle.truffle.api.source.Source source)
JSModuleData	parseModule(JSContext context, com.oracle.truffle.api.source.Source source) Parses a module source.
ScriptNode	parseScript(JSContext context, com.oracle.truffle.api.source.Source source, ByteBuffer binary)
ScriptNode	parseScript(JSContext context, com.oracle.truffle.api.source.Source source, SnapshotProvider snapshotProvider)
ScriptNode	parseScript(JSContext context, com.oracle.truffle.api.source.Source source, String prolog, String epilog, boolean isStrict, List<String> argumentNames)
ScriptNode	parseScript(JSContext context, String sourceCode)
String	parseToJSON(JSContext context, String code, String name, boolean includeLoc)
ExportResolution	resolveExport(JSModuleRecord referencingModule, com.oracle.truffle.api.strings.TruffleString exportName)

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.oracle.truffle.js.runtime.Evaluator

parseScript, parseScript

Constructor Detail

GraalJSEvaluator

public GraalJSEvaluator()

Method Detail

parseEval

public ScriptNode parseEval(JSContext context,
                            com.oracle.truffle.api.nodes.Node lastNode,
                            com.oracle.truffle.api.source.Source source,
                            ScriptOrModule activeScriptOrModule)

Evaluate indirect eval.

Specified by:

parseEval in interface Evaluator

lastNode - the node invoking the eval or null

parseFunction

public ScriptNode parseFunction(JSContext context,
                                String parameterList,
                                String body,
                                boolean generatorFunction,
                                boolean asyncFunction,
                                String sourceName,
                                ScriptOrModule activeScriptOrModule)

Evaluate Function(parameterList, body).

Specified by:

parseFunction in interface Evaluator

parseDirectEval

public ScriptNode parseDirectEval(JSContext context,
                                  com.oracle.truffle.api.nodes.Node lastNode,
                                  com.oracle.truffle.api.source.Source source,
                                  Object evalEnv)

Evaluate direct eval.

Specified by:

parseDirectEval in interface Evaluator

lastNode - the node invoking the eval or null

evalCompile

public ScriptNode evalCompile(JSContext context,
                              String sourceCode,
                              String name)

Description copied from interface: Evaluator

Parses a script string. Returns an executable script object.

Specified by:

evalCompile in interface Evaluator

parseScript

public ScriptNode parseScript(JSContext context,
                              com.oracle.truffle.api.source.Source source,
                              String prolog,
                              String epilog,
                              boolean isStrict,
                              List<String> argumentNames)

Specified by:

parseScript in interface Evaluator

parseScript

public ScriptNode parseScript(JSContext context,
                              String sourceCode)

Specified by:

parseScript in interface Evaluator

parseDate

public Integer[] parseDate(JSRealm realm,
                           String date,
                           boolean extraLenient)

Specified by:

parseDate in interface Evaluator

parseToJSON

public String parseToJSON(JSContext context,
                          String code,
                          String name,
                          boolean includeLoc)

Specified by:

parseToJSON in interface Evaluator

getDefaultNodeFactory

public Object getDefaultNodeFactory()

Description copied from interface: Evaluator

Returns the NodeFactory used by this parser instance to create AST nodes.

Specified by:

getDefaultNodeFactory in interface Evaluator

internalParseForTiming

public static Supplier<ScriptNode> internalParseForTiming(JSContext context,
                                                          com.oracle.truffle.api.source.Source source)

Parses source to intermediate AST and returns a closure for the translation to Truffle AST.

parseModule

public JSModuleData parseModule(JSContext context,
                                com.oracle.truffle.api.source.Source source)

Description copied from interface: Evaluator

Parses a module source.

Specified by:

parseModule in interface Evaluator

envParseModule

public JSModuleData envParseModule(JSRealm realm,
                                   com.oracle.truffle.api.source.Source source)

Description copied from interface: Evaluator

Like Evaluator.parseModule(JSContext, Source), but parses the source via TruffleLanguage.Env in order to make use of Truffle code caching.

Specified by:

envParseModule in interface Evaluator

parseJSONModule

public JSModuleRecord parseJSONModule(JSRealm realm,
                                      com.oracle.truffle.api.source.Source source)

Specified by:

parseJSONModule in interface Evaluator

hostResolveImportedModule

public JSModuleRecord hostResolveImportedModule(JSContext context,
                                                ScriptOrModule referrer,
                                                Module.ModuleRequest moduleRequest)

Specified by:

hostResolveImportedModule in interface Evaluator

resolveExport

public ExportResolution resolveExport(JSModuleRecord referencingModule,
                                      com.oracle.truffle.api.strings.TruffleString exportName)

Specified by:

resolveExport in interface Evaluator

getModuleNamespace

public JSDynamicObject getModuleNamespace(JSModuleRecord moduleRecord)

Specified by:

getModuleNamespace in interface Evaluator

moduleLinking

public void moduleLinking(JSRealm realm,
                          JSModuleRecord moduleRecord)

Specified by:

moduleLinking in interface Evaluator

moduleEvaluation

public Object moduleEvaluation(JSRealm realm,
                               JSModuleRecord moduleRecord)

Specified by:

moduleEvaluation in interface Evaluator

parseScript

public ScriptNode parseScript(JSContext context,
                              com.oracle.truffle.api.source.Source source,
                              ByteBuffer binary)

Specified by:

parseScript in interface JSParser

parseScript

public ScriptNode parseScript(JSContext context,
                              com.oracle.truffle.api.source.Source source,
                              SnapshotProvider snapshotProvider)

Specified by:

parseScript in interface JSParser

parseInlineScript

public JavaScriptNode parseInlineScript(JSContext context,
                                        com.oracle.truffle.api.source.Source source,
                                        com.oracle.truffle.api.frame.MaterializedFrame lexicalContextFrame,
                                        boolean isStrict,
                                        com.oracle.truffle.api.nodes.Node locationNode)

Description copied from interface: Evaluator

Creates a script that will be evaluated in a specified lexical context.

Specified by:

parseInlineScript in interface Evaluator

parseExpression

public Expression parseExpression(JSContext context,
                                  String sourceString)

Specified by:

parseExpression in interface Evaluator

checkFunctionSyntax

public void checkFunctionSyntax(JSContext context,
                                JSParserOptions parserOptions,
                                String parameterList,
                                String body,
                                boolean generator,
                                boolean async,
                                String sourceName)

Specified by:

checkFunctionSyntax in interface Evaluator