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	Description
GraalJSEvaluator()

Method Summary

Modifier and Type	Method	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.
void	hostLoadImportedModule(JSRealm realm, ScriptOrModule referrer, Module.ModuleRequest moduleRequest, Object hostDefined, Object payload)	HostLoadImportedModule takes arguments referrer (a Script Record, a Cyclic Module Record, or a Realm Record), specifier (a String), hostDefined (anything), and payload (a GraphLoadingState Record or a PromiseCapability Record) and returns unused.
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.
JSPromiseObject	loadRequestedModules(JSRealm realm, CyclicModuleRecord moduleRecord, Object hostDefined)
JSPromiseObject	moduleEvaluation(JSRealm realm, CyclicModuleRecord moduleRecord)
void	moduleLinking(JSRealm realm, CyclicModuleRecord 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, 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, com.oracle.truffle.api.source.Source source, ByteBuffer binary)
ScriptNode	parseScript(JSContext context, String sourceCode)
String	parseToJSON(JSContext context, String code, String name, boolean includeLoc)
AbstractModuleRecord	parseWasmModuleSource(JSRealm realm, com.oracle.truffle.api.source.Source source)

Methods inherited from class java.lang.Object

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

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

parseScript, parseScript

Constructor Details

GraalJSEvaluator

public GraalJSEvaluator()

Method Details

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

Parameters:

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

Parameters:

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

parseWasmModuleSource

public AbstractModuleRecord parseWasmModuleSource(JSRealm realm,
 com.oracle.truffle.api.source.Source source)

Specified by:

parseWasmModuleSource in interface Evaluator

parseJSONModule

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

Specified by:

parseJSONModule in interface Evaluator

loadRequestedModules

public JSPromiseObject loadRequestedModules(JSRealm realm,
 CyclicModuleRecord moduleRecord,
 Object hostDefined)

Specified by:

loadRequestedModules in interface Evaluator

hostLoadImportedModule

public void hostLoadImportedModule(JSRealm realm,
 ScriptOrModule referrer,
 Module.ModuleRequest moduleRequest,
 Object hostDefined,
 Object payload)

HostLoadImportedModule takes arguments referrer (a Script Record, a Cyclic Module Record, or a Realm Record), specifier (a String), hostDefined (anything), and payload (a GraphLoadingState Record or a PromiseCapability Record) and returns unused. The host environment must perform FinishLoadingImportedModule(referrer, specifier, payload, result), where result is either a normal completion containing the loaded Module Record or a throw completion, either synchronously or asynchronously.

Specified by:

hostLoadImportedModule in interface Evaluator

moduleLinking

public void moduleLinking(JSRealm realm,
 CyclicModuleRecord moduleRecord)

Specified by:

moduleLinking in interface Evaluator

moduleEvaluation

public JSPromiseObject moduleEvaluation(JSRealm realm,
 CyclicModuleRecord 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