org.gnome.webkit.jsc.Value

All Implemented Interfaces:: Proxy

@Generated("io.github.jwharm.JavaGI") public final class Value extends GObject

JSCValue represents a reference to a value in a JSCContext. The JSCValue protects the referenced value from being garbage collected.

Nested Class Summary

Nested Classes

Modifier and Type

Class

Description

static class

Value.Builder<B extends Value.Builder<B>>

Inner class implementing a builder pattern to construct a GObject with properties.

static class

Value.ValueClass

Nested classes/interfaces inherited from class org.gnome.gobject.GObject
GObject.NotifyCallback, GObject.ObjectClass
Constructor Summary

Constructors

Constructor

Description

Value(MemorySegment address)

Create a Value proxy instance for the provided memory address.
Method Summary

Modifier and Type

Method

Description

static Value

array(Context context, Type firstItemType, Object... varargs)

Create a new JSCValue referencing an array with the given items.

static Value

arrayBuffer(Context context, @Nullable MemorySegment data, long size)

Creates a new ArrayBuffer from existing data in memory.

MemorySegment

arrayBufferGetData(@Nullable MemorySegment size)

Gets a pointer to memory that contains the array buffer data.

long

arrayBufferGetSize()

Gets the size in bytes of the array buffer.

static Value

arrayFromGarray(Context context, @Nullable Value[] array)

Create a new JSCValue referencing an array with the items from array.

static Value

arrayFromStrv(Context context, String[] strv)

Create a new JSCValue referencing an array of strings with the items from strv.

protected Value

asParent()

Returns this instance as if it were its parent type.

static Value

boolean_(Context context, boolean value)

Create a new JSCValue from value

static Value.Builder<? extends Value.Builder>

builder()

A Value.Builder object constructs a Value with the specified properties.

Value

constructorCall(@Nullable Value[] parameters)

Invoke <function>new</function> with constructor referenced by this Value.

static Value

fromJson(Context context, String json)

Create a new JSCValue referencing a new value created by parsing json.

static Value

function(Context context, @Nullable String name, Callback callback, Type returnType, @Nullable Type[] parameterTypes)

Create a function in context.

Value

functionCall(@Nullable Value[] parameters)

Call function referenced by this Value, passing the given parameters.

static Value

functionVariadic(Context context, @Nullable String name, Callback callback, Type returnType)

Create a function in context.

Context

getContext()

Get the JSCContext in which this Value was created.

static Type

getType()

Get the GType of the Value class

boolean

isArray()

Get whether the value referenced by this Value is an array.

boolean

isArrayBuffer()

Check whether the this Value is an ArrayBuffer.

boolean

isBoolean()

Get whether the value referenced by this Value is a boolean.

boolean

isConstructor()

Get whether the value referenced by this Value is a constructor.

boolean

isFunction()

Get whether the value referenced by this Value is a function

boolean

isNull()

Get whether the value referenced by this Value is <function>null</function>.

boolean

isNumber()

Get whether the value referenced by this Value is a number.

boolean

isObject()

Get whether the value referenced by this Value is an object.

boolean

isString()

Get whether the value referenced by this Value is a string

boolean

isTypedArray()

Determines whether a value is a typed array.

boolean

isUndefined()

Get whether the value referenced by this Value is <function>undefined</function>.

Value

newTypedArrayWithBuffer(TypedArrayType type, long offset, long length)

Create a new typed array value with elements from an array buffer.

static Value

null_(Context context)

Create a new JSCValue referencing <function>null</function> in context.

static Value

number(Context context, double number)

Create a new JSCValue from number.

static Value

object(Context context, @Nullable MemorySegment instance, @Nullable Class jscClass)

Create a new JSCValue from instance.

void

objectDefinePropertyAccessor(String propertyName, Set<ValuePropertyFlags> flags, Type propertyType, @Nullable Callback getter, @Nullable Callback setter)

Define or modify a property with propertyName in object referenced by this Value.

void

objectDefinePropertyAccessor(String propertyName, ValuePropertyFlags flags, Type propertyType, @Nullable Callback getter, @Nullable Callback setter)

Define or modify a property with propertyName in object referenced by this Value.

