com.caoccao.javet.interop.V8Runtime Maven / Gradle / Ivy
Show all versions of javet-linux-arm64 Show documentation
/*
* Copyright (c) 2021-2024. caoccao.com Sam Cao
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.caoccao.javet.interop;
import com.caoccao.javet.annotations.CheckReturnValue;
import com.caoccao.javet.enums.*;
import com.caoccao.javet.exceptions.*;
import com.caoccao.javet.interfaces.IEnumBitset;
import com.caoccao.javet.interfaces.IJavetClosable;
import com.caoccao.javet.interfaces.IJavetLogger;
import com.caoccao.javet.interop.callback.*;
import com.caoccao.javet.interop.converters.IJavetConverter;
import com.caoccao.javet.interop.converters.JavetObjectConverter;
import com.caoccao.javet.interop.executors.IV8Executor;
import com.caoccao.javet.interop.executors.V8FileExecutor;
import com.caoccao.javet.interop.executors.V8PathExecutor;
import com.caoccao.javet.interop.executors.V8StringExecutor;
import com.caoccao.javet.interop.monitoring.V8HeapSpaceStatistics;
import com.caoccao.javet.interop.monitoring.V8HeapStatistics;
import com.caoccao.javet.interop.monitoring.V8SharedMemoryStatistics;
import com.caoccao.javet.interop.monitoring.V8StatisticsFuture;
import com.caoccao.javet.interop.options.RuntimeOptions;
import com.caoccao.javet.utils.JavetDefaultLogger;
import com.caoccao.javet.utils.JavetResourceUtils;
import com.caoccao.javet.utils.SimpleMap;
import com.caoccao.javet.utils.StringUtils;
import com.caoccao.javet.values.IV8ValueNonProxyable;
import com.caoccao.javet.values.V8Value;
import com.caoccao.javet.values.primitive.*;
import com.caoccao.javet.values.reference.*;
import com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol;
import com.caoccao.javet.values.virtual.V8VirtualValue;
import java.io.File;
import java.math.BigInteger;
import java.nio.ByteBuffer;
import java.nio.file.Path;
import java.text.MessageFormat;
import java.time.ZonedDateTime;
import java.util.*;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.CopyOnWriteArrayList;
import static com.caoccao.javet.exceptions.JavetError.PARAMETER_FEATURE;
/**
* The representation of a V8 isolate (and V8 context).
*
* Javet simplifies the V8 runtime model to 1 runtime - 1 isolate - 1 context,
* though in V8 1 isolate can host multiple contexts.
*
* V8 runtime exposes many useful methods and callbacks that allow low level
* interaction with the V8 isolate or context.
*
* @since 0.7.0
*/
@SuppressWarnings("unchecked")
public class V8Runtime implements IJavetClosable, IV8Creatable, IV8Convertible {
/**
* The constant ERROR_BYTE_BUFFER_MUST_BE_DIRECT.
*
* @since 2.2.0
*/
protected static final String ERROR_BYTE_BUFFER_MUST_BE_DIRECT = "Byte buffer must be direct.";
/**
* The constant ERROR_HANDLE_MUST_BE_VALID.
*
* @since 2.2.0
*/
protected static final String ERROR_HANDLE_MUST_BE_VALID = "Handle must be valid.";
/**
* The constant ERROR_SYMBOL_DESCRIPTION_CANNOT_BE_EMPTY.
*
* @since 2.2.0
*/
protected static final String ERROR_SYMBOL_DESCRIPTION_CANNOT_BE_EMPTY = "Symbol description cannot be empty.";
/**
* The constant ERROR_THE_KEY_VALUE_PAIR_MUST_MATCH.
*
* @since 2.2.0
*/
protected static final String ERROR_THE_KEY_VALUE_PAIR_MUST_MATCH = "The key value pair must match.";
/**
* The constant ERROR_THE_PROPERTY_NAME_MUST_BE_EITHER_STRING_OR_SYMBOL.
*
* @since 2.2.0
*/
protected static final String ERROR_THE_PROPERTY_NAME_MUST_BE_EITHER_STRING_OR_SYMBOL =
"The property name must be either string or symbol.";
/**
* The constant ERROR_VALUE_CANNOT_BE_A_V_8_CONTEXT.
*
* @since 3.0.4
*/
protected static final String ERROR_VALUE_CANNOT_BE_A_V_8_CONTEXT = "Value cannot be a V8 context.";
/**
* The constant ERROR_VALUE_CANNOT_BE_A_V_8_MODULE.
*
* @since 3.0.4
*/
protected static final String ERROR_VALUE_CANNOT_BE_A_V_8_MODULE = "Value cannot be a V8 module.";
/**
* The constant ERROR_VALUE_CANNOT_BE_A_V_8_SCRIPT.
*
* @since 3.0.4
*/
protected static final String ERROR_VALUE_CANNOT_BE_A_V_8_SCRIPT = "Value cannot be a V8 script.";
/**
* The Default converter.
*
* @since 0.8.5
*/
static final IJavetConverter DEFAULT_CONVERTER = new JavetObjectConverter();
/**
* The Default message format javet inspector.
*
* @since 0.7.3
*/
static final String DEFAULT_MESSAGE_FORMAT_JAVET_INSPECTOR = "Javet Inspector {0}";
/**
* The Invalid handle.
*
* @since 0.7.0
*/
static final long INVALID_HANDLE = 0L;
/**
* The Property data view.
*
* @since 0.7.2
*/
static final String PROPERTY_DATA_VIEW = "DataView";
/**
* The V8 value boolean false index.
*
* @since 0.7.4
*/
static final int V8_VALUE_BOOLEAN_FALSE_INDEX = 0;
/**
* The V8 value boolean true index.
*
* @since 0.7.4
*/
static final int V8_VALUE_BOOLEAN_TRUE_INDEX = 1;
/**
* The V8 value number lower bound.
*
* @since 0.7.4
*/
static final int V8_VALUE_NUMBER_LOWER_BOUND = -128; // Inclusive
/**
* The V8 value number upper bound.
*
* @since 0.7.4
*/
static final int V8_VALUE_NUMBER_UPPER_BOUND = 128; // Exclusive
/**
* The Callback context lock.
*
* @since 0.9.12
*/
final Object callbackContextLock;
/**
* The Callback context map.
*
* V8 may not make final callback when V8 context is being recycled.
* That may result in memory leak.
* Callback context map is designed for closing that memory leak issue.
*
* @since 0.8.3
*/
final Map callbackContextMap;
/**
* The GC epilogue callbacks.
*
* @since 1.0.3
*/
final List gcEpilogueCallbacks;
/**
* The GC prologue callbacks.
*
* @since 1.0.3
*/
final List gcPrologueCallbacks;
/**
* The Primitive flags is for passing the calling succession in JNI calls.
* Its length is 1. True: success. False: failure.
*
* @since 2.2.0
*/
final boolean[] primitiveFlags;
/**
* The Reference lock.
*
* @since 0.9.12
*/
final Object referenceLock;
/**
* The Reference map.
*
* @since 0.7.0
*/
final Map referenceMap;
/**
* The Runtime options.
*
* @since 1.0.0
*/
final RuntimeOptions runtimeOptions;
/**
* The V8 host.
*
* @since 0.7.0
*/
final V8Host v8Host;
/**
* The V8 internal.
*
* @since 1.0.2
*/
final V8Internal v8Internal;
/**
* The V8 module lock.
*
* @since 0.9.12
*/
final Object v8ModuleLock;
/**
* The V8 module map.
*
* @since 0.9.12
*/
final Map v8ModuleMap;
/**
* The Cached V8 value booleans.
*
* @since 0.7.4
*/
V8ValueBoolean[] cachedV8ValueBooleans;
/**
* The Cached V8 value integers.
*
* @since 0.7.4
*/
V8ValueInteger[] cachedV8ValueIntegers;
/**
* The Cached V8 value longs.
*
* @since 0.7.4
*/
V8ValueLong[] cachedV8ValueLongs;
/**
* The Cached V8 value null.
*
* @since 0.7.4
*/
V8ValueNull cachedV8ValueNull;
/**
* The Cached V8 value undefined.
*
* @since 0.7.4
*/
V8ValueUndefined cachedV8ValueUndefined;
/**
* The Close lock.
*
* @since 3.1.3
*/
Object closeLock;
/**
* The Converter.
*
* @since 0.7.0
*/
IJavetConverter converter;
/**
* The GC scheduled.
*
* @since 0.8.3
*/
boolean gcScheduled;
/**
* The Handle.
*
* @since 0.7.0
*/
long handle;
/**
* The Logger.
*
* @since 0.7.0
*/
IJavetLogger logger;
/**
* The Pooled.
*
* @since 0.7.0
*/
boolean pooled;
/**
* The Promise reject callback.
*
* @since 0.8.3
*/
IJavetPromiseRejectCallback promiseRejectCallback;
/**
* The V8 inspector.
*
* @since 0.7.3
*/
V8Inspector v8Inspector;
/**
* The V8 module resolver.
*
* @since 0.9.3
*/
IV8ModuleResolver v8ModuleResolver;
/**
* The V8 native.
*
* @since 0.7.0
*/
IV8Native v8Native;
/**
* Instantiates a new V8 runtime.
*
* @param v8Host the V8 host
* @param handle the handle
* @param pooled the pooled
* @param v8Native the V8 native
* @param runtimeOptions the runtime options
* @since 0.7.0
*/
V8Runtime(V8Host v8Host, long handle, boolean pooled, IV8Native v8Native, RuntimeOptions runtimeOptions) {
assert handle != INVALID_HANDLE : ERROR_HANDLE_MUST_BE_VALID;
callbackContextLock = new Object();
callbackContextMap = new HashMap<>();
closeLock = new Object();
converter = DEFAULT_CONVERTER;
gcEpilogueCallbacks = new CopyOnWriteArrayList<>();
gcPrologueCallbacks = new CopyOnWriteArrayList<>();
gcScheduled = false;
this.runtimeOptions = Objects.requireNonNull(runtimeOptions);
this.handle = handle;
logger = new JavetDefaultLogger(getClass().getName());
this.pooled = pooled;
primitiveFlags = new boolean[1];
promiseRejectCallback = new JavetPromiseRejectCallback(logger);
referenceLock = new Object();
referenceMap = new HashMap<>();
this.v8Host = Objects.requireNonNull(v8Host);
v8Inspector = null;
this.v8Native = Objects.requireNonNull(v8Native);
v8ModuleLock = new Object();
v8ModuleMap = new HashMap<>();
v8ModuleResolver = null;
v8Internal = new V8Internal(this);
initializeV8ValueCache();
}
/**
* Add GC epilogue callback.
*
* @param iJavetGCCallback the javet GC callback
* @since 1.0.3
*/
public void addGCEpilogueCallback(IJavetGCCallback iJavetGCCallback) {
synchronized (gcEpilogueCallbacks) {
boolean registered = !gcEpilogueCallbacks.isEmpty();
gcEpilogueCallbacks.add(Objects.requireNonNull(iJavetGCCallback));
if (!registered) {
v8Native.registerGCEpilogueCallback(handle);
}
}
}
/**
* Add GC prologue callback.
*
* @param iJavetGCCallback the javet GC callback
* @since 1.0.3
*/
public void addGCPrologueCallback(IJavetGCCallback iJavetGCCallback) {
synchronized (gcPrologueCallbacks) {
boolean registered = !gcPrologueCallbacks.isEmpty();
gcPrologueCallbacks.add(Objects.requireNonNull(iJavetGCCallback));
if (!registered) {
v8Native.registerGCPrologueCallback(handle);
}
}
}
/**
* Add reference.
*
* @param iV8ValueReference the V8 value reference
* @since 1.0.3
*/
void addReference(IV8ValueReference iV8ValueReference) {
synchronized (referenceLock) {
referenceMap.put(iV8ValueReference.getHandle(), iV8ValueReference);
}
}
/**
* Add V8 module.
*
* @param iV8Module the V8 module
* @throws JavetException the javet exception
* @since 0.9.1
*/
public void addV8Module(IV8Module iV8Module) throws JavetException {
String resourceName = Objects.requireNonNull(iV8Module.getResourceName());
if (StringUtils.isNotEmpty(resourceName)) {
synchronized (v8ModuleLock) {
if (containsV8Module(resourceName)) {
removeV8Module(resourceName, true);
}
v8ModuleMap.put(resourceName, iV8Module);
}
}
}
/**
* Allow eval().
*
* @param allow true : allow eval(), false : disallow eval()
* @since 0.8.0
*/
public void allowEval(boolean allow) {
v8Native.allowCodeGenerationFromStrings(handle, allow);
}
/**
* Gets length from an array.
*
* @param iV8ValueArray the V8 value array
* @return the length
* @throws JavetException the javet exception
* @since 0.7.0
*/
@SuppressWarnings("RedundantThrows")
int arrayGetLength(IV8ValueArray iV8ValueArray) throws JavetException {
return v8Native.arrayGetLength(handle, iV8ValueArray.getHandle(), iV8ValueArray.getType().getId());
}
/**
* Gets length from a typed array.
*
* @param iV8ValueTypedArray the V8 value typed array
* @return the length
* @throws JavetException the javet exception
* @since 0.8.4
*/
@SuppressWarnings("RedundantThrows")
int arrayGetLength(IV8ValueTypedArray iV8ValueTypedArray) throws JavetException {
return v8Native.arrayGetLength(handle, iV8ValueTypedArray.getHandle(), iV8ValueTypedArray.getType().getId());
}
/**
* Await tells the V8 runtime to pump the message loop in a non-blocking manner.
*
* @return true : there are more tasks, false : there are no more tasks
* @since 0.8.0
*/
public boolean await() {
return await(V8AwaitMode.RunTillNoMoreTasks);
}
/**
* Await tells the V8 runtime to pump the message loop in a non-blocking manner.
*
* In the Node.js mode, the V8 await mode takes effect.
* In the V8 mode, the V8 await mode takes no effect and the return is always false.
*
* @param v8AwaitMode the V8 await mode
* @return true : there are more tasks, false : there are no more tasks
* @since 2.0.4
*/
public boolean await(V8AwaitMode v8AwaitMode) {
return v8Native.await(handle, Objects.requireNonNull(v8AwaitMode).getId());
}
/**
* Get the given range of items from the array.
*
* @param iV8ValueArray the V8 value array
* @param v8Values the V8 values
* @param startIndex the start index
* @param endIndex the end index
* @return the actual item count
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
int batchArrayGet(
IV8ValueArray iV8ValueArray, V8Value[] v8Values, int startIndex, int endIndex)
throws JavetException {
return v8Native.batchArrayGet(
handle, iV8ValueArray.getHandle(), iV8ValueArray.getType().getId(),
v8Values, startIndex, endIndex);
}
/**
* Batch get a range of values by keys.
*
* @param iV8ValueObject the V8 value object
* @param v8ValueKeys the V8 value keys
* @param v8ValueValues the V8 value values
* @param length the length
* @return the actual item count
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
int batchObjectGet(
IV8ValueObject iV8ValueObject, V8Value[] v8ValueKeys, V8Value[] v8ValueValues, int length)
throws JavetException {
return v8Native.batchObjectGet(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(),
v8ValueKeys, v8ValueValues, length);
}
/**
* From boolean object to boolean.
*
* @param v8ValueBooleanObject the V8 value boolean object
* @return the V8 value boolean
* @since 3.0.4
*/
V8ValueBoolean booleanObjectValueOf(V8ValueBooleanObject v8ValueBooleanObject) {
return (V8ValueBoolean) v8Native.booleanObjectValueOf(
handle,
Objects.requireNonNull(v8ValueBooleanObject).getHandle(),
v8ValueBooleanObject.getType().getId());
}
/**
* Set a reference to a strong reference.
*
* @param iV8ValueReference the V8 value reference
* @throws JavetException the javet exception
* @since 0.7.0
*/
@SuppressWarnings("RedundantThrows")
void clearWeak(IV8ValueReference iV8ValueReference) throws JavetException {
v8Native.clearWeak(handle, iV8ValueReference.getHandle(), iV8ValueReference.getType().getId());
}
/**
* Clone a V8 value.
*
* @param the type parameter
* @param iV8ValueReference the V8 value reference
* @param referenceCopy the reference copy
* @return the cloned V8 value
* @throws JavetException the javet exception
* @since 0.7.0
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
T cloneV8Value(
IV8ValueReference iV8ValueReference,
boolean referenceCopy)
throws JavetException {
return (T) v8Native.cloneV8Value(
handle, iV8ValueReference.getHandle(), iV8ValueReference.getType().getId(), referenceCopy);
}
@Override
public void close() throws JavetException {
close(!pooled);
}
/**
* Close by a force close flag.
*
* @param forceClose the force close
* @throws JavetException the javet exception
* @since 0.7.0
*/
public void close(boolean forceClose) throws JavetException {
if (!isClosed() && forceClose) {
removeAllReferences();
synchronized (closeLock) {
v8Host.closeV8Runtime(this);
handle = INVALID_HANDLE;
v8Native = null;
}
}
}
/**
* Compile a V8 module and add that V8 module to the internal V8 module map.
*
* @param scriptString the script string
* @param cachedData the cached data
* @param v8ScriptOrigin the V8 script origin
* @param resultRequired the result required
* @return the compiled V8 module or null
* @throws JavetException the javet exception
* @since 0.8.0
*/
@CheckReturnValue
public V8Module compileV8Module(
String scriptString, byte[] cachedData, V8ScriptOrigin v8ScriptOrigin, boolean resultRequired)
throws JavetException {
v8ScriptOrigin.setModule(true);
if (StringUtils.isEmpty(v8ScriptOrigin.getResourceName())) {
throw new JavetException(JavetError.ModuleNameEmpty);
}
Object result = v8Native.moduleCompile(
handle, scriptString, cachedData, resultRequired, v8ScriptOrigin.getResourceName(),
v8ScriptOrigin.getResourceLineOffset(), v8ScriptOrigin.getResourceColumnOffset(),
v8ScriptOrigin.getScriptId(), v8ScriptOrigin.isWasm(), v8ScriptOrigin.isModule());
V8Module v8Module = null;
if (resultRequired && result instanceof V8Module) {
v8Module = (V8Module) result;
addV8Module(v8Module);
}
return v8Module;
}
/**
* Compile a V8 script.
*
* @param scriptString the script string
* @param cachedData the cached data
* @param v8ScriptOrigin the V8 script origin
* @param resultRequired the result required
* @return the V8 script
* @throws JavetException the javet exception
* @since 0.9.13
*/
@CheckReturnValue
@SuppressWarnings("RedundantThrows")
public V8Script compileV8Script(
String scriptString, byte[] cachedData, V8ScriptOrigin v8ScriptOrigin, boolean resultRequired)
throws JavetException {
v8ScriptOrigin.setModule(false);
return (V8Script) v8Native.scriptCompile(
handle, scriptString, cachedData, resultRequired, v8ScriptOrigin.getResourceName(),
v8ScriptOrigin.getResourceLineOffset(), v8ScriptOrigin.getResourceColumnOffset(),
v8ScriptOrigin.getScriptId(), v8ScriptOrigin.isWasm(), v8ScriptOrigin.isModule());
}
/**
* Compile V8 value function.
*
* @param scriptString the script string
* @param cachedData the cached data
* @param v8ScriptOrigin the V8 script origin
* @param arguments the arguments
* @param contextExtensions the context extensions
* @return the V8 value function
* @throws JavetException the javet exception
* @since 2.0.3
*/
@CheckReturnValue
@SuppressWarnings("RedundantThrows")
public V8ValueFunction compileV8ValueFunction(
String scriptString, byte[] cachedData, V8ScriptOrigin v8ScriptOrigin,
String[] arguments, V8ValueObject[] contextExtensions)
throws JavetException {
return (V8ValueFunction) v8Native.functionCompile(
handle, scriptString, cachedData, v8ScriptOrigin.getResourceName(),
v8ScriptOrigin.getResourceLineOffset(), v8ScriptOrigin.getResourceColumnOffset(),
v8ScriptOrigin.getScriptId(), v8ScriptOrigin.isWasm(),
arguments, contextExtensions);
}
/**
* Contains a V8 module by resource name.
*
* @param resourceName the resource name
* @return true : yes, false : no
* @since 0.8.1
*/
public boolean containsV8Module(String resourceName) {
synchronized (v8ModuleLock) {
return v8ModuleMap.containsKey(resourceName);
}
}
/**
* Gets element by index.
*
* @param the type parameter
* @param iV8Context the V8 context
* @param index the index
* @return the t
* @throws JavetException the javet exception
*/
@CheckReturnValue
@SuppressWarnings("RedundantThrows")
T contextGet(IV8Context iV8Context, int index) throws JavetException {
return (T) v8Native.contextGet(handle, iV8Context.getHandle(), iV8Context.getType().getId(), index);
}
/**
* Gets the context element length.
*
* @param iV8Context the V8 context
* @return the element length
* @throws JavetException the javet exception
* @since 2.0.1
*/
@SuppressWarnings("RedundantThrows")
int contextGetLength(IV8Context iV8Context) throws JavetException {
return v8Native.contextGetLength(handle, iV8Context.getHandle(), iV8Context.getType().getId());
}
/**
* Tests the given context type.
*
* @param iV8Context the V8 context
* @param contextTypeId the context type id
* @return true : yes, false : no
* @throws JavetException the javet exception
*/
@SuppressWarnings("RedundantThrows")
boolean contextIsContextType(IV8Context iV8Context, int contextTypeId) throws JavetException {
return v8Native.contextIsContextType(
handle, iV8Context.getHandle(), iV8Context.getType().getId(), contextTypeId);
}
/**
* Sets the content element length.
*
* @param iV8Context the V8 context
* @param length the element length
* @return true : success, false: failure
* @throws JavetException the javet exception
* @since 2.0.1
*/
@SuppressWarnings("RedundantThrows")
boolean contextSetLength(IV8Context iV8Context, int length) throws JavetException {
return v8Native.contextSetLength(handle, iV8Context.getHandle(), iV8Context.getType().getId(), length);
}
/**
* Create snapshot in byte array.
*
* @return the byte array
* @throws JavetException the javet exception
* @see Custom startup snapshots
* @since 3.0.3
*/
public byte[] createSnapshot() throws JavetException {
if (!runtimeOptions.isCreateSnapshotEnabled()) {
throw new JavetException(JavetError.RuntimeCreateSnapshotDisabled);
}
final int callbackContextCount = getCallbackContextCount();
final int referenceCount = getReferenceCount();
final int v8ModuleCount = getV8ModuleCount();
if (callbackContextCount > 0 || referenceCount > 0 || v8ModuleCount > 0) {
throw new JavetException(JavetError.RuntimeCreateSnapshotBlocked, SimpleMap.of(
JavetError.PARAMETER_CALLBACK_CONTEXT_COUNT, callbackContextCount,
JavetError.PARAMETER_REFERENCE_COUNT, referenceCount,
JavetError.PARAMETER_V8_MODULE_COUNT, v8ModuleCount));
}
return v8Native.snapshotCreate(handle);
}
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
@Override
public V8Module createV8Module(String moduleName, IV8ValueObject iV8ValueObject) throws JavetException {
if (StringUtils.isEmpty(moduleName)) {
throw new JavetException(JavetError.ModuleNameEmpty);
}
Objects.requireNonNull(iV8ValueObject);
V8Module v8Module = (V8Module) v8Native.moduleCreate(
handle, moduleName, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId());
if (v8Module != null) {
addV8Module(v8Module);
}
return v8Module;
}
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
@Override
public V8ValueArray createV8ValueArray() throws JavetException {
return (V8ValueArray) v8Native.arrayCreate(handle);
}
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
@Override
public V8ValueArrayBuffer createV8ValueArrayBuffer(int length) throws JavetException {
return (V8ValueArrayBuffer) v8Native.arrayBufferCreate(handle, length);
}
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
@Override
public V8ValueArrayBuffer createV8ValueArrayBuffer(ByteBuffer byteBuffer) throws JavetException {
Objects.requireNonNull(byteBuffer);
assert byteBuffer.isDirect() : ERROR_BYTE_BUFFER_MUST_BE_DIRECT;
return (V8ValueArrayBuffer) v8Native.arrayBufferCreate(handle, byteBuffer);
}
@Override
public V8ValueBigInteger createV8ValueBigInteger(BigInteger bigInteger) throws JavetException {
return new V8ValueBigInteger(this, bigInteger);
}
@Override
public V8ValueBigInteger createV8ValueBigInteger(String bigIntegerValue) throws JavetException {
return new V8ValueBigInteger(this, bigIntegerValue);
}
@Override
@SuppressWarnings("RedundantThrows")
public V8ValueBoolean createV8ValueBoolean(boolean booleanValue) throws JavetException {
return cachedV8ValueBooleans[booleanValue ? V8_VALUE_BOOLEAN_TRUE_INDEX : V8_VALUE_BOOLEAN_FALSE_INDEX];
}
@Override
public V8ValueBooleanObject createV8ValueBooleanObject(boolean booleanValue) throws JavetException {
return (V8ValueBooleanObject) v8Native.booleanObjectCreate(handle, booleanValue);
}
@CheckReturnValue
@Override
public V8ValueDataView createV8ValueDataView(V8ValueArrayBuffer v8ValueArrayBuffer) throws JavetException {
Objects.requireNonNull(v8ValueArrayBuffer);
try (V8Value v8Value = getExecutor(PROPERTY_DATA_VIEW).execute()) {
if (v8Value instanceof V8ValueFunction) {
V8ValueFunction v8ValueFunction = (V8ValueFunction) v8Value;
return v8ValueFunction.callAsConstructor(v8ValueArrayBuffer);
}
}
throw new JavetException(JavetError.NotSupported, SimpleMap.of(PARAMETER_FEATURE, PROPERTY_DATA_VIEW));
}
@Override
public V8ValueDouble createV8ValueDouble(double doubleValue) throws JavetException {
return new V8ValueDouble(this, doubleValue);
}
@Override
public V8ValueDoubleObject createV8ValueDoubleObject(double doubleValue) throws JavetException {
return (V8ValueDoubleObject) v8Native.doubleObjectCreate(handle, doubleValue);
}
@CheckReturnValue
@Override
public V8ValueError createV8ValueError(V8ValueErrorType v8ValueErrorType, String message) throws JavetException {
return (V8ValueError) v8Native.errorCreate(
handle, Objects.requireNonNull(v8ValueErrorType).getId(), Objects.requireNonNull(message));
}
@CheckReturnValue
@Override
public V8ValueFunction createV8ValueFunction(JavetCallbackContext javetCallbackContext) throws JavetException {
V8ValueFunction v8ValueFunction = (V8ValueFunction) v8Native.functionCreate(
handle, Objects.requireNonNull(javetCallbackContext));
synchronized (callbackContextLock) {
callbackContextMap.put(javetCallbackContext.getHandle(), javetCallbackContext);
}
return v8ValueFunction;
}
@CheckReturnValue
@Override
public V8ValueFunction createV8ValueFunction(String codeString) throws JavetException {
return getExecutor(codeString).execute();
}
@Override
public V8ValueInteger createV8ValueInteger(int integerValue) throws JavetException {
if (integerValue >= V8_VALUE_NUMBER_LOWER_BOUND && integerValue < V8_VALUE_NUMBER_UPPER_BOUND) {
return cachedV8ValueIntegers[integerValue - V8_VALUE_NUMBER_LOWER_BOUND];
}
return new V8ValueInteger(this, integerValue);
}
@Override
public V8ValueIntegerObject createV8ValueIntegerObject(int intValue) throws JavetException {
// V8 NumberObject is always mapped to double. An internal conversion is required.
return ((V8ValueDoubleObject) v8Native.integerObjectCreate(handle, intValue)).toIntegerObject();
}
@Override
public V8ValueLong createV8ValueLong(long longValue) throws JavetException {
if (longValue >= V8_VALUE_NUMBER_LOWER_BOUND && longValue < V8_VALUE_NUMBER_UPPER_BOUND) {
return cachedV8ValueLongs[(int) longValue - V8_VALUE_NUMBER_LOWER_BOUND];
}
return new V8ValueLong(this, longValue);
}
@Override
public V8ValueLongObject createV8ValueLongObject(long longValue) throws JavetException {
return (V8ValueLongObject) v8Native.longObjectCreate(handle, longValue);
}
@CheckReturnValue
@SuppressWarnings("RedundantThrows")
@Override
public V8ValueMap createV8ValueMap() throws JavetException {
return (V8ValueMap) v8Native.mapCreate(handle);
}
@Override
public V8ValueNull createV8ValueNull() {
return cachedV8ValueNull;
}
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
@Override
public V8ValueObject createV8ValueObject() throws JavetException {
return (V8ValueObject) v8Native.objectCreate(handle);
}
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
@Override
public V8ValuePromise createV8ValuePromise() throws JavetException {
return (V8ValuePromise) v8Native.promiseCreate(handle);
}
@CheckReturnValue
@Override
public V8ValueProxy createV8ValueProxy(V8Value v8Value) throws JavetException {
if (v8Value instanceof IV8ValueNonProxyable) {
throw new JavetException(
JavetError.NotSupported,
SimpleMap.of(PARAMETER_FEATURE, v8Value.toString()));
}
return (V8ValueProxy) v8Native.proxyCreate(handle, v8Value);
}
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
@Override
public V8ValueSet createV8ValueSet() throws JavetException {
return (V8ValueSet) v8Native.setCreate(handle);
}
@Override
public V8ValueString createV8ValueString(String str) throws JavetException {
return new V8ValueString(this, str);
}
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
@Override
public V8ValueStringObject createV8ValueStringObject(String str) throws JavetException {
return (V8ValueStringObject) v8Native.stringObjectCreate(handle, str);
}
@Override
@CheckReturnValue
public V8ValueSymbol createV8ValueSymbol(String description, boolean global) throws JavetException {
assert !StringUtils.isEmpty(description) : ERROR_SYMBOL_DESCRIPTION_CANNOT_BE_EMPTY;
if (global) {
try (V8ValueBuiltInSymbol v8ValueBuiltInSymbol = getGlobalObject().getBuiltInSymbol()) {
return v8ValueBuiltInSymbol._for(description);
}
} else {
return (V8ValueSymbol) v8Native.symbolCreate(handle, description);
}
}
@Override
@CheckReturnValue
public V8ValueTypedArray createV8ValueTypedArray(V8ValueReferenceType type, int length) throws JavetException {
try (V8Value v8Value = getGlobalObject().get(type.getName())) {
if (v8Value instanceof V8ValueFunction) {
V8ValueFunction v8ValueFunction = (V8ValueFunction) v8Value;
return v8ValueFunction.callAsConstructor(createV8ValueInteger(length));
}
}
throw new JavetException(JavetError.NotSupported, SimpleMap.of(PARAMETER_FEATURE, type.getName()));
}
@Override
public V8ValueUndefined createV8ValueUndefined() {
return cachedV8ValueUndefined;
}
@Override
public V8ValueZonedDateTime createV8ValueZonedDateTime(long jsTimestamp) throws JavetException {
return new V8ValueZonedDateTime(this, jsTimestamp);
}
@Override
public V8ValueZonedDateTime createV8ValueZonedDateTime(ZonedDateTime zonedDateTime) throws JavetException {
return new V8ValueZonedDateTime(this, zonedDateTime);
}
/**
* From double object to either double or integer.
*
* @param v8ValueDoubleObject the V8 value double object
* @return the V8 value number
* @since 3.0.4
*/
V8ValueNumber doubleObjectValueOf(V8ValueDoubleObject v8ValueDoubleObject) {
return (V8ValueNumber) v8Native.doubleObjectValueOf(
handle, Objects.requireNonNull(v8ValueDoubleObject).getHandle(), v8ValueDoubleObject.getType().getId());
}
/**
* Equals tells whether 2 references are reference equal or not.
*
* @param iV8ValueReference1 the V8 value reference 1
* @param iV8ValueReference2 the V8 value reference 2
* @return true : yes, false : no
* @throws JavetException the javet exception
* @since 0.7.2
*/
@SuppressWarnings("RedundantThrows")
boolean equals(IV8ValueReference iV8ValueReference1, IV8ValueReference iV8ValueReference2)
throws JavetException {
return v8Native.equals(handle, iV8ValueReference1.getHandle(), iV8ValueReference2.getHandle());
}
/**
* Execute a script or module.
*
* @param the type parameter
* @param scriptString the script string
* @param cachedData the cached data
* @param v8ScriptOrigin the V8 script origin
* @param resultRequired the result required
* @return the result
* @throws JavetException the javet exception
* @since 0.7.0
*/
@CheckReturnValue
public T execute(
String scriptString, byte[] cachedData, V8ScriptOrigin v8ScriptOrigin, boolean resultRequired)
throws JavetException {
if (v8ScriptOrigin.isModule()) {
return (T) v8Native.moduleExecute(
handle, scriptString, cachedData, resultRequired, v8ScriptOrigin.getResourceName(),
v8ScriptOrigin.getResourceLineOffset(), v8ScriptOrigin.getResourceColumnOffset(),
v8ScriptOrigin.getScriptId(), v8ScriptOrigin.isWasm());
} else {
return (T) v8Native.scriptExecute(
handle, scriptString, cachedData, resultRequired, v8ScriptOrigin.getResourceName(),
v8ScriptOrigin.getResourceLineOffset(), v8ScriptOrigin.getResourceColumnOffset(),
v8ScriptOrigin.getScriptId(), v8ScriptOrigin.isWasm());
}
}
/**
* Call a function.
*
* It is similar to JavaScript built-in functions apply() or call().
*
* @param the type parameter
* @param iV8ValueObject the V8 value object
* @param receiver the receiver
* @param returnResult the return result
* @param v8Values the V8 values
* @return the result
* @throws JavetException the javet exception
* @since 0.7.0
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
T functionCall(
IV8ValueObject iV8ValueObject, V8Value receiver, boolean returnResult,
V8Value... v8Values)
throws JavetException {
return (T) v8Native.functionCall(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(),
receiver, returnResult, v8Values);
}
/**
* Call a function as a constructor.
*
* @param the type parameter
* @param iV8ValueObject the V8 value object
* @param v8Values the V8 values
* @return the result
* @throws JavetException the javet exception
* @since 0.7.2
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
T functionCallAsConstructor(
IV8ValueObject iV8ValueObject, V8Value... v8Values) throws JavetException {
return (T) v8Native.functionCallAsConstructor(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), v8Values);
}
/**
* Can discard compiled byte code of a function.
*
* @param iV8ValueFunction the V8 value function
* @return true : yes, false : no
* @since 2.0.1
*/
boolean functionCanDiscardCompiled(IV8ValueFunction iV8ValueFunction) {
return v8Native.functionCanDiscardCompiled(
handle, iV8ValueFunction.getHandle(), iV8ValueFunction.getType().getId());
}
/**
* Copies the scope info from source function to target function.
*
* @param targetIV8ValueFunction the target V8 value function
* @param sourceIV8ValueFunction the source V8 value function
* @return true : copied, false : not copied
* @throws JavetException the javet exception
* @since 2.0.1
*/
@SuppressWarnings("RedundantThrows")
boolean functionCopyScopeInfoFrom(
IV8ValueFunction targetIV8ValueFunction,
IV8ValueFunction sourceIV8ValueFunction) throws JavetException {
return v8Native.functionCopyScopeInfoFrom(handle,
targetIV8ValueFunction.getHandle(), targetIV8ValueFunction.getType().getId(),
sourceIV8ValueFunction.getHandle(), sourceIV8ValueFunction.getType().getId());
}
/**
* Discard compiled byte code of a function.
*
* @param iV8ValueFunction the V8 value function
* @return true : discarded, false : not discarded
* @since 2.0.1
*/
boolean functionDiscardCompiled(IV8ValueFunction iV8ValueFunction) {
return v8Native.functionDiscardCompiled(
handle, iV8ValueFunction.getHandle(), iV8ValueFunction.getType().getId());
}
/**
* Gets arguments from a function.
*
* @param iV8ValueFunction the V8 value function
* @return the arguments
* @throws JavetException the javet exception
* @since 2.0.3
*/
@SuppressWarnings("RedundantThrows")
String[] functionGetArguments(IV8ValueFunction iV8ValueFunction) throws JavetException {
return v8Native.functionGetArguments(
handle, iV8ValueFunction.getHandle(), iV8ValueFunction.getType().getId());
}
/**
* Get cached data from a function.
*
* @param iV8ValueFunction the V8 value function
* @return the cached data
* @throws JavetException the javet exception
* @since 2.0.3
*/
@SuppressWarnings("RedundantThrows")
byte[] functionGetCachedData(IV8ValueFunction iV8ValueFunction) throws JavetException {
return v8Native.functionGetCachedData(
handle, iV8ValueFunction.getHandle(), iV8ValueFunction.getType().getId());
}
/**
* Gets the V8 context.
*
* @param iV8ValueFunction the V8 value function
* @return the V8 context
* @throws JavetException the javet exception
* @since 2.0.1
*/
@CheckReturnValue
@SuppressWarnings("RedundantThrows")
V8Context functionGetContext(IV8ValueFunction iV8ValueFunction) throws JavetException {
return (V8Context) v8Native.functionGetContext(
handle, iV8ValueFunction.getHandle(), iV8ValueFunction.getType().getId());
}
/**
* Gets internal properties from a function.
*
* This is experimental only.
*
* @param iV8ValueFunction the V8 value function
* @return the internal properties
* @throws JavetException the javet exception
* @since 0.8.8
*/
@CheckReturnValue
@SuppressWarnings("RedundantThrows")
IV8ValueArray functionGetInternalProperties(IV8ValueFunction iV8ValueFunction) throws JavetException {
return (V8ValueArray) v8Native.functionGetInternalProperties(
handle, iV8ValueFunction.getHandle(), iV8ValueFunction.getType().getId());
}
/**
* Gets the JS function type from a function.
*
* @param iV8ValueFunction the V8 value function
* @return the JS function type
* @since 0.8.8
*/
JSFunctionType functionGetJSFunctionType(IV8ValueFunction iV8ValueFunction) {
return JSFunctionType.parse(v8Native.functionGetJSFunctionType(
handle, iV8ValueFunction.getHandle(), iV8ValueFunction.getType().getId()));
}
/**
* Gets js scope type.
*
* @param iV8ValueFunction the V8 value function
* @return the js scope type
* @since 0.8.8
*/
JSScopeType functionGetJSScopeType(IV8ValueFunction iV8ValueFunction) {
return JSScopeType.parse(v8Native.functionGetJSScopeType(
handle, iV8ValueFunction.getHandle(), iV8ValueFunction.getType().getId()));
}
/**
* Gets scope infos from a V8 value function.
*
* @param iV8ValueFunction the V8 value function
* @param options the options
* @return the V8 value array
* @throws JavetException the javet exception
*/
@SuppressWarnings("RedundantThrows")
IV8ValueArray functionGetScopeInfos(
IV8ValueFunction iV8ValueFunction,
IV8ValueFunction.GetScopeInfosOptions options)
throws JavetException {
return (IV8ValueArray) v8Native.functionGetScopeInfos(
handle, iV8ValueFunction.getHandle(), iV8ValueFunction.getType().getId(),
options.isIncludeGlobalVariables(), options.isIncludeScopeTypeGlobal());
}
/**
* Gets script source from a function.
*
* @param iV8ValueFunction the V8 value function
* @return the script source
* @throws JavetException the javet exception
* @since 2.0.1
*/
@SuppressWarnings("RedundantThrows")
IV8ValueFunction.ScriptSource functionGetScriptSource(IV8ValueFunction iV8ValueFunction) throws JavetException {
return (IV8ValueFunction.ScriptSource) v8Native.functionGetScriptSource(
handle, iV8ValueFunction.getHandle(), iV8ValueFunction.getType().getId());
}
/**
* Gets source code from a function.
*
* @param iV8ValueFunction the V8 value function
* @return the source code
* @throws JavetException the javet exception
* @since 0.8.8
*/
@SuppressWarnings("RedundantThrows")
String functionGetSourceCode(IV8ValueFunction iV8ValueFunction) throws JavetException {
return v8Native.functionGetSourceCode(handle, iV8ValueFunction.getHandle(), iV8ValueFunction.getType().getId());
}
/**
* Is the function compiled.
*
* @param iV8ValueFunction the V8 value function
* @return true : yes, false : no
* @since 2.0.1
*/
boolean functionIsCompiled(IV8ValueFunction iV8ValueFunction) {
return v8Native.functionIsCompiled(
handle, iV8ValueFunction.getHandle(), iV8ValueFunction.getType().getId());
}
/**
* Is the function wrapped.
*
* @param iV8ValueFunction the V8 value function
* @return true : yes, false : no
* @since 2.0.3
*/
boolean functionIsWrapped(IV8ValueFunction iV8ValueFunction) {
return v8Native.functionIsWrapped(
handle, iV8ValueFunction.getHandle(), iV8ValueFunction.getType().getId());
}
/**
* Sets the V8 context.
*
* @param iV8ValueFunction the V8 value function
* @param v8Context the V8 context
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 2.0.1
*/
@SuppressWarnings("RedundantThrows")
boolean functionSetContext(
IV8ValueFunction iV8ValueFunction, V8Context v8Context) throws JavetException {
return v8Native.functionSetContext(
handle, iV8ValueFunction.getHandle(), iV8ValueFunction.getType().getId(), v8Context);
}
/**
* Sets the script source.
*
* @param iV8ValueFunction the V8 value function
* @param scriptSource the script source
* @param cloneScript the clone script
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 2.0.1
*/
@SuppressWarnings("RedundantThrows")
boolean functionSetScriptSource(
IV8ValueFunction iV8ValueFunction,
IV8ValueFunction.ScriptSource scriptSource,
boolean cloneScript)
throws JavetException {
return v8Native.functionSetScriptSource(
handle, iV8ValueFunction.getHandle(), iV8ValueFunction.getType().getId(), scriptSource, cloneScript);
}
/**
* Sets source code of a function.
*
* @param iV8ValueFunction the V8 value function
* @param sourceCode the source code
* @param cloneScript the clone script
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 0.8.8
*/
@SuppressWarnings("RedundantThrows")
boolean functionSetSourceCode(
IV8ValueFunction iV8ValueFunction, String sourceCode, boolean cloneScript)
throws JavetException {
return v8Native.functionSetSourceCode(
handle, iV8ValueFunction.getHandle(), iV8ValueFunction.getType().getId(), sourceCode, cloneScript);
}
/**
* Gets a callback context by a handle.
*
* @param handle the handle
* @return the callback context
* @since 0.9.12
*/
public JavetCallbackContext getCallbackContext(long handle) {
synchronized (callbackContextLock) {
return callbackContextMap.get(handle);
}
}
/**
* Gets callback context count.
*
* @return the callback context count
* @since 0.9.12
*/
public int getCallbackContextCount() {
return callbackContextMap.size();
}
/**
* Gets close lock.
*
* @return the close lock
* @since 3.1.3
*/
Object getCloseLock() {
return closeLock;
}
/**
* Gets converter.
*
* @return the converter
* @since 0.8.5
*/
public IJavetConverter getConverter() {
return converter;
}
/**
* Gets an executor by {@link File}.
*
* @param scriptFile the script file
* @return the executor
* @throws JavetException the javet exception
* @since 0.8.4
*/
public IV8Executor getExecutor(File scriptFile) throws JavetException {
return new V8FileExecutor(this, scriptFile);
}
/**
* Gets an executor by {@link Path}.
*
* @param scriptPath the script path
* @return the executor
* @throws JavetException the javet exception
* @since 0.8.0
*/
public IV8Executor getExecutor(Path scriptPath) throws JavetException {
return new V8PathExecutor(this, scriptPath);
}
/**
* Gets an executor by a script string.
*
* @param scriptString the script string
* @return the executor
* @since 0.8.0
*/
public IV8Executor getExecutor(String scriptString) {
return new V8StringExecutor(this, scriptString);
}
/**
* Gets executor by a script string and cached data.
*
* @param scriptString the script string
* @param cachedData the cached data
* @return the executor
* @since 2.0.3
*/
public IV8Executor getExecutor(String scriptString, byte[] cachedData) {
return new V8StringExecutor(this, scriptString, cachedData);
}
/**
* Gets the global object. By default, it is globalThis.
*
* @return the global object
* @throws JavetException the javet exception
* @since 0.7.0
*/
public V8ValueGlobalObject getGlobalObject() throws JavetException {
return (V8ValueGlobalObject) v8Native.getGlobalObject(handle);
}
/**
* Gets guard.
*
* @return the guard
* @since 3.1.3
*/
@CheckReturnValue
public V8Guard getGuard() {
return new V8Guard(this);
}
/**
* Gets guard.
*
* @param timoutMillis the timout millis
* @return the guard
* @since 3.1.3
*/
@CheckReturnValue
public V8Guard getGuard(long timoutMillis) {
return new V8Guard(this, timoutMillis);
}
/**
* Gets guard.
*
* @param timoutMillis the timout millis
* @param debugModeEnabled the debug mode enabled
* @return the guard
* @since 3.1.3
*/
@CheckReturnValue
public V8Guard getGuard(long timoutMillis, boolean debugModeEnabled) {
return new V8Guard(this, timoutMillis, debugModeEnabled);
}
/**
* Gets the internal handle that represents the current V8 runtime in JNI.
*
* @return the handle
* @since 0.7.0
*/
public long getHandle() {
return handle;
}
/**
* Gets the JS runtime type.
*
* @return the JS runtime type
* @since 0.9.1
*/
public JSRuntimeType getJSRuntimeType() {
return JSRuntimeType.V8;
}
/**
* Gets the internal logger.
*
* @return the logger
* @since 0.9.1
*/
public IJavetLogger getLogger() {
return logger;
}
/**
* Gets promise reject callback.
*
* @return the promise reject callback
* @since 0.8.3
*/
public IJavetPromiseRejectCallback getPromiseRejectCallback() {
return promiseRejectCallback;
}
/**
* Gets the internal reference count.
*
* @return the reference count
* @since 0.7.0
*/
public int getReferenceCount() {
return referenceMap.size();
}
/**
* Gets the runtime options.
*
* @return the runtime options
* @since 1.0.0
*/
public RuntimeOptions getRuntimeOptions() {
return runtimeOptions;
}
/**
* Gets V8 heap space statistics by an allocation space via completable future.
* It is an async call that will be completed if there is no race condition.
*
* @param v8AllocationSpace the V8 allocation space
* @return the V8 heap space statistics in a complete future
* @since 1.0.4
*/
public CompletableFuture getV8HeapSpaceStatistics(V8AllocationSpace v8AllocationSpace) {
V8StatisticsFuture v8StatisticsFuture = (V8StatisticsFuture)
v8Native.getV8HeapSpaceStatistics(handle, Objects.requireNonNull(v8AllocationSpace));
if (!v8StatisticsFuture.isDone()) {
v8Host.offerV8StatisticsFuture(v8StatisticsFuture);
}
return v8StatisticsFuture;
}
/**
* Gets V8 heap statistics via completable future.
* It is an async call that will be completed if there is no race condition.
*
* @return the V8 heap statistics in a complete future
* @since 1.0.0
*/
public CompletableFuture getV8HeapStatistics() {
V8StatisticsFuture v8StatisticsFuture = (V8StatisticsFuture)
v8Native.getV8HeapStatistics(handle);
if (!v8StatisticsFuture.isDone()) {
v8Host.offerV8StatisticsFuture(v8StatisticsFuture);
}
return v8StatisticsFuture;
}
/**
* Gets V8 host.
*
* @return the V8 host
* @since 3.1.3
*/
V8Host getV8Host() {
return v8Host;
}
/**
* Gets V8 inspector.
*
* @return the V8 inspector
* @since 0.7.3
*/
public V8Inspector getV8Inspector() {
return getV8Inspector(MessageFormat.format(DEFAULT_MESSAGE_FORMAT_JAVET_INSPECTOR, Long.toString(handle)));
}
/**
* Gets V8 inspector by name.
*
* @param name the name
* @return the V8 inspector
* @since 0.7.3
*/
public V8Inspector getV8Inspector(String name) {
if (v8Inspector == null) {
v8Inspector = new V8Inspector(this, name, v8Native);
}
return v8Inspector;
}
/**
* Gets V8 internal.
*
* @return the V8 internal
* @since 1.0.2
*/
public V8Internal getV8Internal() {
return v8Internal;
}
/**
* Gets V8 locker.
*
* The V8 locker is for maximizing the performance by explicitly acquire and release
* the lock. It should not be called in regular case because V8 runtime is thread-safe.
*
* @return the V8 locker
* @throws JavetException the javet exception
* @since 0.8.0
*/
@CheckReturnValue
public V8Locker getV8Locker() throws JavetException {
return new V8Locker(this, v8Native);
}
/**
* Gets V8 module by the resource name and module referrer.
*
* It is the callback function that handles the callback from JNI.
* The return V8 module tells V8 how to resolve an ESM request.
*
* @param resourceName the resource name
* @param v8ModuleReferrer the V8 module referrer
* @return the V8 module
* @throws JavetException the javet exception
* @since 0.9.3
*/
@CheckReturnValue
IV8Module getV8Module(String resourceName, IV8Module v8ModuleReferrer) throws JavetException {
IV8Module iV8Module = null;
if (!StringUtils.isEmpty(resourceName)) {
synchronized (v8ModuleLock) {
iV8Module = v8ModuleMap.get(resourceName);
}
if (iV8Module == null && v8ModuleResolver != null) {
iV8Module = v8ModuleResolver.resolve(this, resourceName, v8ModuleReferrer);
}
}
return iV8Module;
}
/**
* Gets V8 module count.
*
* @return the V8 module count
* @since 0.8.1
*/
public int getV8ModuleCount() {
return v8ModuleMap.size();
}
/**
* Gets V8 module resolver.
*
* @return the V8 module resolver
* @since 0.9.3
*/
public IV8ModuleResolver getV8ModuleResolver() {
return v8ModuleResolver;
}
/**
* Gets V8 scope.
*
* @return the V8 scope
* @since 0.9.14
*/
public V8Scope getV8Scope() {
return new V8Scope(this);
}
/**
* Gets V8 shared memory statistics.
*
* @return the V8 shared memory statistics
* @since 1.0.0
*/
public V8SharedMemoryStatistics getV8SharedMemoryStatistics() {
return v8Host.getV8SharedMemoryStatistics();
}
/**
* Gets the V8 version.
*
* @return the version
* @since 0.8.2
*/
public String getVersion() {
return v8Native.getVersion();
}
/**
* Has internal type.
*
* @param iV8ValueObject the V8 value object
* @param internalType the internal type
* @return true : yes, false : no
* @since 0.9.13
*/
boolean hasInternalType(IV8ValueObject iV8ValueObject, V8ValueInternalType internalType) {
return v8Native.hasInternalType(
handle, iV8ValueObject.getHandle(), Objects.requireNonNull(internalType).getId());
}
/**
* Has pending exception.
*
* @return true : yes, false : no
* @throws JavetException the javet exception
* @since 1.0.4
*/
@SuppressWarnings("RedundantThrows")
public boolean hasPendingException() throws JavetException {
return v8Native.hasPendingException(handle);
}
/**
* Has pending message.
*
* @return true : yes, false : no
* @throws JavetException the javet exception
* @since 1.0.4
*/
@SuppressWarnings("RedundantThrows")
public boolean hasPendingMessage() throws JavetException {
return v8Native.hasPendingMessage(handle);
}
/**
* Has scheduled exception.
*
* @return true : yes, false : no
* @throws JavetException the javet exception
* @since 1.0.4
*/
@SuppressWarnings("RedundantThrows")
public boolean hasScheduledException() throws JavetException {
return v8Native.hasScheduledException(handle);
}
/**
* Initialize V8 value cache.
*
* @since 0.7.4
*/
void initializeV8ValueCache() {
try {
cachedV8ValueNull = new V8ValueNull(this);
cachedV8ValueUndefined = new V8ValueUndefined(this);
cachedV8ValueBooleans = new V8ValueBoolean[]{
new V8ValueBoolean(this, false),
new V8ValueBoolean(this, true)};
cachedV8ValueIntegers = new V8ValueInteger[V8_VALUE_NUMBER_UPPER_BOUND - V8_VALUE_NUMBER_LOWER_BOUND];
cachedV8ValueLongs = new V8ValueLong[V8_VALUE_NUMBER_UPPER_BOUND - V8_VALUE_NUMBER_LOWER_BOUND];
for (int i = V8_VALUE_NUMBER_LOWER_BOUND; i < V8_VALUE_NUMBER_UPPER_BOUND; ++i) {
try {
cachedV8ValueIntegers[i - V8_VALUE_NUMBER_LOWER_BOUND] = new V8ValueInteger(this, i);
cachedV8ValueLongs[i - V8_VALUE_NUMBER_LOWER_BOUND] = new V8ValueLong(this, i);
} catch (JavetException e) {
logger.logError(e, e.getMessage());
}
}
} catch (JavetException e) {
logger.logError(e, e.getMessage());
}
}
/**
* From integer object to integer.
*
* @param v8ValueIntegerObject the V8 value integer object
* @return the V8 value integer
* @throws JavetException the javet exception
* @since 3.0.4
*/
V8ValueInteger integerObjectValueOf(V8ValueIntegerObject v8ValueIntegerObject) throws JavetException {
return (V8ValueInteger) v8Native.integerObjectValueOf(
handle, Objects.requireNonNull(v8ValueIntegerObject).getHandle(), v8ValueIntegerObject.getType().getId());
}
@Override
public boolean isClosed() {
return handle == INVALID_HANDLE;
}
/**
* Returns whether the V8 runtime is dead or not.
*
* @return true : dead, false : alive
* @since 0.7.2
*/
public boolean isDead() {
return v8Native.isDead(handle);
}
/**
* Returns whether the GC is scheduled or not.
*
* @return true : scheduled, false: not scheduled
* @since 0.8.3
*/
public boolean isGCScheduled() {
return gcScheduled;
}
/**
* Returns whether the V8 runtime is in use or not.
*
* @return the boolean
* @since 0.7.2
*/
public boolean isInUse() {
return v8Native.isInUse(handle);
}
/**
* Returns whether the V8 runtime is managed by a pool or not.
*
* @return true : yes, false : no
* @since 0.7.0
*/
public boolean isPooled() {
return pooled;
}
/**
* Returns whether the reference is weak or not.
*
* @param iV8ValueReference the V8 value reference
* @return true : weak, false : strong
* @since 0.7.0
*/
boolean isWeak(IV8ValueReference iV8ValueReference) {
return v8Native.isWeak(handle, iV8ValueReference.getHandle(), iV8ValueReference.getType().getId());
}
/**
* From long object to long.
*
* @param v8ValueLongObject the V8 value long object
* @return the V8 value long
* @throws JavetException the javet exception
* @since 3.0.4
*/
V8ValueLong longObjectValueOf(V8ValueLongObject v8ValueLongObject) throws JavetException {
return (V8ValueLong) v8Native.longObjectValueOf(
handle,
Objects.requireNonNull(v8ValueLongObject).getHandle(),
v8ValueLongObject.getType().getId());
}
/**
* Send low memory notification to current V8 isolate.
*
* @since 0.8.3
*/
public void lowMemoryNotification() {
if (!isClosed()) {
v8Native.lowMemoryNotification(handle);
}
}
/**
* Convert map to array.
*
* @param iV8ValueMap the V8 value map
* @return the V8 value array
* @throws JavetException the javet exception
* @since 3.0.4
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
V8ValueArray mapAsArray(IV8ValueMap iV8ValueMap) throws JavetException {
return (V8ValueArray) v8Native.mapAsArray(handle, iV8ValueMap.getHandle(), iV8ValueMap.getType().getId());
}
/**
* Clear the map.
*
* @param iV8ValueMap the V8 value map
* @since 3.0.4
*/
void mapClear(IV8ValueMap iV8ValueMap) {
v8Native.mapClear(handle, iV8ValueMap.getHandle(), iV8ValueMap.getType().getId());
}
/**
* Delete a key from a map.
*
* @param iV8ValueMap the V8 value map
* @param key the key
* @return true : deleted, false : key is not found
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
boolean mapDelete(IV8ValueMap iV8ValueMap, V8Value key) throws JavetException {
return v8Native.mapDelete(handle, iV8ValueMap.getHandle(), iV8ValueMap.getType().getId(), key);
}
/**
* Get a property from a map by a key.
*
* @param the type parameter
* @param iV8ValueMap the v 8 value map
* @param key the property key
* @return the property value
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
T mapGet(IV8ValueMap iV8ValueMap, V8Value key) throws JavetException {
return (T) v8Native.mapGet(
handle, iV8ValueMap.getHandle(), iV8ValueMap.getType().getId(), key);
}
/**
* Get Boolean from a map by key
*
* @param iV8ValueMap the V8 value map
* @param key the key
* @return the boolean
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
Boolean mapGetBoolean(
IV8ValueMap iV8ValueMap, V8Value key)
throws JavetException {
primitiveFlags[0] = true;
boolean value = v8Native.mapGetBoolean(
handle, iV8ValueMap.getHandle(), iV8ValueMap.getType().getId(), key, primitiveFlags);
return primitiveFlags[0] ? value : null;
}
/**
* Get Double from a map by key
*
* @param iV8ValueMap the V8 value map
* @param key the key
* @return the double
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
Double mapGetDouble(
IV8ValueMap iV8ValueMap, V8Value key)
throws JavetException {
primitiveFlags[0] = true;
double value = v8Native.mapGetDouble(
handle, iV8ValueMap.getHandle(), iV8ValueMap.getType().getId(), key, primitiveFlags);
return primitiveFlags[0] ? value : null;
}
/**
* Get Integer from a map by key
*
* @param iV8ValueMap the V8 value map
* @param key the key
* @return the int
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
Integer mapGetInteger(
IV8ValueMap iV8ValueMap, V8Value key)
throws JavetException {
primitiveFlags[0] = true;
int value = v8Native.mapGetInteger(
handle, iV8ValueMap.getHandle(), iV8ValueMap.getType().getId(), key, primitiveFlags);
return primitiveFlags[0] ? value : null;
}
/**
* Get Long from a map by key
*
* @param iV8ValueMap the V8 value map
* @param key the key
* @return the long
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
Long mapGetLong(
IV8ValueMap iV8ValueMap, V8Value key)
throws JavetException {
primitiveFlags[0] = true;
long value = v8Native.mapGetLong(
handle, iV8ValueMap.getHandle(), iV8ValueMap.getType().getId(), key, primitiveFlags);
return primitiveFlags[0] ? value : null;
}
/**
* Gets size from a map.
*
* @param iV8ValueMap the V8 value map
* @return the size
* @throws JavetException the javet exception
* @since 0.7.0
*/
@SuppressWarnings("RedundantThrows")
int mapGetSize(IV8ValueMap iV8ValueMap) throws JavetException {
return v8Native.mapGetSize(handle, iV8ValueMap.getHandle(), iV8ValueMap.getType().getId());
}
/**
* Get String from a map by key
*
* @param iV8ValueMap the V8 value map
* @param key the key
* @return the String
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
String mapGetString(
IV8ValueMap iV8ValueMap, V8Value key)
throws JavetException {
return v8Native.mapGetString(
handle, iV8ValueMap.getHandle(), iV8ValueMap.getType().getId(), key);
}
/**
* Has a property in a map.
*
* @param iV8ValueMap the V8 value map
* @param value the value
* @return true : yes, false : no
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
boolean mapHas(IV8ValueMap iV8ValueMap, V8Value value) throws JavetException {
return v8Native.mapHas(handle, iV8ValueMap.getHandle(), iV8ValueMap.getType().getId(), value);
}
/**
* Sets a property of a map by a key
*
* @param iV8ValueMap the V8 value map
* @param v8Values the V8 values
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
boolean mapSet(IV8ValueMap iV8ValueMap, V8Value... v8Values) throws JavetException {
assert v8Values.length > 0 && v8Values.length % 2 == 0 : ERROR_THE_KEY_VALUE_PAIR_MUST_MATCH;
return v8Native.mapSet(handle, iV8ValueMap.getHandle(), iV8ValueMap.getType().getId(), v8Values);
}
/**
* Sets a property of a map to a boolean value by a key
*
* @param iV8ValueMap the V8 value map
* @param key the key
* @param value the value
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
boolean mapSetBoolean(
IV8ValueMap iV8ValueMap, V8Value key, boolean value)
throws JavetException {
return v8Native.mapSetBoolean(handle, iV8ValueMap.getHandle(), iV8ValueMap.getType().getId(), key, value);
}
/**
* Sets a property of a map to a double value by a key
*
* @param iV8ValueMap the V8 value map
* @param key the key
* @param value the value
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
boolean mapSetDouble(
IV8ValueMap iV8ValueMap, V8Value key, double value)
throws JavetException {
return v8Native.mapSetDouble(handle, iV8ValueMap.getHandle(), iV8ValueMap.getType().getId(), key, value);
}
/**
* Sets a property of a map to an int value by a key
*
* @param iV8ValueMap the V8 value map
* @param key the key
* @param value the value
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
boolean mapSetInteger(
IV8ValueMap iV8ValueMap, V8Value key, int value)
throws JavetException {
return v8Native.mapSetInteger(handle, iV8ValueMap.getHandle(), iV8ValueMap.getType().getId(), key, value);
}
/**
* Sets a property of a map to a long value by a key
*
* @param iV8ValueMap the V8 value map
* @param key the key
* @param value the value
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
boolean mapSetLong(
IV8ValueMap iV8ValueMap, V8Value key, long value)
throws JavetException {
return v8Native.mapSetLong(handle, iV8ValueMap.getHandle(), iV8ValueMap.getType().getId(), key, value);
}
/**
* Sets a property of a map to null by a key
*
* @param iV8ValueMap the V8 value map
* @param key the key
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
boolean mapSetNull(IV8ValueMap iV8ValueMap, V8Value key) throws JavetException {
return v8Native.mapSetNull(handle, iV8ValueMap.getHandle(), iV8ValueMap.getType().getId(), key);
}
/**
* Sets a property of a map to a string value by a key
*
* @param iV8ValueMap the V8 value map
* @param key the key
* @param value the value
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
boolean mapSetString(
IV8ValueMap iV8ValueMap, V8Value key, String value)
throws JavetException {
return v8Native.mapSetString(handle, iV8ValueMap.getHandle(), iV8ValueMap.getType().getId(), key, value);
}
/**
* Sets a property of a map to undefined by a key
*
* @param iV8ValueMap the V8 value map
* @param key the key
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
boolean mapSetUndefined(IV8ValueMap iV8ValueMap, V8Value key) throws JavetException {
return v8Native.mapSetUndefined(handle, iV8ValueMap.getHandle(), iV8ValueMap.getType().getId(), key);
}
/**
* Evaluate a module.
*
* @param the type parameter
* @param iV8Module the V8 module
* @param resultRequired the result required
* @return the result
* @throws JavetException the javet exception
* @since 0.8.0
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
T moduleEvaluate(
IV8Module iV8Module, boolean resultRequired) throws JavetException {
return (T) v8Native.moduleEvaluate(
handle, iV8Module.getHandle(), iV8Module.getType().getId(), resultRequired);
}
/**
* Get cached data from a module.
*
* @param iV8Module the V8 module
* @return the cached data
* @throws JavetException the javet exception
* @since 2.0.3
*/
@SuppressWarnings("RedundantThrows")
byte[] moduleGetCachedData(IV8Module iV8Module) throws JavetException {
return v8Native.moduleGetCachedData(
handle, iV8Module.getHandle(), iV8Module.getType().getId());
}
/**
* Gets an error from a module.
*
* @param iV8Module the V8 module
* @return the V8 value error
* @throws JavetException the javet exception
* @since 0.9.12
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
V8ValueError moduleGetException(IV8Module iV8Module) throws JavetException {
return (V8ValueError) v8Native.moduleGetException(
handle, iV8Module.getHandle(), iV8Module.getType().getId());
}
/**
* Gets an idendity hash from a module
*
* @param iV8Module the V8 module
* @return the identity hash
* @throws JavetException the javet exception
*/
@SuppressWarnings("RedundantThrows")
int moduleGetIdentityHash(IV8Module iV8Module) throws JavetException {
return v8Native.moduleGetIdentityHash(handle, iV8Module.getHandle(), iV8Module.getType().getId());
}
/**
* Gets the namespace from a module.
*
* @param iV8Module the V8 module
* @return the namespace
* @throws JavetException the javet exception
* @since 0.8.0
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
V8Value moduleGetNamespace(IV8Module iV8Module) throws JavetException {
return (V8Value) v8Native.moduleGetNamespace(
handle, iV8Module.getHandle(), iV8Module.getType().getId());
}
/**
* Gets the resource name from a module.
*
* @param iV8Module the V8 module
* @return the resource name
* @throws JavetException the javet exception
* @since 3.1.0
*/
String moduleGetResourceName(IV8Module iV8Module) throws JavetException {
return v8Native.moduleGetResourceName(handle, iV8Module.getHandle(), iV8Module.getType().getId());
}
/**
* Gets the script ID from a module.
*
* @param iV8Module the V8 module
* @return the script ID
* @throws JavetException the javet exception
* @since 0.8.4
*/
@SuppressWarnings("RedundantThrows")
int moduleGetScriptId(IV8Module iV8Module) throws JavetException {
return v8Native.moduleGetScriptId(handle, iV8Module.getHandle(), iV8Module.getType().getId());
}
/**
* Gets the status from a module.
*
* @param iV8Module the V8 module
* @return the status
* @throws JavetException the javet exception
* @since 0.8.4
*/
@SuppressWarnings("RedundantThrows")
int moduleGetStatus(IV8Module iV8Module) throws JavetException {
return v8Native.moduleGetStatus(handle, iV8Module.getHandle(), iV8Module.getType().getId());
}
/**
* Instantiate a module.
*
* It may return an exception or false if the module state is invalid.
*
* @param iV8Module the V8 module
* @return true : success, false : false
* @throws JavetException the javet exception
* @since 0.8.4
*/
@SuppressWarnings("RedundantThrows")
boolean moduleInstantiate(IV8Module iV8Module) throws JavetException {
return v8Native.moduleInstantiate(handle, iV8Module.getHandle(), iV8Module.getType().getId());
}
/**
* Is source text module.
*
* @param iV8Module the V8 module
* @return true : yes, false : no
* @since 3.0.1
*/
boolean moduleIsSourceTextModule(IV8Module iV8Module) {
return v8Native.moduleIsSourceTextModule(handle, iV8Module.getHandle(), iV8Module.getType().getId());
}
/**
* Is synthetic module.
*
* @param iV8Module the V8 module
* @return true : yes, false : no
* @since 3.0.1
*/
boolean moduleIsSyntheticModule(IV8Module iV8Module) {
return v8Native.moduleIsSyntheticModule(handle, iV8Module.getHandle(), iV8Module.getType().getId());
}
/**
* Delete a key from an object.
*
* @param iV8ValueObject the V8 value object
* @param key the key
* @return true : deleted, false : key is not found
* @throws JavetException the javet exception
* @since 0.7.0
*/
@SuppressWarnings("RedundantThrows")
boolean objectDelete(IV8ValueObject iV8ValueObject, V8Value key) throws JavetException {
return v8Native.objectDelete(handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key);
}
/**
* Delete a private property from an object.
*
* @param iV8ValueObject the V8 value object
* @param propertyName the property name
* @return true : deleted, false : key is not found
* @throws JavetException the javet exception
* @since 0.9.12
*/
@SuppressWarnings("RedundantThrows")
boolean objectDeletePrivateProperty(IV8ValueObject iV8ValueObject, String propertyName) throws JavetException {
return v8Native.objectDeletePrivateProperty(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), propertyName);
}
/**
* Get a property from an object by a property key.
*
* @param the type parameter
* @param iV8ValueObject the V8 value object
* @param key the property key
* @return the property value
* @throws JavetException the javet exception
* @since 0.7.0
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
T objectGet(IV8ValueObject iV8ValueObject, V8Value key) throws JavetException {
return (T) v8Native.objectGet(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key);
}
/**
* Get Boolean from an object by key
*
* @param iV8ValueObject the V8 value object
* @param key the key
* @return the boolean
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
Boolean objectGetBoolean(
IV8ValueObject iV8ValueObject, V8Value key)
throws JavetException {
primitiveFlags[0] = true;
boolean value = v8Native.objectGetBoolean(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key, primitiveFlags);
return primitiveFlags[0] ? value : null;
}
/**
* Get Double from an object by key
*
* @param iV8ValueObject the V8 value object
* @param key the key
* @return the double
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
Double objectGetDouble(
IV8ValueObject iV8ValueObject, V8Value key)
throws JavetException {
primitiveFlags[0] = true;
double value = v8Native.objectGetDouble(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key, primitiveFlags);
return primitiveFlags[0] ? value : null;
}
/**
* Gets the internal identity hash by a reference object.
*
* @param iV8ValueReference the V8 value reference
* @return the identity hash
* @throws JavetException the javet exception
* @since 0.9.1
*/
@SuppressWarnings("RedundantThrows")
int objectGetIdentityHash(IV8ValueReference iV8ValueReference) throws JavetException {
return v8Native.objectGetIdentityHash(
handle, iV8ValueReference.getHandle(), iV8ValueReference.getType().getId());
}
/**
* Get Integer from an object by key
*
* @param iV8ValueObject the V8 value object
* @param key the key
* @return the int
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
Integer objectGetInteger(
IV8ValueObject iV8ValueObject, V8Value key)
throws JavetException {
primitiveFlags[0] = true;
int value = v8Native.objectGetInteger(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key, primitiveFlags);
return primitiveFlags[0] ? value : null;
}
/**
* Get Long from an object by key
*
* @param iV8ValueObject the V8 value object
* @param key the key
* @return the long
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
Long objectGetLong(
IV8ValueObject iV8ValueObject, V8Value key)
throws JavetException {
primitiveFlags[0] = true;
long value = v8Native.objectGetLong(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key, primitiveFlags);
return primitiveFlags[0] ? value : null;
}
/**
* Gets own property names from an object.
*
* @param iV8ValueObject the V8 value object
* @return the own property names
* @throws JavetException the javet exception
* @since 0.7.0
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
IV8ValueArray objectGetOwnPropertyNames(
IV8ValueObject iV8ValueObject) throws JavetException {
return (V8ValueArray) v8Native.objectGetOwnPropertyNames(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId());
}
/**
* Gets a private property from an object by a property name.
*
* @param the type parameter
* @param iV8ValueObject the V8 value object
* @param propertyName the property name
* @return the private property
* @throws JavetException the javet exception
* @since 0.9.12
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
T objectGetPrivateProperty(IV8ValueObject iV8ValueObject, String propertyName)
throws JavetException {
return (T) v8Native.objectGetPrivateProperty(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), propertyName);
}
/**
* Gets a property from an object by a property key.
*
* @param the type parameter
* @param iV8ValueObject the V8 value object
* @param key the property key
* @return the property
* @throws JavetException the javet exception
* @since 0.7.0
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
T objectGetProperty(IV8ValueObject iV8ValueObject, V8Value key) throws JavetException {
return (T) v8Native.objectGetProperty(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key);
}
/**
* Gets property names from an object.
*
* @param iV8ValueObject the V8 value object
* @return the property names
* @throws JavetException the javet exception
* @since 0.7.0
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
IV8ValueArray objectGetPropertyNames(IV8ValueObject iV8ValueObject) throws JavetException {
return (V8ValueArray) v8Native.objectGetPropertyNames(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId());
}
/**
* Gets prototype from an object.
*
* @param the type parameter
* @param iV8ValueObject the V8 value object
* @return the prototype
* @throws JavetException the javet exception
* @since 0.9.4
*/
@CheckReturnValue
@SuppressWarnings("RedundantThrows")
T objectGetPrototype(IV8ValueObject iV8ValueObject) throws JavetException {
return (T) v8Native.objectGetPrototype(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId());
}
/**
* Get String from an object by key
*
* @param iV8ValueObject the V8 value object
* @param key the key
* @return the String
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
String objectGetString(
IV8ValueObject iV8ValueObject, V8Value key)
throws JavetException {
return v8Native.objectGetString(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key);
}
/**
* Has a property in an object.
*
* @param iV8ValueObject the V8 value object
* @param propertyKey the property key
* @return true : yes, false : no
* @throws JavetException the javet exception
* @since 0.7.2
*/
@SuppressWarnings("RedundantThrows")
boolean objectHas(IV8ValueObject iV8ValueObject, V8Value propertyKey) throws JavetException {
return v8Native.objectHas(handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), propertyKey);
}
/**
* Has own property in an object by a property key.
*
* @param iV8ValueObject the V8 value object
* @param key the property key
* @return true : yes, false : no
* @throws JavetException the javet exception
* @since 0.7.2
*/
@SuppressWarnings("RedundantThrows")
boolean objectHasOwnProperty(IV8ValueObject iV8ValueObject, V8Value key) throws JavetException {
return v8Native.objectHasOwnProperty(handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key);
}
/**
* Has private property in an object by a property name.
*
* @param iV8ValueObject the V8 value object
* @param propertyName the property name
* @return true : yes, false : no
* @throws JavetException the javet exception
* @since 0.9.12
*/
@SuppressWarnings("RedundantThrows")
boolean objectHasPrivateProperty(IV8ValueObject iV8ValueObject, String propertyName) throws JavetException {
return v8Native.objectHasPrivateProperty(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), propertyName);
}
/**
* Invoke a function by a function name.
*
* @param the type parameter
* @param iV8ValueObject the V8 value object
* @param functionName the function name
* @param returnResult the return result
* @param v8Values the V8 values
* @return the result
* @throws JavetException the javet exception
* @since 0.7.0
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
T objectInvoke(
IV8ValueObject iV8ValueObject, String functionName, boolean returnResult, V8Value... v8Values)
throws JavetException {
Object result = v8Native.objectInvoke(
handle,
iV8ValueObject.getHandle(),
iV8ValueObject.getType().getId(),
functionName,
returnResult,
v8Values);
if (result == null) {
String message = MessageFormat.format(
"{0}: {1}",
V8ValueErrorType.TypeError.getName(),
V8ErrorTemplate.typeErrorValueIsNotAFunction(functionName));
throw new JavetExecutionException(new JavetScriptingError(message, message, null), null);
}
return (T) result;
}
/**
* Object is frozen.
*
* @param iV8ValueObject the V8 value object
* @return true : yes, false: no
* @since 3.1.3
*/
public boolean objectIsFrozen(IV8ValueObject iV8ValueObject) {
return v8Native.objectIsFrozen(handle, Objects.requireNonNull(iV8ValueObject).getHandle());
}
/**
* Object is sealed.
*
* @param iV8ValueObject the V8 value object
* @return true : yes, false: no
* @since 3.1.3
*/
public boolean objectIsSealed(IV8ValueObject iV8ValueObject) {
return v8Native.objectIsSealed(handle, Objects.requireNonNull(iV8ValueObject).getHandle());
}
/**
* Sets a property of an object by a key
*
* @param iV8ValueObject the V8 value object
* @param v8Values the V8 values
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 0.7.0
*/
@SuppressWarnings("RedundantThrows")
boolean objectSet(IV8ValueObject iV8ValueObject, V8Value... v8Values) throws JavetException {
assert v8Values.length > 0 && v8Values.length % 2 == 0 : ERROR_THE_KEY_VALUE_PAIR_MUST_MATCH;
return v8Native.objectSet(
handle,
Objects.requireNonNull(iV8ValueObject).getHandle(),
iV8ValueObject.getType().getId(),
v8Values);
}
/**
* Sets accessor (getter / setter) by a property name.
*
* @param iV8ValueObject the V8 value object
* @param propertyName the property name
* @param javetCallbackContextGetter the javet callback context getter
* @param javetCallbackContextSetter the javet callback context setter
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 0.8.9
*/
@SuppressWarnings("RedundantThrows")
boolean objectSetAccessor(
IV8ValueObject iV8ValueObject,
V8Value propertyName,
JavetCallbackContext javetCallbackContextGetter,
JavetCallbackContext javetCallbackContextSetter) throws JavetException {
assert (propertyName instanceof V8ValueString || propertyName instanceof V8ValueSymbol)
: ERROR_THE_PROPERTY_NAME_MUST_BE_EITHER_STRING_OR_SYMBOL;
boolean isAccessorSet = v8Native.objectSetAccessor(
handle,
iV8ValueObject.getHandle(),
iV8ValueObject.getType().getId(),
propertyName,
javetCallbackContextGetter,
javetCallbackContextSetter);
synchronized (callbackContextLock) {
if (javetCallbackContextGetter != null && javetCallbackContextGetter.isValid()) {
callbackContextMap.put(javetCallbackContextGetter.getHandle(), javetCallbackContextGetter);
}
if (javetCallbackContextSetter != null && javetCallbackContextSetter.isValid()) {
callbackContextMap.put(javetCallbackContextSetter.getHandle(), javetCallbackContextSetter);
}
}
return isAccessorSet;
}
/**
* Sets a property of an object to a boolean value by a key
*
* @param iV8ValueObject the V8 value object
* @param key the key
* @param value the value
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
boolean objectSetBoolean(
IV8ValueObject iV8ValueObject, V8Value key, boolean value)
throws JavetException {
return v8Native.objectSetBoolean(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key, value);
}
/**
* Sets a property of an object to a double value by a key
*
* @param iV8ValueObject the V8 value object
* @param key the key
* @param value the value
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
boolean objectSetDouble(
IV8ValueObject iV8ValueObject, V8Value key, double value)
throws JavetException {
return v8Native.objectSetDouble(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key, value);
}
/**
* Sets a property of an object to an int value by a key
*
* @param iV8ValueObject the V8 value object
* @param key the key
* @param value the value
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
boolean objectSetInteger(
IV8ValueObject iV8ValueObject, V8Value key, int value)
throws JavetException {
return v8Native.objectSetInteger(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key, value);
}
/**
* Sets a property of an object to a long value by a key
*
* @param iV8ValueObject the V8 value object
* @param key the key
* @param value the value
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
boolean objectSetLong(
IV8ValueObject iV8ValueObject, V8Value key, long value)
throws JavetException {
return v8Native.objectSetLong(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key, value);
}
/**
* Sets a property of an object to null by a key
*
* @param iV8ValueObject the V8 value object
* @param key the key
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
boolean objectSetNull(IV8ValueObject iV8ValueObject, V8Value key) throws JavetException {
return v8Native.objectSetNull(handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key);
}
/**
* Sets a private property.
*
* @param iV8ValueObject the V8 value object
* @param propertyName the property name
* @param propertyValue the property value
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 0.9.12
*/
@SuppressWarnings("RedundantThrows")
boolean objectSetPrivateProperty(
IV8ValueObject iV8ValueObject, String propertyName, V8Value propertyValue)
throws JavetException {
return v8Native.objectSetPrivateProperty(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), propertyName, propertyValue);
}
/**
* Sets property.
*
* @param iV8ValueObject the V8 value object
* @param key the key
* @param value the value
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 0.7.0
*/
@SuppressWarnings("RedundantThrows")
boolean objectSetProperty(IV8ValueObject iV8ValueObject, V8Value key, V8Value value) throws JavetException {
return v8Native.objectSetProperty(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key, value);
}
/**
* Sets prototype.
*
* @param iV8ValueObject the V8 value object
* @param iV8ValueObjectPrototype the V8 value object prototype
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 0.9.4
*/
@SuppressWarnings("RedundantThrows")
boolean objectSetPrototype(
IV8ValueObject iV8ValueObject, IV8ValueObject iV8ValueObjectPrototype)
throws JavetException {
return v8Native.objectSetPrototype(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(),
iV8ValueObjectPrototype.getHandle());
}
/**
* Sets a property of an object to a string value by a key
*
* @param iV8ValueObject the V8 value object
* @param key the key
* @param value the value
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
boolean objectSetString(
IV8ValueObject iV8ValueObject, V8Value key, String value)
throws JavetException {
return v8Native.objectSetString(
handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key, value);
}
/**
* Sets a property of an object to undefined by a key
*
* @param iV8ValueObject the V8 value object
* @param key the key
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
boolean objectSetUndefined(IV8ValueObject iV8ValueObject, V8Value key) throws JavetException {
return v8Native.objectSetUndefined(handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key);
}
/**
* Gets a proto string from a reference.
*
* @param iV8ValueReference the V8 value reference
* @return the proto string
* @throws JavetException the javet exception
* @since 0.8.4
*/
@SuppressWarnings("RedundantThrows")
String objectToProtoString(IV8ValueReference iV8ValueReference) throws JavetException {
return v8Native.objectToProtoString(handle, iV8ValueReference.getHandle(), iV8ValueReference.getType().getId());
}
/**
* Call Promise.catch().
*
* @param the type parameter
* @param iV8ValuePromise the V8 value promise
* @param functionHandle the function handle
* @return the V8 value promise
* @throws JavetException the javet exception
* @since 0.8.0
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
T promiseCatch(
IV8ValuePromise iV8ValuePromise, IV8ValueFunction functionHandle) throws JavetException {
return (T) v8Native.promiseCatch(
handle, iV8ValuePromise.getHandle(), iV8ValuePromise.getType().getId(), functionHandle.getHandle());
}
/**
* Gets a promise from a promise resolver.
*
* @param iV8ValuePromise the V8 value promise
* @return the V8 value promise
* @throws JavetException the javet exception
* @since 0.9.8
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
V8ValuePromise promiseGetPromise(IV8ValuePromise iV8ValuePromise) throws JavetException {
return (V8ValuePromise) v8Native.promiseGetPromise(
handle, iV8ValuePromise.getHandle(), iV8ValuePromise.getType().getId());
}
/**
* Gets the result from a promise.
*
* @param the type parameter
* @param iV8ValuePromise the V8 value promise
* @return the result
* @throws JavetException the javet exception
* @since 0.8.0
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
T promiseGetResult(IV8ValuePromise iV8ValuePromise) throws JavetException {
return (T) v8Native.promiseGetResult(
handle, iV8ValuePromise.getHandle(), iV8ValuePromise.getType().getId());
}
/**
* Gets the state from a promise.
*
* @param iV8ValuePromise the V8 value promise
* @return the state
* @since 0.8.4
*/
int promiseGetState(IV8ValuePromise iV8ValuePromise) {
return v8Native.promiseGetState(handle, iV8ValuePromise.getHandle(), iV8ValuePromise.getType().getId());
}
/**
* Returns whether a promise has a handler or not.
*
* @param iV8ValuePromise the V8 value promise
* @return true : yes, false : false
* @since 0.8.4
*/
boolean promiseHasHandler(IV8ValuePromise iV8ValuePromise) {
return v8Native.promiseHasHandler(handle, iV8ValuePromise.getHandle(), iV8ValuePromise.getType().getId());
}
/**
* Mark a promise as handled.
*
* @param iV8ValuePromise the V8 value promise
* @since 0.8.4
*/
void promiseMarkAsHandled(IV8ValuePromise iV8ValuePromise) {
v8Native.promiseMarkAsHandled(handle, iV8ValuePromise.getHandle(), iV8ValuePromise.getType().getId());
}
/**
* Rejects a promise by a value.
*
* @param v8ValuePromise the V8 value promise
* @param v8Value the V8 value
* @return true : rejected, false : not rejected
* @since 0.8.4
*/
boolean promiseReject(V8ValuePromise v8ValuePromise, V8Value v8Value) {
return v8Native.promiseReject(
handle, v8ValuePromise.getHandle(), v8ValuePromise.getType().getId(), v8Value);
}
/**
* Call Promise.resolve() by a value.
*
* @param v8ValuePromise the V8 value promise
* @param v8Value the V8 value
* @return true : resolved, false : not resolved
* @since 0.9.8
*/
boolean promiseResolve(V8ValuePromise v8ValuePromise, V8Value v8Value) {
return v8Native.promiseResolve(
handle, v8ValuePromise.getHandle(), v8ValuePromise.getType().getId(), v8Value);
}
/**
* Call Promise.then() by a function fulfilled handle and a function rejected handle.
*
* @param the type parameter
* @param iV8ValuePromise the V8 value promise
* @param functionFulfilledHandle the function fulfilled handle
* @param functionRejectedHandle the function rejected handle
* @return the result promise
* @throws JavetException the javet exception
* @since 0.8.0
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
T promiseThen(
IV8ValuePromise iV8ValuePromise, IV8ValueFunction functionFulfilledHandle,
IV8ValueFunction functionRejectedHandle) throws JavetException {
return (T) v8Native.promiseThen(
handle, iV8ValuePromise.getHandle(), iV8ValuePromise.getType().getId(),
functionFulfilledHandle.getHandle(),
functionRejectedHandle == null ? 0L : functionRejectedHandle.getHandle());
}
/**
* Promote scheduled exception.
*
* @return true : success, false : failure
* @throws JavetException the javet exception
* @since 1.0.4
*/
@SuppressWarnings("RedundantThrows")
public boolean promoteScheduledException() throws JavetException {
return v8Native.promoteScheduledException(handle);
}
/**
* Gets a handler from a proxy
*
* @param iV8ValueProxy the V8 value proxy
* @return the handler
* @throws JavetException the javet exception
* @since 0.9.6
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
V8ValueObject proxyGetHandler(IV8ValueProxy iV8ValueProxy) throws JavetException {
return (V8ValueObject) v8Native.proxyGetHandler(
handle, iV8ValueProxy.getHandle(), iV8ValueProxy.getType().getId());
}
/**
* Gets the target from a proxy.
*
* @param iV8ValueProxy the V8 value proxy
* @return the target
* @throws JavetException the javet exception
* @since 0.9.6
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
V8ValueObject proxyGetTarget(IV8ValueProxy iV8ValueProxy) throws JavetException {
return (V8ValueObject) v8Native.proxyGetTarget(
handle, iV8ValueProxy.getHandle(), iV8ValueProxy.getType().getId());
}
/**
* Returns whether a proxy is revoked or not.
*
* @param iV8ValueProxy the V8 value proxy
* @return true : revoked, false : not revoked
* @throws JavetException the javet exception
* @since 0.9.6
*/
@SuppressWarnings("RedundantThrows")
boolean proxyIsRevoked(IV8ValueProxy iV8ValueProxy) throws JavetException {
return v8Native.proxyIsRevoked(handle, iV8ValueProxy.getHandle(), iV8ValueProxy.getType().getId());
}
/**
* Revokes a proxy.
*
* @param iV8ValueProxy the V8 value proxy
* @throws JavetException the javet exception
* @since 0.9.6
*/
@SuppressWarnings("RedundantThrows")
void proxyRevoke(IV8ValueProxy iV8ValueProxy) throws JavetException {
v8Native.proxyRevoke(handle, iV8ValueProxy.getHandle(), iV8ValueProxy.getType().getId());
}
/**
* Receives the GC epilogue callback from JNI.
*
* @param v8GCTypeValue the V8 GC type value
* @param v8GCCallbackFlagsValue the V8 GC callback flags value
* @since 1.0.3
*/
void receiveGCEpilogueCallback(int v8GCTypeValue, int v8GCCallbackFlagsValue) {
final EnumSet enumSetV8GCType = IEnumBitset.getEnumSet(v8GCTypeValue, V8GCType.class);
final EnumSet enumSetV8GCCallbackFlags = IEnumBitset.getEnumSet(
v8GCCallbackFlagsValue, V8GCCallbackFlags.class, V8GCCallbackFlags.NoGCCallbackFlags);
for (IJavetGCCallback iJavetGCCallback : gcEpilogueCallbacks) {
iJavetGCCallback.callback(enumSetV8GCType, enumSetV8GCCallbackFlags);
}
}
/**
* Receives the GC prologue callback from JNI.
*
* @param v8GCTypeValue the V8 GC type value
* @param v8GCCallbackFlagsValue the V8 GC callback flags value
* @since 1.0.3
*/
void receiveGCPrologueCallback(int v8GCTypeValue, int v8GCCallbackFlagsValue) {
final EnumSet enumSetV8GCType = IEnumBitset.getEnumSet(v8GCTypeValue, V8GCType.class);
final EnumSet enumSetV8GCCallbackFlags = IEnumBitset.getEnumSet(
v8GCCallbackFlagsValue, V8GCCallbackFlags.class, V8GCCallbackFlags.NoGCCallbackFlags);
for (IJavetGCCallback iJavetGCCallback : gcPrologueCallbacks) {
iJavetGCCallback.callback(enumSetV8GCType, enumSetV8GCCallbackFlags);
}
}
/**
* Receives the promise reject callback from JNI.
*
* @param event the event
* @param promise the promise
* @param value the value
* @since 0.9.1
*/
void receivePromiseRejectCallback(int event, V8ValuePromise promise, V8Value value) {
try {
promiseRejectCallback.callback(JavetPromiseRejectEvent.parse(event), promise, value);
} catch (Throwable t) {
logger.logError(t, "Failed to process promise reject callback {0}.", event);
} finally {
JavetResourceUtils.safeClose(promise, value);
}
}
/**
* Remove all references.
*
* @throws JavetException the javet exception
* @since 0.8.3
*/
void removeAllReferences() throws JavetException {
removeReferences();
removeCallbackContexts();
removeV8Modules();
v8Inspector = null;
}
/**
* Remove a callback context by a handle.
*
* @param handle the handle
* @since 0.8.3
*/
public void removeCallbackContext(long handle) {
synchronized (callbackContextLock) {
callbackContextMap.remove(handle);
}
}
/**
* Remove callback contexts.
*
* @since 0.8.3
*/
void removeCallbackContexts() {
synchronized (callbackContextLock) {
if (!callbackContextMap.isEmpty()) {
logger.logWarn("{0} V8 callback context object(s) not recycled.",
Integer.toString(callbackContextMap.size()));
callbackContextMap.clear();
}
}
}
/**
* Remove a GC epilogue callback.
*
* @param iJavetGCCallback the javet GC callback
* @since 1.0.3
*/
public void removeGCEpilogueCallback(IJavetGCCallback iJavetGCCallback) {
synchronized (gcEpilogueCallbacks) {
gcEpilogueCallbacks.remove(Objects.requireNonNull(iJavetGCCallback));
if (gcEpilogueCallbacks.isEmpty()) {
v8Native.unregisterGCEpilogueCallback(handle);
}
}
}
/**
* Remove a GC prologue callback.
*
* @param iJavetGCCallback the javet GC callback
* @since 1.0.3
*/
public void removeGCPrologueCallback(IJavetGCCallback iJavetGCCallback) {
synchronized (gcPrologueCallbacks) {
gcPrologueCallbacks.remove(Objects.requireNonNull(iJavetGCCallback));
if (gcPrologueCallbacks.isEmpty()) {
v8Native.unregisterGCPrologueCallback(handle);
}
}
}
/**
* Remove a JNI global ref by a handle.
*
* @param handle the handle
* @since 0.8.0
*/
void removeJNIGlobalRef(long handle) {
if (!isClosed()) {
v8Native.removeJNIGlobalRef(handle);
}
}
/**
* Remove reference.
*
* @param iV8ValueReference the V8 value reference
* @throws JavetException the javet exception
* @since 0.7.0
*/
@SuppressWarnings("RedundantThrows")
void removeReference(IV8ValueReference iV8ValueReference) throws JavetException {
final long referenceHandle = iV8ValueReference.getHandle();
synchronized (referenceLock) {
if (referenceMap.remove(referenceHandle) != null) {
final int referenceType = iV8ValueReference.getType().getId();
if (referenceType == V8ValueReferenceType.Module.getId()) {
removeV8Module((IV8Module) iV8ValueReference);
}
v8Native.removeReferenceHandle(handle, referenceHandle, referenceType);
}
}
if (gcScheduled) {
lowMemoryNotification();
gcScheduled = false;
}
}
/**
* Remove all references.
*
* @throws JavetException the javet exception
* @since 0.7.0
*/
void removeReferences() throws JavetException {
synchronized (referenceLock) {
if (!referenceMap.isEmpty()) {
final int referenceCount = getReferenceCount();
final int v8ModuleCount = getV8ModuleCount();
int weakReferenceCount = 0;
for (IV8ValueReference iV8ValueReference : new ArrayList<>(referenceMap.values())) {
if (iV8ValueReference instanceof IV8ValueObject) {
IV8ValueObject iV8ValueObject = (IV8ValueObject) iV8ValueReference;
if (iV8ValueObject.isWeak()) {
++weakReferenceCount;
}
}
iV8ValueReference.close(true);
}
if (v8ModuleCount + weakReferenceCount < referenceCount) {
logger.logWarn("{0} V8 object(s) not recycled, {1} weak, {2} module(s).",
Integer.toString(referenceCount),
Integer.toString(weakReferenceCount),
Integer.toString(v8ModuleCount));
} else {
logger.logDebug("{0} V8 object(s) not recycled, {1} weak, {2} module(s).",
Integer.toString(referenceCount),
Integer.toString(weakReferenceCount),
Integer.toString(v8ModuleCount));
}
referenceMap.clear();
}
}
}
/**
* Remove a V8 module by a resource name and force close flag.
*
* @param resourceName the resource name
* @param forceClose the force close
* @throws JavetException the javet exception
* @since 0.9.12
*/
public void removeV8Module(String resourceName, boolean forceClose) throws JavetException {
IV8Module iV8Module;
synchronized (v8ModuleLock) {
iV8Module = v8ModuleMap.remove(resourceName);
}
if (forceClose && iV8Module != null) {
iV8Module.close(true);
}
}
/**
* Remove a V8 module by a resource name.
*
* @param resourceName the resource name
* @throws JavetException the javet exception
* @since 0.9.4
*/
public void removeV8Module(String resourceName) throws JavetException {
removeV8Module(resourceName, false);
}
/**
* Remove a V8 module.
*
* @param iV8Module the V8 module
* @throws JavetException the javet exception
* @since 0.9.4
*/
public void removeV8Module(IV8Module iV8Module) throws JavetException {
removeV8Module(iV8Module, false);
}
/**
* Remove a V8 module by a force close flag.
*
* @param iV8Module the V8 module
* @param forceClose the force close
* @throws JavetException the javet exception
* @since 0.9.4
*/
public void removeV8Module(IV8Module iV8Module, boolean forceClose) throws JavetException {
removeV8Module(iV8Module.getResourceName(), forceClose);
}
/**
* Remove all V8 modules.
*
* @throws JavetException the javet exception
* @since 0.9.3
*/
public void removeV8Modules() throws JavetException {
removeV8Modules(false);
}
/**
* Remove all V8 modules by a force close flag.
*
* @param forceClose the force close
* @throws JavetException the javet exception
* @since 0.8.3
*/
public void removeV8Modules(boolean forceClose) throws JavetException {
synchronized (v8ModuleLock) {
if (!v8ModuleMap.isEmpty()) {
logger.logWarn("{0} V8 module(s) not recycled.", Integer.toString(v8ModuleMap.size()));
for (IV8Module iV8Module : v8ModuleMap.values()) {
logger.logWarn(" V8 module: {0}", iV8Module.getResourceName());
if (forceClose) {
iV8Module.close(true);
}
}
v8ModuleMap.clear();
}
}
}
/**
* Report pending messages.
*
* @return true : reported, false : not reported
* @throws JavetException the javet exception
* @since 1.0.4
*/
@SuppressWarnings("RedundantThrows")
public boolean reportPendingMessages() throws JavetException {
return v8Native.reportPendingMessages(handle);
}
/**
* Requests GC for testing.
* Note: --expose_gc must be set.
*
* @param fullGC true : Full GC, false : Minor GC
* @since 0.8.0
*/
public void requestGarbageCollectionForTesting(boolean fullGC) {
v8Native.requestGarbageCollectionForTesting(handle, fullGC);
}
/**
* Resets the V8 context.
*
* This is a light-weight and recommended reset.
*
* @throws JavetException the javet exception
* @since 0.7.0
*/
public void resetContext() throws JavetException {
removeAllReferences();
v8Native.resetV8Context(handle, runtimeOptions);
}
/**
* Resets the V8 isolate.
*
* This is a heavy reset. Please avoid using it in performance sensitive scenario.
*
* @throws JavetException the javet exception
* @since 0.7.0
*/
@SuppressWarnings("UnusedReturnValue")
public void resetIsolate() throws JavetException {
removeAllReferences();
v8Native.resetV8Isolate(handle, runtimeOptions);
}
/**
* Tests whether 2 objects are the same in value.
*
* @param iV8ValueObject1 the V8 value object 1
* @param iV8ValueObject2 the V8 value object 2
* @return true : same, false : not same
* @since 0.8.4
*/
boolean sameValue(IV8ValueObject iV8ValueObject1, IV8ValueObject iV8ValueObject2) {
return v8Native.sameValue(handle, iV8ValueObject1.getHandle(), iV8ValueObject2.getHandle());
}
/**
* Get cached data from a script.
*
* @param iV8Script the V8 script
* @return the cached data
* @throws JavetException the javet exception
* @since 2.0.3
*/
@SuppressWarnings("RedundantThrows")
byte[] scriptGetCachedData(IV8Script iV8Script) throws JavetException {
return v8Native.scriptGetCachedData(handle, iV8Script.getHandle(), iV8Script.getType().getId());
}
/**
* Get resource name from a script.
*
* @param iV8Script the V8 script
* @return the resource name
* @throws JavetException the javet exception
* @since 3.1.0
*/
@SuppressWarnings("RedundantThrows")
String scriptGetResourceName(IV8Script iV8Script) throws JavetException {
return v8Native.scriptGetResourceName(handle, iV8Script.getHandle(), iV8Script.getType().getId());
}
/**
* Run a script.
*
* @param the type parameter
* @param iV8Script the V8 script
* @param resultRequired the result required
* @return the result
* @throws JavetException the javet exception
* @since 0.8.0
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
T scriptRun(
IV8Script iV8Script, boolean resultRequired) throws JavetException {
return (T) v8Native.scriptRun(
handle, iV8Script.getHandle(), iV8Script.getType().getId(), resultRequired);
}
/**
* Add a value to a set.
*
* @param iV8ValueSet the V8 value set
* @param key the key
* @throws JavetException the javet exception
* @since 0.7.0
*/
@SuppressWarnings("RedundantThrows")
void setAdd(IV8ValueSet iV8ValueSet, V8Value key) throws JavetException {
v8Native.setAdd(handle, iV8ValueSet.getHandle(), iV8ValueSet.getType().getId(), key);
}
/**
* Convert set to array.
*
* @param iV8ValueSet the V8 value set
* @return the V8 value array
* @throws JavetException the javet exception
* @since 3.0.4
*/
@SuppressWarnings("RedundantThrows")
@CheckReturnValue
V8ValueArray setAsArray(IV8ValueSet iV8ValueSet) throws JavetException {
return (V8ValueArray) v8Native.setAsArray(handle, iV8ValueSet.getHandle(), iV8ValueSet.getType().getId());
}
/**
* Clear the set.
*
* @param iV8ValueSet the V8 value set
* @since 3.0.4
*/
void setClear(IV8ValueSet iV8ValueSet) {
v8Native.setClear(handle, iV8ValueSet.getHandle(), iV8ValueSet.getType().getId());
}
/**
* Sets converter.
*
* @param converter the converter
* @since 0.9.1
*/
public void setConverter(IJavetConverter converter) {
Objects.requireNonNull(converter);
this.converter = converter;
}
/**
* Delete a key from a set.
*
* @param iV8ValueSet the V8 value set
* @param key the key
* @return true : deleted, false : key is not found
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
boolean setDelete(IV8ValueSet iV8ValueSet, V8Value key) throws JavetException {
return v8Native.setDelete(handle, iV8ValueSet.getHandle(), iV8ValueSet.getType().getId(), key);
}
/**
* Sets GC scheduled.
*
* @param gcScheduled the GC scheduled
* @since 0.9.1
*/
public void setGCScheduled(boolean gcScheduled) {
this.gcScheduled = gcScheduled;
}
/**
* Gets size from a set.
*
* @param iV8ValueSet the V8 value set
* @return the size
* @throws JavetException the javet exception
* @since 0.7.0
*/
@SuppressWarnings("RedundantThrows")
int setGetSize(IV8ValueSet iV8ValueSet) throws JavetException {
return v8Native.setGetSize(handle, iV8ValueSet.getHandle(), iV8ValueSet.getType().getId());
}
/**
* Has a property in a set.
*
* @param iV8ValueSet the V8 value set
* @param key the key
* @return true : yes, false : no
* @throws JavetException the javet exception
* @since 2.2.0
*/
@SuppressWarnings("RedundantThrows")
boolean setHas(IV8ValueSet iV8ValueSet, V8Value key) throws JavetException {
return v8Native.setHas(handle, iV8ValueSet.getHandle(), iV8ValueSet.getType().getId(), key);
}
/**
* Sets logger.
*
* @param logger the logger
* @since 0.9.1
*/
public void setLogger(IJavetLogger logger) {
this.logger = logger;
}
/**
* Sets promise reject callback.
*
* @param promiseRejectCallback the promise reject callback
* @since 0.9.1
*/
public void setPromiseRejectCallback(IJavetPromiseRejectCallback promiseRejectCallback) {
Objects.requireNonNull(promiseRejectCallback);
this.promiseRejectCallback = promiseRejectCallback;
}
/**
* Sets V8 module resolver.
*
* @param v8ModuleResolver the V8 module resolver
* @since 0.9.3
*/
public void setV8ModuleResolver(IV8ModuleResolver v8ModuleResolver) {
this.v8ModuleResolver = v8ModuleResolver;
}
/**
* Sets a reference to weak.
*
* @param iV8ValueReference the V8 value reference
* @since 0.8.4
*/
void setWeak(IV8ValueReference iV8ValueReference) {
v8Native.setWeak(handle, iV8ValueReference.getHandle(), iV8ValueReference.getType().getId(), iV8ValueReference);
}
/**
* Tests whether 2 objects are strict equal.
*
* @param iV8ValueObject1 the V8 value object 1
* @param iV8ValueObject2 the V8 value object 2
* @return true : strict equal, false: not strict equal
* @since 0.8.4
*/
boolean strictEquals(IV8ValueObject iV8ValueObject1, IV8ValueObject iV8ValueObject2) {
return v8Native.strictEquals(handle, iV8ValueObject1.getHandle(), iV8ValueObject2.getHandle());
}
/**
* From string object to string.
*
* @param v8ValueStringObject the V8 value string object
* @return the V8 value string
* @since 3.0.4
*/
V8ValueString stringObjectValueOf(V8ValueStringObject v8ValueStringObject) {
return (V8ValueString) v8Native.stringObjectValueOf(
handle, Objects.requireNonNull(v8ValueStringObject).getHandle(), v8ValueStringObject.getType().getId());
}
/**
* Symbol description.
*
* @param v8ValueSymbol the V8 value symbol
* @return the description
* @since 3.0.4
*/
String symbolDescription(V8ValueSymbol v8ValueSymbol) {
return v8Native.symbolDescription(
handle, Objects.requireNonNull(v8ValueSymbol).getHandle(), v8ValueSymbol.getType().getId());
}
/**
* From symbol object to symbol.
*
* @param v8ValueSymbolObject the V8 value symbol object
* @return the V8 value symbol
* @since 3.0.4
*/
V8ValueSymbol symbolObjectValueOf(V8ValueSymbolObject v8ValueSymbolObject) {
return (V8ValueSymbol) v8Native.symbolObjectValueOf(
handle, Objects.requireNonNull(v8ValueSymbolObject).getHandle(), v8ValueSymbolObject.getType().getId());
}
/**
* From symbol to symbol object.
*
* @param v8ValueSymbol the V8 value symbol
* @return the V8 value symbol object
* @since 3.0.4
*/
V8ValueSymbolObject symbolToObject(V8ValueSymbol v8ValueSymbol) {
return (V8ValueSymbolObject) v8Native.symbolToObject(
handle, Objects.requireNonNull(v8ValueSymbol).getHandle(), v8ValueSymbol.getType().getId());
}
/**
* Terminate execution.
*
* Forcefully terminate the current thread of JavaScript execution
* in the given isolate.
*
* This method can be used by any thread even if that thread has not
* acquired the V8 lock with a Locker object.
*
* @since 0.8.0
*/
public void terminateExecution() {
v8Native.terminateExecution(handle);
}
/**
* Throw error.
*
* @param v8ValueErrorType the V8 value error type
* @param message the message
* @return true : thrown, false : not thrown
* @since 3.0.4
*/
public boolean throwError(V8ValueErrorType v8ValueErrorType, String message) {
return v8Native.throwError(
handle, Objects.requireNonNull(v8ValueErrorType).getId(), Objects.requireNonNull(message));
}
/**
* Throw error.
*
* @param errorObject the error object
* @return true : thrown, false : not thrown
* @throws JavetException the javet exception
* @since 3.0.4
*/
public boolean throwError(Object errorObject) throws JavetException {
try (V8VirtualValue v8VirtualValue = new V8VirtualValue(
this, getConverter(), Objects.requireNonNull(errorObject))) {
return throwError(v8VirtualValue.get());
}
}
/**
* Throw error.
*
* @param errorV8Value the error v 8 value
* @return true : thrown, false : not thrown
* @since 3.0.4
*/
public boolean throwError(V8Value errorV8Value) {
assert !(errorV8Value instanceof V8Context) : ERROR_VALUE_CANNOT_BE_A_V_8_CONTEXT;
assert !(errorV8Value instanceof V8Module) : ERROR_VALUE_CANNOT_BE_A_V_8_MODULE;
assert !(errorV8Value instanceof V8Script) : ERROR_VALUE_CANNOT_BE_A_V_8_SCRIPT;
return v8Native.throwError(handle, Objects.requireNonNull(errorV8Value));
}
@Override
public T toObject(V v8Value) throws JavetException {
return converter.toObject(v8Value);
}
/**
* Call toString().
*
* @param iV8ValueReference the V8 value reference
* @return the string
* @throws JavetException the javet exception
* @since 0.8.0
*/
@SuppressWarnings("RedundantThrows")
String toString(IV8ValueReference iV8ValueReference) throws JavetException {
return v8Native.toString(handle, iV8ValueReference.getHandle(), iV8ValueReference.getType().getId());
}
@Override
@CheckReturnValue
public V toV8Value(T object) throws JavetException {
return converter.toV8Value(this, object);
}
}