JSCExceptionHandler ()

void
(*JSCExceptionHandler) (JSCContext *context,
                        JSCException *exception,
                        gpointer user_data);

Function used to handle JavaScript exceptions in a JSCContext.

jsc_context_new ()

JSCContext *
jsc_context_new (void);

Create a new JSCContext. The context is created in a new JSCVirtualMachine. Use jsc_context_new_with_virtual_machine() to create a new JSCContext in an existing JSCVirtualMachine.

jsc_context_new_with_virtual_machine ()

JSCContext *
jsc_context_new_with_virtual_machine (JSCVirtualMachine *vm);

Create a new JSCContext in virtual_machine .

jsc_context_get_virtual_machine ()

JSCVirtualMachine *
jsc_context_get_virtual_machine (JSCContext *context);

Get the JSCVirtualMachine where context was created.

jsc_context_get_exception ()

JSCException *
jsc_context_get_exception (JSCContext *context);

Get the last unhandled exception thrown in context by API functions calls.

jsc_context_throw ()

void
jsc_context_throw (JSCContext *context,
                   const char *error_message);

Throw an exception to context using the given error message. The created JSCException can be retrieved with jsc_context_get_exception().

jsc_context_throw_exception ()

void
jsc_context_throw_exception (JSCContext *context,
                             JSCException *exception);

Throw exception to context .

jsc_context_clear_exception ()

void
jsc_context_clear_exception (JSCContext *context);

Clear the uncaught exception in context if any.

jsc_context_push_exception_handler ()

void
jsc_context_push_exception_handler (JSCContext *context,
                                    JSCExceptionHandler handler,
                                    gpointer user_data,
                                    GDestroyNotify destroy_notify);

Push an exception handler in context . Whenever a JavaScript exception happens in the JSCContext, the given handler will be called. The default JSCExceptionHandler simply calls jsc_context_throw_exception() to throw the exception to the JSCContext. If you don't want to catch the exception, but only get notified about it, call jsc_context_throw_exception() in handler like the default one does. The last exception handler pushed is the only one used by the JSCContext, use jsc_context_pop_exception_handler() to remove it and set the previous one. When handler is removed from the context, destroy_notify i called with user_data as parameter.

jsc_context_pop_exception_handler ()

void
jsc_context_pop_exception_handler (JSCContext *context);

Remove the last JSCExceptionHandler previously pushed to context with jsc_context_push_exception_handler().

jsc_context_get_current ()

JSCContext *
jsc_context_get_current (void);

Get the JSCContext that is currently executing a function. This should only be called within a function or method callback, otherwise NULL will be returned.

jsc_context_evaluate ()

JSCValue *
jsc_context_evaluate (JSCContext *context,
                      const char *code,
                      gssize length);

Evaluate code in context .

jsc_context_evaluate_with_source_uri ()

JSCValue *
jsc_context_evaluate_with_source_uri (JSCContext *context,
                                      const char *code,
                                      gssize length,
                                      const char *uri);

Evaluate code in context using uri as the source URI. This is exactly the same as jsc_context_evaluate() but uri will be shown in exceptions. The source uri doesn't affect the behavior of the script.

jsc_context_set_value ()

void
jsc_context_set_value (JSCContext *context,
                       const char *name,
                       JSCValue *value);

Set a property of context global object with name and value .

jsc_context_get_value ()

JSCValue *
jsc_context_get_value (JSCContext *context,
                       const char *name);

Get a property of context global object with name .

jsc_context_register_class ()

JSCClass *
jsc_context_register_class (JSCContext *context,
                            const char *name,
                            JSCClass *parent_class,
                            JSCClassVTable *vtable,
                            GDestroyNotify destroy_notify);

Register a custom class in context using the given name . If the new class inherits from another JSCClass, the parent should be passed as parent_class , otherwise NULL should be used. The optional vtable parameter allows to provide a custom implementation for handling the class, for example, to handle external properties not added to the prototype. When an instance of the JSCClass is cleared in the context, destroy_notify is called with the instance as parameter.

JSCContext

typedef struct _JSCContext JSCContext;

The “virtual-machine” property

  “virtual-machine”          JSCVirtualMachine *

The JSCVirtualMachine in which the context was created.

Flags: Read / Write / Construct Only