void

objectDefinePropertyData(String propertyName, Set<ValuePropertyFlags> flags, @Nullable Value propertyValue)

Define or modify a property with propertyName in object referenced by this Value.

void

objectDefinePropertyData(String propertyName, ValuePropertyFlags flags, @Nullable Value propertyValue)

Define or modify a property with propertyName in object referenced by this Value.

boolean

objectDeleteProperty(String name)

Try to delete property with name from this Value.

String[]

objectEnumerateProperties()

Get the list of property names of this Value.

Value

objectGetProperty(String name)

Get property with name from this Value.

Value

objectGetPropertyAtIndex(int index)

Get property at index from this Value.

boolean

objectHasProperty(String name)

Get whether this Value has property with name.

Value

objectInvokeMethod(String name, @Nullable Value[] parameters)

Invoke method with name on object referenced by this Value, passing the given parameters.

boolean

objectIsInstanceOf(String name)

Get whether the value referenced by this Value is an instance of class name.

void

objectSetProperty(String name, Value property)

Set property with name on this Value.

void

objectSetPropertyAtIndex(int index, Value property)

Set property at index on this Value.

static Value

string(Context context, @Nullable String string)

Create a new JSCValue from string.

static Value

stringFromBytes(Context context, @Nullable Bytes bytes)

Create a new JSCValue from bytes.

boolean

toBoolean()

Convert this Value to a boolean.

double

toDouble()

Convert this Value to a double.

int

toInt32()

Convert this Value to a gint32.

String

toJson(int indent)

Create a JSON string of this Value serialization.

String

toString()

Convert this Value to a string.

Bytes

toStringAsBytes()

Convert this Value to a string and return the results as GBytes.

static Value

typedArray(Context context, TypedArrayType type, long length)

Create a new typed array containing a given amount of elements.

Value

typedArrayGetBuffer()

Obtain the ArrayBuffer for the memory region of the typed array elements.

MemorySegment

typedArrayGetData(@Nullable Out<Long> length)

Obtains a pointer to the memory region that holds the elements of the typed array; modifications done to them will be visible to JavaScript code.

long

typedArrayGetLength()

Gets the number of elements in a typed array.

long

typedArrayGetOffset()

Gets the offset over the underlying array buffer data.

long

typedArrayGetSize()

Gets the size of a typed array.

TypedArrayType

typedArrayGetType()

Gets the type of elements contained in a typed array.

static Value

undefined(Context context)

Create a new JSCValue referencing <function>undefined</function> in context.

Methods inherited from class org.gnome.gobject.GObject
addToggleRef, addWeakPointer, bindProperty, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, connect, constructed, disconnect, dispatchPropertiesChanged, dispose, dupData, dupQdata, emit, emitNotify, finalize_, forceFloating, freezeNotify, get, getData, getMemoryLayout, getProperty, getProperty, getProperty, getQdata, getv, interfaceFindProperty, interfaceInstallProperty, interfaceListProperties, isFloating, newInstance, newInstance, newInstance, newInstance, newv, notify_, notify_, notifyByPspec, onNotify, ref, refSink, removeToggleRef, removeWeakPointer, replaceData, replaceQdata, runDispose, set, setData, setDataFull, setProperty, setProperty, setProperty, setQdata, setQdataFull, setv, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref, withProperties

Methods inherited from class org.gnome.gobject.TypeInstance
callParent, callParent, getPrivate, readGClass, writeGClass

Methods inherited from class io.github.jwharm.javagi.base.ProxyInstance
equals, handle, hashCode

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details
- Value
  
  public Value(MemorySegment address)
  
  Create a Value proxy instance for the provided memory address.
  
  Parameters:
  
  address - the memory address of the native object
Method Details
- getType
  
  public static Type getType()
  
  Get the GType of the Value class
  
  Returns:
  
  the GType
- asParent
  
  protected Value asParent()
  
  Returns this instance as if it were its parent type. This is mostly synonymous to the Java super keyword, but will set the native typeclass function pointers to the parent type. When overriding a native virtual method in Java, "chaining up" with super.methodName() doesn't work, because it invokes the overridden function pointer again. To chain up, call asParent().methodName(). This will call the native function pointer of this virtual method in the typeclass of the parent type.
  
  Overrides:
  
  asParent in class GObject
