JSContext class

A JavaScript execution context. Holds the global object and other execution state.

Constructors

JSContext(Pointer<NativeType> _pointer)

JSContext.create({JSClass? globalObjectClass})

Creates a global JavaScript execution context. JSGlobalContextCreate allocates a global object and populates it with all the built-in JavaScript objects, such as Object, Function, String, and Array.

JSContext.createInGroup({JSContextGroup? group, JSClass? globalObjectClass})

Creates a global JavaScript execution context in the context group provided. JSGlobalContextCreateInGroup allocates a global object and populates it with all the built-in JavaScript objects, such as Object, Function, String, and Array. group (JSContextGroup) The context group to use. The created global context retains the group. Pass NULL to create a unique group for the context. globalObjectClass (JSClass) The class to use when creating the global object. Pass NULL to use the default object class. @result (JSGlobalContext) A JSGlobalContext with a global object of class globalObjectClass and a context group equal to group.

Properties

exception ↔ JSValuePointer

Exception (JSValueRef*) A pointer to a JSValueRef in which to store an exception, if any. Pass NULL if you do not care to store an exception.

getter/setter pair

globalObject → JSObject

Gets the global object of a JavaScript execution context. @result (JSObject) ctx's global object.

no setter

group → JSContextGroup

Gets the context group to which a JavaScript execution context belongs. @result (JSContextGroup) ctx's group.

no setter

hashCode → int

The hash code for this object.

no setter, inherited

pointer → Pointer<NativeType>

no setter

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

Methods

copyName() → JSString

Gets the global context of a JavaScript execution context. @result (JSGlobalContext) ctx's global context. Gets a copy of the name of a context. A JSGlobalContext's name is exposed for remote debugging to make it easier to identify the context you would like to attach to. @result (JSString) The name for ctx.

evaluate(String script, {JSObject? thisObject, String? sourceURL, int startingLineNumber = 1}) → JSValue

Evaluates a string of JavaScript. script (String) A JSString containing the script to evaluate. thisObject (JSObject) The object to use as "this," or NULL to use the global object as "this." sourceURL (String) A JSString containing a URL for the script's source file. This is used by debuggers and when reporting exceptions. Pass NULL if you do not care to include source file information. startingLineNumber (int) An integer value specifying the script's starting line number in the file located at sourceURL. This is only used when reporting exceptions. The value is one-based, so the first line is line 1 and invalid values are clamped to 1. @result (JSValueRef) The JSValue that results from evaluating script, or NULL if an exception is thrown.

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

release() → void

Releases a global JavaScript execution context. ctx (JSGlobalContext) The JSGlobalContext to release.

retain() → void

Retains a global JavaScript execution context. @result (JSGlobalContext) A JSGlobalContext that is the same as ctx.

setName(JSString name) → void

Sets the remote debugging name for a context. name (JSString) The remote debugging name to set on ctx.

toString() → String

A string representation of this object.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited