Class Language

java.lang.Object

org.graalvm.polyglot.Language

public final class Language
extends Object

A handle for a Graal language installed in an engine. The handle provides access to the language's meta-data, including the language's id, name, version and options.

Since:

19.0

See Also:

• Engine.getLanguages()

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object obj)
String	getDefaultMimeType()	Returns the default MIME type that is in use by a language.
String	getId()	Gets the primary identification string of this language.
String	getImplementationName()	Gets a human-readable name of the language implementation (for example, "Graal.JS").
Set<String>	getMimeTypes()	Returns the MIME types supported by this language.
String	getName()	Gets a human-readable name for the language (for example, "JavaScript").
OptionDescriptors	getOptions()	Returns the set of options provided by this language.
OptionDescriptors	getSourceOptions()	Returns the source options descriptors available for sources of this language.
String	getVersion()	Gets the version information of the language in an arbitrary language-specific format.
String	getWebsite()	Get the URL for the language website.
int	hashCode()
boolean	isInteractive()	Returns true if a the language is suitable for interactive evaluation of sources.

Methods inherited from class Object

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

Method Details

getId

public String getId()

Gets the primary identification string of this language. The language id is used as the primary way of identifying languages in the polyglot API. (eg. js)

Returns:

a language ID string.

Since:

19.0

getName

public String getName()

Gets a human-readable name for the language (for example, "JavaScript").

Returns:

the user-friendly name for this language.

Since:

19.0

getImplementationName

public String getImplementationName()

Gets a human-readable name of the language implementation (for example, "Graal.JS"). Returns null if no implementation name was specified.

Since:

19.0

getVersion

public String getVersion()

Gets the version information of the language in an arbitrary language-specific format.

Since:

19.0

isInteractive

public boolean isInteractive()

Returns true if a the language is suitable for interactive evaluation of sources. Interactive languages should be displayed in interactive environments and presented to the user.

Since:

19.0

getOptions

public OptionDescriptors getOptions()

Returns the set of options provided by this language. Option values for languages can either be provided while building an engine or a context. The option descriptor name must be used as the option name.

Since:

19.0

getSourceOptions

public OptionDescriptors getSourceOptions()

Returns the source options descriptors available for sources of this language.

Since:

25.0

See Also:

• getOptions()
• Source.Builder.option(String, String)

getDefaultMimeType

public String getDefaultMimeType()

Returns the default MIME type that is in use by a language. The default MIME type specifies whether a source is loaded as character or binary based source by default. Returns null if the language does not specify a default MIME type.

Since:

19.0

See Also:

• Source.hasBytes()
• Source.getMimeType()

getMimeTypes

public Set<String> getMimeTypes()

Returns the MIME types supported by this language.

Since:

19.0

See Also:

• Source.getMimeType()

getWebsite

public String getWebsite()

Get the URL for the language website.

Since:

21.1.0

hashCode

public int hashCode()

Overrides:

hashCode in class Object

Since:

24.2

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

Since:

24.2