- array
  
  public static Value array(Context context, Type firstItemType, Object... varargs)
  
  Create a new JSCValue referencing an array with the given items. If firstItemType is G_TYPE_NONE an empty array is created.
  
  Parameters:
  
  context - a JSCContext
  
  firstItemType - GType of first item, or G_TYPE_NONE
  
  varargs - value of the first item, followed optionally by more type/value pairs, followed by G_TYPE_NONE.
  
  Returns:
  
  a JSCValue.
  
  Throws:
  
  UnsupportedPlatformException - when run on a platform other than linux
- arrayBuffer
  public static Value arrayBuffer(Context context, @Nullable @Nullable MemorySegment data, long size)
  
  Creates a new ArrayBuffer from existing data in memory.
  The data is not copied: while this allows sharing data with JavaScript efficiently, the caller must ensure that the memory region remains valid until the newly created object is released by JSC.
  Optionally, a destroyNotify callback can be provided, which will be invoked with userData as parameter when the ArrayBuffer object is released. This is intended to be used for freeing resources related to the memory region which contains the data:
  GMappedFile *f = g_mapped_file_new (file_path, TRUE, NULL); JSCValue *value = jsc_value_new_array_buffer (context, g_mapped_file_get_contents (f), g_mapped_file_get_length (f), (GDestroyNotify) g_mapped_file_unref, f);
  
  Note that the userData can be the same value as data:
  void *bytes = g_malloc0 (100); JSCValue *value = jsc_value_new_array_buffer (context, bytes, 100, g_free, bytes);
  
  Parameters:
  
  context - A JSCContext
  
  data - Pointer to a region of memory.
  
  size - Size in bytes of the memory region.
  
  Returns:
  
  A JSCValue, or null in case of exception.
  
  Throws:
  
  UnsupportedPlatformException - when run on a platform other than linux
- arrayFromGarray
  
  public static Value arrayFromGarray(Context context, @Nullable @Nullable Value[] array)
  
  Create a new JSCValue referencing an array with the items from array. If array is null or empty a new empty array will be created. Elements of array should be pointers to a JSCValue.
  
  Parameters:
  
  context - a JSCContext
  
  array - a GPtrArray
  
  Returns:
  
  a JSCValue.
  
  Throws:
  
  UnsupportedPlatformException - when run on a platform other than linux
- arrayFromStrv
  
  public static Value arrayFromStrv(Context context, String[] strv)
  
  Create a new JSCValue referencing an array of strings with the items from strv. If array is null or empty a new empty array will be created.
  
  Parameters:
  
  context - a JSCContext
  
  strv - a null-terminated array of strings
  
  Returns:
  
  a JSCValue.
  
  Throws:
  
  UnsupportedPlatformException - when run on a platform other than linux
- boolean_
  
  public static Value boolean_(Context context, boolean value)
  
  Create a new JSCValue from value
  
  Parameters:
  
  context - a JSCContext
  
  value - a gboolean
  
  Returns:
  
  a JSCValue.
  
  Throws:
  
  UnsupportedPlatformException - when run on a platform other than linux
- fromJson
  
  public static Value fromJson(Context context, String json)
  
  Create a new JSCValue referencing a new value created by parsing json.
  
  Parameters:
  
  context - a JSCContext
  
  json - the JSON string to be parsed
  
  Returns:
  
  a JSCValue.
  
  Throws:
  
  UnsupportedPlatformException - when run on a platform other than linux
- functionVariadic
  
  public static Value functionVariadic(Context context, @Nullable @Nullable String name, Callback callback, Type returnType)
  
  Create a function in context. If name is null an anonymous function will be created. When the function is called by JavaScript or jsc_value_function_call(), callback is called receiving an GPtrArray of JSCValues with the arguments and then userData as last parameter. When the function is cleared in context, destroyNotify is called with userData as parameter.
  Note that the value returned by callback must be fully transferred. In case of boxed types, you could use G_TYPE_POINTER instead of the actual boxed GType to ensure that the instance owned by JSCClass is used. If you really want to return a new copy of the boxed type, use JSC_TYPE_VALUE and return a JSCValue created with jsc_value_new_object() that receives the copy as instance parameter.
  
  Parameters:
  
  context - a JSCContext
  
  name - the function name or null
  
  callback - a GCallback.
  
  returnType - the GType of the function return value, or G_TYPE_NONE if the function is void.
  
  Returns:
  
  a JSCValue.
  
  Throws:
  
  UnsupportedPlatformException - when run on a platform other than linux
- function
  
  public static Value function(Context context, @Nullable @Nullable String name, Callback callback, Type returnType, @Nullable @Nullable Type[] parameterTypes)
  
  Create a function in context. If name is null an anonymous function will be created. When the function is called by JavaScript or jsc_value_function_call(), callback is called receiving the function parameters and then userData as last parameter. When the function is cleared in context, destroyNotify is called with userData as parameter.
  Note that the value returned by callback must be fully transferred. In case of boxed types, you could use G_TYPE_POINTER instead of the actual boxed GType to ensure that the instance owned by JSCClass is used. If you really want to return a new copy of the boxed type, use JSC_TYPE_VALUE and return a JSCValue created with jsc_value_new_object() that receives the copy as instance parameter.
  
  Parameters:
  
  context - a JSCContext
  
  name - the function name or null
  
  callback - a GCallback.
  
  returnType - the GType of the function return value, or G_TYPE_NONE if the function is void.
  
  parameterTypes - a list of GTypes, one for each parameter, or null
  
  Returns:
  
  a JSCValue.
  
  Throws:
  
  UnsupportedPlatformException - when run on a platform other than linux
- null_
  
  public static Value null_(Context context)
  
  Create a new JSCValue referencing <function>null</function> in context.
  
  Parameters:
  
  context - a JSCContext
  
  Returns:
  
  a JSCValue.
  
  Throws:
  
  UnsupportedPlatformException - when run on a platform other than linux
- number
  
  public static Value number(Context context, double number)
  
  Create a new JSCValue from number.
  
  Parameters:
  
  context - a JSCContext
  
  number - a number
  
  Returns:
  
  a JSCValue.
  
  Throws:
  
  UnsupportedPlatformException - when run on a platform other than linux
- object
  
  public static Value object(Context context, @Nullable @Nullable MemorySegment instance, @Nullable @Nullable Class jscClass)
  
  Create a new JSCValue from instance. If instance is null a new empty object is created. When instance is provided, jscClass must be provided too. jscClass takes ownership of instance that will be freed by the GDestroyNotify passed to jsc_context_register_class().
  
  Parameters:
  
  context - a JSCContext
  
  instance - an object instance or null
  
  jscClass - the JSCClass of instance
  
  Returns:
  
  a JSCValue.
  
  Throws:
  
  UnsupportedPlatformException - when run on a platform other than linux
- string
  
  public static Value string(Context context, @Nullable @Nullable String string)
  
  Create a new JSCValue from string. If you need to create a JSCValue from a string containing null characters, use jsc_value_new_string_from_bytes() instead.
  
  Parameters:
  
  context - a JSCContext
  
  string - a null-terminated string
  
  Returns:
  
  a JSCValue.
  
  Throws:
  
  UnsupportedPlatformException - when run on a platform other than linux
- stringFromBytes
  
  public static Value stringFromBytes(Context context, @Nullable @Nullable Bytes bytes)
  
  Create a new JSCValue from bytes.
  
  Parameters:
  
  context - a JSCContext
  
  bytes - a GBytes
  
  Returns:
  
  a JSCValue.
  
  Throws:
  
  UnsupportedPlatformException - when run on a platform other than linux
- typedArray
  
  public static Value typedArray(Context context, TypedArrayType type, long length)
  
  Create a new typed array containing a given amount of elements.
  Create a JSCValue referencing a new typed array with space for length elements of a given type. As all typed arrays must have an associated ArrayBuffer, a new one of suitable size will be allocated to store the elements, which will be initialized to zero.
  The type must not be TypedArrayType.NONE.
  
  Parameters:
  
  context - a JSCContext
  
  type - the type of array elements
  
  length - number of elements in the array
  
  Returns:
  
  a JSCValue
  
  Throws:
  
  UnsupportedPlatformException - when run on a platform other than linux
- undefined
  
  public static Value undefined(Context context)
  
  Create a new JSCValue referencing <function>undefined</function> in context.
  
  Parameters:
  
  context - a JSCContext
  
  Returns:
  
  a JSCValue.
  
  Throws:
  
  UnsupportedPlatformException - when run on a platform other than linux
- arrayBufferGetData
  
  public MemorySegment arrayBufferGetData(@Nullable @Nullable MemorySegment size)
  
  Gets a pointer to memory that contains the array buffer data.
  Obtains a pointer to the memory region that holds the contents of the ArrayBuffer; modifications done to the data will be visible to JavaScript code. If size is not null, the size in bytes of the memory region will also be stored in the pointed location.
  Note that the pointer returned by this function is not guaranteed to remain the same after calls to other JSC API functions. If you plan to access the data of the ArrayBuffer later, you can keep a reference to the this Value and obtain the data pointer at a later point. Keep in mind that if JavaScript code has a chance to run, for example due to main loop events that result in JSC being called, the contents of the memory region might be modified in the meantime. Consider taking a copy of the data and using the copy instead in asynchronous code.
  
  Parameters:
  
  size - location where to store the size of the memory region.
  
  Returns:
  
  pointer to memory.
- arrayBufferGetSize
  
  public long arrayBufferGetSize()
  
  Gets the size in bytes of the array buffer.
  Obtains the size in bytes of the memory region that holds the contents of an ArrayBuffer.
  
  Returns:
  
  size, in bytes.
- constructorCall
  
  public Value constructorCall(@Nullable @Nullable Value[] parameters)
  
  Invoke <function>new</function> with constructor referenced by this Value. If nParameters is 0 no parameters will be passed to the constructor.
  
  Parameters:
  
  parameters - the JSCValues to pass as parameters to the constructor, or null
  
  Returns:
  
  a JSCValue referencing the newly created object instance.
- functionCall
  
  public Value functionCall(@Nullable @Nullable Value[] parameters)
  
  Call function referenced by this Value, passing the given parameters. If nParameters is 0 no parameters will be passed to the function.
  This function always returns a JSCValue, in case of void functions a JSCValue referencing <function>undefined</function> is returned
  
  Parameters:
  
  parameters - the JSCValues to pass as parameters to the function, or null
  
  Returns:
  
  a JSCValue with the return value of the function.
- getContext
  
  public Context getContext()
  
  Get the JSCContext in which this Value was created.
  
  Returns:
  
  the JSCValue context.
- isArray
  
  public boolean isArray()
  
  Get whether the value referenced by this Value is an array.
  
  Returns:
  
  whether the value is an array.
- isArrayBuffer
  
  public boolean isArrayBuffer()
  
  Check whether the this Value is an ArrayBuffer.
  
  Returns:
  
  whether the value is an ArrayBuffer
- isBoolean
  
  public boolean isBoolean()
  
  Get whether the value referenced by this Value is a boolean.
  
  Returns:
  
  whether the value is a boolean.
- isConstructor
  
  public boolean isConstructor()
  
  Get whether the value referenced by this Value is a constructor.
  
  Returns:
  
  whether the value is a constructor.
- isFunction
  
  public boolean isFunction()
  
  Get whether the value referenced by this Value is a function
  
  Returns:
  
  whether the value is a function.
- isNull
  
  public boolean isNull()
  
  Get whether the value referenced by this Value is <function>null</function>.
  
  Returns:
  
  whether the value is null.
- isNumber
  
  public boolean isNumber()
  
  Get whether the value referenced by this Value is a number.
  
  Returns:
  
  whether the value is a number.
- isObject
  
  public boolean isObject()
  
  Get whether the value referenced by this Value is an object.
  
  Returns:
  
  whether the value is an object.
- isString
  
  public boolean isString()
  
  Get whether the value referenced by this Value is a string
  
  Returns:
  
  whether the value is a string
- isTypedArray
  
  public boolean isTypedArray()
  
  Determines whether a value is a typed array.
  
  Returns:
  
  Whether this Value is a typed array.
- isUndefined
  
  public boolean isUndefined()
  
  Get whether the value referenced by this Value is <function>undefined</function>.
  
  Returns:
  
  whether the value is undefined.
- newTypedArrayWithBuffer
  
  public Value newTypedArrayWithBuffer(TypedArrayType type, long offset, long length)
  
  Create a new typed array value with elements from an array buffer.
  Create a JSCValue referencing a new typed array value containing elements of the given type, where the elements are stored at the memory region represented by the this Value.
  The type must not be TypedArrayType.NONE.
  The offset and length parameters can be used to indicate which part of the array buffer can be accessed through the typed array. If both are omitted (passing zero as offset, and -1 as length), the whole this Value is exposed through the typed array. Omitting the length with a non-zero offset will expose the remainder of the this Value starting at the indicated offset.
  
  Parameters:
  
  type - type of array elements.
  
  offset - offset, in bytes.
  
  length - number of array elements, or -1.
  
  Returns:
  
  a JSCValue
- objectDefinePropertyAccessor
  
  public void objectDefinePropertyAccessor(String propertyName, Set<ValuePropertyFlags> flags, Type propertyType, @Nullable @Nullable Callback getter, @Nullable @Nullable Callback setter)
  
  Define or modify a property with propertyName in object referenced by this Value. When the property value needs to be getted or set, getter and setter callbacks will be called. When the property is cleared in the JSCClass context, destroyNotify is called with userData as parameter. This is equivalent to JavaScript <function>Object.defineProperty()</function> when used with an accessor descriptor.
  Note that the value returned by getter must be fully transferred. In case of boxed types, you could use G_TYPE_POINTER instead of the actual boxed GType to ensure that the instance owned by JSCClass is used. If you really want to return a new copy of the boxed type, use JSC_TYPE_VALUE and return a JSCValue created with jsc_value_new_object() that receives the copy as instance parameter.
  Note that getter and setter are called as functions and not methods, so they don't receive an instance as first parameter. Use jsc_class_add_property() if you want to add property accessor invoked as a method.
  
  Parameters:
  
  propertyName - the name of the property to define
  
  flags - JSCValuePropertyFlags
  
  propertyType - the GType of the property
  
  getter - a GCallback to be called to get the property value
  
  setter - a GCallback to be called to set the property value
- objectDefinePropertyAccessor
  
  public void objectDefinePropertyAccessor(String propertyName, ValuePropertyFlags flags, Type propertyType, @Nullable @Nullable Callback getter, @Nullable @Nullable Callback setter)
  
  Define or modify a property with propertyName in object referenced by this Value. When the property value needs to be getted or set, getter and setter callbacks will be called. When the property is cleared in the JSCClass context, destroyNotify is called with userData as parameter. This is equivalent to JavaScript <function>Object.defineProperty()</function> when used with an accessor descriptor.
  Note that the value returned by getter must be fully transferred. In case of boxed types, you could use G_TYPE_POINTER instead of the actual boxed GType to ensure that the instance owned by JSCClass is used. If you really want to return a new copy of the boxed type, use JSC_TYPE_VALUE and return a JSCValue created with jsc_value_new_object() that receives the copy as instance parameter.
  Note that getter and setter are called as functions and not methods, so they don't receive an instance as first parameter. Use jsc_class_add_property() if you want to add property accessor invoked as a method.
  
  Parameters:
  
  propertyName - the name of the property to define
  
  flags - JSCValuePropertyFlags
  
  propertyType - the GType of the property
  
  getter - a GCallback to be called to get the property value
  
  setter - a GCallback to be called to set the property value
- objectDefinePropertyData
  
  public void objectDefinePropertyData(String propertyName, Set<ValuePropertyFlags> flags, @Nullable @Nullable Value propertyValue)
  
  Define or modify a property with propertyName in object referenced by this Value. This is equivalent to JavaScript <function>Object.defineProperty()</function> when used with a data descriptor.
  
  Parameters:
  
  propertyName - the name of the property to define
  
  flags - JSCValuePropertyFlags
  
  propertyValue - the default property value
- objectDefinePropertyData
  
  public void objectDefinePropertyData(String propertyName, ValuePropertyFlags flags, @Nullable @Nullable Value propertyValue)
  
  Define or modify a property with propertyName in object referenced by this Value. This is equivalent to JavaScript <function>Object.defineProperty()</function> when used with a data descriptor.
  
  Parameters:
  
  propertyName - the name of the property to define
  
  flags - JSCValuePropertyFlags
  
  propertyValue - the default property value
- objectDeleteProperty
  
  public boolean objectDeleteProperty(String name)
  
  Try to delete property with name from this Value. This function will return false if the property was defined without ValuePropertyFlags.CONFIGURABLE flag.
  
  Parameters:
  
  name - the property name
  
  Returns:
  
  true if the property was deleted, or false otherwise.
- objectEnumerateProperties
  
  public String[] objectEnumerateProperties()
  
  Get the list of property names of this Value. Only properties defined with ValuePropertyFlags.ENUMERABLE flag will be collected.
  
  Returns:
  
  a null-terminated array of strings containing the property names, or null if this Value doesn't have enumerable properties. Use g_strfreev() to free.
- objectGetProperty
  
  public Value objectGetProperty(String name)
  
  Get property with name from this Value.
  
  Parameters:
  
  name - the property name
  
  Returns:
  
  the property JSCValue.
- objectGetPropertyAtIndex
  
  public Value objectGetPropertyAtIndex(int index)
  
  Get property at index from this Value.
  
  Parameters:
  
  index - the property index
  
  Returns:
  
  the property JSCValue.
- objectHasProperty
  
  public boolean objectHasProperty(String name)
  
  Get whether this Value has property with name.
  
  Parameters:
  
  name - the property name
  
  Returns:
  
  true if this Value has a property with name, or false otherwise
- objectInvokeMethod
  
  public Value objectInvokeMethod(String name, @Nullable @Nullable Value[] parameters)
  
  Invoke method with name on object referenced by this Value, passing the given parameters. If nParameters is 0 no parameters will be passed to the method. The object instance will be handled automatically even when the method is a custom one registered with jsc_class_add_method(), so it should never be passed explicitly as parameter of this function.
  This function always returns a JSCValue, in case of void methods a JSCValue referencing <function>undefined</function> is returned.
  
  Parameters:
  
  name - the method name
  
  parameters - the JSCValues to pass as parameters to the method, or null
  
  Returns:
  
  a JSCValue with the return value of the method.
- objectIsInstanceOf
  
  public boolean objectIsInstanceOf(String name)
  
  Get whether the value referenced by this Value is an instance of class name.
  
  Parameters:
  
  name - a class name
  
  Returns:
  
  whether the value is an object instance of class name.
- objectSetProperty
  
  public void objectSetProperty(String name, Value property)
  
  Set property with name on this Value.
  
  Parameters:
  
  name - the property name
  
  property - the JSCValue to set
- objectSetPropertyAtIndex
  
  public void objectSetPropertyAtIndex(int index, Value property)
  
  Set property at index on this Value.
  
  Parameters:
  
  index - the property index
  
  property - the JSCValue to set
- toBoolean
  
  public boolean toBoolean()
  
  Convert this Value to a boolean.
  
  Returns:
  
  a gboolean result of the conversion.
- toDouble
  
  public double toDouble()
  
  Convert this Value to a double.
  
  Returns:
  
  a gdouble result of the conversion.
- toInt32
  
  public int toInt32()
  
  Convert this Value to a gint32.
  
  Returns:
  
  a gint32 result of the conversion.
- toJson
  
  public String toJson(int indent)
  
  Create a JSON string of this Value serialization. If indent is 0, the resulting JSON will not contain newlines. The size of the indent is clamped to 10 spaces.
  
  Parameters:
  
  indent - The number of spaces to indent when nesting.
  
  Returns:
  
  a null-terminated JSON string with serialization of this Value
- toString
  
  public String toString()
  
  Convert this Value to a string. Use jsc_value_to_string_as_bytes() instead, if you need to handle strings containing null characters.
  
  Overrides:
  
  toString in class Object
  
  Returns:
  
  a null-terminated string result of the conversion.
- toStringAsBytes
  
  public Bytes toStringAsBytes()
  
  Convert this Value to a string and return the results as GBytes. This is needed to handle strings with null characters.
  
  Returns:
  
  a GBytes with the result of the conversion.
- typedArrayGetBuffer
  
  public Value typedArrayGetBuffer()
  
  Obtain the ArrayBuffer for the memory region of the typed array elements.
  
  Returns:
  
  A JSCValue
- typedArrayGetData
  public MemorySegment typedArrayGetData(@Nullable @Nullable Out<Long> length)
  
  Obtains a pointer to the memory region that holds the elements of the typed array; modifications done to them will be visible to JavaScript code. If length is not null, the number of elements contained in the typed array are also stored in the pointed location.
  The returned pointer needs to be casted to the appropriate type (see JSCTypedArrayType), and has the offset over the underlying array buffer data applied—that is, points to the first element of the typed array:
  if (jsc_value_typed_array_get_type(value) != JSC_TYPED_ARRAY_UINT32) g_error ("Only arrays of uint32_t are supported"); gsize count = 0; uint32_t *elements = jsc_value_typed_array_get_contents (value, &count); for (gsize i = 0; i < count; i++) g_print ("index %zu, value %" PRIu32 "\\n", i, elements[i]);
  
  Note that the pointer returned by this function is not guaranteed to remain the same after calls to other JSC API functions. See jsc_value_array_buffer_get_data() for details.
  
  Parameters:
  
  length - location to return the number of elements contained
  
  Returns:
  
  pointer to memory.
- typedArrayGetLength
  
  public long typedArrayGetLength()
  
  Gets the number of elements in a typed array.
  
  Returns:
  
  number of elements.
- typedArrayGetOffset
  
  public long typedArrayGetOffset()
  
  Gets the offset over the underlying array buffer data.
  
  Returns:
  
  offset, in bytes.
- typedArrayGetSize
  
  public long typedArrayGetSize()
  
  Gets the size of a typed array.
  
  Returns:
  
  size, in bytes.
- typedArrayGetType
  
  public TypedArrayType typedArrayGetType()
  
  Gets the type of elements contained in a typed array.
  
  Returns:
  
  type of the elements, or TypedArrayType.NONE if this Value is not a typed array.
- builder
  
  public static Value.Builder<? extends Value.Builder> builder()
  
  A Value.Builder object constructs a Value with the specified properties. Use the various set...() methods to set properties, and finish construction with Value.Builder.build().

Class Value

Nested Class Summary

Nested classes/interfaces inherited from class org.gnome.gobject.GObject

Constructor Summary

Method Summary

Methods inherited from class org.gnome.gobject.GObject

Methods inherited from class org.gnome.gobject.TypeInstance

Methods inherited from class io.github.jwharm.javagi.base.ProxyInstance

Methods inherited from class java.lang.Object

Constructor Details

Value

Method Details

getType

asParent

array

arrayBuffer

arrayFromGarray

arrayFromStrv

boolean_

fromJson

functionVariadic

function

null_

number

object

string

stringFromBytes

typedArray

undefined

arrayBufferGetData

arrayBufferGetSize

constructorCall

functionCall

getContext

isArray

isArrayBuffer

isBoolean

isConstructor

isFunction

isNull

isNumber

isObject

isString

isTypedArray

isUndefined

newTypedArrayWithBuffer

objectDefinePropertyAccessor

objectDefinePropertyAccessor

objectDefinePropertyData

objectDefinePropertyData

objectDeleteProperty

objectEnumerateProperties

objectGetProperty

objectGetPropertyAtIndex

objectHasProperty

objectInvokeMethod

objectIsInstanceOf

objectSetProperty

objectSetPropertyAtIndex

toBoolean

toDouble

toInt32

toJson

toString

toStringAsBytes

typedArrayGetBuffer

typedArrayGetData

typedArrayGetLength

typedArrayGetOffset

typedArrayGetSize

typedArrayGetType

builder