diff --git a/.github/workflows/linux_build.yml b/.github/workflows/linux_build.yml index 29d038800..8b24f847e 100644 --- a/.github/workflows/linux_build.yml +++ b/.github/workflows/linux_build.yml @@ -5,11 +5,11 @@ on: types: [opened, synchronize, reopened, ready_for_review] paths-ignore: - '**.rst' - - 'doc/**' + - 'docs/**' push: paths-ignore: - '**.rst' - - 'doc/**' + - 'docs/**' jobs: diff --git a/.idea/codeStyles/Project.xml b/.idea/codeStyles/Project.xml new file mode 100644 index 000000000..62305e2d8 --- /dev/null +++ b/.idea/codeStyles/Project.xml @@ -0,0 +1,298 @@ + + + + + + + + + + +
+ + + + true + true + true + true + + + +
+
+ + + + true + true + true + true + + + BY_NAME + +
+
+ + + + true + true + true + true + + + BY_NAME + +
+
+ + + + true + true + true + true + + + BY_NAME + +
+
+ + + + true + true + true + + + BY_NAME + +
+
+ + + + true + true + true + + + BY_NAME + +
+
+ + + + true + true + true + + + BY_NAME + +
+
+ + + + true + true + true + + + BY_NAME + +
+
+ + + + true + true + + + +
+
+ + + + true + true + true + + + BY_NAME + +
+
+ + + + true + true + true + + + BY_NAME + +
+
+ + + + true + true + true + + + BY_NAME + +
+
+ + + + true + true + true + + + BY_NAME + +
+
+ + + + true + true + + + BY_NAME + +
+
+ + + + true + true + + + BY_NAME + +
+
+ + + + true + true + + + BY_NAME + +
+
+ + + + true + true + + + BY_NAME + +
+
+ + + true + + BY_NAME + +
+
+ + + true + + +
+
+ + + true + + BY_NAME + +
+
+ + + + true + true + + + BY_NAME + +
+
+ + + true + + BY_NAME + +
+
+ + + true + + BY_NAME + +
+
+ + + true + + BY_NAME + +
+
+ + + + true + true + + + BY_NAME + +
+
+ + + true + + BY_NAME + +
+ + + + + + + \ No newline at end of file diff --git a/.idea/codeStyles/codeStyleConfig.xml b/.idea/codeStyles/codeStyleConfig.xml new file mode 100644 index 000000000..307554b77 --- /dev/null +++ b/.idea/codeStyles/codeStyleConfig.xml @@ -0,0 +1,5 @@ + + + + \ No newline at end of file diff --git a/.idea/copyright/Apache_License_2_0.xml b/.idea/copyright/Apache_License_2_0.xml new file mode 100644 index 000000000..0fd503e41 --- /dev/null +++ b/.idea/copyright/Apache_License_2_0.xml @@ -0,0 +1,6 @@ + + + + \ No newline at end of file diff --git a/.idea/copyright/profiles_settings.xml b/.idea/copyright/profiles_settings.xml new file mode 100644 index 000000000..47b33c7cd --- /dev/null +++ b/.idea/copyright/profiles_settings.xml @@ -0,0 +1,7 @@ + + + + + + + \ No newline at end of file diff --git a/README.rst b/README.rst index aed20879a..57fde7898 100644 --- a/README.rst +++ b/README.rst @@ -15,11 +15,11 @@ Javet .. |Linux Build| image:: https://img.shields.io/github/workflow/status/caoccao/Javet/Linux%20Build?label=Linux%20Build&style=for-the-badge :target: https://github.com/caoccao/Javet/actions/workflows/linux_build.yml -Javet is Java + V8 (JAVa + V + EighT). It is an awesome way of embedding Node.js and V8 in Java. +`Javet `_ is Java + V8 (JAVa + V + EighT). It is an awesome way of embedding Node.js and V8 in Java. If you like my work, please **Star** this project. And, you may follow me `@sjtucaocao `_, or visit http://caoccao.blogspot.com/. And the official support channel is at `discord `_. -💖 If you use Mac OS (x86_64), please be aware that the Mac OS (x86_64) build will discontinue anytime because my MacBook Air mid-2012 will be soon deprecated by new version of V8. Please `donate `_ to support me purchasing a new Mac OS (x86_64) device. +💖 If you use Mac OS (x86_64), please be aware that the Mac OS (x86_64) build will discontinue anytime because my `MacBook Air mid-2012 `_ will be soon deprecated by new version of V8. Please `donate `_ to support me purchasing a new Mac OS (x86_64) device. Or, if you have a retired Mac OS (x86_64) device and are fine with mailing it to me, that will also be great. Thank you for supporting Javet. 💖 If you use Mac OS (arm64), unfortunately there is no Mac OS (arm64) build because I don't have any Mac OS (arm64) device. Please `donate `_ to support me purchasing a new Mac OS (arm64) device. @@ -52,14 +52,14 @@ Maven com.caoccao.javet javet - 0.9.11 + 0.9.12 com.caoccao.javet javet-macos - 0.9.11 + 0.9.12 Gradle Kotlin DSL @@ -67,16 +67,16 @@ Gradle Kotlin DSL .. code-block:: kotlin - implementation("com.caoccao.javet:javet:0.9.11") // Linux or Windows - implementation("com.caoccao.javet:javet-macos:0.9.11") // Mac OS (x86_64 Only) + implementation("com.caoccao.javet:javet:0.9.12") // Linux or Windows + implementation("com.caoccao.javet:javet-macos:0.9.12") // Mac OS (x86_64 Only) Gradle Groovy DSL ^^^^^^^^^^^^^^^^^ .. code-block:: groovy - implementation 'com.caoccao.javet:javet:0.9.11' // Linux or Windows - implementation 'com.caoccao.javet:javet-macos:0.9.11' // Mac OS (x86_64 Only) + implementation 'com.caoccao.javet:javet:0.9.12' // Linux or Windows + implementation 'com.caoccao.javet:javet-macos:0.9.12' // Mac OS (x86_64 Only) Hello Javet ----------- @@ -93,17 +93,13 @@ Hello Javet System.out.println(v8Runtime.getExecutor("'Hello Javet'").executeString()); } -Documents -========= - -* `Javet Intro `_ -* `Tutorial `_ -* `Reference `_ -* `Release Notes `_ -* `FAQ `_ -* `Development `_ - License ======= `APACHE LICENSE, VERSION 2.0 `_. + +Documents +========= + +* `Javet Intro `_ +* `Javet Document Portal `_ diff --git a/build.gradle.kts b/build.gradle.kts index 2164263e1..f648ccb0c 100644 --- a/build.gradle.kts +++ b/build.gradle.kts @@ -25,7 +25,7 @@ repositories { } group = "com.caoccao.javet" -version = "0.9.11" +version = "0.9.12" repositories { mavenCentral() diff --git a/cpp/build-linux.sh b/cpp/build-linux.sh index 879ebac19..c7e6995d9 100755 --- a/cpp/build-linux.sh +++ b/cpp/build-linux.sh @@ -2,7 +2,7 @@ # Usage for V8: sh build-linux.sh -DV8_DIR=${HOME}/v8 # Usage for Node: sh build-linux.sh -DNODE_DIR=${HOME}/node -JAVET_VERSION=0.9.11 +JAVET_VERSION=0.9.12 rm -rf build mkdir build cd build diff --git a/cpp/build-macos.sh b/cpp/build-macos.sh index 073a9db44..e91abec9e 100755 --- a/cpp/build-macos.sh +++ b/cpp/build-macos.sh @@ -2,7 +2,7 @@ # Usage for V8: sh build-macos.sh -DV8_DIR=${HOME}/v8 # Usage for Node: sh build-macos.sh -DNODE_DIR=${HOME}/node -JAVET_VERSION=0.9.11 +JAVET_VERSION=0.9.12 rm -rf build mkdir build cd build diff --git a/cpp/build-windows.cmd b/cpp/build-windows.cmd index 6cf06435c..4c8a3ca65 100644 --- a/cpp/build-windows.cmd +++ b/cpp/build-windows.cmd @@ -1,7 +1,7 @@ @echo off REM Usage for V8: build -DV8_DIR=C:\v8 REM Usage for Node: build -DNODE_DIR=C:\node -SET JAVET_VERSION=0.9.11 +SET JAVET_VERSION=0.9.12 rd /s/q build mkdir build cd build diff --git a/cpp/jni/com_caoccao_javet_interop_V8Native.cpp b/cpp/jni/com_caoccao_javet_interop_V8Native.cpp index 650314b8e..738e8f9fc 100644 --- a/cpp/jni/com_caoccao_javet_interop_V8Native.cpp +++ b/cpp/jni/com_caoccao_javet_interop_V8Native.cpp @@ -396,6 +396,18 @@ JNIEXPORT jboolean JNICALL Java_com_caoccao_javet_interop_V8Native_delete return false; } +JNIEXPORT jboolean JNICALL Java_com_caoccao_javet_interop_V8Native_deletePrivateProperty +(JNIEnv* jniEnv, jobject caller, jlong v8RuntimeHandle, jlong v8ValueHandle, jint v8ValueType, jstring mKey) { + RUNTIME_AND_VALUE_HANDLES_TO_OBJECTS_WITH_SCOPE(v8RuntimeHandle, v8ValueHandle); + if (v8LocalValue->IsObject()) { + auto v8LocalStringKey = Javet::Converter::ToV8String(jniEnv, v8Context, mKey); + auto v8LocalPrivateKey = v8::Private::ForApi(v8Context->GetIsolate(), v8LocalStringKey); + auto v8MaybeBool = v8LocalValue.As()->DeletePrivate(v8Context, v8LocalPrivateKey); + return v8MaybeBool.FromMaybe(false); + } + return false; +} + JNIEXPORT jboolean JNICALL Java_com_caoccao_javet_interop_V8Native_equals (JNIEnv* jniEnv, jobject caller, jlong v8RuntimeHandle, jlong v8ValueHandle1, jlong v8ValueHandle2) { RUNTIME_AND_2_VALUES_HANDLES_TO_OBJECTS_WITH_SCOPE(v8RuntimeHandle, v8ValueHandle1, v8ValueHandle2); @@ -578,7 +590,24 @@ JNIEXPORT jobject JNICALL Java_com_caoccao_javet_interop_V8Native_getOwnProperty } if (v8LocalValue->IsObject()) { auto v8LocalObject = v8LocalValue.As(); - return v8Runtime->SafeToExternalV8Value(jniEnv, v8Context, v8LocalObject->GetOwnPropertyNames(v8Context).ToLocalChecked()); + auto v8MaybeLocalArray = v8LocalObject->GetOwnPropertyNames(v8Context); + if (!v8MaybeLocalArray.IsEmpty()) { + return v8Runtime->SafeToExternalV8Value(jniEnv, v8Context, v8MaybeLocalArray.ToLocalChecked()); + } + } + return Javet::Converter::ToExternalV8ValueUndefined(jniEnv, v8Runtime->externalV8Runtime); +} + +JNIEXPORT jobject JNICALL Java_com_caoccao_javet_interop_V8Native_getPrivateProperty +(JNIEnv* jniEnv, jobject caller, jlong v8RuntimeHandle, jlong v8ValueHandle, jint v8ValueType, jstring mKey) { + RUNTIME_AND_VALUE_HANDLES_TO_OBJECTS_WITH_SCOPE(v8RuntimeHandle, v8ValueHandle); + if (v8LocalValue->IsObject()) { + auto v8LocalStringKey = Javet::Converter::ToV8String(jniEnv, v8Context, mKey); + auto v8LocalPrivateKey = v8::Private::ForApi(v8Context->GetIsolate(), v8LocalStringKey); + auto v8MaybeLocalValue = v8LocalValue.As()->GetPrivate(v8Context, v8LocalPrivateKey); + if (!v8MaybeLocalValue.IsEmpty()) { + return v8Runtime->SafeToExternalV8Value(jniEnv, v8Context, v8MaybeLocalValue.ToLocalChecked()); + } } return Javet::Converter::ToExternalV8ValueUndefined(jniEnv, v8Runtime->externalV8Runtime); } @@ -716,6 +745,18 @@ JNIEXPORT jboolean JNICALL Java_com_caoccao_javet_interop_V8Native_hasOwnPropert return false; } +JNIEXPORT jboolean JNICALL Java_com_caoccao_javet_interop_V8Native_hasPrivateProperty +(JNIEnv* jniEnv, jobject caller, jlong v8RuntimeHandle, jlong v8ValueHandle, jint v8ValueType, jstring mKey) { + RUNTIME_AND_VALUE_HANDLES_TO_OBJECTS_WITH_SCOPE(v8RuntimeHandle, v8ValueHandle); + if (v8LocalValue->IsObject()) { + auto v8LocalStringKey = Javet::Converter::ToV8String(jniEnv, v8Context, mKey); + auto v8LocalPrivateKey = v8::Private::ForApi(v8Context->GetIsolate(), v8LocalStringKey); + auto v8MaybeBool = v8LocalValue.As()->HasPrivate(v8Context, v8LocalPrivateKey); + return v8MaybeBool.FromMaybe(false); + } + return false; +} + JNIEXPORT void JNICALL Java_com_caoccao_javet_interop_V8Native_idleNotificationDeadline (JNIEnv* jniEnv, jobject caller, jlong v8RuntimeHandle, jlong deadlineInMillis) { if (deadlineInMillis > 0) { @@ -944,9 +985,7 @@ JNIEXPORT jboolean JNICALL Java_com_caoccao_javet_interop_V8Native_promiseReject if (IS_V8_PROMISE(v8ValueType)) { auto v8LocalPromiseResolver = v8LocalValue.As(); auto v8MaybeBool = v8LocalPromiseResolver->Reject(v8Context, Javet::Converter::ToV8Value(jniEnv, v8Context, value)); - if (v8MaybeBool.IsJust()) { - return v8MaybeBool.ToChecked(); - } + return v8MaybeBool.FromMaybe(false); } return false; } @@ -1159,6 +1198,19 @@ JNIEXPORT void JNICALL Java_com_caoccao_javet_interop_V8Native_setFlags } } +JNIEXPORT jboolean JNICALL Java_com_caoccao_javet_interop_V8Native_setPrivateProperty +(JNIEnv* jniEnv, jobject caller, jlong v8RuntimeHandle, jlong v8ValueHandle, jint v8ValueType, jstring mKey, jobject mValue) { + RUNTIME_AND_VALUE_HANDLES_TO_OBJECTS_WITH_SCOPE(v8RuntimeHandle, v8ValueHandle); + if (v8LocalValue->IsObject()) { + auto v8LocalStringKey = Javet::Converter::ToV8String(jniEnv, v8Context, mKey); + auto v8LocalPrivateKey = v8::Private::ForApi(v8Context->GetIsolate(), v8LocalStringKey); + auto v8LocalPrivateValue = Javet::Converter::ToV8Value(jniEnv, v8Context, mValue); + auto v8MaybeBool = v8LocalValue.As()->SetPrivate(v8Context, v8LocalPrivateKey, v8LocalPrivateValue); + return v8MaybeBool.FromMaybe(false); + } + return false; +} + JNIEXPORT jboolean JNICALL Java_com_caoccao_javet_interop_V8Native_setProperty (JNIEnv* jniEnv, jobject caller, jlong v8RuntimeHandle, jlong v8ValueHandle, jint v8ValueType, jobject key, jobject value) { RUNTIME_AND_VALUE_HANDLES_TO_OBJECTS_WITH_SCOPE(v8RuntimeHandle, v8ValueHandle); @@ -1248,7 +1300,7 @@ JNIEXPORT jboolean JNICALL Java_com_caoccao_javet_interop_V8Native_setSourceCode #else v8InternalFunction.set_code(v8InternalIsolate->builtins()->code(V8InternalBuiltin::kCompileLazy)); #endif - } + } /* * Set the source and update the start and end position. @@ -1261,9 +1313,9 @@ JNIEXPORT jboolean JNICALL Java_com_caoccao_javet_interop_V8Native_setSourceCode const int newEndPosition = startPosition + umSourceCode->Length(); v8InternalShared.scope_info().SetPositionInfo(startPosition, newEndPosition); return true; + } } } -} return false; } diff --git a/cpp/jni/com_caoccao_javet_interop_V8Native.h b/cpp/jni/com_caoccao_javet_interop_V8Native.h index 00016c7ad..30e64e47c 100644 --- a/cpp/jni/com_caoccao_javet_interop_V8Native.h +++ b/cpp/jni/com_caoccao_javet_interop_V8Native.h @@ -119,6 +119,14 @@ JNIEXPORT jobject JNICALL Java_com_caoccao_javet_interop_V8Native_createV8Value JNIEXPORT jboolean JNICALL Java_com_caoccao_javet_interop_V8Native_delete (JNIEnv *, jobject, jlong, jlong, jint, jobject); +/* + * Class: com_caoccao_javet_interop_V8Native + * Method: deletePrivateProperty + * Signature: (JJILjava/lang/String;)Z + */ +JNIEXPORT jboolean JNICALL Java_com_caoccao_javet_interop_V8Native_deletePrivateProperty + (JNIEnv *, jobject, jlong, jlong, jint, jstring); + /* * Class: com_caoccao_javet_interop_V8Native * Method: equals @@ -207,6 +215,14 @@ JNIEXPORT jint JNICALL Java_com_caoccao_javet_interop_V8Native_getLength JNIEXPORT jobject JNICALL Java_com_caoccao_javet_interop_V8Native_getOwnPropertyNames (JNIEnv *, jobject, jlong, jlong, jint); +/* + * Class: com_caoccao_javet_interop_V8Native + * Method: getPrivateProperty + * Signature: (JJILjava/lang/String;)Ljava/lang/Object; + */ +JNIEXPORT jobject JNICALL Java_com_caoccao_javet_interop_V8Native_getPrivateProperty + (JNIEnv *, jobject, jlong, jlong, jint, jstring); + /* * Class: com_caoccao_javet_interop_V8Native * Method: getProperty @@ -271,6 +287,14 @@ JNIEXPORT jboolean JNICALL Java_com_caoccao_javet_interop_V8Native_has JNIEXPORT jboolean JNICALL Java_com_caoccao_javet_interop_V8Native_hasOwnProperty (JNIEnv *, jobject, jlong, jlong, jint, jobject); +/* + * Class: com_caoccao_javet_interop_V8Native + * Method: hasPrivateProperty + * Signature: (JJILjava/lang/String;)Z + */ +JNIEXPORT jboolean JNICALL Java_com_caoccao_javet_interop_V8Native_hasPrivateProperty + (JNIEnv *, jobject, jlong, jlong, jint, jstring); + /* * Class: com_caoccao_javet_interop_V8Native * Method: idleNotificationDeadline @@ -567,6 +591,14 @@ JNIEXPORT jboolean JNICALL Java_com_caoccao_javet_interop_V8Native_setAccessor JNIEXPORT void JNICALL Java_com_caoccao_javet_interop_V8Native_setFlags (JNIEnv *, jobject, jstring); +/* + * Class: com_caoccao_javet_interop_V8Native + * Method: setPrivateProperty + * Signature: (JJILjava/lang/String;Ljava/lang/Object;)Z + */ +JNIEXPORT jboolean JNICALL Java_com_caoccao_javet_interop_V8Native_setPrivateProperty + (JNIEnv *, jobject, jlong, jlong, jint, jstring, jobject); + /* * Class: com_caoccao_javet_interop_V8Native * Method: setProperty diff --git a/cpp/jni/javet_callbacks.cpp b/cpp/jni/javet_callbacks.cpp index 4d2e0309c..5b27a5955 100644 --- a/cpp/jni/javet_callbacks.cpp +++ b/cpp/jni/javet_callbacks.cpp @@ -60,8 +60,19 @@ namespace Javet { FETCH_JNI_ENV(GlobalJavaVM); auto javetCallbackContextReferencePointer = info.GetParameter(); auto v8Context = info.GetIsolate()->GetCurrentContext(); - jobject externalV8Runtime = Javet::V8Runtime::FromV8Context(v8Context)->externalV8Runtime; - javetCallbackContextReferencePointer->RemoveCallbackContext(externalV8Runtime); + if (v8Context.IsEmpty()) { + LOG_ERROR("JavetCloseWeakCallbackContextHandle: V8 context is empty."); + } + else { + auto v8Runtime = V8Runtime::FromV8Context(v8Context); + if (v8Runtime == nullptr) { + LOG_ERROR("JavetCloseWeakCallbackContextHandle: V8 runtime is empty."); + } + else { + jobject externalV8Runtime = v8Runtime->externalV8Runtime; + javetCallbackContextReferencePointer->RemoveCallbackContext(externalV8Runtime); + } + } delete javetCallbackContextReferencePointer; INCREASE_COUNTER(Javet::Monitor::CounterType::DeleteJavetCallbackContextReference); } @@ -97,32 +108,40 @@ namespace Javet { V8LocalFixedArray importAssertions, #endif V8LocalModule referrer) { - auto v8Runtime = V8Runtime::FromV8Context(v8Context); - FETCH_JNI_ENV(GlobalJavaVM); - auto externalV8Runtime = v8Runtime->externalV8Runtime; - jobject mReferrerV8Module = referrer.IsEmpty() ? nullptr : Javet::Converter::ToExternalV8Module(jniEnv, externalV8Runtime, v8Context, referrer); - jobject mIV8Module = jniEnv->CallObjectMethod( - externalV8Runtime, jmethodIDV8RuntimeGetV8Module, - Javet::Converter::ToJavaString(jniEnv, v8Context, specifier), - mReferrerV8Module); - V8MaybeLocalModule resolvedV8MaybeLocalModule; - if (jniEnv->ExceptionCheck()) { - // JNI exception is not re-thrown in this callback function because it will pop up automatically. - LOG_ERROR("ModuleResolveCallback: module " << *Javet::Converter::ToStdString(v8Context, specifier) << " with exception"); - resolvedV8MaybeLocalModule = V8MaybeLocalModule(); - } - else if (mIV8Module == nullptr) { - LOG_ERROR("ModuleResolveCallback: module " << *Javet::Converter::ToStdString(v8Context, specifier) << " not found"); - resolvedV8MaybeLocalModule = V8MaybeLocalModule(); + V8MaybeLocalModule resolvedV8MaybeLocalModule = V8MaybeLocalModule(); + if (v8Context.IsEmpty()) { + LOG_ERROR("JavetModuleResolveCallback: V8 context is empty."); } else { - auto mHandle = jniEnv->CallLongMethod(mIV8Module, jmethodIDIV8ModuleGetHandle); - auto v8PersistentModule = TO_V8_PERSISTENT_MODULE_POINTER(mHandle); - LOG_DEBUG("ModuleResolveCallback: module " << *Javet::Converter::ToStdString(v8Context, specifier) << " found"); - resolvedV8MaybeLocalModule = v8PersistentModule->Get(v8Context->GetIsolate()); - } - if (mReferrerV8Module != nullptr) { - jniEnv->CallVoidMethod(mReferrerV8Module, jmethodIDIV8ValueReferenceClose, true); + auto v8Runtime = V8Runtime::FromV8Context(v8Context); + if (v8Runtime == nullptr) { + LOG_ERROR("JavetModuleResolveCallback: V8 runtime is empty."); + } + else { + FETCH_JNI_ENV(GlobalJavaVM); + auto externalV8Runtime = v8Runtime->externalV8Runtime; + jobject mReferrerV8Module = referrer.IsEmpty() ? nullptr : Javet::Converter::ToExternalV8Module(jniEnv, externalV8Runtime, v8Context, referrer); + jobject mIV8Module = jniEnv->CallObjectMethod( + externalV8Runtime, jmethodIDV8RuntimeGetV8Module, + Javet::Converter::ToJavaString(jniEnv, v8Context, specifier), + mReferrerV8Module); + if (jniEnv->ExceptionCheck()) { + // JNI exception is not re-thrown in this callback function because it will pop up automatically. + LOG_ERROR("JavetModuleResolveCallback: module " << *Javet::Converter::ToStdString(v8Context, specifier) << " with exception"); + } + else if (mIV8Module == nullptr) { + LOG_ERROR("JavetModuleResolveCallback: module " << *Javet::Converter::ToStdString(v8Context, specifier) << " not found"); + } + else { + auto mHandle = jniEnv->CallLongMethod(mIV8Module, jmethodIDIV8ModuleGetHandle); + auto v8PersistentModule = TO_V8_PERSISTENT_MODULE_POINTER(mHandle); + LOG_DEBUG("JavetModuleResolveCallback: module " << *Javet::Converter::ToStdString(v8Context, specifier) << " found"); + resolvedV8MaybeLocalModule = v8PersistentModule->Get(v8Context->GetIsolate()); + } + if (mReferrerV8Module != nullptr) { + jniEnv->CallVoidMethod(mReferrerV8Module, jmethodIDIV8ValueReferenceClose, true); + } + } } return resolvedV8MaybeLocalModule; } @@ -134,21 +153,31 @@ namespace Javet { FETCH_JNI_ENV(GlobalJavaVM); auto v8Isolate = v8LocalPromise->GetIsolate(); auto v8Context = v8Isolate->GetCurrentContext(); - auto v8Runtime = Javet::V8Runtime::FromV8Context(v8Context); - auto externalV8Runtime = v8Runtime->externalV8Runtime; - jobject value; - if (promiseRejectEvent == v8::PromiseRejectEvent::kPromiseHandlerAddedAfterReject) { - value = Javet::Converter::ToExternalV8ValueUndefined(jniEnv, externalV8Runtime); + if (v8Context.IsEmpty()) { + LOG_ERROR("JavetPromiseRejectCallback: V8 context is empty."); } else { - value = Javet::Converter::ToExternalV8Value(jniEnv, externalV8Runtime, v8Context, message.GetValue()); + auto v8Runtime = Javet::V8Runtime::FromV8Context(v8Context); + if (v8Runtime == nullptr) { + LOG_ERROR("JavetPromiseRejectCallback: V8 runtime is empty."); + } + else { + auto externalV8Runtime = v8Runtime->externalV8Runtime; + jobject value; + if (promiseRejectEvent == v8::PromiseRejectEvent::kPromiseHandlerAddedAfterReject) { + value = Javet::Converter::ToExternalV8ValueUndefined(jniEnv, externalV8Runtime); + } + else { + value = Javet::Converter::ToExternalV8Value(jniEnv, externalV8Runtime, v8Context, message.GetValue()); + } + jniEnv->CallVoidMethod( + externalV8Runtime, + jmethodIDV8RuntimeReceivePromiseRejectCallback, + promiseRejectEvent, + Javet::Converter::ToExternalV8Value(jniEnv, externalV8Runtime, v8Context, v8LocalPromise), + value); + } } - jniEnv->CallVoidMethod( - externalV8Runtime, - jmethodIDV8RuntimeReceivePromiseRejectCallback, - promiseRejectEvent, - Javet::Converter::ToExternalV8Value(jniEnv, externalV8Runtime, v8Context, v8LocalPromise), - value); } JavetCallbackContextReference::JavetCallbackContextReference(JNIEnv* jniEnv, jobject callbackContext) { @@ -165,44 +194,50 @@ namespace Javet { V8HandleScope v8HandleScope(v8Isolate); auto v8Context = v8Isolate->GetCurrentContext(); if (v8Context.IsEmpty()) { - // The callback may come after V8 context is closed. + LOG_ERROR("CallFunction: V8 context is empty."); args.GetReturnValue().SetUndefined(); } else { auto v8Runtime = Javet::V8Runtime::FromV8Context(v8Context); - jobject externalV8Runtime = v8Runtime->externalV8Runtime; - V8ContextScope v8ContextScope(v8Context); - jboolean isReturnResult = IsReturnResult(); - jboolean isThisObjectRequired = IsThisObjectRequired(); - jobject externalArgs = Javet::Converter::ToExternalV8ValueArray(jniEnv, externalV8Runtime, v8Context, args); - jobject thisObject = isThisObjectRequired ? Javet::Converter::ToExternalV8Value(jniEnv, externalV8Runtime, v8Context, args.This()) : nullptr; - jobject mResult = jniEnv->CallStaticObjectMethod( - jclassV8FunctionCallback, - jmethodIDV8FunctionCallbackReceiveCallback, - externalV8Runtime, - callbackContext, - thisObject, - externalArgs); - if (jniEnv->ExceptionCheck()) { - Javet::Exceptions::ThrowV8Exception(jniEnv, v8Context, "Uncaught JavaError in function callback"); + if (v8Runtime == nullptr) { + LOG_ERROR("CallFunction: V8 runtime is empty."); + args.GetReturnValue().SetUndefined(); } - else if (isReturnResult) { - if (mResult == nullptr) { - args.GetReturnValue().SetUndefined(); + else { + jobject externalV8Runtime = v8Runtime->externalV8Runtime; + V8ContextScope v8ContextScope(v8Context); + jboolean isReturnResult = IsReturnResult(); + jboolean isThisObjectRequired = IsThisObjectRequired(); + jobject externalArgs = Javet::Converter::ToExternalV8ValueArray(jniEnv, externalV8Runtime, v8Context, args); + jobject thisObject = isThisObjectRequired ? Javet::Converter::ToExternalV8Value(jniEnv, externalV8Runtime, v8Context, args.This()) : nullptr; + jobject mResult = jniEnv->CallStaticObjectMethod( + jclassV8FunctionCallback, + jmethodIDV8FunctionCallbackReceiveCallback, + externalV8Runtime, + callbackContext, + thisObject, + externalArgs); + if (jniEnv->ExceptionCheck()) { + Javet::Exceptions::ThrowV8Exception(jniEnv, v8Context, "Uncaught JavaError in function callback"); } - else { - args.GetReturnValue().Set(Javet::Converter::ToV8Value(jniEnv, v8Context, mResult)); + else if (isReturnResult) { + if (mResult == nullptr) { + args.GetReturnValue().SetUndefined(); + } + else { + args.GetReturnValue().Set(Javet::Converter::ToV8Value(jniEnv, v8Context, mResult)); + } + } + if (thisObject != nullptr) { + jniEnv->DeleteLocalRef(thisObject); + } + if (externalArgs != nullptr) { + jniEnv->DeleteLocalRef(externalArgs); + } + if (mResult != nullptr) { + jniEnv->CallStaticVoidMethod(jclassJavetResourceUtils, jmethodIDJavetResourceUtilsSafeClose, mResult); + jniEnv->DeleteLocalRef(mResult); } - } - if (thisObject != nullptr) { - jniEnv->DeleteLocalRef(thisObject); - } - if (externalArgs != nullptr) { - jniEnv->DeleteLocalRef(externalArgs); - } - if (mResult != nullptr) { - jniEnv->CallStaticVoidMethod(jclassJavetResourceUtils, jmethodIDJavetResourceUtilsSafeClose, mResult); - jniEnv->DeleteLocalRef(mResult); } } } @@ -214,39 +249,45 @@ namespace Javet { V8HandleScope v8HandleScope(v8Isolate); auto v8Context = v8Isolate->GetCurrentContext(); if (v8Context.IsEmpty()) { - // The callback may come after V8 context is closed. + LOG_ERROR("CallPropertyGetter: V8 context is empty."); args.GetReturnValue().SetUndefined(); } else { auto v8Runtime = Javet::V8Runtime::FromV8Context(v8Context); - jobject externalV8Runtime = v8Runtime->externalV8Runtime; - V8ContextScope v8ContextScope(v8Context); - jboolean isThisObjectRequired = IsThisObjectRequired(); - jobject thisObject = isThisObjectRequired ? Javet::Converter::ToExternalV8Value(jniEnv, externalV8Runtime, v8Context, args.This()) : nullptr; - jobject mResult = jniEnv->CallStaticObjectMethod( - jclassV8FunctionCallback, - jmethodIDV8FunctionCallbackReceiveCallback, - externalV8Runtime, - callbackContext, - thisObject, - nullptr); - if (jniEnv->ExceptionCheck()) { - Javet::Exceptions::ThrowV8Exception(jniEnv, v8Context, "Uncaught JavaError in property getter callback"); + if (v8Runtime == nullptr) { + LOG_ERROR("CallPropertyGetter: V8 runtime is empty."); + args.GetReturnValue().SetUndefined(); } else { - if (mResult == nullptr) { - args.GetReturnValue().SetUndefined(); + jobject externalV8Runtime = v8Runtime->externalV8Runtime; + V8ContextScope v8ContextScope(v8Context); + jboolean isThisObjectRequired = IsThisObjectRequired(); + jobject thisObject = isThisObjectRequired ? Javet::Converter::ToExternalV8Value(jniEnv, externalV8Runtime, v8Context, args.This()) : nullptr; + jobject mResult = jniEnv->CallStaticObjectMethod( + jclassV8FunctionCallback, + jmethodIDV8FunctionCallbackReceiveCallback, + externalV8Runtime, + callbackContext, + thisObject, + nullptr); + if (jniEnv->ExceptionCheck()) { + Javet::Exceptions::ThrowV8Exception(jniEnv, v8Context, "Uncaught JavaError in property getter callback"); } else { - args.GetReturnValue().Set(Javet::Converter::ToV8Value(jniEnv, v8Context, mResult)); + if (mResult == nullptr) { + args.GetReturnValue().SetUndefined(); + } + else { + args.GetReturnValue().Set(Javet::Converter::ToV8Value(jniEnv, v8Context, mResult)); + } + } + if (thisObject != nullptr) { + jniEnv->DeleteLocalRef(thisObject); + } + if (mResult != nullptr) { + jniEnv->CallStaticVoidMethod(jclassJavetResourceUtils, jmethodIDJavetResourceUtilsSafeClose, mResult); + jniEnv->DeleteLocalRef(mResult); } - } - if (thisObject != nullptr) { - jniEnv->DeleteLocalRef(thisObject); - } - if (mResult != nullptr) { - jniEnv->CallStaticVoidMethod(jclassJavetResourceUtils, jmethodIDJavetResourceUtilsSafeClose, mResult); - jniEnv->DeleteLocalRef(mResult); } } } @@ -257,32 +298,40 @@ namespace Javet { V8IsolateScope v8IsolateScope(v8Isolate); V8HandleScope v8HandleScope(v8Isolate); auto v8Context = v8Isolate->GetCurrentContext(); - if (!v8Context.IsEmpty()) { + if (v8Context.IsEmpty()) { + LOG_ERROR("CallPropertySetter: V8 context is empty."); + } + else { auto v8Runtime = Javet::V8Runtime::FromV8Context(v8Context); - jobject externalV8Runtime = v8Runtime->externalV8Runtime; - V8ContextScope v8ContextScope(v8Context); - auto v8Array = v8::Array::New(v8Context->GetIsolate(), 1); - auto maybeResult = v8Array->Set(v8Context, 0, propertyValue); - maybeResult.Check(); - jboolean isThisObjectRequired = IsThisObjectRequired(); - jobject thisObject = isThisObjectRequired ? Javet::Converter::ToExternalV8Value(jniEnv, externalV8Runtime, v8Context, args.This()) : nullptr; - jobject mPropertyValue = Javet::Converter::ToExternalV8Value(jniEnv, externalV8Runtime, v8Context, v8Array); - jobject mResult = jniEnv->CallStaticObjectMethod( - jclassV8FunctionCallback, - jmethodIDV8FunctionCallbackReceiveCallback, - externalV8Runtime, - callbackContext, - thisObject, - mPropertyValue); - if (jniEnv->ExceptionCheck()) { - Javet::Exceptions::ThrowV8Exception(jniEnv, v8Context, "Uncaught JavaError in property setter callback"); + if (v8Runtime == nullptr) { + LOG_ERROR("CallPropertySetter: V8 runtime is empty."); } - if (thisObject != nullptr) { - jniEnv->DeleteLocalRef(thisObject); - } - if (mResult != nullptr) { - jniEnv->CallStaticVoidMethod(jclassJavetResourceUtils, jmethodIDJavetResourceUtilsSafeClose, mResult); - jniEnv->DeleteLocalRef(mResult); + else { + jobject externalV8Runtime = v8Runtime->externalV8Runtime; + V8ContextScope v8ContextScope(v8Context); + auto v8Array = v8::Array::New(v8Context->GetIsolate(), 1); + auto maybeResult = v8Array->Set(v8Context, 0, propertyValue); + maybeResult.Check(); + jboolean isThisObjectRequired = IsThisObjectRequired(); + jobject thisObject = isThisObjectRequired ? Javet::Converter::ToExternalV8Value(jniEnv, externalV8Runtime, v8Context, args.This()) : nullptr; + jobject mPropertyValue = Javet::Converter::ToExternalV8Value(jniEnv, externalV8Runtime, v8Context, v8Array); + jobject mResult = jniEnv->CallStaticObjectMethod( + jclassV8FunctionCallback, + jmethodIDV8FunctionCallbackReceiveCallback, + externalV8Runtime, + callbackContext, + thisObject, + mPropertyValue); + if (jniEnv->ExceptionCheck()) { + Javet::Exceptions::ThrowV8Exception(jniEnv, v8Context, "Uncaught JavaError in property setter callback"); + } + if (thisObject != nullptr) { + jniEnv->DeleteLocalRef(thisObject); + } + if (mResult != nullptr) { + jniEnv->CallStaticVoidMethod(jclassJavetResourceUtils, jmethodIDJavetResourceUtilsSafeClose, mResult); + jniEnv->DeleteLocalRef(mResult); + } } } } diff --git a/cpp/jni/javet_converter.cpp b/cpp/jni/javet_converter.cpp index 464353332..93ad039c5 100644 --- a/cpp/jni/javet_converter.cpp +++ b/cpp/jni/javet_converter.cpp @@ -46,6 +46,7 @@ #define IS_JAVA_REFERENCE(jniEnv, obj) jniEnv->IsInstanceOf(obj, jclassV8ValueReference) #define IS_JAVA_REG_EXP(jniEnv, obj) jniEnv->IsInstanceOf(obj, jclassV8ValueRegExp) #define IS_JAVA_SET(jniEnv, obj) jniEnv->IsInstanceOf(obj, jclassV8ValueSet) +#define IS_JAVA_SHARED_ARRAY_BUFFER(jniEnv, obj) jniEnv->IsInstanceOf(obj, jclassV8ValueSharedArrayBuffer) #define IS_JAVA_SYMBOL(jniEnv, obj) jniEnv->IsInstanceOf(obj, jclassV8ValueSymbol) #define IS_JAVA_SYMBOL_OBJECT(jniEnv, obj) jniEnv->IsInstanceOf(obj, jclassV8ValueSymbolObject) #define IS_JAVA_WEAK_MAP(jniEnv, obj) jniEnv->IsInstanceOf(obj, jclassV8ValueWeakMap) @@ -169,6 +170,10 @@ namespace Javet { jmethodIDV8ValueSetConstructor = jniEnv->GetMethodID(jclassV8ValueSet, JAVA_CONSTRUCTOR_AND_SIGNATURE_FROM_HANDLE); jmethodIDV8ValueSetGetHandle = jniEnv->GetMethodID(jclassV8ValueSet, JAVA_METHOD_AND_SIGNATURE_GET_HANDLE); + jclassV8ValueSharedArrayBuffer = (jclass)jniEnv->NewGlobalRef(jniEnv->FindClass("com/caoccao/javet/values/reference/V8ValueSharedArrayBuffer")); + jmethodIDV8ValueSharedArrayBufferConstructor = jniEnv->GetMethodID(jclassV8ValueSharedArrayBuffer, "", "(JLjava/nio/ByteBuffer;)V"); + jmethodIDV8ValueSharedArrayBufferGetHandle = jniEnv->GetMethodID(jclassV8ValueSharedArrayBuffer, JAVA_METHOD_AND_SIGNATURE_GET_HANDLE); + jclassV8ValueSymbol = (jclass)jniEnv->NewGlobalRef(jniEnv->FindClass("com/caoccao/javet/values/reference/V8ValueSymbol")); jmethodIDV8ValueSymbolConstructor = jniEnv->GetMethodID(jclassV8ValueSymbol, JAVA_CONSTRUCTOR_AND_SIGNATURE_FROM_HANDLE); jmethodIDV8ValueSymbolGetHandle = jniEnv->GetMethodID(jclassV8ValueSymbol, JAVA_METHOD_AND_SIGNATURE_GET_HANDLE); @@ -273,6 +278,11 @@ namespace Javet { return jniEnv->NewObject(jclassV8ValueArrayBuffer, jmethodIDV8ValueArrayBufferConstructor, ToV8PersistentValueReference(v8Context, v8Value), jniEnv->NewDirectByteBuffer(v8ArrayBuffer->GetBackingStore()->Data(), v8ArrayBuffer->ByteLength())); } + if (v8Value->IsSharedArrayBuffer()) { + auto v8SharedArrayBuffer = v8Value.As(); + return jniEnv->NewObject(jclassV8ValueSharedArrayBuffer, jmethodIDV8ValueSharedArrayBufferConstructor, ToV8PersistentValueReference(v8Context, v8Value), + jniEnv->NewDirectByteBuffer(v8SharedArrayBuffer->GetBackingStore()->Data(), v8SharedArrayBuffer->ByteLength())); + } if (v8Value->IsArrayBufferView()) { /* ArrayBufferView is a helper type representing any of typed array or DataView. @@ -349,7 +359,10 @@ namespace Javet { return ToExternalV8ValuePrimitive(jniEnv, jclassV8ValueString, jmethodIDV8ValueStringConstructor, v8Context, v8Value); } if (v8Value->IsName()) { - // It defaults to V8ValueObject. + /* + * Name is handled by either String or Symbol. + * This block should not be entered. + */ } #ifndef ENABLE_NODE if (v8Value->IsModule()) { diff --git a/cpp/jni/javet_converter.h b/cpp/jni/javet_converter.h index 3dc45b313..d1ef590c6 100644 --- a/cpp/jni/javet_converter.h +++ b/cpp/jni/javet_converter.h @@ -135,6 +135,10 @@ namespace Javet { static jmethodID jmethodIDV8ValueSetConstructor; static jmethodID jmethodIDV8ValueSetGetHandle; + static jclass jclassV8ValueSharedArrayBuffer; + static jmethodID jmethodIDV8ValueSharedArrayBufferConstructor; + static jmethodID jmethodIDV8ValueSharedArrayBufferGetHandle; + static jclass jclassV8ValueSymbol; static jmethodID jmethodIDV8ValueSymbolConstructor; static jmethodID jmethodIDV8ValueSymbolGetHandle; diff --git a/cpp/jni/javet_enums.h b/cpp/jni/javet_enums.h index 53b7ac5e8..e0503a8af 100644 --- a/cpp/jni/javet_enums.h +++ b/cpp/jni/javet_enums.h @@ -62,17 +62,18 @@ namespace Javet { Module = 21, DataView = 30, ArrayBuffer = 31, - Int8Array = 32, // -128 to 127 1 8-bit two's complement signed integer byte int8_t - Uint8Array = 33, // 0 to 255 1 8-bit unsigned integer octet uint8_t - Uint8ClampedArray = 34, // 0 to 255 1 8-bit unsigned integer (clamped) octet uint8_t - Int16Array = 35, // -32768 to 32767 2 16-bit two's complement signed integer short int16_t - Uint16Array = 36, // 0 to 65535 2 16-bit unsigned integer unsigned short uint16_t - Int32Array = 37, // -2147483648 to 2147483647 4 32-bit two's complement signed integer long int32_t - Uint32Array = 38, // 0 to 4294967295 4 32-bit unsigned integer unsigned long uint32_t - Float32Array = 39, // 1.210^-38 to 3.410^38 4 32-bit IEEE floating point number (7 significant digits e.g., 1.234567) unrestricted float float - Float64Array = 40, // 5.010^-324 to 1.810^308 8 64-bit IEEE floating point number (16 significant digits e.g., 1.23456789012345) unrestricted double double - BigInt64Array = 41, // -2^63 to 2^63-1 8 64-bit two's complement signed integer bigint int64_t (signed long long) - BigUint64Array = 42, // 0 to 2^64-1 8 64-bit unsigned integer bigint uint64_t (unsigned long long) + SharedArrayBuffer = 32, + Int8Array = 33, // -128 to 127 1 8-bit two's complement signed integer byte int8_t + Uint8Array = 34, // 0 to 255 1 8-bit unsigned integer octet uint8_t + Uint8ClampedArray = 35, // 0 to 255 1 8-bit unsigned integer (clamped) octet uint8_t + Int16Array = 36, // -32768 to 32767 2 16-bit two's complement signed integer short int16_t + Uint16Array = 37, // 0 to 65535 2 16-bit unsigned integer unsigned short uint16_t + Int32Array = 38, // -2147483648 to 2147483647 4 32-bit two's complement signed integer long int32_t + Uint32Array = 39, // 0 to 4294967295 4 32-bit unsigned integer unsigned long uint32_t + Float32Array = 40, // 1.210^-38 to 3.410^38 4 32-bit IEEE floating point number (7 significant digits e.g., 1.234567) unrestricted float float + Float64Array = 41, // 5.010^-324 to 1.810^308 8 64-bit IEEE floating point number (16 significant digits e.g., 1.23456789012345) unrestricted double double + BigInt64Array = 42, // -2^63 to 2^63-1 8 64-bit two's complement signed integer bigint int64_t (signed long long) + BigUint64Array = 43, // 0 to 2^64-1 8 64-bit unsigned integer bigint uint64_t (unsigned long long) }; }; diff --git a/cpp/jni/javet_resource_node.rc b/cpp/jni/javet_resource_node.rc index b6253da40..7675a4c78 100644 --- a/cpp/jni/javet_resource_node.rc +++ b/cpp/jni/javet_resource_node.rc @@ -61,8 +61,8 @@ LANGUAGE LANG_ENGLISH, SUBLANG_ENGLISH_US // VS_VERSION_INFO VERSIONINFO - FILEVERSION 0,9,11,0 - PRODUCTVERSION 0,9,11,0 + FILEVERSION 0,9,12,0 + PRODUCTVERSION 0,9,12,0 FILEFLAGSMASK 0x3fL #ifdef _DEBUG FILEFLAGS 0x1L @@ -79,12 +79,12 @@ BEGIN BEGIN VALUE "CompanyName", "caoccao.com" VALUE "FileDescription", "caoccao.com" - VALUE "FileVersion", "0.9.11.0" - VALUE "InternalName", "libjavet-node-windows-x86_64.v.0.9.11.dll" + VALUE "FileVersion", "0.9.12.0" + VALUE "InternalName", "libjavet-node-windows-x86_64.v.0.9.12.dll" VALUE "LegalCopyright", "Copyright (C) 2021" - VALUE "OriginalFilename", "libjavet-node-windows-x86_64.v.0.9.11.dll" + VALUE "OriginalFilename", "libjavet-node-windows-x86_64.v.0.9.12.dll" VALUE "ProductName", "Javet Windows" - VALUE "ProductVersion", "0.9.11.0" + VALUE "ProductVersion", "0.9.12.0" END END BLOCK "VarFileInfo" diff --git a/cpp/jni/javet_resource_v8.rc b/cpp/jni/javet_resource_v8.rc index 579c845a5..e97987c33 100644 --- a/cpp/jni/javet_resource_v8.rc +++ b/cpp/jni/javet_resource_v8.rc @@ -61,8 +61,8 @@ LANGUAGE LANG_ENGLISH, SUBLANG_ENGLISH_US // VS_VERSION_INFO VERSIONINFO - FILEVERSION 0,9,11,0 - PRODUCTVERSION 0,9,11,0 + FILEVERSION 0,9,12,0 + PRODUCTVERSION 0,9,12,0 FILEFLAGSMASK 0x3fL #ifdef _DEBUG FILEFLAGS 0x1L @@ -79,12 +79,12 @@ BEGIN BEGIN VALUE "CompanyName", "caoccao.com" VALUE "FileDescription", "caoccao.com" - VALUE "FileVersion", "0.9.11.0" - VALUE "InternalName", "libjavet-v8-windows-x86_64.v.0.9.11.dll" + VALUE "FileVersion", "0.9.12.0" + VALUE "InternalName", "libjavet-v8-windows-x86_64.v.0.9.12.dll" VALUE "LegalCopyright", "Copyright (C) 2021" - VALUE "OriginalFilename", "libjavet-v8-windows-x86_64.v.0.9.11.dll" + VALUE "OriginalFilename", "libjavet-v8-windows-x86_64.v.0.9.12.dll" VALUE "ProductName", "Javet Windows" - VALUE "ProductVersion", "0.9.11.0" + VALUE "ProductVersion", "0.9.12.0" END END BLOCK "VarFileInfo" diff --git a/docs/.nojekyll b/docs/.nojekyll new file mode 100644 index 000000000..e69de29bb diff --git a/docs/_images/chome_developer_tools_console.png b/docs/_images/chome_developer_tools_console.png new file mode 100644 index 000000000..5387dc092 Binary files /dev/null and b/docs/_images/chome_developer_tools_console.png differ diff --git a/docs/_images/chome_developer_tools_devices_remote_target_javet.png b/docs/_images/chome_developer_tools_devices_remote_target_javet.png new file mode 100644 index 000000000..0d4a8c66f Binary files /dev/null and b/docs/_images/chome_developer_tools_devices_remote_target_javet.png differ diff --git a/docs/_images/javet_architecture.png b/docs/_images/javet_architecture.png new file mode 100644 index 000000000..295eeac6c Binary files /dev/null and b/docs/_images/javet_architecture.png differ diff --git a/docs/_images/javet_cross_platform.png b/docs/_images/javet_cross_platform.png new file mode 100644 index 000000000..77cfa6028 Binary files /dev/null and b/docs/_images/javet_cross_platform.png differ diff --git a/docs/_images/javet_engine_pool.png b/docs/_images/javet_engine_pool.png new file mode 100644 index 000000000..e523eab8c Binary files /dev/null and b/docs/_images/javet_engine_pool.png differ diff --git a/docs/_images/javet_interception.png b/docs/_images/javet_interception.png new file mode 100644 index 000000000..949265cfa Binary files /dev/null and b/docs/_images/javet_interception.png differ diff --git a/docs/_images/javet_memory_management_passive_gc.png b/docs/_images/javet_memory_management_passive_gc.png new file mode 100644 index 000000000..b0b90bab7 Binary files /dev/null and b/docs/_images/javet_memory_management_passive_gc.png differ diff --git a/docs/_images/javet_modes.png b/docs/_images/javet_modes.png new file mode 100644 index 000000000..b650a3127 Binary files /dev/null and b/docs/_images/javet_modes.png differ diff --git a/docs/_images/javet_module_system.png b/docs/_images/javet_module_system.png new file mode 100644 index 000000000..9b416a887 Binary files /dev/null and b/docs/_images/javet_module_system.png differ diff --git a/docs/_images/lifecycle_of_v8_function.png b/docs/_images/lifecycle_of_v8_function.png new file mode 100644 index 000000000..7c5c601a0 Binary files /dev/null and b/docs/_images/lifecycle_of_v8_function.png differ diff --git a/docs/_images/memory_layout_of_v8_function.png b/docs/_images/memory_layout_of_v8_function.png new file mode 100644 index 000000000..d2a460537 Binary files /dev/null and b/docs/_images/memory_layout_of_v8_function.png differ diff --git a/docs/_images/v8_promise_and_resolver.png b/docs/_images/v8_promise_and_resolver.png new file mode 100644 index 000000000..ba4b397d9 Binary files /dev/null and b/docs/_images/v8_promise_and_resolver.png differ diff --git a/docs/_images/v8_promise_lifecycle.png b/docs/_images/v8_promise_lifecycle.png new file mode 100644 index 000000000..919cd3260 Binary files /dev/null and b/docs/_images/v8_promise_lifecycle.png differ diff --git a/docs/_sources/development/build.rst.txt b/docs/_sources/development/build.rst.txt new file mode 100644 index 000000000..743b30f33 --- /dev/null +++ b/docs/_sources/development/build.rst.txt @@ -0,0 +1,18 @@ +=========== +Build Javet +=========== + +It's quite hard for developers to build Javet successfully for various reasons. + +* Node.js needs to be built to static libraries. +* V8 needs to be built to monolith. +* Every OS platform has its own pitfalls which usually make developers frustrated, or even desperate. + +Here are 3 ways of building Javet. + +.. toctree:: + :maxdepth: 1 + + build_javet_with_docker + build_javet_with_pre_built_binaries + build_javet_from_scratch diff --git a/docs/_sources/development/build_javet_from_scratch.rst.txt b/docs/_sources/development/build_javet_from_scratch.rst.txt new file mode 100644 index 000000000..786b9b0ff --- /dev/null +++ b/docs/_sources/development/build_javet_from_scratch.rst.txt @@ -0,0 +1,153 @@ +======================== +Build Javet from Scratch +======================== + +Build Environment +================= + +Linux Environment +----------------- + +* Ubuntu 20.04 +* CMake 3.10+ +* JDK 8 +* Gradle 7.0+ + +MacOS Environment +----------------- + +* MacOS Catalina+ +* Latest Brew +* Xcode 11.4.1+ +* Cmake 3.16+ +* JDK 8 +* Gradle 7.0+ + +Windows Environment +------------------- + +* Latest Windows 10 +* Visual Studio 2019 Community +* CMake 3.16+ (comes with Visual Studio) +* Latest Windows 10 SDK with WinDbg +* JDK 8 +* Gradle 7.0+ + +Build V8 +======== + +Please follow the `official guide `_ to build V8. If you face any issues, you may contact `@sjtucaocao `_. + +Prepare V8 +---------- + +* Clone the source code. +* Checkout a proper version. + +Also, please make sure ``args.gn`` file looks like the following. + +.. code-block:: ini + + is_debug = false + target_cpu = "x64" + v8_monolithic = true + v8_use_external_startup_data = false + is_component_build = false + v8_enable_i18n_support= false + v8_enable_pointer_compression = false + v8_static_library = true + symbol_level = 0 + use_custom_libcxx = false + +Build V8 on Linux and Mac OS +---------------------------- + +.. code-block:: shell + + export PATH=path_to_depot_tools:$PATH + cd root_path_to_v8 + ninja -C out.gn/x64.release v8_monolith + +⚠️ In V8 v9.3, the following file needs to be patched. + +./include/cppgc/allocation.h +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. code-block:: cpp + + #include + #include // This line needs to be added. + #include + +Build V8 on Windows +------------------- + +⚠️ The patch script requires Python 3. + +.. code-block:: shell + + set PATH=path_to_depot_tools;%PATH% + set DEPOT_TOOLS_WIN_TOOLCHAIN=0 + cd root_path_to_v8 + ninja -C out.gn/x64.release v8_monolith + python root_path_to_javet\scripts\python\patch_v8_build.py -p .\ + ninja -C out.gn/x64.release v8_monolith + gn gen --ide=vs out.gn\x64.solution + +Why Patching? + +A few ninja files set certain warnings as errors so that MSVC stops compilation. The patch is to turn off those errors. + +Build Node.js +============= + +Please follow `Building Node.js `_ to build the static and LTS version of Node.js libraries. + +Prepare Node.js +--------------- + +* Clone the source code. +* Checkout a proper version. + +Build Node.js on Linux +---------------------- + +⚠️ The patch script requires Python 3. + +.. code-block:: shell + + cd root_path_to_node_js + python3 root_path_to_javet/scripts/python/patch_node_build.py -p ./ + ./configure --enable-static --without-intl + python3 root_path_to_javet/scripts/python/patch_node_build.py -p ./ + make -j4 + +Why Patching? + +* First patch: All static node libraries are ```` libraries. The patch is to disable ````. +* Second patch: Many static node libraries are not compiled to `position independent code `_ and link phase is broken with the following error. The patch is to set ``-fPIC`` to those make files. + + /usr/bin/ld: /....../out/Release/libnode.a(node_binding.o): + relocation R_X86_64_TPOFF32 against ``_ZN4nodeL23thread_local_modpendingE`` + can not be used when making a shared object; + recompile with -fPIC + +Build Node.js on Mac OS +----------------------- + +.. code-block:: shell + + ./configure --enable-static --without-intl + make -j4 + +Build Node.js on Windows +------------------------ + +.. code-block:: shell + + vcbuild.bat static without-intl + +Build Javet +=========== + +Once Node.js and V8 are ready, please proceed with :doc:`build_javet_with_pre_built_binaries`. diff --git a/docs/_sources/development/build_javet_with_docker.rst.txt b/docs/_sources/development/build_javet_with_docker.rst.txt new file mode 100644 index 000000000..71c78fdce --- /dev/null +++ b/docs/_sources/development/build_javet_with_docker.rst.txt @@ -0,0 +1,64 @@ +======================= +Build Javet with Docker +======================= + +The Docker build supports building Javet for Linux and Windows. As Docker supports Linux and Windows with WSL2, Javet for Linux can also be built on Windows. + +Regarding Docker build for Mac OS, contributors are welcome if you are interested. Or, you will have to wait for a long while. + +Build Environment +================= + +Linux Environment +----------------- + +* Ubuntu 20.04 +* Git +* Docker + +Windows Environment +------------------- + +* Latest Windows 10 +* WSL2 + Ubuntu 20.04 +* Git +* Docker + +Docker Hub and Github +--------------------- + +Please make sure the network connection to the Docker Hub and Github is up and running. The Docker repository of the Javet images are available at https://hub.docker.com/repository/docker/sjtucaocao. + +Build Javet for Linux on Linux or Windows +========================================= + +1. Clone Javet. +2. Navigate to the root directory of the Javet repository. +3. Execute ``docker build -f docker/linux-x86_64/build.Dockerfile .`` (Be careful, please include the last ``.``). + + * Docker will pull the corresponding image (~10GB) from Docker Hub. + * The actual build takes few minutes including pulling dependent libraries from Maven Central, building and testing. + +Build Javet for Windows on Windows +================================== + +1. Update daemon.json + +.. code-block:: json + + "storage-opts": [ + "dm.basesize=120GB", + "size=120GB" + ] + +2. Restart WSL2 +3. Restart docker +4. Clone Javet. +5. Navigate to the root directory of the Javet repository. +6. Execute ``docker build -t sjtucaocao/javet-windows:x.x.x -m 4G -f docker/windows-x86_64/base.Dockerfile .`` (Be careful, please include the last ``.``). +7. Execute ``docker build -f docker/windows-x86_64/build.Dockerfile .`` (Be careful, please include the last ``.``). + +Note: + +* The base image is so large (60+GB) that it's not efficient to push the base image to docker hub. Of course, without the base image at docker hub, it's not wise to enable the github workflow for Windows build. +* Building the base image takes many hours and may experience intermittent errors. diff --git a/docs/_sources/development/build_javet_with_pre_built_binaries.rst.txt b/docs/_sources/development/build_javet_with_pre_built_binaries.rst.txt new file mode 100644 index 000000000..6ca9c1db0 --- /dev/null +++ b/docs/_sources/development/build_javet_with_pre_built_binaries.rst.txt @@ -0,0 +1,83 @@ +=================================== +Build Javet with Pre-built Binaries +=================================== + +Build Environment +================= + +Linux Environment +----------------- + +* Ubuntu 20.04 +* CMake 3.10+ +* JDK 8 +* Gradle 7.0+ + +MacOS Environment +----------------- + +* MacOS Catalina+ +* Latest Brew +* Xcode 11.4.1+ +* Cmake 3.16+ +* JDK 8 +* Gradle 7.0+ + +Windows Environment +------------------- + +* Latest Windows 10 +* Visual Studio 2019 Community +* CMake 3.16+ (comes with Visual Studio) +* Latest Windows 10 SDK with WinDbg +* JDK 8 +* Gradle 7.0+ + +Download Pre-built Node.js and V8 +================================= + +⚠️ As the docker builds are available, I have stopped publishing pre-built binaries. If you really need them, please contact the maintainer wisely. Legacy pre-built binaries are at this `drive `_. + +Build Javet JNI Library +======================= + +Once Node.js and V8 are ready, please navigate to ``./cpp``, make sure CMake is accessible and execute corresponding build script. + +=========== =================================================================== =================================================================== +OS Node.js V8 +=========== =================================================================== =================================================================== +Linux ``sh build-linux.sh -DNODE_DIR=/absolute_path_to_node_js_build`` ``build-linux.sh -DV8_DIR=\absolute_path_to_v8_build`` +Mac OS ``sh build-macos.sh -DNODE_DIR=/absolute_path_to_node_js_build`` ``build-macos.sh -DV8_DIR=\absolute_path_to_v8_build`` +Windows ``sh build-windows.cmd -DNODE_DIR=/absolute_path_to_node_js_build`` ``build-windows.cmd -DV8_DIR=\absolute_path_to_v8_build`` +=========== =================================================================== =================================================================== + +After a while, the following libraries will be placed in folder ``src/main/resources``. + +=========== =========================================================== ========================================================== +OS Node.js V8 +=========== =========================================================== ========================================================== +Linux ``libjavet-node-linux-x86_64.v.*.*.*.so`` ``libjavet-v8-linux-x86_64.v.*.*.*.so`` +Mac OS ``libjavet-node-macos-x86_64.v.*.*.*.dylib`` ``libjavet-v8-macos-x86_64.v.*.*.*.dylib`` +Windows ``libjavet-node-windows-x86_64.v.*.*.*.dll`` ``libjavet-v8-windows-x86_64.v.*.*.*.dll`` +=========== =========================================================== ========================================================== + +Build Javet Jar +=============== + +Once all these libraries are built, please put them altogether under ``src/main/resources`` then kick off ``gradle build test``. + +After a while, ``javet-*.*.*.jar`` will be placed in folder ``build/libs``. + +Upload Javet to Maven Central (Optional) +---------------------------------------- + +Package Jar files in Maven. + +.. code-block:: sh + + # mvn package + mvn clean + mvn release:prepare + mvn release:perform + +Jar files are built under ``./target``. diff --git a/docs/_sources/development/debug_with_chrome_developer_tools.rst.txt b/docs/_sources/development/debug_with_chrome_developer_tools.rst.txt new file mode 100644 index 000000000..94cf38767 --- /dev/null +++ b/docs/_sources/development/debug_with_chrome_developer_tools.rst.txt @@ -0,0 +1,94 @@ +================================= +Debug with Chrome Developer Tools +================================= + +`Chrome DevTools `_ (aka. CDT) is a set of web developer tools built directly into the Google Chrome browser. DevTools can help you edit pages on-the-fly and diagnose problems quickly, which ultimately helps you build better websites, faster. + +CDT Shell +========= + +Javet ships a demo :extsource2:`CDT Shell <../../src/test/java/com/caoccao/javet/tutorial/cdt/TestCDT.java>` application to demonstrate how to work with CDT to perform a live debugging. + +1. Run CDT Shell +---------------- + +Run CDT Shell as a normal Java console application and an interactive console will appear working just like a node console does. + +2. Run Script in CDT Shell +-------------------------- + +Run arbitrary code in the console just like what can be done in a node console. + +.. code-block:: js + + > let a = 3 + undefined + > let b = 4 + undefined + > a + b + 7 + +3. Open CDT +----------- + +Open chrome://inspect/ in Chrome, wait few seconds and Javet will appear as a remote target. + +.. image:: ../resources/images/chome_developer_tools_devices_remote_target_javet.png + :alt: Remote Target Javet + +4. Debug as Usual +----------------- + +Click ``inspect``. Voilà, DevTools is up. As the screenshot shows, live evaluation and auto-completion work successfully. Enjoy the live debugging. + +.. image:: ../resources/images/chome_developer_tools_console.png + :alt: Remote Target Javet + +Chrome Developer Tools Internals +================================ + +Handshake +--------- + +* CDT Shell listens to port 9229 by default because CDT constantly queries http://127.0.0.1:9229/json for remote target. CDT Shell tells CDT that it is a node flavored remote target via http://127.0.0.1:9229/json and the websocket address is http://127.0.0.1:9229/javet. +* CDT queries http://127.0.0.1:9229/json/version for protocol version. CDT Shell currently uses v1.3. The complete protocol API docs are available at https://chromedevtools.github.io/devtools-protocol/. +* CDT queries http://127.0.0.1:9229/javet with a websocket upgrade request. CDT Shell responses with websocket upgrade accepted. +* CDT switches to ws://127.0.0.1:9229/javet and sends the following 8 messages to perform a handshake with a node flavored remote target. + +.. code-block:: js + + Chrome: {"id":1,"method":"Runtime.enable","params":{}} + Javet Notification: {"method":"Runtime.executionContextCreated","params":{"context":{"id":1,"origin":"","name":"Javet Inspector 00000000","uniqueId":"00000000.00000000"}}} + Javet Response: {"id":1,"result":{}} + Chrome: {"id":2,"method":"Debugger.enable","params":{"maxScriptsCacheSize":100000000}} + Javet Response: {"id":2,"result":{"debuggerId":"00000000.00000000"}} + Chrome: {"id":3,"method":"Debugger.setPauseOnExceptions","params":{"state":"none"}} + Javet Response: {"id":3,"result":{}} + Chrome: {"id":4,"method":"Debugger.setAsyncCallStackDepth","params":{"maxDepth":32}} + Javet Response: {"id":4,"result":{}} + Chrome: {"id":5,"method":"Profiler.enable","params":{}} + Javet Response: {"id":5,"result":{}} + Chrome: {"id":6,"method":"Runtime.getIsolateId","params":{}} + Javet Response: {"id":6,"result":{"id":"00000000"}} + Chrome: {"id":7,"method":"Debugger.setBlackboxPatterns","params":{"patterns":[]}} + Javet Response: {"id":7,"result":{}} + Chrome: {"id":8,"method":"Runtime.runIfWaitingForDebugger","params":{}} + Javet Response: {"id":8,"result":{}} + +Note: Method ``Runtime.runIfWaitingForDebugger`` can be regarded as the handshake completion and there is no need to parse this message because it is exposed as a callback in ``IV8InspectorListener``. + +Actually, inside V8, the first message can enable the debugging without the rest of them. Please refer to the :extsource2:`source code <../../src/test/java/com/caoccao/javet/interop/TestV8Inspector.java>` for detail. + +Customization +============= + +Yes, please feel free to customize the debugging server in your environment. CDT Shell is created as a showcase for further customization. Here are some tips. + +* Integrate with your HTTP and WebSocket servers. CDT Shell currently uses embedded Jetty. Be careful, HTTP and WebSocket servers need to be hosted together, otherwise, CDT refuses to communicate with the WebSocket server. +* Add your ``IV8InspectorListener`` to intercept all the event messages. In practice, a decent JSON library like JackSon, GSon may help interpret those messages. As a demo, CDT Shell doesn't process those messages. Why intercept those messages? Because: + + * To set up breakpoints before script is executed. + * To send messages to CDT right after CDT is connected. + * To turn on / off certain features. + * To enforce authentication and authorization. + * To change V8 runtime. diff --git a/docs/_sources/development/design.rst.txt b/docs/_sources/development/design.rst.txt new file mode 100644 index 000000000..98edc382e --- /dev/null +++ b/docs/_sources/development/design.rst.txt @@ -0,0 +1,150 @@ +============ +Javet Design +============ + +Architecture +============ + +.. image:: ../resources/images/javet_architecture.png + :alt: Javet Architecture + +Primitive and Reference Types in Javet +-------------------------------------- + +There is a vague boundary between V8 primitive and reference types. In Javet, the definition of primitive is a mixture of both V8 and Java primitive types as a trade-off in design. + +=========================== ======================= ============================== +Feature Primitive Reference +=========================== ======================= ============================== +Interception No Yes +Memory Copy Copy by Value Copy by Reference +Resource Leak Not Possible Possible +Set to Weak No Yes +=========================== ======================= ============================== + +Reference typed objects keep memory footprint in V8 + JNI + JVM. All resource will be recycled when ``close()`` is called. That is quite an old school way of managing resource. Javet tries to hide that kind of tedious work from Java applications via try-with-resource. + +Please refer to :doc:`../reference/best_practices` for detail. + +Node.js Mode vs. V8 Mode +======================== + +Javet supports both Node.js mode and V8 mode both of which can co-exist in one JVM. In other words, they can run side by side and don't interfere with each other. + +.. image:: ../resources/images/javet_modes.png + :alt: Javet Modes + +As the diagram shows, both Node.js and V8 are lazy loaded in dedicated custom classloaders. Detailed comparisons are as following. + +=========================== ======================= ============================== +Feature Node.js Mode V8 Mode +=========================== ======================= ============================== +Lazy Loadable **Yes** **Yes** +Customization **High** **High** +Node.js Ecosystem **Complete** No +Security Low **High** +Unload **Yes** **Yes** +V8 Ecosystem **Complete** **Complete** +V8 Version Low **High** +=========================== ======================= ============================== + +One of the beauties of Javet is all the features in V8 mode can be applied to Node.js mode. Here are some examples. + +* Virtualization - All Node.js modules can be virtualized. E.g. ``console``, ``fs``, ``HTTP``, ``Net``, ``OS``, etc. +* Zero-copy - JVM can share the same byte buffer with Node.js and V8 to achieve zero-copy. +* Multi-threading - Multiple Java threads can host multiple Node.js runtime instances with only one copy of V8 objects visible to those instances. +* Beyond Node.js - Javet allows explicit ``await()`` so that applications can take more control over ``async`` execution. + +Module +====== + +Executing all scripts in global context is not recommended when project size increases. Javet provides complete support to applications so that V8 runtime context is aligned with the way Node or Chrome does. That brings the module system. + +Unfortunately, V8 has very limited support to the JS module system. However, that is not bad because V8 leaves all the possibilities to Javet. The typical challenges Javet faces are as following. + +* Sync or Async +* Module Location +* Module Dependency + +require() vs. import() +---------------------- + +=============== =========== ======================= =================== ============================== +Feature Async Original V8 Javet Node.js Mode Javet V8 Mode +=============== =========== ======================= =================== ============================== +``require()`` No No Yes (Complete) Yes (with an Interceptor) +``import()`` Yes Yes (Partial) Yes (Complete) Yes (Complete) +=============== =========== ======================= =================== ============================== + +Module Virtualization +--------------------- + +Javet doesn't build ``require()`` in but allows applications to set an interceptor because Javet doesn't know how to locate the modules and doesn't want to know for security issues. So it's up to the applications to define their own ways of locating the modules. + +Javet provides complete support to ES6 ``import()`` because certain work inside JNI has to be in place as V8 only partially supports ``import()``. So, in Javet the module is kind of virtualized, in other words, the module is represented by an arbitrary string that can be interpreted by applications during runtime. E.g. ``module.js`` may come from a file, a URL, a string in memory or whatever. Javet stores the compiled and evaluated module in a map with that string as key, and feeds V8 that module when V8 looks it up by that string. + +.. image:: ../resources/images/javet_module_system.png + :alt: Javet Module System + +Engine Pool +=========== + +.. image:: ../resources/images/javet_engine_pool.png + :alt: Javet Engine Pool + +V8 Isolate and Context in Javet +------------------------------- + +`Getting started with embedding V8 `_ is an excellent article that explains the concepts, design, insights of V8. In summary: + +* An isolate is a VM instance with its own heap. +* A context is an execution environment that allows separate, unrelated, JavaScript applications to run in a single instance of V8. + +In Javet, that model is simplified to 1 engine - 1 runtime - 1 isolate - 1 context. In V8Runtime, ``resetIsolate()`` and ``resetContext()`` are both exposed. It is recommended to always use ``resetContext()`` to get a brand new V8 context for the following reasons. + +* ``resetContext()`` is a much cheaper operation with much better performance. +* ``resetContext()`` is good enough in terms of getting a brand new V8 context. + +Javet Engine Pool +----------------- + +Multiple Javet engines are managed by Javet Engine Pool which works almost the same way as a typical DB connection pool. Javet Engine Pool is thread-safe. However, Javet Engine is **NOT** thread-safe because it is designed to be single-threaded and lock free for the following reasons. + +* V8 isolate and V8 context are single-threaded. Thread context violation results in V8 core dump immediately. +* Javet Engine performs better without locks. Actually, Javet engine only validates current thread ID to minimize the performance overhead. + +Please refer to :doc:`../reference/best_practices` for detail. + +Interception +============ + +Javet allows intercepting almost all V8 API so that JS code actually interacts with Java code behind the scene. + +.. image:: ../resources/images/javet_interception.png + :alt: Javet Interception + +Sample code is available at :doc:`../reference/v8_function`. + +Cross-platform +============== + +Javet packages all the libraries in a single jar file and automatically loads corresponding library per OS and JS runtime. + +.. image:: ../resources/images/javet_cross_platform.png + :alt: Javet Cross-platform + +* Javet calculates the library file name from OS and JS runtime. +* Javet unpacks the library files from resource directory to ``system_temporary_directory/javet/pid``. +* Javet loads the library files using either default classloader or custom classloader. + +Multi-process Safety +-------------------- + +Javet is multi-process safe because it deploys the library files to ``system_temporary_directory/javet/pid`` to avoid race conditions during initialization. Also, Javet purges legacy libraries (at least 1 minute old) at the beginning of the initialization. + +Memory Leak Detection +===================== + +Javet native library keeps track of every ``new`` and ``delete`` in ``JavetNativeMonitor``. Javet every unit test case fetches the tracking data, compares the ``new`` and ``delete`` count to verify unmanaged objects are properly allocated and freed. + +This feature is only turned on in debug version and there is zero performance overhead in release version. diff --git a/docs/_sources/development/index.rst.txt b/docs/_sources/development/index.rst.txt new file mode 100644 index 000000000..db4ce780c --- /dev/null +++ b/docs/_sources/development/index.rst.txt @@ -0,0 +1,12 @@ +=========== +Development +=========== + +.. toctree:: + :maxdepth: 2 + + tools + build + test + design + debug_with_chrome_developer_tools diff --git a/docs/_sources/development/test.rst.txt b/docs/_sources/development/test.rst.txt new file mode 100644 index 000000000..09adda82b --- /dev/null +++ b/docs/_sources/development/test.rst.txt @@ -0,0 +1,7 @@ +========== +Test Javet +========== + +Test is designed to completely reuse test cases for either Node.js or V8 mode. + +How do test cases know which mode to test? The base test suite compares the timestamp of the Node.js and V8 libraries and set test target to the newer one. So, if a new library is built, test cases automatically set test target to that new library. diff --git a/docs/_sources/development/tools.rst.txt b/docs/_sources/development/tools.rst.txt new file mode 100644 index 000000000..d53ed7ba7 --- /dev/null +++ b/docs/_sources/development/tools.rst.txt @@ -0,0 +1,38 @@ +================= +Development Tools +================= + +JDK +=== + +Javet development requires JDK 8 to be installed, though Javet supports JDK 8+. JDK 6 support has been dropped because a few JDK 8 features are heavily used in Javet. + +IntelliJ +======== + +I personally recommend IntelliJ IDEA. + +Gradle +====== + +For now, Gradle v7.2 + Kotlin DSL constructs the build system. + +Node.js +================= + +Node.js 14.17.6+ is supported. + +Maven (Optional) +================ + +Maven v3.6.3+ is used for packaging bundle to maven central. + +Visual Studio Community 2019 (Optional) +======================================= + +Visual Studio Community 2019 is used for JNI development. + +Python 3.8+ (Optional) +====================== + +Python 3.8+ is required if you want to upgrade the version. diff --git a/docs/_sources/faq/background/history_with_j2v8.rst.txt b/docs/_sources/faq/background/history_with_j2v8.rst.txt new file mode 100644 index 000000000..447a3fff7 --- /dev/null +++ b/docs/_sources/faq/background/history_with_j2v8.rst.txt @@ -0,0 +1,65 @@ +================= +History with J2V8 +================= + +J2V8 Issues +=========== + +J2V8 is an excellent project on embedding V8 in Java. However, J2V8 community hasn't been active since 2017. + +The last Windows version 4.6.0 was released in 2016 and the last Linux version 4.8.0 was released in 2017. The V8 in Windows v4.6.0 doesn't even fully support ES6. + +The latest community activities were around Android versions. The Node.js API was dropped. The Windows build has been seriously broken for years. The Linux build is nearly broken. There are serious memory leak issues which are hard to be fixed under the current architecture. + +Its API has stopped evolving for years. Many new features I expect just don't get any chances to be implemented. Obviously, if the build system was broken and couldn't be easily fixed, almost no one would like to contribute. That includes me. When I was trying to fix the build system for Windows and Linux, I had to admit that's so, so, so, challenging. Why is that? I think it's not merely J2V8 community's problem because in the meanwhile V8, Node.js and ECMAScript move forward rapidly causing many unexpected challenges. Someone or some team needs to look after J2V8 from time to time. Unfortunately, the reality is cruel. + +J2V8 Latest Version +=================== + +I managed to unofficially build the latest `J2V8 v6.2.0 `_. + +* V8 is upgraded to v8.3.110.9 which was released in May, 2020. +* Windows and Linux are supported. +* Node.js is dropped temporarily. + +I've tested the performance between ``j2v8_win32_x86_64-4.6.0.jar`` and ``j2v8_win32_x86_64-6.2.0.jar`` on a Windows machine with CPU i7 10700K. The test code is just ``1+1 -> 2``. Here are the comparisons. + +=============================== ============== ============= + Case 4.6.0 (TPS) 6.2.0 (TPS) +=============================== ============== ============= + Single Session with 1 Thread 1,003,009 1,338,688 + Ad-hoc Session with 1 Thread 35 299 + 4 Sessions with 4 threads 2,274,019 4,571,428 +=============================== ============== ============= + +With this kind of performance improvement, what are the reasons of sticking to ``v4.6.0``? + +Why Windows and Linux only? +=========================== + +* I don't own a decent Mac device. To be more precisely, I have Mac Mini and MacBook Air, but they are too old (building V8 would take many hours). And I have no plan on buying a new one in the near future. Call for donation? Don't be joking. So there's no MacOS release. +* I don't intend to support Android for now. + +Why not Automate the J2V8 Build System? +======================================= + +TL;DR: It's too hard. + +* V8 is evolving rapidly. v8.3.110.9 is a relatively easy one to be mastered. I didn't move forward well with v8.9.213 which placed a different set of *solvable* challenges to me. I plan to revisit the latest V8 in near future. +* Node.js was removed early. I haven't got time reviving it in J2V8. +* J2V8 build system is too old. + + * Gradle v2.14.1 is far from the lowest supported gradle version in my latest IntelliJ IDEA. And I don't have interest in installing a legacy Eclipse to play with that version of gradle. Hey, why not upgrade gradle to satisfy IDEA? I tried, but all was bad luck. You may take a try, then understand what I have suffered from. + * CMake is old and seriously broken on Windows. Nowadays, V8 only supports VS 2017 or 2019, but ``CMakeLists.txt`` is still at the VS 2015 age. No surprise, it doesn't work at all. + * Docker build is deeply broken as well. The dependent docker image was gone. There are many errors in many steps. Sitting there, watching the docker build breaks made me full of frustration because I thought it would take me a few months fixing the problems, but I don't have a few months. No one pays me to do that. + * Python2 scripts form the outer layer of the build system, also hide the actual building logic from someone who tries to fix the build system. I don't want to spend my precious time fixing Python2 scripts, because I've been on Python3 for many years. I wish my hair could be as much as Guido van Rossum's. Obviously, I am not, so no more Python2. + * Maven is old but the least problematic. At least it allows me to package the jar files with my hack to the ``pom.xml``. + +With these uncertainties, to me, automating the build system is something with ROI closing to 0. Supposing I achieved it in a particular version of V8, let's say ``v8.3.110.9``, it would for sure break in ``v8.9.x``. Later, I managed to build ``v8.9.255`` which has been embeded into Javet. + +Why not Deploy J2V8 to Maven Repository? +======================================== + +* I don't have the permission to its official repository. +* There has been no Windows / Linux releases deployed since 2016 / 2017. I really don't know who to contact with. +* You may easily integrate the jar files in your local maven repository. diff --git a/docs/_sources/faq/background/index.rst.txt b/docs/_sources/faq/background/index.rst.txt new file mode 100644 index 000000000..f34978f5e --- /dev/null +++ b/docs/_sources/faq/background/index.rst.txt @@ -0,0 +1,9 @@ +========== +Background +========== + +.. toctree:: + :maxdepth: 1 + + what_is_the_motivation + history_with_j2v8 diff --git a/docs/_sources/faq/background/what_is_the_motivation.rst.txt b/docs/_sources/faq/background/what_is_the_motivation.rst.txt new file mode 100644 index 000000000..1ce83fee8 --- /dev/null +++ b/docs/_sources/faq/background/what_is_the_motivation.rst.txt @@ -0,0 +1,11 @@ +======================= +What is the Motivation? +======================= + +I used to take a try of J2V8 and find it's quite compelling. However, J2V8 is slowly dying, with serious memory leak issues, V8 version issue, etc. + +Sometimes starting from scratch implies lower cost than upgrading an existing solution. I think it might be true here in this project. I've learned quite a lot by manually fixing the Windows and Linux build system of J2V8. + +Also, I had got many ideas on how the API will look like. At the end of 2020, I thought I would be able to write a new one from scratch and leave J2V8 behind. Indeed, I made it few months later. + +Please refer to :doc:`history_with_j2v8` for detail. diff --git a/docs/_sources/faq/development/how_to_think_in_javet.rst.txt b/docs/_sources/faq/development/how_to_think_in_javet.rst.txt new file mode 100644 index 000000000..de194ec67 --- /dev/null +++ b/docs/_sources/faq/development/how_to_think_in_javet.rst.txt @@ -0,0 +1,46 @@ +====================== +How to Think in Javet? +====================== + +There are folks migrating projects from other libraries (e.g. J2V8) to Javet. Some experienced certain challenges which from Javet perspective required **Thinking in Javet**. So, how? + +V8Runtime and V8ValueGlobalObject +================================= + +In Javet, ``V8Runtime`` and ``V8ValueGlobalObject`` are separate concepts. + +V8Runtime +--------- + +``V8Runtime`` is only a representative of the V8 isolate and V8 context. It has nothing to do with ``globalThis`` or ``window``. However, in few other libraries these concepts are mixed up. + +V8ValueGlobalObject +------------------- + +As ``V8Runtime`` no longer represents ``globalThis`` or ``window``, ``V8ValueGlobalObject`` from ``V8Runtime.getGlobalObject()`` is the one. + +If you want to access global objects or call top level functions, ``globalObject.get('...')`` and ``globalObject.invoke('...')`` are the Javet ways. + +Executor and Execute +==================== + +In Javet, executing a script involves 2 steps. + +1. Get an executor. +2. Call certain execute method of that executor. + +This is quite different from the common practice of few other libraries where execute is just a 1-step thing. + +Why? Javet intends to offer a builder pattern in the script execution. With an executor, application may do every other things before the actual execution. For instance: security check, enable / disable certain V8 features, hack the AST, set up interception, etc. The scope may be limited to that executor only. Also, the executor can be reused to avoid the duplicated resource loading overhead. + +Declarative Function and Property Interception +============================================== + +Javet offers an easy way of registering function and property interception in a declarative way. Just decorate a function of arbitrary object with ``@V8Function(name = "...")`` or ``@V8Property(name = "...")``, Javet is able to register it and that function will be called back from V8. Application is free from managing those tedious things like resource leakage, object lifecycle, type conversion, etc. Javet just handles that behind the scene and everything goes smoothly. + +The coding experience is a little bit close to working with Spring Framework. + +Learn from Unit Test +==================== + +Most of the Javet API is unit test covered. Learning from Javet unit test is an express and effective way to Thinking in Javet. diff --git a/docs/_sources/faq/development/index.rst.txt b/docs/_sources/faq/development/index.rst.txt new file mode 100644 index 000000000..c29b71412 --- /dev/null +++ b/docs/_sources/faq/development/index.rst.txt @@ -0,0 +1,9 @@ +=========== +Development +=========== + +.. toctree:: + :maxdepth: 1 + + how_to_think_in_javet + where_are_es6_api_in_v8_mode diff --git a/docs/_sources/faq/development/where_are_es6_api_in_v8_mode.rst.txt b/docs/_sources/faq/development/where_are_es6_api_in_v8_mode.rst.txt new file mode 100644 index 000000000..9f905cd07 --- /dev/null +++ b/docs/_sources/faq/development/where_are_es6_api_in_v8_mode.rst.txt @@ -0,0 +1,7 @@ +============================= +Where are ES6 API in V8 Mode? +============================= + +V8 mode only offers the basic functionality so that some ES6 API are absent. E.g. setTimeout, setInterval, etc. + +Project `Javenode `_ is an extension of Javet aiming at simulating Node.js with Java in Javet V8 mode. diff --git a/docs/_sources/faq/environment/can_javet_support_legacy_linux.rst.txt b/docs/_sources/faq/environment/can_javet_support_legacy_linux.rst.txt new file mode 100644 index 000000000..fe7cb646a --- /dev/null +++ b/docs/_sources/faq/environment/can_javet_support_legacy_linux.rst.txt @@ -0,0 +1,37 @@ +=============================== +Can Javet Support Legacy Linux? +=============================== + +Yes, Javet can support some legacy linux distributions, eg: Ubuntu 16.04, Ubuntu 18.04, but not with the official builds which rely on more advanced tool chain. + +Please download the private builds from this `drive `_ and prepare your runtime environment as following. + +.. code-block:: shell + + sudo apt update + sudo apt upgrade -y + sudo apt install build-essential -y + sudo apt install software-properties-common -y + sudo add-apt-repository ppa:ubuntu-toolchain-r/test + sudo apt upgrade -y + sudo apt install gcc-snapshot -y + sudo apt upgrade -y + sudo apt install gcc-7 g++-7 gcc-8 g++-8 gcc-9 g++-9 -y + sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-9 90 --slave /usr/bin/g++ g++ /usr/bin/g++-9 --slave /usr/bin/gcov gcov /usr/bin/gcov-9 + sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-8 80 --slave /usr/bin/g++ g++ /usr/bin/g++-8 --slave /usr/bin/gcov gcov /usr/bin/gcov-8 + sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-7 70 --slave /usr/bin/g++ g++ /usr/bin/g++-7 --slave /usr/bin/gcov gcov /usr/bin/gcov-7 + sudo update-alternatives --config gcc + + There are 3 choices for the alternative gcc (providing /usr/bin/gcc). + + Selection Path Priority Status + ------------------------------------------------------------ + * 0 /usr/bin/gcc-9 90 auto mode + 1 /usr/bin/gcc-7 70 manual mode + 2 /usr/bin/gcc-8 80 manual mode + 3 /usr/bin/gcc-9 90 manual mode + +Notes +===== + +Private builds imply considerable additional effort, so there is no commitments. Please contact the maintainer for private builds wisely. diff --git a/docs/_sources/faq/environment/can_javet_support_mac.rst.txt b/docs/_sources/faq/environment/can_javet_support_mac.rst.txt new file mode 100644 index 000000000..10a244dca --- /dev/null +++ b/docs/_sources/faq/environment/can_javet_support_mac.rst.txt @@ -0,0 +1,43 @@ +====================== +Can Javet Support Mac? +====================== + +Now +=== + +My `MacBook Air mid-2012 `_ was revived with Mac OS Catalina which is the lowest version supported by latest V8. I managed to include it in the regular release cycle. + +Known Issue +----------- + +Some of the Node.js symbols might not be exposed correctly. That might cause native node modules malfunction. Quick fix will be served per issue reported. + +Will the Mac OS Build be LTS? +----------------------------- + +I doubt because when next time V8 abandons Catalina, I won't be able to create any new builds unless someone takes care of the Mac OS build or I get enough donation for a new device. |Donate| + +How about arm64? +---------------- + +That is still not supported. Please |Donate| + +.. |Donate| image:: https://img.shields.io/badge/Donate-PayPal-green.svg + :target: https://paypal.me/caoccao?locale.x=en_US + +Before Aug 10, 2021 +=================== + +Short answer is **Yes and No**. + +Yes +--- + +There is no technical difficulties. The code is written in cross-platform manner. Someone needs to pay considerable effort creating and maintaining the Mac build. + +No +-- + +I don't own a decent Mac device. To be more precisely, I have Mac Mini and MacBook Air, but they are too old (building Node.js and V8 would take many hours). Besides, there are both x86 and arm64 to be supported. + +I have no plan on buying 2 new Mac devices for supporting Javet only in the near future. If I could be well funded, I would consider supporting Mac. diff --git a/docs/_sources/faq/environment/index.rst.txt b/docs/_sources/faq/environment/index.rst.txt new file mode 100644 index 000000000..de6b5a214 --- /dev/null +++ b/docs/_sources/faq/environment/index.rst.txt @@ -0,0 +1,9 @@ +=========== +Environment +=========== + +.. toctree:: + :maxdepth: 1 + + can_javet_support_mac + can_javet_support_legacy_linux diff --git a/docs/_sources/faq/index.rst.txt b/docs/_sources/faq/index.rst.txt new file mode 100644 index 000000000..b6bc02345 --- /dev/null +++ b/docs/_sources/faq/index.rst.txt @@ -0,0 +1,11 @@ +=== +FAQ +=== + +.. toctree:: + :maxdepth: 2 + + background/index + development/index + environment/index + troubleshooting/index diff --git a/docs/_sources/faq/troubleshooting/a_dynamic_link_library_dll_initialization_routine_failed.rst.txt b/docs/_sources/faq/troubleshooting/a_dynamic_link_library_dll_initialization_routine_failed.rst.txt new file mode 100644 index 000000000..e85bcab1f --- /dev/null +++ b/docs/_sources/faq/troubleshooting/a_dynamic_link_library_dll_initialization_routine_failed.rst.txt @@ -0,0 +1,5 @@ +========================================================== +A dynamic link library (DLL) initialization routine failed +========================================================== + +This failure happens when Javet Node.js mode tries to load a Node.js native module. The root cause is some ``NAPI`` symbols cannot be found on Windows. The fix is is available at :doc:`../../reference/modularization`. diff --git a/docs/_sources/faq/troubleshooting/can_i_debug_javet_in_chrome_dev_tools.rst.txt b/docs/_sources/faq/troubleshooting/can_i_debug_javet_in_chrome_dev_tools.rst.txt new file mode 100644 index 000000000..9766a1223 --- /dev/null +++ b/docs/_sources/faq/troubleshooting/can_i_debug_javet_in_chrome_dev_tools.rst.txt @@ -0,0 +1,8 @@ +===================================== +Can I Debug Javet in Chrome DevTools? +===================================== + +Yes, you can do that. Please visit :doc:`../../development/debug_with_chrome_developer_tools` for detail. + +.. image:: ../../resources/images/chome_developer_tools_devices_remote_target_javet.png + :alt: Remote Target Javet diff --git a/docs/_sources/faq/troubleshooting/index.rst.txt b/docs/_sources/faq/troubleshooting/index.rst.txt new file mode 100644 index 000000000..dd860e885 --- /dev/null +++ b/docs/_sources/faq/troubleshooting/index.rst.txt @@ -0,0 +1,10 @@ +=============== +Troubleshooting +=============== + +.. toctree:: + :maxdepth: 1 + + a_dynamic_link_library_dll_initialization_routine_failed + can_i_debug_javet_in_chrome_dev_tools + why_node_js_crashes_when_being_closed diff --git a/docs/_sources/faq/troubleshooting/why_node_js_crashes_when_being_closed.rst.txt b/docs/_sources/faq/troubleshooting/why_node_js_crashes_when_being_closed.rst.txt new file mode 100644 index 000000000..491927ce8 --- /dev/null +++ b/docs/_sources/faq/troubleshooting/why_node_js_crashes_when_being_closed.rst.txt @@ -0,0 +1,50 @@ +====================================== +Why Node.js Crashes When being Closed? +====================================== + +Background +========== + +Some Javet users experience segfaults when using the Node.js mode. The segfaults occur when ``NodeRuntime`` is being closed. E.g. `issue #20 `_ and `issue #82 `_. + +Root Cause +========== + +The root cause is Node.js event loop is activated when Node.js is exiting. Let's see how ``NodeRuntime.close()`` works behind the scenes. + +1. Close all Node.js modules +2. Close all reference objects +3. Close all callback context objects +4. Close all V8 modules +5. Hand over the control to Node.js exiting process + +If the application registers interceptors, those interceptors will be closed at step 3. However, the corresponding JavaScript objects hasn't been recycled yet. So, at step 5, Node.js activates the event loop and async objects will get resolved or rejected. The callbacks land Javet which is not able to handle because the callback context objects are gone. That leads to memory corruption and segfaults. + +Can Javet address that? Yes, but that implies hacking Node.js event loop. People choose Javet Node.js mode mostly because it is a genuine Node.js. So, no, Javet does not perform such hack. + +Solution +======== + +Well, how to prevent that from happening? In fact, knowing how Javet works and following the Javet way, that won't happen. + +Event unhandledRejection +------------------------ + +Node.js provides a standard `solution `_. Application can listen to event ``unhandledRejection`` to prevent that event from hitting Javet so that the segfaults will not take place. + +.. code-block:: javascript + + import process from 'process'; + process.on('unhandledRejection', (reason, promise) => { + // Do whatever you want to do + }); + +NodeRuntime.await() +------------------- + +Application may call ``NodeRuntime.await()`` before closing the ``NodeRuntime``. This call explicitly tells ``NodeRuntime`` to activate the event loop. + +NodeRuntime.lowMemoryNotification() +----------------------------------- + +Application may call ``NodeRuntime.lowMemoryNotification()`` before closing the ``NodeRuntime``. This call forces ``NodeRuntime`` to perform garbage collection. During the garbage collection, the callbacks can be safely handled by Javet without segfaults. diff --git a/docs/_sources/index.rst.txt b/docs/_sources/index.rst.txt new file mode 100644 index 000000000..0f481303e --- /dev/null +++ b/docs/_sources/index.rst.txt @@ -0,0 +1,10 @@ +.. include:: ../README.rst + +.. toctree:: + :maxdepth: 2 + + tutorial/index + reference/index + release_notes/index + faq/index + development/index diff --git a/docs/_sources/reference/best_practices.rst.txt b/docs/_sources/reference/best_practices.rst.txt new file mode 100644 index 000000000..1d5377f8b --- /dev/null +++ b/docs/_sources/reference/best_practices.rst.txt @@ -0,0 +1,46 @@ +============== +Best Practices +============== + +Thread, Engine and Pool +======================= + +* Always get 1 Javet engine from the pool in 1 thread. +* If multiple context is required in 1 thread, there are 2 options. + + * Call ``resetContext()`` between context switch. + * Obtain multiple V8Runtime instances. + +* Do not pass Javet engine to other threads. +* Always return Javet engine to pool in the end via try-with-resource or calling ``close()`` explicitly. +* Subclass Javet engine pool and Javet engine to complete your customization. Indeed, they are open to full customization. + +Resource Management +=================== + +* Dangling V8 objects will be forced to be recycled by Javet under the following scenarios and corresponding log will reflect that. Keeping an eye on the log helps address memory leak issues in the early stage. + + * Engine is closed. + * Pool is closed. + * Context is reset. + * Isolate is reset. + +* Always apply ``try-with-resource`` to Javet objects regardless of primitive or reference if they are not returned to Javet. +* Always prohibit calling ``close()`` of Javet objects if they will be returned to Javet. +* If the lifecycle of V8 objects is uncertain, calling ``setWeak()`` is the only way so that calling ``close()`` is no longer required. Be careful, calling ``close()`` after calling ``setWeak()`` may lead to V8 core dump immediately. +* In performance sensitive scenarios, please explicitly acquire ``V8Locker``. + +Security +======== + +* Malicious scripts are recommended to be executed in V8 mode or in ``vm`` module in Node.js mode. +* ``eval`` can be disabled in Javet. +* V8 0-day vulnerable issues most likely impact Node.js because the embedded V8 in Node.js is very old. It's recommended to use the V8 mode to minimize the risk. + +Node.js +======= + +* Modularize the code as much as possible so that performance is maximized. +* Always register unhandled rejection event. +* In **non-module** mode (similar to V8 in web browser), always put launch script in a dedicated folder whose parent folder contains ``node_modules`` and avoid ``require`` modules in the same folder. +* In **module** mode (similar to V8 in Node.js), be aware that the execution result is a promise and the behavior is different from native Node.js runtime behavior unless ``await()`` is called. diff --git a/docs/_sources/reference/error_codes.rst.txt b/docs/_sources/reference/error_codes.rst.txt new file mode 100644 index 000000000..ef61d1798 --- /dev/null +++ b/docs/_sources/reference/error_codes.rst.txt @@ -0,0 +1,59 @@ +=========== +Error Codes +=========== + +Why Error Codes? +---------------- + +Because Javet doesn't want to support i18n though both Node.js and V8 support i18n. + +* The final binary size will significantly increase with i18n. +* There is no development resource for i18n. + +Backward Compatibility +---------------------- + +Once the error codes are released, they are likely not changed any more for backward compatibility. + +The following error codes are generated automatically from the :extsource2:`source code <../../src/main/java/com/caoccao/javet/exceptions/JavetError.java>`. + +.. Error Codes Begin + + +==== =========== ====================================== ================================================================================================================================================================= +Code Type Name Format +==== =========== ====================================== ================================================================================================================================================================= +101 System OSNotSupported OS ${OS} is not supported +102 System LibraryNotFound Javet library ${path} is not found +103 System LibraryNotLoaded Javet library is not loaded because ${reason} +104 System NotSupported ${feature} is not supported +105 System FailedToReadPath Failed to read ${path} +201 Compilation CompilationFailure ${message} +301 Execution ExecutionFailure ${message} +302 Execution ExecutionTerminated Execution is terminated and continuable is ${continuable} +401 Callback CallbackSignatureParameterSizeMismatch Callback signature mismatches: method name is ${methodName}, expected parameter size is ${expectedParameterSize}, actual parameter size is ${actualParameterSize} +402 Callback CallbackSignatureParameterTypeMismatch Callback signature mismatches: expected parameter type is ${expectedParameterType}, actual parameter type is ${actualParameterType} +403 Callback CallbackInjectionFailure Failed to inject runtime with error message ${message} +404 Callback CallbackRegistrationFailure Callback ${methodName} registration failed with error message ${message} +405 Callback CallbackMethodFailure Callback ${methodName} failed with error message ${message} +406 Callback CallbackUnknownFailure Callback failed with unknown error message ${message} +407 Callback CallbackUnregistrationFailure Callback ${methodName} unregistration failed with error message ${message} +501 Converter ConverterFailure Failed to convert values with error message ${message} +502 Converter ConverterCircularStructure Circular structure is detected with max depth ${maxDepth} reached +503 Converter ConverterSymbolNotBuiltIn ${symbol} is not a built-in symbol +601 Module ModuleNameEmpty Module name is empty +602 Module ModuleNotFound Module ${moduleName} is not found +603 Module ModulePermissionDenied Denied access to module ${moduleName} +701 Lock LockAcquisitionFailure Failed to acquire the lock +702 Lock LockReleaseFailure Failed to release the lock +703 Lock LockConflictThreadIdMismatch Runtime lock conflict is detected with locked thread ID ${lockedThreadID} and current thread ID ${currentThreadID} +801 Runtime RuntimeAlreadyClosed Runtime is already closed +802 Runtime RuntimeAlreadyRegistered Runtime is already registered +803 Runtime RuntimeNotRegistered Runtime is not registered +804 Runtime RuntimeLeakageDetected ${count} runtime(s) leakage is detected +805 Runtime RuntimeCloseFailure Failed to close the runtime with error message ${message} +==== =========== ====================================== ================================================================================================================================================================= + + +.. Error Codes End + diff --git a/docs/_sources/reference/index.rst.txt b/docs/_sources/reference/index.rst.txt new file mode 100644 index 000000000..ef03781b2 --- /dev/null +++ b/docs/_sources/reference/index.rst.txt @@ -0,0 +1,21 @@ +========= +Reference +========= + +.. toctree:: + :maxdepth: 1 + + javadoc/index + v8_collection + v8_function + v8_promise + modularization + memory_management + lock + termination + logging + load_and_unload + best_practices + performance + error_codes + todo_list diff --git a/docs/_sources/reference/javadoc/index.rst.txt b/docs/_sources/reference/javadoc/index.rst.txt new file mode 100644 index 000000000..a26617ce3 --- /dev/null +++ b/docs/_sources/reference/javadoc/index.rst.txt @@ -0,0 +1,3 @@ +============= +API Reference +============= \ No newline at end of file diff --git a/docs/_sources/reference/load_and_unload.rst.txt b/docs/_sources/reference/load_and_unload.rst.txt new file mode 100644 index 000000000..3a77133b8 --- /dev/null +++ b/docs/_sources/reference/load_and_unload.rst.txt @@ -0,0 +1,45 @@ +=============== +Load and Unload +=============== + +As documented in :doc:`../development/design`, Javet supports loading and unloading the JNI libraries during runtime in both Node.js and V8 modes. + +How? +==== + +Unload +------ + +Assuming the JNI library per mode is already loaded, here are the step-by-step on how to unload it. + +.. code-block:: java + + // Step 1: Set library reloadable. Why? Because Javet defaults that switch to false. + V8Host.setLibraryReloadable(true); + // Step 2: Get V8Host per JS runtime type. + V8Host v8Host = V8Host.getInstance(jsRuntimeType); + // Step 3: Unload the library. + v8Host.unloadLibrary(); + // Step 4: Restore the switch. + V8Host.setLibraryReloadable(false); + +How does ``unloadLibrary()`` work? There is no API that allows unloading a JNI library explicitly. The only way is GC will automatically unload the library if all references to that library are garbage collectable. So, application is supposed to close all V8 values, V8 runtimes prior to calling ``unloadLibrary()``. + +Load +---- + +Assuming the JNI library per mode is already unloaded, here are the step-by-step on how to load it again. + +.. code-block:: java + + // Step 1: Get V8Host per JS runtime type. + V8Host v8Host = V8Host.getInstance(jsRuntimeType); + // Step 2: Load the library. + v8Host.loadLibrary(); + +Notes +===== + +* ``unloadLibrary()`` can only take effect after all references are garbage collectable. +* ``loadLibrary()`` is internally called by Javet at the first time and only takes effect after ``unloadLibrary()`` is called. +* ``loadLibrary()`` and ``unloadLibrary()`` are for experiment only. **They may be unstable and crash JVM. Please use this feature at your own risk.** diff --git a/docs/_sources/reference/lock.rst.txt b/docs/_sources/reference/lock.rst.txt new file mode 100644 index 000000000..81c6fd2aa --- /dev/null +++ b/docs/_sources/reference/lock.rst.txt @@ -0,0 +1,43 @@ +============= +Know the Lock +============= + +What does Lock Mean in Javet? +============================= + +V8 runtime runs in an isolated and single-threaded environment so that there is no race condition issue. How about playing V8 runtime in JVM among multiple threads? Yes, that is possible in 2 modes. + +1. Implicit Mode +---------------- + +Javet automatically handles the ``lock()`` and ``unlock()`` regardless of thread context switch. So, in most of the cases, application just calls regular API without calling single line of locking API. + +2. Explicit Mode +---------------- + +In explicit mode, application just needs to surround the code block with a ``V8Locker`` applied by ``try-with-resource``. Internally, Javet allocates a long-live V8 locker instead of creating V8 locker per API call to achieve better performance. + +.. code-block:: java + + try (V8Locker v8Locker = v8Runtime.getV8Locker()) { + // Do whatever you want to do. + } + +Be careful, ``V8Locker`` cannot be nested, otherwise checked exception will be thrown reporting lock conflict. Also, if the JS runtime type is Node.js, calling ``resetContext()`` or ``resetIsolate()`` may trigger core dump. Please refer to the :extsource2:`source code <../../src/test/java/com/caoccao/javet/interop/engine/TestPerformance.java>` for detail. + +Comparisons +=========== + +Performance +----------- + +Implicit mode comes with a slight performance overhead in V8 because every native call is protected by a new V8 locker. + +Explicit mode is designed for performance sensitive work. In extreme performance test cases, the performance improvement may be up to 150% compared to implicit mode. + +Thread-safety +------------- + +Implicit mode is thread-safe because its locking granularity is at API call level. Multiple threads are free to share the same V8 runtime in concurrent scenarios. Of course, be careful that JavaScript variables may be changed by other threads. It's better not to touch the same JavaScript variable among multiple threads, otherwise, Javet may crash. Yes, crash, because Javet doesn't perform this kind of check. + +Explicit mode is **NOT** thread-safe because it's designed to improve performance in single-threaded scenarios. Sharing V8 locker protected V8 runtime among multiple threads will result in Javet crash immediately. diff --git a/docs/_sources/reference/logging.rst.txt b/docs/_sources/reference/logging.rst.txt new file mode 100644 index 000000000..ec7b55889 --- /dev/null +++ b/docs/_sources/reference/logging.rst.txt @@ -0,0 +1,77 @@ +======= +Logging +======= + +As Javet is a fundamental SDK, it doesn't rely on any other libraries except JDK so that Javet users don't get dependency hell. That also means Javet has to use the JDK logging API, but Javet allows injecting 3rd party logging API. + +Step 1: Implement IJavetLogger +============================== + +``IJavetLogger`` is the the only logging interface accepted by Javet. You may implement ``IJavetLogger`` with ``slf4j`` as following. + +.. code-block:: java + + import com.caoccao.javet.interfaces.IJavetLogger; + import org.slf4j.Logger; + import org.slf4j.LoggerFactory; + + public class MyJavetLogger implements IJavetLogger { + protected Logger logger; + + public MyJavetLogger(String name) { + logger = LoggerFactory.getLogger(name); + } + + @Override + public void debug(String message) { + if (logger.isDebugEnabled()) { + logger.debug(message); + } + } + + @Override + public void error(String message) { + if (logger.isDebugEnabled()) { + logger.error(message); + } + } + + @Override + public void error(String message, Throwable throwable) { + if (logger.isDebugEnabled()) { + logger.error(message, throwable); + } + } + + @Override + public void info(String message) { + if (logger.isInfoEnabled()) { + logger.info(message); + } + } + + @Override + public void warn(String message) { + if (logger.isWarnEnabled()) { + logger.warn(message); + } + } + } + +Step 2: Inject the Logger +========================= + +Injecting the logger is quite simple. + +* Create an instance of the logger. +* Set the logger to a config. +* Set the config to a pool. + +.. code-block:: java + + MyJavetLogger javetLogger = new MyJavetLogger("TestLogger"); + JavetEngineConfig javetEngineConfig = new JavetEngineConfig(); + javetEngineConfig.setJavetLogger(javetLogger); + JavetEnginePool javetEnginePool = new JavetEnginePool(javetEngineConfig); + +Now, Javet is integrated into your logging system. diff --git a/docs/_sources/reference/memory_management.rst.txt b/docs/_sources/reference/memory_management.rst.txt new file mode 100644 index 000000000..0e850c637 --- /dev/null +++ b/docs/_sources/reference/memory_management.rst.txt @@ -0,0 +1,157 @@ +================= +Memory Management +================= + +3 Challenges in Memory Management +================================= + +JVM GC +------ + +JVM is known to have a GC that manages memory automatically. However, that doesn't cover the objects in JNI native implementation. Once ``NewGlobalRef(javaObject)`` is called, that ``javaObject`` lives forever in JVM until ``DeleteGlobalRef(javaObject)`` is called. + +C++ Runtime +----------- + +Smart pointers in C++ cannot easily work across JNI to JVM, in other words, raw pointers are directly referenced in JVM as ``long``. C++ runtime has no idea when to free the memory of those raw pointers unless JVM tells C++ runtime to release via JNI. + +V8 GC +----- + +V8 generally categorizes objects in memory to 3 types. + +1. ``v8::Local`` - It lives within the local scope of a C++ function call. +2. ``v8::Persistent`` - Its lifecycle is managed by V8 GC. +3. ``v8::External`` - V8 GC treats it as root object so that it lives as long as the V8 isolate lives. + +The awful thing in V8 GC is V8 does not make final callback when a context is being closed. From V8 perspective, that's a performance improvement. But from Javet perspective, Javet cannot completely rely on V8 to do the resource management. So, Javet keeps track of all unmanaged resource and makes sure there is no memory leak in all cases. + +Recommended Options +=================== + +Javet directly borrows the way V8 manages objects in JVM. The rule is simple in the following 2 Options. + +Automatic Management with try-with-resource +------------------------------------------- + +.. code-block:: java + + // Create an object and wrap it with try resource. + try (V8ValueObject v8ValueObject = v8Runtime.createV8ValueObject()) { + // Do whatever you want to do with this object + // v8ValueObject.close() is called automatically at the end of the block. + } + // Outside the code block, this object is no longer valid. + +Automatically Manage with Weak Reference +---------------------------------------- + +.. code-block:: java + + // Create an object. + V8ValueObject v8ValueObject = v8Runtime.createV8ValueObject(); + // Do whatever you want to do with this object + v8ValueObject.setWeak(); + // Do whatever you want to do with this object + /* + v8ValueObject.close() is called automatically via V8 GC callback. + So, there is no need to close the V8 object explicitly. + This is quite useful when the lifecycle is not determined, E.g. V8 function. + */ + +Note: V8 does not recycle objects that are referenced by other objects. Please make sure the object chain is broken so that GC can work as expected. ``com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor`` is a good sample showing how to deal with that. + +Alternative Option: ArrayBuffer +=============================== + +The ArrayBuffer object is used to represent a generic, fixed-length raw binary data buffer. + +It is an array of bytes, often referred to in other languages as a "byte array".You cannot directly manipulate the contents of an ArrayBuffer; instead, you create one of the typed array objects or a DataView object which represents the buffer in a specific format, and use that to read and write the contents of the buffer. + +Javet offers complete support to all the typed arrays as well as ``DataView`` as following. There is a ``java.nio.ByteBuffer`` inside every typed array and ``DataView``. That ``ByteBuffer`` directly links to the corresponding backing store of V8 typed array. In other words, Javet and V8 can both access the same address to achieve zero memory copy. Please consider using typed array in performance sensitive scenarios. + ++-------------------+-----------------------------+---------------+------------------------------------------------------------------------------------+---------------------+-------------------------------+ +| Type | Value Range | Size in bytes | Description | Web IDL type | Equivalent C type | ++===================+=============================+===============+====================================================================================+=====================+===============================+ +| Int8Array | -128 to 127 | 1 | 8-bit two's complement signed integer | byte | int8_t | ++-------------------+-----------------------------+---------------+------------------------------------------------------------------------------------+---------------------+-------------------------------+ +| Uint8Array | 0 to 255 | 1 | 8-bit unsigned integer | octet | uint8_t | ++-------------------+-----------------------------+---------------+------------------------------------------------------------------------------------+---------------------+-------------------------------+ +| Uint8ClampedArray | 0 to 255 | 1 | 8-bit unsigned integer (clamped) | octet | uint8_t | ++-------------------+-----------------------------+---------------+------------------------------------------------------------------------------------+---------------------+-------------------------------+ +| Int16Array | -32768 to 32767 | 2 | 16-bit two's complement signed integer | short | int16_t | ++-------------------+-----------------------------+---------------+------------------------------------------------------------------------------------+---------------------+-------------------------------+ +| Uint16Array | 0 to 65535 | 2 | 16-bit unsigned integer | unsigned short | uint16_t | ++-------------------+-----------------------------+---------------+------------------------------------------------------------------------------------+---------------------+-------------------------------+ +| Int32Array | -2147483648 to 2147483647 | 4 | 32-bit two's complement signed integer | long | int32_t | ++-------------------+-----------------------------+---------------+------------------------------------------------------------------------------------+---------------------+-------------------------------+ +| Uint32Array | 0 to 4294967295 | 4 | 32-bit unsigned integer | unsigned long | uint32_t | ++-------------------+-----------------------------+---------------+------------------------------------------------------------------------------------+---------------------+-------------------------------+ +| Float32Array | 1.2×10-38 to 3.4×1038 | 4 | 32-bit IEEE floating point number (7 significant digits e.g., 1.234567) | unrestricted float | float | ++-------------------+-----------------------------+---------------+------------------------------------------------------------------------------------+---------------------+-------------------------------+ +| Float64Array | 5.0×10-324 to 1.8×10308 | 8 | 64-bit IEEE floating point number (16 significant digits e.g., 1.23456789012345) | unrestricted double | double | ++-------------------+-----------------------------+---------------+------------------------------------------------------------------------------------+---------------------+-------------------------------+ +| BigInt64Array | -263 to 263-1 | 8 | 64-bit two's complement signed integer | bigint | int64_t (signed long long) | ++-------------------+-----------------------------+---------------+------------------------------------------------------------------------------------+---------------------+-------------------------------+ +| BigUint64Array | 0 to 264-1 | 8 | 64-bit unsigned integer | bigint | uint64_t (unsigned long long) | ++-------------------+-----------------------------+---------------+------------------------------------------------------------------------------------+---------------------+-------------------------------+ + +Please refer to :extsource2:`TestV8ValueTypedArray <../../src/test/java/com/caoccao/javet/values/reference/TestV8ValueTypedArray.java>` and :extsource2:`TestV8ValueDataView <../../src/test/java/com/caoccao/javet/values/reference/TestV8ValueDataView.java>` for sample code snippets. + +GC +== + +Automatic GC +------------ + +Javet has built-in automatic GC in both Node.js mode and V8 mode. Why? In high frequency API calling area, V8 may not keep up with the GC pace that JVM performs. Sometimes, JVM is running out of heap memory whereas V8 holds many zombie objects that are referenced by Javet in JVM. In this case, JVM ignores those objects unless V8 releases them in V8 GC cycle. + +Passive GC +^^^^^^^^^^ + +So, how to notify V8 GC that Java heap memory pool is running out of space? Javet automates this via ``V8Host`` and ``V8Notifier``. By default, this feature is disabled. Here is the step-by-step on how to enable this feature. + +1. (Optional) Call ``V8Host.setMemoryUsageThresholdRatio(double)`` to set memory usage threshold ratio. This is optional because the default value is 0.7. +2. Call ``V8Host.getNodeInstance().enableGCNotification()`` or ``V8Host.getV8Instance().enableGCNotification()`` to enable the notification. + +Here is a sample heap memory usage with default memory usage threshold ration and ``-Xms64m -Xmx64m``. Please note that in this sample, application is under high pressure of creating and destroying V8 objects. In normal cases, the curve is much smoother. + +.. image:: ../resources/images/javet_memory_management_passive_gc.png + :alt: Javet Memory Management Passive GC + +What happens internally is as following. + +1. ``V8Notifier`` listens to the heap memory notification from JVM per ``V8Host`` instance. +2. JVM notifies ``V8Notifier`` that memory threshold exceeds. +3. ``V8Notifier`` broadcasts GC scheduled flag to all ``V8Runtime`` managed by the ``V8Host`` instance. +4. Each ``V8Runtime`` performs GC in its own isolate. + +Aggressive GC +^^^^^^^^^^^^^ + +Just get ``V8Runtime`` from Javet engine pool that aggressively sends GC notification to idle engine in daemon thread. There is no performance overhead because: + +* The engine performs GC when it is idle in a dedicated thread. +* Javet engine pool is lock free so that the GC doesn't affect other worker threads. + +Of course, this behavior can be turned off by calling ``JavetEngineConfig.setAutoSendGCNotification(false)``. + +Manual GC +--------- + +There are 3 ways of manually triggering GC in both Node.js mode and V8 mode. + +V8Runtime.await() +^^^^^^^^^^^^^^^^^ + +This API represents a light-weighted way of giving V8 a hint to perform GC. It actually tells Node.js or V8 runtime to drain the message or task queue. As a side effect of the drain, a GC may occur based on the decision of Node.js or V8 runtime. + +V8Runtime.idleNotificationDeadline(long deadlineInMillis) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +This API explicitly tells Node.js or V8 runtime that the application expects a GC to happen in the given milliseconds. Be careful, Node.js or V8 runtime may disregard this instruction. + +V8Runtime.lowMemoryNotification() +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +This API explicitly tells Node.js or V8 runtime to perform a GC immediately. It is also used in automatic GC aforementioned. diff --git a/docs/_sources/reference/modularization.rst.txt b/docs/_sources/reference/modularization.rst.txt new file mode 100644 index 000000000..1287ce081 --- /dev/null +++ b/docs/_sources/reference/modularization.rst.txt @@ -0,0 +1,204 @@ +============== +Modularization +============== + +Node.js Mode +============ + +Example +------- + +In Node.js mode, Javet leaves Node.js with its own ways of handling modules. The coding experience is identical to the one in Node.js and applications can get all features supported by Javet, like function interception. Here is an example. + +.. code-block:: java + + try (JavetEnginePool javetEnginePool = new JavetEnginePool()) { + javetEnginePool.getConfig().setJSRuntimeType(JSRuntimeType.Node); + try (IJavetEngine iJavetEngine = javetEnginePool.getEngine()) { + NodeRuntime nodeRuntime = iJavetEngine.getV8Runtime(); + Path workingDirectory = new File(JavetOSUtils.WORKING_DIRECTORY, "scripts/node/test-node").toPath(); + // Set the require root directory so that Node.js is able to locate node_modules. + nodeRuntime.getNodeModule(NodeModuleModule.class).setRequireRootDirectory(workingDirectory); + getLogger().logInfo("1.23 + 2.34 = {0}", nodeRuntime.getExecutor( + "const Decimal = require('decimal.js');" + + "const a = new Decimal(1.23);" + + "const b = new Decimal(2.34);" + + "a.add(b).toString();").executeString()); + } + } + +Gaps between Javet Node.js Mode and Native Node.js +-------------------------------------------------- + +=================== ======================================= ============================================== +Feature Javet Node.js Mode Native Node.js +=================== ======================================= ============================================== +``require()`` Root Java Application Working Directory JavaScript Application Working Directory +Working Directory Java Application Working Directory JavaScript Application Working Directory +``__dirname`` N/A Yes +``__filename`` N/A Yes +Module Mode default: false default: true +=================== ======================================= ============================================== + +Usually the Java application working directory doesn't contain ``node_modules``. That for sure breaks Node.js. No worry, here are the steps on closing the gaps. + +1. Set the ``require()`` root directory so that Node.js is able to locate ``node_modules``. +2. Set working directory to where the script is located. +3. Set ``__dirname``. +4. Set ``__filename``. + +Luckily, in Javet, when ``getExecutor(File scriptFile)`` or ``getExecutor(Path scriptPath)`` is called, all these 4 steps are automatically performed. If ``getExecutor(String scriptString)`` is called, obviously Javet doesn't know what to do, but application may call ``IV8Executor.setResourceName(String resourceName)`` later to perform these 4 steps. So, Javet Node.js mode doesn't care where the script comes from. Application may feel free to virtualize Node.js. + +Can Javet run script in Node.js Module Mode? Yes, just call ``IV8Executor.setModule(true)``. + +The exciting thing is: in Javet, applications may have multiple instances of Node.js pointing to different ``node_modules`` and potentially these Node.js instances can share the same piece of data. + +Deal with Native Modules +------------------------ + +Node.js native modules usually cannot be dynamically loaded to Javet. E.g. sqlite3. That issue also bothers Electron. Electron folks created project `electron-rebuild `_ which rebuilds the native modules from source code and its own native symbols. + +Javet follows the same approach on Windows, and a simpler approach on Linux. + +Patch ELF Native Modules on Linux +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The native modules on Linux don't know the existence of Javet. When they look up Node.js symbols which are provided by Javet, they just fail with errors like the following. + + com.caoccao.javet.exceptions.JavetExecutionException: Error: /....../node_modules/sqlite3/lib/binding/napi-v3-linux-x64/node_sqlite3.node: undefined symbol: napi_create_error + +The fix is very simple. Here is a sample sqlite3. + +.. code-block:: shell + + # Install patchelf on Ubuntu (Optional) + sudo apt install patchelf + cd scripts/node + # Install sqlite3 + npm install + cd javet-rebuild + export NODE_MODULE_FILE="../node_modules/sqlite3/lib/binding/napi-v3-linux-x64/node_sqlite3.node" + ./rebuild.sh + +The `rebuild.sh <../../scripts/node/javet-rebuild/rebuild.sh>`_ actually calls `patchelf `_ to add Javet to the node module's dependency. + +Rebuild Native Modules on Windows +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The native modules on Windows don't know the existence of Javet. Windows dynamic library loading API ``LoadLibraryExW`` throws the following error. + + A dynamic link library (DLL) initialization routine failed. + +The fix is a bit complicated. + +* Prepare the Windows build environment by following :doc:`../development/build`. +* Install the node modules from source code ``npm install --build-from-source``. +* Download the corresponding Javet library file from this `drive `_. +* Unzip the Javet library file somewhere. +* Create a rebuild script pointing to the Javet library file by referencing `rebuild-sqlite3.cmd <../../scripts/node/javet-rebuild/rebuild-sqlite3.cmd>`_ and `rebuild.cmd <../../scripts/node/javet-rebuild/rebuild.cmd>`_. +* Run the rebuild script. + +The rebuild script actually replaces ``node.lib`` with ``libjavet....lib`` during the rebuild so that the new node modules can tell ``LoadLibraryExW`` to look for Javet instead of Node.js. + +Javet calls for someone who can voluntarily host the Javet libraries and Javet compatible node modules so that major Javet users don't need to go through these. For now, it has to be a pretty manual work. + +Caution! +^^^^^^^^ + +* Once the node modules are patched or rebuilt, they can only be loaded by that particular version of Javet and they cannot be loaded by Node.js any more. +* Make backups. + +V8 Mode +======= + +In V8 mode, there is no out-of-box support to ES6 dynamic import. But, Javet provides complete support on top of V8. There are 2 ways of playing around with the ES6 dynamic import: Pre-load and On-demand. + +Pre-load +-------- + +Javet stores compiled modules in a map with key = module path, value = compiled module. When V8 meets a new module to be imported, Javet will look up the map and return the compiled module to V8. So, in order to simulate dynamic import, application needs to compile those required modules before the final execution. + +For instance: The dependency is as following. + +.. code-block:: + + Application + ├─A + │ ├─a.js (depends on b.js) + │ └─B + │ └─b.js + ├─C + │ └─c.js + └─d.js + +The execution steps are as following. + +1. Compile module ./A/B/b.js +2. Compile module ./A/a.js +3. Compile module ./C/c.js +4. Compile module ./d.js +5. Launch the application + +Here is an example. Assuming ``test.js`` depends on ``module.js``, the code looks like the following. + +.. code-block:: java + + String codeString = "export function testFromModule() { return { a: 1 }; };"; + // Step 1: Assign a resource name to a piece of code. + IV8Executor iV8Executor = v8Runtime.getExecutor(codeString).setResourceName("./module.js"); + // Step 2: Compile the module.js. + try (V8Module v8Module = iV8Executor.compileModule()) { + // Step 3: Evaluate the module.js. + v8Module.executeVoid(); + if (v8Runtime.containsModule("./module.js")) { + System.out.println("./module.js is registered as a module."); + } + codeString = "import { testFromModule } from './module.js'; testFromModule();"; + // Step 4: Do the same to test.js. + iV8Executor = v8Runtime.getExecutor(codeString).setResourceName("./test.js").setModule(true); + // Step 5: Compile and evaluate test.js and Javet will automatically feed V8 with module.js. + try (V8ValueObject v8ValueObject = iV8Executor.execute()) { + // Step 6: Verify the module.js taking effect. + System.out.println("Variable a = " + v8ValueObject.getInteger("a") + "."); + } + } + +On-demand +--------- + +Obviously, pre-loading modules requires application to analyze the code for complete dependency. That is too heavy in most of the cases. Luckily, Javet also supports registering a module resolver which is called back when the modules are being imported. With the module resolver, application doesn't need to analyze the code for dependency. Of course, application is responsible for security check. + +Here is an example. Assuming ``test.js`` depends on ``module.js``, the code looks like the following. + +.. code-block:: java + + // Step 1: Create a V8 runtime from V8 host in try-with-resource. + try (V8Runtime v8Runtime = V8Host.getV8Instance().createV8Runtime()) { + // Step 2: Register a custom module resolver. + v8Runtime.setV8ModuleResolver((runtime, resourceName, v8ModuleReferrer) -> { + // Step 3: Compile module.js from source code if the resource name matches. + if ("./module.js".equals(resourceName)) { + return runtime.getExecutor("export function test() { return 1; }") + .setResourceName(resourceName).compileV8Module(); + } else { + return null; + } + }); + // Step 4: Import module.js in test.js and expose test() in global context. + v8Runtime.getExecutor("import { test } from './module.js'; globalThis.test = test;") + .setModule(true).setResourceName("./test.js").executeVoid(); + // Step 5: Call test() in global context. + System.out.println("test() -> " + v8Runtime.getExecutor("test()").executeInteger()); + } + +It is V8 that performs the dependency analysis. Javet just relays the callback to application and actively caches the compiled modules so that the module resolver is only called one time per module. + +Internals +========= + +How Javet and V8 work internally for supporting modules can be found at :doc:`../development/design`. + +.. image:: ../resources/images/javet_module_system.png + :alt: Javet Module System + +Please note that the way Javet handles dynamic import in V8 mode can be applied to Node.js mode. That means all Node.js modules can be virtualized by Javet. diff --git a/docs/_sources/reference/performance.rst.txt b/docs/_sources/reference/performance.rst.txt new file mode 100644 index 000000000..d4995fd19 --- /dev/null +++ b/docs/_sources/reference/performance.rst.txt @@ -0,0 +1,39 @@ +================= +Javet Performance +================= + +In V8, a context is an execution environment that allows separate, unrelated, JavaScript applications to run in a single instance of V8. + +It's recommended to reset context if a new execution environment is required. + +Result +====== + +Here is the performance test result from i7 10700K + Windows 10. Test case is just ``1 + 1 = 2``. + +======== =============================== =============== +Type Case TPS +======== =============================== =============== +Node Single Context with 1 Thread 751,032 +Node Ad-hoc Context with 1 Thread 65 +Node Single Context with 8 Threads 4,410,143 +Node Ad-hoc Context with 8 Threads 363 +Node Ad-hoc Isolate with 1 Thread 51 +Node Ad-hoc Isolate with 8 Threads 263 +V8 Single Context with 1 Thread 647,458 +V8 Ad-hoc Context with 1 Thread 2,846 +V8 Single Context with 8 Threads 3,968,253 +V8 Ad-hoc Context with 8 Threads 16,508 +V8 Ad-hoc Isolate with 1 Thread 748 +V8 Ad-hoc Isolate with 8 Threads 3,660 +======== =============================== =============== + +Highlights +========== + +* Node.js performs slightly better in **Single Context** mode mainly because the V8 embedded in Node.js is much older than the built-in V8. +* Built-in V8 dramatically outperforms Node.js in **Ad-hoc** mode mainly because Node.js comes with a huge overhead that seriously slows down the context and isolate creation and recycle. +* It's recommended to use built-in V8 unless Node.js is required in some particular cases. +* Node.js on Linux is built as `position independent code `_ which comes with an additional performance overhead. + +Reference: https://v8.dev/docs/embed#contexts diff --git a/docs/_sources/reference/termination.rst.txt b/docs/_sources/reference/termination.rst.txt new file mode 100644 index 000000000..596846033 --- /dev/null +++ b/docs/_sources/reference/termination.rst.txt @@ -0,0 +1,73 @@ +=========== +Termination +=========== + +Terminating scripts that run out of control is quite important in terms of protecting the applications from being attacked by malicious scripts. In Javet, there are 2 typical ways of terminating scripts. + +Automatic Termination with Pool and Engine +========================================== + +``IJavetEngineGuard`` is the built-in support for terminating a script which runs out of control. + +.. code-block:: java + + // Get an engine from the pool as usual. + try (IJavetEngine iJavetEngine = iJavetEnginePool.getEngine()) { + V8Runtime v8Runtime = iJavetEngine.getV8Runtime(); + // Get a guard from the engine and apply try-with-resource pattern. + try (IJavetEngineGuard iJavetEngineGuard = iJavetEngine.getGuard(10000)) { + v8Runtime.getExecutor("while (true) {}").executeVoid(); + // That infinite loop will be terminated in 10 seconds by the guard. + } catch (JavetTerminatedException e) { + // JavetTerminatedException will be thrown to mark that. + assertFalse(e.isContinuable()); + } + assertEquals(2, v8Runtime.getExecutor("1 + 1").executeInteger(), + "The V8 runtime is not dead and still be able to execute code afterwards."); + } + +Does ``IJavetEngineGuard`` hang normal scripts till timeout is hit? No, it doesn't cause any overhead. If the script completes, ``IJavetEngineGuard.close()`` will be called via try-with-resource pattern and cancel the daemon thread immediately. + +Please refer to the :extsource2:`source code <../../src/test/java/com/caoccao/javet/interop/engine/TestJavetEngineGuard.java>` for more detail. + +Manual Termination +================== + +Manual termination gives applications complete control. In return, the coding effort is considerable. + +.. code-block:: java + + V8Host v8Host = V8Host.getV8Instance(); + try (V8Runtime v8Runtime = v8Host.createV8Runtime()) { + // Create a daemon thread monitoring the V8 runtime status. + Thread daemonThread = new Thread(() -> { + // V8 runtime isInUse() does not require lock. + while (!v8Runtime.isInUse()) { + try { + TimeUnit.MILLISECONDS.sleep(1); + } catch (InterruptedException e) { + e.printStackTrace(); + } + } + // V8 runtime terminateExecution() does not require lock. + v8Runtime.terminateExecution(); + }); + daemonThread.start(); + try { + v8Runtime.getExecutor( + "var count = 0; while (true) { ++count; }") + .executeVoid(); + fail("Failed to throw exception when execution is terminated."); + } catch (JavetTerminatedException e) { + assertFalse(e.isContinuable()); + } + final int count = v8Runtime.getGlobalObject().getInteger("count"); + assertTrue(count > 0, "Count should be greater than 0."); + assertEquals(2, v8Runtime.getExecutor("1 + 1").executeInteger(), + "V8 runtime should still be able to execute script after being terminated."); + } + +How about Debug Mode? +===================== + +Usually, when application is being debugged, ``JavetEngineGuard`` may easily interrupt the debug. No worry, ``JavetEngineGuard`` is by default disabled in debug mode. Please refer to ``disableInDebugMode()`` and ``enableInDebugMode()`` for detail. diff --git a/docs/_sources/reference/todo_list.rst.txt b/docs/_sources/reference/todo_list.rst.txt new file mode 100644 index 000000000..772b4f6c9 --- /dev/null +++ b/docs/_sources/reference/todo_list.rst.txt @@ -0,0 +1,7 @@ +========= +TODO List +========= + +* To upgrade V8 and Node.js periodically. +* To expose more Node.js modules in Javet style. +* To polyfill V8 mode with more API. diff --git a/docs/_sources/reference/v8_collection.rst.txt b/docs/_sources/reference/v8_collection.rst.txt new file mode 100644 index 000000000..6a54652d5 --- /dev/null +++ b/docs/_sources/reference/v8_collection.rst.txt @@ -0,0 +1,80 @@ +============= +V8 Collection +============= + +Collection in V8 +================ + +Javet provides decent support on manipulating V8 collection as following. + +=================== =========================== ================ =========== ============ ======= =================================== =============== =============== =================== ============================ +Collection getLength() / getSize() add() / set() delete() has() get() getKeys() / getOwnPropertyNames() getValues() getEntries() forEach(Consumer) forEach(BiConsumer) +=================== =========================== ================ =========== ============ ======= =================================== =============== =============== =================== ============================ +Object No **Yes** **yes** **Yes** **Yes** **Yes** No No **Yes** **Yes** +Array **Yes** **Yes** **yes** **Yes** **Yes** **Yes** No No **Yes** No +Map **Yes** **Yes** **yes** **Yes** **Yes** **Yes** **Yes** **Yes** **Yes** **Yes** +Set **Yes** **Yes** **yes** **Yes** **Yes** **Yes** No No **Yes** No +WeakMap No **Yes** **yes** **Yes** **Yes** No No No No No +WeakSet No **Yes** **yes** **Yes** No No No No No No +=================== =========================== ================ =========== ============ ======= =================================== =============== =============== =================== ============================ + +Usage +===== + +V8ValueArray +------------ + +.. code-block:: java + + try (V8ValueArray v8ValueArray = v8Runtime.getExecutor("const a = new Array(0,1,2); a;").execute()) { + AtomicInteger count = new AtomicInteger(0); + v8ValueArray.forEach((V8ValueInteger value) -> { + assertEquals(count.getAndIncrement(), value.getValue()); + }); + assertEquals(4, v8ValueArray.push(3)); + assertEquals(3, v8ValueArray.popInteger()); + } + +V8ValueSet +---------- + +.. code-block:: java + + try (V8ValueSet v8ValueSet = v8Runtime.getExecutor( + "const a = new Set(); a.add('0'); a.add('1'); a.add('2'); a;").execute()) { + // V8 feature: Order is preserved. + AtomicInteger count = new AtomicInteger(0); + assertEquals(3, v8ValueSet.forEach((V8ValueString key) -> { + assertEquals(Integer.toString(count.getAndIncrement()), key.getValue()); + })); + v8ValueSet.add("3"); + assertTrue(v8ValueSet.has("3")); + assertTrue(v8ValueSet.delete("3")); + assertFalse(v8ValueSet.has("3")); + } + +V8ValueMap +---------- + +.. code-block:: java + + try (V8ValueMap v8ValueMap = v8Runtime.getExecutor( + "const a = new Map(); a.set('0', 0); a.set('1', 1); a.set('2', 2); a;").execute()) { + // V8 feature: Order is preserved. + AtomicInteger count = new AtomicInteger(0); + assertEquals(3, v8ValueMap.forEach((V8ValueString key) -> { + assertNotNull(key); + assertEquals(Integer.toString(count.getAndIncrement()), key.getValue()); + })); + count.set(0); + assertEquals(3, v8ValueMap.forEach((V8ValueString key, V8ValueInteger value) -> { + assertNotNull(key); + assertNotNull(value); + assertEquals(Integer.toString(count.get()), key.getValue()); + assertEquals(count.getAndIncrement(), value.getValue()); + })); + v8ValueMap.set("a", 1); + assertEquals(4, v8ValueMap.getSize()); + assertTrue(v8ValueMap.has("a")); + assertTrue(v8ValueMap.delete("a")); + } diff --git a/docs/_sources/reference/v8_function.rst.txt b/docs/_sources/reference/v8_function.rst.txt new file mode 100644 index 000000000..575960ab2 --- /dev/null +++ b/docs/_sources/reference/v8_function.rst.txt @@ -0,0 +1,490 @@ +=========== +V8 Function +=========== + +Function Types +============== + +In general, there are 3 types of function exposed by Javet. + +* **Native** functions are V8 built-in functions. +* **API** functions are C++ backed functions. Node.js defined C++ functions and Javet defined Java functions are all API functions. +* **User Defined** functions are JavaScript backed functions. Basically, any function generated via JavaScript code execution is user defined function. + +Comparisons +----------- + +=============== =========== =========== =========== =============== ================== +Type V8 Built-in C++ or Java JavaScript Interception Change on the Fly +=============== =========== =========== =========== =============== ================== +Native Yes Yes No Yes No +API No Yes No Yes No +User Defined No No Yes Yes Yes +=============== =========== =========== =========== =============== ================== + +Call ``getJSFunctionType()`` to determine which function type it is. + +Function Interception +===================== + +Functions can be intercepted via Javet API. This is equivalent to the capability provided by Node.js. However, there is still a key difference between user defined functions and function interception: local scoped context is visible to user defined function, but invisible to function interceptor. Why? That's a long story related to how closure is implemented in V8 which is not the goal in this section. If local scoped context has to be required, please consider changing the function on the fly which is documented in next section. + +``com.caoccao.javet.values.reference.IV8ValueObject`` exposes a set of ``bindFunction()`` that allow caller to register function interceptors in automatic or manual ways. + +Automatic Registration +---------------------- + +bind() +^^^^^^ + +``bind()`` scans the input callback receiver for functions decorated by ``@V8Function`` and ``@V8Property``. It allows registering many getters / setters and functions in one call. + +.. code-block:: java + + List bind(Object functionCallbackReceiver); + +How about Object Type Conversion? +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +As V8 only accepts data represented by its own format, Java objects need to be converted to native ``V8Value`` objects. Creating native ``V8Value`` objects is tricky in the callback receiver. There are typically 2 options. + +1. **Use Object Converter** - Enhance the :doc:`../tutorial/advanced/object_converter` and it just works as a charm. This is the recommended option. Please refer to ``generateArrayWithConverter()``. + +The beauty of the object converter is Javet doesn't intrude into the receiver at all so that application may pass any objects that are untouchable in the application code, e.g. a native object from a 3rd party library. Of course, in that situation, application may ignore the annotation and register the methods directly in the manual registration which is documented in the next section. + +2. **Convert via V8Runtime** - V8Runtime can be directly used to perform the type conversion. V8Runtime can be manually set by application, or borrowed from the input arguments. Sometimes the callback receiver is not able to borrow ``V8Runtime`` from input arguments, it may decorate a setter with ``@V8RuntimeSetter`` so that Javet will inject the current ``V8Runtime``. Please refer to ``generateArrayWithoutConverter()``. + +Here is a sample. The first step is to declare callback receiver and callback functions. That is quite easy as the sample code shows. + +.. code-block:: java + + public class AnnotationBasedCallbackReceiver { + private V8Runtime v8Runtime; + private String stringValue; + + public AnnotationBasedCallbackReceiver() { + stringValue = null; + v8Runtime = null; + } + + // Javet detects the getter automatically. + @V8Property(name = "stringValue") + public String getStringValue() { + return stringValue; + } + + // Javet detects the setter and property name automatically. + @V8Property + public void setStringValue(String stringValue) { + this.stringValue = stringValue; + } + + // Instance method with same name and same signature. + @V8Function(name = "echo") + public String echo(String str) { + return str; + } + + // Instance method with different name and same signature. + @V8Function(name = "add") + public Integer mathAdd(Integer a, Integer b) { + return a + b; + } + + // Instance method with converter for non-primitive objects. + @V8Function(name = "generateArrayWithConverter") + public Object[] generateArrayWithConverter() throws JavetException { + // Converter is able to recognize non-primitive types. + return new Object[]{"a", 1}; + } + + // Instance method requiring V8Runtime without converter. + @V8Function(name = "generateArrayWithoutConverter") + public V8ValueArray generateArrayWithoutConverter() throws JavetException { + V8ValueArray v8ValueArray = v8Runtime.createV8ValueArray(); + v8ValueArray.push("a"); + v8ValueArray.push(1); + return v8ValueArray; + } + + // Static method. + @V8Function(name = "staticEcho") + public static String staticEcho(String str) { + return str; + } + + // Declare the V8RuntimeSetter for dependency injection. + @V8RuntimeSetter + public void setV8Runtime(V8Runtime v8Runtime) { + this.v8Runtime = v8Runtime; + } + } + +The second step is to call the functions or properties. + +.. code-block:: java + + try (V8ValueObject v8ValueObject = v8Runtime.createV8ValueObject()) { + v8Runtime.getGlobalObject().set("a", v8ValueObject); + AnnotationBasedCallbackReceiver annotationBasedCallbackReceiver = new AnnotationBasedCallbackReceiver(); + v8ValueObject.bind(annotationBasedCallbackReceiver); + assertEquals("test", v8Runtime.getExecutor("a.echo('test')").executeString()); + assertEquals(3, v8Runtime.getExecutor("a.add(1, 2)").executeInteger()); + try (V8ValueArray v8ValueArray = v8Runtime.getExecutor( + "a.generateArrayWithConverter()").execute()) { + assertEquals("[\"a\",1]", v8ValueArray.toJsonString()); + } + try (V8ValueArray v8ValueArray = v8Runtime.getExecutor( + "a.generateArrayWithoutConverter()").execute()) { + assertEquals("[\"a\",1]", v8ValueArray.toJsonString()); + } + assertEquals("static", v8Runtime.getExecutor("a.staticEcho('static')").executeString()); + v8Runtime.getExecutor("a.stringValue = 'abc';").executeVoid(); + assertEquals("abc", v8Runtime.getExecutor("a.stringValue").executeString()); + v8Runtime.getGlobalObject().delete("a"); + } + +Can **this** be Passed in? +^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Yes, both ``@V8Function`` and ``@V8Property`` support ``thisObjectRequired``. Just set it to ``true`` and specify the first argument as ``this``. + +.. code-block:: java + + @V8Property(thisObjectRequired = true) + public ... functionName(V8ValueObject thisObject, ...) { + // function body + } + +This feature is especially useful when ``this`` needs to be returned. Just simply return the input ``this`` object and there is no need to create a new V8 object. + +Can Symbol Properties be Intercepted? +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Yes, ``@V8Property`` supports ``symbol``. Just set it to ``true``. + +.. code-block:: java + + @V8Property(symbol = true) + public String getValue() { + return value; + } + + @V8Property(symbol = true) + public void setValue(String value) { + this.value = value; + } + +Be careful, Javet only supports symbols that are registered as global symbols in property interception. + +How to Disable Properties or Functions? +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +As ``@V8Function`` and ``@V8Property`` are statically declared, there is no way of selectively disabling them. ``@V8BindEnabler`` is designed to give Javet a hint on which properties or functions are enabled. Here is a sample. + +.. code-block:: java + + @V8Function + public String disabledFunction() { + return "I am a disabled function."; + } + + @V8Property + public String disabledProperty() { + return "I am a disabled property."; + } + + @V8BindEnabler + public boolean isV8BindEnabled(String methodName) { + if ("disabledFunction".equals(methodName) || "disabledProperty".equals(methodName)) { + return false; + } + return true; + } + +``@V8BindEnabler`` can be used to decorate a method with signature ``boolean arbitraryMethod(String methodName)``. Javet calls that method by each method name for whether each method is enabled or not. + +How to Unregister Properties or Functions? +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +``unbind()`` follows the same way that ``bind()`` goes to unregister both properties and functions. + +``unbindProperty()`` and ``unbindFunction()`` provide precise way of unregistering single property or function. + +Manual Registration +------------------- + +Manual registration allows the applications to have full control over every step of the function interception. + +boolean bindFunction(String functionName, JavetCallbackContext javetCallbackContext) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +This method is for binding a Java code based function in semi-manual way. The caller is expected to do the following steps. + +* Create a callback receiver. +* Find certain callback method in the callback receiver. +* Create ``JavetCallbackContext`` by the callback receiver and callback method. +* Bind the callback context to a V8 object via ``bindFunction``. +* Call the function to trigger the callback. + +.. code-block:: java + + MockCallbackReceiver mockCallbackReceiver = new MockCallbackReceiver(v8Runtime); + JavetCallbackContext javetCallbackContext = new JavetCallbackContext( + mockCallbackReceiver, mockCallbackReceiver.getMethod("blank")); + V8ValueObject globalObject = v8Runtime.getGlobalObject(); + globalObject.bindFunction("blank", javetCallbackContext); + v8Runtime.getExecutor("blank();").executeVoid(); + globalObject.delete("blank"); + +boolean set(String key, V8Value value) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +This method is for binding a Java code based function in complete manual way. The caller is expected to do the following steps. + +* Create a callback receiver. +* Find certain callback method in the callback receiver. +* Create ``JavetCallbackContext`` by the callback receiver and callback method. +* Create ``V8ValueFunction`` by ``JavetCallbackContext``. +* Bind the function to a V8 object via ``set``. +* Call the function to trigger the callback. + +.. code-block:: java + + MockCallbackReceiver mockCallbackReceiver = new MockCallbackReceiver(v8Runtime); + JavetCallbackContext javetCallbackContext = new JavetCallbackContext( + mockCallbackReceiver, mockCallbackReceiver.getMethod("blank")); + V8ValueObject globalObject = v8Runtime.getGlobalObject(); + try (V8ValueFunction v8ValueFunction = v8Runtime.createV8ValueFunction(javetCallbackContext); + V8ValueObject a = v8Runtime.createV8ValueObject()) { + globalObject.set("a", a); + a.set("blank", v8ValueFunction); + assertFalse(mockCallbackReceiver.isCalled()); + v8Runtime.getExecutor("a.blank();").executeVoid(); + assertTrue(mockCallbackReceiver.isCalled()); + a.delete("blank"); + globalObject.delete("a"); + } + +boolean bindFunction(String functionName, String codeString) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +This method is for binding a JavaScript code based function. + +.. code-block:: java + + v8Runtime.getGlobalObject().bindFunction("b", "(x) => x + 1;"); + assertEquals(2, v8Runtime.getExecutor("b(1);").executeInteger()); + v8Runtime.getGlobalObject().delete("b"); + +Type Mismatch +------------- + +It is very easy to cause type mismatches in JavaScript. The Javet exception is so generic that applications may not be happy with it. So, how to customize the type mismatch exception? The recommended way is to declare the function signature to ``(V8Value... v8Values)`` or ``(Object... objects)``. + +* Javet doesn't throw exceptions under this signature in all cases. +* Application is the one that performs the argument validation so that the error handling is completely customized. +* When dealing with ``V8Value...``, application is responsible for the type conversion. +* Variable arguments can be achieved under this signature so that a JavaScript function can be completely mirrored in Java. + +Resource Management +------------------- + +In the function callback, Javet manages the lifecycle of the input arguments and the return value. So, **DO NOT** close the input arguments, and **DO NOT** apply ``try-with-resource`` to the return value. + +Summary +------- + +Obviously, the automatic registration is much better than the manual registration. Please use them wisely. + +Change a User Defined JavaScript Function on the Fly +==================================================== + +Why is Changing a User Defined JavaScript Function Important? +------------------------------------------------------------- + +Functions can be changed on the fly at JavaScript code level via Javet API. Why to choose this approach? Because sometimes local scoped context is required which is usually called closure. E.g: + +.. code-block:: javascript + + const a = function () { + const b = 1; + return () => b; + } + const x = a(); + console.log(x()); + // Output is: 1 + +Local const b is visible to the anonymous function at line 3, but invisible to the function interceptor. Javet provides a way of changing the function at JavaScript source code level so that local scoped context is still visible. + +How to Change a User Defined JavaScript Function on the Fly? +------------------------------------------------------------ + +``getSourceCode()`` and ``setSourceCode(String sourceCode)`` are designed for getting and setting the source code. ``setSourceCode(String sourceCode)`` actually performs the follow steps. + +.. code-block:: python + + def setSourceCode(sourceCode): + existingSourceCode = v8Function.getSourceCode() + (startPosition, endPosition) = v8Function.getPosition() + newSourceCode = existingSourceCode[:startPosition] + sourceCode + existingSourceCode[endPosition:] + v8Function.setSourceCode(newSourceCode) + v8Function.setPosition(startPosition, startPosition + len(sourceCode)) + +Be careful, ``setSourceCode(String sourceCode)`` has radical impacts that may break the execution because all functions during one execution share the same source code but have their own positions. The following diagram shows the rough memory layout. Assuming function (4) has been changed to something else with position changed, function (1) and (2) will not be impacted because their positions remain the same, but function (3) will be broken because its end position is not changed to the end position of function (4) accordingly. + +.. image:: ../resources/images/memory_layout_of_v8_function.png + :alt: Memory Layout of V8 Function + +Javet does not scan memory for all impacted function. So, it is caller's responsibility for restoring the original source code after invocation. The pseudo logic is as following. + +.. code-block:: java + + originalSourceCode = v8ValueFunction.getSourceCode() + v8ValueFunction.setSourceCode(sourceCode) + v8ValueFunction.call(...) + v8ValueFunction.setSourceCode(originalSourceCode) + +Why does ``setSourceCode()`` sometimes return ``false``? Usually, that means the local scoped context hasn't been generated by V8. ``getJSScopeType().isClass() == true`` indicates that state. After ``callVoid(null)``, the local scoped context will be created with ``getJSScopeType().isFunction() == true`` and ``setSourceCode()`` will work. The pseudo logic is as following. + +.. code-block:: java + + originalSourceCode = v8ValueFunction.getSourceCode() + if (v8ValueFunction.getJSScopeType().isClass()) { + try { + v8ValueFunction.callVoid(null); + // Now v8ValueFunction.getJSScopeType().isFunction() is true + } catch (JavetException e) { + } + } + v8ValueFunction.setSourceCode(sourceCode) // true + v8ValueFunction.call(...) + v8ValueFunction.setSourceCode(originalSourceCode) + +The rough lifecycle of a V8 function is as following. + +.. image:: ../resources/images/lifecycle_of_v8_function.png + :alt: Lifecycle of V8 Function + +What is the Source Code of a Function in V8? +-------------------------------------------- + +When V8 calculates start position of a function, it does not include the keyword ``function`` and function name. E.g. + +.. code-block:: javascript + + function abc(a, b, c) { ... } // Source code is (a, b, c) { ... } + + (a, b, c) => { ... } // Source code is (a, b, c) => { ... } + +So, please always discard the keyword ``function`` and function name when calling ``setSourceCode()``. + +Automatic Type Conversion +========================= + +Javet is capable of automatically converting its internal ``V8Value`` to primitive types by inspecting the function signature. So, the following 4 functions are all the same and valid. + +.. code-block:: java + + // Option 1 + public String echo(String str) { + return str; + } + + // Option 2 + public String echo(V8Value arg) { + return arg == null ? null : arg.toString(); + } + + // Option 3 + public V8Value echo(String str) { + return v8Runtime.createV8ValueString(str); + } + + // Option 4 + public V8Value echo(V8Value arg) throws JavetException { + return arg.toClone(); + } + + // All 4 functions above can be handled in Javet as the following function + echo("123"); + +Primitive types can be in either primitive or object form in the method signature. Javet just automatically handles the type conversion and it is null safe. + +* ``boolean``: ``boolean``, ``Boolean``, ``null`` ⟶️ ``false``, ``undefined`` ⟶️ ``false``. +* ``byte``, ``integer``, ``long``, ``Short``: ``int``, ``Integer``, ``long``, ``Long``, ``short``, ``Short``, ``byte``, ``Byte``, ``null`` ⟶️ ``0``, ``undefined`` ⟶️ ``0``. +* ``char``: ``char``, ``Char``, ``null`` ⟶️ ``\0``, ``undefined`` ⟶️ ``\0``. +* ``float``, ``double``: ``float``, ``Float``, ``double``, ``Double``, ``int``, ``Integer``, ``long``, ``Long``, ``short``, ``Short``, ``byte``, ``Byte``, ``null`` ⟶️ ``0``, ``undefined`` ⟶️ ``0``. + +For instance: The following 4 functions are all the same and valid. + +.. code-block:: java + + // Option 1 + public int echo(Integer i) { + return i == null? 0: i.intValue(); + } + + // Option 2 + public Integer echo(int arg) { + return Integer.valueOf(int); + } + + // Option 3 + public V8ValueInteger echo(int i) { + return new V8ValueInteger(i); + } + + // Option 4 + public Integer echo(V8ValueInteger i) { + return i == null? 0: i.getValue(); + } + +Can the default values be changed in terms of null safety? Yes, :doc:`../tutorial/advanced/object_converter` allows overriding the default values. + +Call vs. Invoke +=============== + +In one sentence, ``call()`` belongs to function and ``invoke()`` belongs to object. + +Call +---- + +``call()`` is almost equivalent to ``Function.prototype.call()``. It allows the caller to specify receiver. Besides, Javet combines ``Function.prototype.call()`` and ``Function.prototype.apply()`` because Java is friendly to varargs. + +.. code-block:: java + + func.call(object, a, b, c); // func.call(object, a, b, c); with V8 object returned + func.callVoid(object, a, b, c); // func.call(object, a, b, c); without return + func.callObject(object, a, b, c); // func.call(object, a, b, c); with Java object returned + func.callPrimitive(object, a, b, c); // func.call(object, a, b, c); with Java primitive returned + func.callAsConstructor(a, b, c); // new func(a, b, c); + +Invoke +------ + +``invoke()`` takes function name and arguments, but not receiver because the object itself is the receiver. So the API is almost identical to ``call()`` except for the first argument. + +.. code-block:: java + + object.invoke("func", a, b, c); // object.func(a, b, c); with V8 object returned + object.invokeVoid("func", a, b, c); // object.func(a, b, c); without return + object.invokeObject("func", a, b, c); // object.func(a, b, c); with Java object returned + object.invokePrimitive("func", a, b, c); // object.func(a, b, c); with Java primitive returned + +``invoke()`` is heavily used in Javet so that the JNI implementation can be dramatically simplified. In few extreme cases, V8 doesn't expose its C++ API and ``invoke()`` appears to be the only way. So, feel free to invoke all kinds of JS API despite of the deficit of Javet built-in API. + +How about Bind? +--------------- + +``Function.prototype.bind()`` is simply a ``set()`` in Javet. + +.. code-block:: java + + // func.bind(object); func(a, b, c); with return + object.set("func", func); object.invoke("func", a, b, c); + + // func.bind(object); func(a, b, c); without return + object.set("func", func); object.invokeVoid("func", a, b, c); + +Please review the :extsource2:`test cases <../../src/test/java/com/caoccao/javet/values/reference/TestV8ValueFunction.java>` for more detail. diff --git a/docs/_sources/reference/v8_promise.rst.txt b/docs/_sources/reference/v8_promise.rst.txt new file mode 100644 index 000000000..2ecf7d696 --- /dev/null +++ b/docs/_sources/reference/v8_promise.rst.txt @@ -0,0 +1,97 @@ +========== +V8 Promise +========== + +V8 promise is an advanced topic because it's usually hard to be mastered due to its multi-threaded nature. Javet enables applications to play with V8 promise in a decent way. + +Promise and Resolver +==================== + +Resolver is a new concept to some JavaScript developers. In fact, it is already an old friend. Inside ``new Promise((resolve, reject) => {});``, ``(resolve, reject)`` is called resolver in V8. Javet exposes the V8 promise and resolver via the same interface ``IV8ValuePromise`` because in V8 they really are the same. So, they both share the same set of API. But the ownership of the API makes the difference as the following chart shows. + +.. image:: ../resources/images/v8_promise_and_resolver.png + :alt: V8 Promise and Resolver + +Lifecycle +========= + +The lifecycle is as the following chart shows. + +1. JavaScript application calls an API for certain resource. E.g. ``readFileAsync``. +2. Java application receives a callback from V8 for the resource. +3. Java application creates a V8 promise resolver and holds the resolver. +4. Java application gets a V8 promise from the resolver and returns that V8 promise as callback return. +5. JavaScript application gets that promise and binds the ``.then()`` and ``.catch()``. +6. Java application fetches the resource and calls the resolver via ``.resolve()``. +7. JavaScript application receives the resource in ``.then()`` and processes the result. + +.. image:: ../resources/images/v8_promise_lifecycle.png + :alt: V8 Promise Lifecycle + +Example fs.readFileAsync() +========================== + +Requirements: Create a JavaScript API ``fs.readFileAsync()`` for reading a file in async manner. + +The pseudo code is as following. + +.. code-block:: java + + // Java application injects an interceptor as 'fs'. + v8Runtime.getGlobalObject().set("fs", fs); + +.. code-block:: javascript + + // JavaScript application calls 'readFileAsync()' and registers 'then()' + fs.readFileAsync('a.log').then(fileContent => console.log(fileContent)); + +.. code-block:: java + + // Java application creates a resolver, pushes the resolver to task queue, returns a promise from the resolver. + @V8Function + public V8ValuePromise readFileAsync(String filePath) throws JavetException { + V8ValuePromise v8ValuePromiseResolver = v8Runtime.createV8ValuePromise(); + queue.add(new Task(v8ValuePromiseResolver, filePath, timeout)); + return v8ValuePromiseResolver.getPromise(); + } + +.. code-block:: java + + // Java application fetches the file content and resolve/reject the promise in a background thread. + String fileContent = getFileContent(task.getFilePath()); + try (V8ValuePromise promise = task.getPromise()) { + if (fileContent == null) { + promise.reject(v8Runtime.createV8ValueUndefined()); + } else { + promise.resolve(fileContent); + } + } + // JavaScript application prints the file content in console afterwards. + +Notes +----- + +* Java application needs to have background thread(s) process async calls from V8. +* Node.js mode has its own event loop. So, sometimes, Java application has to call ``await()`` after ``resolve()`` or ``reject()``. + +Unhandled Rejection +=================== + +Sometimes Java application breaks when unhandled rejection is raised. + +In V8 mode, ``V8Runtime.setPromiseRejectCallback()`` allows Java application to register a callback implementing ``IJavetPromiseRejectCallback``. + +In Node.js mode, event ``unhandledRejection`` is recommended to be listened. + +.. code-block:: javascript + + import process from 'process'; + + process.on('unhandledRejection', (reason, promise) => { + console.log('Unhandled Rejection at:', promise, 'reason:', reason); + // Application specific logging, throwing an error, or other logic here + }); + +Be careful, the ``V8Runtime.setPromiseRejectCallback()`` in V8 mode also works in Node.js mode and it can disable the built-in Node.js event ``unhandledRejection``. Sometimes, this is a handy feature. + +Please review the :extsource2:`test cases <../../src/test/java/com/caoccao/javet/values/reference/TestV8ValuePromise.java>` for more detail. diff --git a/docs/_sources/release_notes/index.rst.txt b/docs/_sources/release_notes/index.rst.txt new file mode 100644 index 000000000..63ed9ba28 --- /dev/null +++ b/docs/_sources/release_notes/index.rst.txt @@ -0,0 +1,10 @@ +============= +Release Notes +============= + +.. toctree:: + :maxdepth: 1 + + release_notes_0_9 + release_notes_0_8 + release_notes_0_7 diff --git a/docs/_sources/release_notes/release_notes_0_7.rst.txt b/docs/_sources/release_notes/release_notes_0_7.rst.txt new file mode 100644 index 000000000..65796b08e --- /dev/null +++ b/docs/_sources/release_notes/release_notes_0_7.rst.txt @@ -0,0 +1,44 @@ +=================== +Release Notes 0.7.x +=================== + +0.7.4 Live Debug +---------------- + +* Added V8 primitive value cache +* Added live debug for Chrome Developer Tools + +0.7.3 Locker +------------ + +* Added ``V8ValueWeakMap`` and ``V8ValueWeakSet`` +* Added ``forEach()`` to Collection +* Added ``V8Locker`` for Performance Sensitive Scenarios + +0.7.2 Engine Guard +------------------ + +* Added ``setFunction(String functionName, String codeString)`` to ``IV8ValueObject`` +* Added ``equals()`` and ``strictEquals()`` and ``sameValue()`` to ``IV8Value`` +* Added ``getIdentityHash()`` to ``IV8ValueReference`` +* Added ``isDead()``, ``isInUse()``, ``callAsConstructor()`` and ``terminateExecution()`` to ``V8Runtime`` +* Added V8 typed array and data view +* Added ``IJavetEngineGuard`` + +0.7.1 Bug Fixes +--------------- + +* Easy spring integration +* Performance test cases +* Few bug fixes + +0.7.0 Birth with V8 v8.9 +------------------------ + +* First release of Javet +* Linux + Windows +* V8 ``v8.9.255`` `(2021-02-04) `_ +* Exposure of the majority of V8 API in JVM +* JS function interception +* Native BigInt and Date +* Javet engine pool diff --git a/docs/_sources/release_notes/release_notes_0_8.rst.txt b/docs/_sources/release_notes/release_notes_0_8.rst.txt new file mode 100644 index 000000000..3db323872 --- /dev/null +++ b/docs/_sources/release_notes/release_notes_0_8.rst.txt @@ -0,0 +1,89 @@ +=================== +Release Notes 0.8.x +=================== + +0.8.10 Index in forEach +----------------------- + +* Renamed ``IJavetConsumer`` to ``IJavetUniConsumer`` +* Added ``IJavetUniIndexedConsumer`` and ``IJavetBiIndexedConsumer`` +* Fixed a bug in ``V8FunctionCallback`` on varargs +* Deprecated ``bindFunctions()`` and ``bindProperties()`` +* Added ``@CheckReturnValue`` to warn ignored return value + +0.8.9 Declarative Property Interception +--------------------------------------- + +* Renamed ``setFunction()`` to ``bindFunction()`` in ``IV8ValueObject`` +* Renamed ``setFunctions()`` to ``bindFunctions()`` in ``IV8ValueObject`` +* Added ``disableInDebugMode()`` and ``enableInDebugMode()`` to ``JavetEngineGuard`` +* Added ``bind()``, ``bindProperty()`` and ``bindProperties()`` in ``IV8ValueObject`` +* Added ``@V8Property`` for ``IV8ValueObject.bindProperties()`` + +0.8.8 Hotfix the Source Code +---------------------------- + +* Re-organized doc. +* Added ``getJSFunctionType()``, ``getSourceCode()`` and ``setSourceCode()`` to ``IV8ValueFunction`` + +0.8.7 Native Modules for Node.js +-------------------------------- + +* Supported native modules with rebuilt scripts +* Fixed ``NodeRuntime.await()`` to emit tasks + +0.8.6 Event Loop for Node.js +---------------------------- + +* Upgraded Linux build environment to Ubuntu 20.04 + GCC 9.3 +* Enhanced ``NodeRuntime.await()`` to allow interaction from other threads + +0.8.5 Error Codes +----------------- + +* Universal object conversion is turned on for all API +* Added ``createV8ValueDouble()``, ``createV8ValueString()`` and ``createV8ValueZonedDateTime()`` to ``V8Runtime`` +* Added ``JavetError`` with error codes +* Refactored ``invoke()``, ``call()``, ``set()``, ``has()`` to take ``Object`` instead of ``V8Value`` +* Removed a few exceptions + +0.8.4 V8 v9.0 +------------- + +* Added ``gcBeforeEngineClose`` to ``JavetEngineConfig`` +* Added ``JavetCallbackException`` +* Added ``IV8Value#isNullOrUndefined`` +* Upgraded Node.js to ``v14.16.1`` `(2021-04-06) `_ +* Upgraded V8 to ``v9.0.257`` `(2021-02-24) `_ + +0.8.3 GC +-------- + +* Added ``V8Runtime.lowMemoryNotification()`` and ``V8Runtime.idleNotificationDeadline()`` +* Added ``V8Host.setMemoryUsageThresholdRatio()``, ``V8Host.enableGCNotification()``, and ``V8Host.disableGCNotification()`` +* Updated JavetEnginePool to be lock free +* Added ``autoSendGCNotification`` to ``JavetEngineConfig`` +* Moved ``JavetCallbackContext`` management from ``V8ValueFunction`` to V8 +* Added ``JavetPromiseRejectCallback`` for V8 mode + +0.8.2 Conversion for Primitive +------------------------------ + +* Enabled auto type conversion in primitive types +* Fixed a memory leak issue during V8Runtime ``resetContext()``, ``resetIsolate()``, ``close()`` + +0.8.1 Declarative Function Interception +--------------------------------------- + +* Enabled declarative function interception +* Enabled custom object converter in function callback +* Added ``allowEval`` to ``JavetEngineConfig`` +* Refactored built-in module API for Node.js mode + +0.8.0 First Time with Node.js +----------------------------- + +* Supported Node.js ``v14.16.0`` `(2021-02-23) `_ +* Added ``V8Module`` and ``V8Script`` +* Enhanced ``V8ValuePromise`` +* Added dynamic switch between Node.js and V8 diff --git a/docs/_sources/release_notes/release_notes_0_9.rst.txt b/docs/_sources/release_notes/release_notes_0_9.rst.txt new file mode 100644 index 000000000..7517a8137 --- /dev/null +++ b/docs/_sources/release_notes/release_notes_0_9.rst.txt @@ -0,0 +1,110 @@ +=================== +Release Notes 0.9.x +=================== + +0.9.12 Private Properties +------------------------- + +* Added error code 503 +* Enhanced ``V8Property`` to support built-in symbols +* Added ``V8ValueSharedArrayBuffer`` +* Added ``registerCustomObject()`` and ``unregisterCustomObject()`` to ``JavetObjectConverter`` +* Added private property support to ``IV8ValueObject`` +* Fixed potential core dump issue in V8 runtime close. +* Added Javadoc. + +0.9.11 V8 v9.3 +-------------- + +* Upgraded Node.js to ``v14.17.6`` `(2021-08-31) `_ +* Upgraded V8 to ``v9.3.345.16`` `(2021-08-17) `_ +* Added ``unbind()``, ``unbindProperty()``, ``unbindFunction()`` to ``IV8ValueObject`` +* Updated ``V8Runtime`` to be completely thread-safe +* Added ``V8ValueBuiltInSymbol`` +* Added ``getOwnPropertySymbols()`` to ``V8ValueBuiltInObject`` +* Added ``createV8ValueSymbol()`` to ``V8Runtime`` +* Added ``symbol`` to ``V8Property`` to enable getter and setter on symbol +* Added error code 407 and 805 + +0.9.10 Polyfill Java Interfaces +------------------------------- + +* Added ``JavetVirtualObject`` +* Updated ``JavetUniversalProxyHandler`` to allow passing ``V8Value`` +* Updated ``JavetUniversalProxyHandler`` to allow passing ``V8ValueFunction`` as anonymous function +* Updated ``JavetUniversalProxyHandler`` to allow passing ``V8ValueObject`` as anonymous object +* Added ``isClosed()`` to ``IJavetClosable`` +* Added error code 602 and 603 + +0.9.9 Mac OS x86_64 +------------------- + +* Upgraded Node.js to ``v14.17.4`` `(2021-07-29) `_ +* Added support to Mac OS x86_64 +* Removed ``staticClassEnabled`` from ``JavetProxyConverter`` + +0.9.8 Empower the Promise +------------------------- + +* Added ``resolve()`` and ``reject()`` to ``V8ValuePromise`` +* Added ``staticClassEnabled`` to ``JavetProxyConverter`` +* Added ``construct()`` to ``JavetUniversalProxyHandler`` +* Added Dockerfile for Linux x86-64 +* Refactored document for how to build Javet + +0.9.7 Proxy Converter v2 +------------------------ + +* Added static mode to ``JavetUniversalProxyHandler`` +* Added ``ownKeys()`` to ``JavetUniversalProxyHandler`` + +0.9.6 Proxy Converter v1 +------------------------ + +* Added ``IV8ValueProxy`` and ``V8ValueProxy`` +* Added ``getTarget()``, ``getHandler()``, ``isRevoked()`` and ``revoke()`` to ``IV8ValueProxy`` +* Added ``createV8ValueProxy()`` to ``V8Runtime`` +* Added ``JavetUniversalProxyHandler`` and ``JavetProxyConverter`` + +0.9.5 V8 v9.2 +------------- + +* Upgraded V8 to ``v9.2.230.21`` `(2021-07-19) `_ + +0.9.4 Multi-process Safe +------------------------ + +* Added ``JavetConverterConfig`` +* Added ``JavetEntityFunction`` for ``JavetObjectConverter`` +* Updated ``JavetObjectConverter`` to allow skipping functions +* Added ``getPrototype()`` and ``setPrototype()`` to ``IV8ValueObject`` +* Changed the way that Javet libraries are deployed to be multi-process safe + +0.9.3 Module Resolver +--------------------- + +* Upgraded Node.js to ``v14.17.2`` `(2021-07-01) `_ +* Added ``IV8ModuleResolver`` to allow intercepting module resolving callback +* Added ``V8BindEnabler`` to determine whether certain injection is enabled or not +* Added ``NodeModuleProcess#getVersion`` +* Updated ``JavetPrimitiveConverter`` and ``JavetObjectConverter`` to check recursion depth for circular structure detection + +0.9.2 Anonymous Functions in Converter +-------------------------------------- + +* Upgraded Node.js to ``v14.17.1`` `(2021-06-15) `_ +* Updated ``JavetObjectConverter`` to handle anonymous functions more efficiently +* Added ``V8ValueBuiltInObject#assign`` + +0.9.1 V8 in Classloader +----------------------- + +* Moved V8 to a custom classloader +* Enabled ``unloadLibrary()`` and ``loadLibrary()`` in ``V8Host`` + +0.9.0 V8 v9.1 +------------- + +* Upgraded Node.js to ``v14.17.0`` `(2021-05-11) `_ +* Upgraded V8 to ``v9.1.269.28`` `(2021-05-10) `_ +* Added ``thisObjectRequired`` to ``@V8Function`` and ``@V8Property`` diff --git a/docs/_sources/tutorial/advanced/index.rst.txt b/docs/_sources/tutorial/advanced/index.rst.txt new file mode 100644 index 000000000..3c893598b --- /dev/null +++ b/docs/_sources/tutorial/advanced/index.rst.txt @@ -0,0 +1,10 @@ +======== +Advanced +======== + +.. toctree:: + :maxdepth: 1 + + object_converter + java_and_javascript_interop + interact_with_node_js diff --git a/docs/_sources/tutorial/advanced/interact_with_node_js.rst.txt b/docs/_sources/tutorial/advanced/interact_with_node_js.rst.txt new file mode 100644 index 000000000..a7ca858e5 --- /dev/null +++ b/docs/_sources/tutorial/advanced/interact_with_node_js.rst.txt @@ -0,0 +1,138 @@ +===================== +Interact with Node.js +===================== + +Is That Possible? +================= + +In native Node.js, once a JavaScript server application (e.g. express server) is up, there is no normal way of interacting with the Node.js runtime via console. The reasons are quite simple: + +* V8 is single-threaded. +* Node.js event loop is dedicated to that JavaScript server application. + +So, that almost closes the door to interacting with Node.js runtime from JVM. No worry, Javet is able to hijack the Node.js event loop to allow interaction from JVM. In other words, Java application can seamlessly interact with Node.js runtime as usual. That applies to all Javet API. + +How? +==== + +Step 1: JavaScript Server +------------------------- + +* Create a JavaScript server application. Here is a sample. + +.. code-block:: js + + /* + npm install express body-parser cookie-parser multer --save + */ + + const express = require("express"); + const app = express(); + + // This is the callback function that takes calls from JVM. + var test = (count) => { + console.log(`Call #${count}`); + } + + // This is the express handler. + app.get('/', function (req, res) { + res.send('Hello'); + console.log('GET /'); + }) + + // Start the express server. + const server = app.listen(8991, "0.0.0.0", () => { + const host = server.address().address; + const port = server.address().port; + console.log(`Listening at http://${host}:${port}`); + }); + +Step 2: Worker Thread for the JavaScript Server +----------------------------------------------- + +* Create a worker thread hosting that JavaScript server application. +* Call ``NodeRuntime.await()`` in that worker thread once the Node.js runtime is up. +* Make sure that Node.js runtime is shared with the main thread. + +Step 3: Main Thread for the Interaction +--------------------------------------- + +* Start that worker thread. +* Wait for the Node.js runtime completely initialized. +* Perform the interaction as usual. + +.. code-block:: java + + public class TestExpress { + public static void main(String[] args) throws JavetException, InterruptedException { + // Make sure node_modules and test folders stay together. + File codeFile = Path.of(JavetOSUtils.WORKING_DIRECTORY) + .resolve("test/test-express.js").toFile(); + AtomicBoolean serverUp = new AtomicBoolean(false); + // Make sure Node.js runtime is shared with all threads. + try (NodeRuntime nodeRuntime = V8Host.getNodeInstance().createV8Runtime()) { + // Create a worker thread. + Thread thread = new Thread(() -> { + try { + System.out.println("Starting the server."); + nodeRuntime.getExecutor(codeFile).executeVoid(); + serverUp.set(true); + System.out.println("Awaiting..."); + nodeRuntime.await(); + } catch (JavetException e) { + e.printStackTrace(); + } + }); + // Start the worker thread. + thread.start(); + while (!serverUp.get()) { + System.out.println("Waiting for server getting up."); + TimeUnit.MILLISECONDS.sleep(500); + } + System.out.println("Server is up."); + // Let's call Node.js. + for (int i = 0; i < Integer.MAX_VALUE; ++i) { + try (V8ValueFunction v8ValueFunction = nodeRuntime.getGlobalObject().get("test")) { + v8ValueFunction.callVoid(null, i); + } + TimeUnit.MILLISECONDS.sleep(1000); + } + } + } + } + +Voilà! The calls (``Call #``) from JVM work. And in the meanwhile, calls (``GET /``) to that JavaScript server also work. Here is the console output. + +.. code-block:: shell + + Waiting for server getting up. + Starting the server. + Awaiting... + Listening at http://0.0.0.0:8991 + Server is up. + Call #0 + Call #1 + Call #2 + Call #3 + Call #4 + GET / + Call #5 + Call #6 + Call #7 + Call #8 + Call #9 + +How can this work? The ``await()`` in the worker thread actually plays the following trick. + +.. code-block:: python + + # This is the pseudo logic. + def await(): + while True: + drain_the_task_queue() + pause_the_event_loop() + if there_are_more_tasks_in_task_queue(): + sleep_a_while() # This allows calls from other thread to take effect. + resume_the_event_loop() + else: + break diff --git a/docs/_sources/tutorial/advanced/java_and_javascript_interop.rst.txt b/docs/_sources/tutorial/advanced/java_and_javascript_interop.rst.txt new file mode 100644 index 000000000..d95d0a5bd --- /dev/null +++ b/docs/_sources/tutorial/advanced/java_and_javascript_interop.rst.txt @@ -0,0 +1,83 @@ +=========================== +Java and JavaScript Interop +=========================== + +Javet allows injecting arbitrary Java objects into V8 which enables the complete interop between Java and JavaScript. To enable this feature, application just needs to call ``v8Runtime.setConverter(new JavetProxyConverter());``. Here are 3 examples. + +Inject a Static Class +===================== + +.. code-block:: java + + v8Runtime.getGlobalObject().set("System", System.class); + v8Runtime.getExecutor("function main() {\n" + + // Java reference can be directly called in JavaScript. + " System.out.println('Hello from Java');\n" + + // Java reference can be directly assigned to JavaScript variable. + " const println = System.out.println;\n" + + // Java reference can be directly assigned to JavaScript variable. + " println('Hello from JavaScript');\n" + + "}\n" + + "main();").executeVoid(); + v8Runtime.getGlobalObject().delete("System"); + + /* + * Output: + * Hello from Java + * Hello from JavaScript + */ + +Inject an Enum +============== + +.. code-block:: java + + v8Runtime.getGlobalObject().set("Color", Color.class); + System.out.println(v8Runtime.getExecutor("Color.pink.toString();").executeString()); + System.out.println("The enum in JavaScript is the one in Java: " + + (Color.pink == (Color) v8Runtime.getExecutor("Color.pink;").executeObject())); + v8Runtime.getGlobalObject().delete("Color"); + + /* + * Output: + * java.awt.Color[r=255,g=175,b=175] + * The enum in JavaScript is the one in Java: true + */ + +Inject a Pattern +================ + +.. code-block:: java + + Pattern pattern = Pattern.compile("^\\d+$"); + v8Runtime.getExecutor("function main(pattern) {\n" + + " return [\n" + + " pattern.matcher('123').matches(),\n" + + " pattern.matcher('abc').matches(),\n" + + " ];\n" + + "}").executeVoid(); + System.out.println(v8Runtime.getGlobalObject().invokeObject("main", pattern).toString()); + + /* + * Output: + * [true, false] + */ + +Inject a StringBuilder +====================== + +.. code-block:: java + + v8Runtime.getGlobalObject().set("StringBuilder", StringBuilder.class); + System.out.println(v8Runtime.getExecutor("function main() {\n" + + " return new StringBuilder('Hello').append(' from StringBuilder').toString();\n" + + "}\n" + + "main();").executeString()); + v8Runtime.getGlobalObject().delete("StringBuilder"); + + /* + * Output: + * Hello from StringBuilder + */ + +Please refer to the :extsource3:`source code <../../../src/test/java/com/caoccao/javet/tutorial/TestJavaAndJSInterop.java>` for detail. diff --git a/docs/_sources/tutorial/advanced/object_converter.rst.txt b/docs/_sources/tutorial/advanced/object_converter.rst.txt new file mode 100644 index 000000000..4db272593 --- /dev/null +++ b/docs/_sources/tutorial/advanced/object_converter.rst.txt @@ -0,0 +1,568 @@ +================ +Object Converter +================ + +Javet has a built-in ``JavetObjectConverter`` with the following features. + +* It covers primitive types + Set + Map + Array. +* It is completely open to subclass. +* It minimizes the performance overhead. +* It allows registering custom objects. + +So, Javet doesn't natively support converting POJO objects because a POJO converter has to deal with reflection which is so slow that Javet leaves that to applications. However, if the POJO objects are owned by the application, it is possible to register custom objects with the built-in ``JavetObjectConverter``. Otherwise, designing a POJO converter is the alternative solution. + +What if the application wants to inject arbitrary Java objects? No worry, the ``JavetProxyConverter`` is designed for that purpose. + +Register Custom Objects +======================= + +``JavetObjectConverter`` exposes ``registerCustomObject()`` for alien objects which match the following conditions. + +* Default constructor without arguments +* Method with signature ``void fromMap(Map map)`` +* Method with signature ``Map toMap()`` + +Enhance the Custom Object +------------------------- + +* Create a default constructor without arguments. +* Add a method with signature ``void fromMap(Map map)`` +* Add a method with signature ``Map toMap()`` + +Can the method names be changed? Yes, they can have arbitrary names. + +.. code-block:: java + + public final class CustomObject { + private String name; + private int value; + + public CustomObject(String name, int value) { + this.name = name; + this.value = value; + } + + public CustomObject() { + this(null, 0); + } + + public void fromMap(Map map) { + setName((String) map.get("name")); + setValue((Integer) map.get("value")); + } + + public Map toMap() { + return new HashMap() { + { + put("name", getName()); + put("value", getValue()); + } + }; + } + + // getters and setters + } + +Register the Custom Object +-------------------------- + +As the default converter is ``JavetObjectConverter``, just follow the code snippet below to register a custom object. + +.. code-block:: java + + JavetObjectConverter converter = (JavetObjectConverter)v8Runtime.getConverter(); + converter.registerCustomObject(CustomObject.class); + +If the method names are different from the default ones, just provide the names upon registration as the following. + +.. code-block:: java + + converter.registerCustomObject(CustomObject.class, "customFromMap", "customToMap"); + +Usage +----- + +After the registration is completed, there is no additional steps any more. Just follow the regular pattern. + +.. code-block:: java + + CustomObject[] customObjects = new CustomObject[]{ + new CustomObject("x", 1), + new CustomObject("y", 2), + }; + v8Runtime.getGlobalObject().set("a", customObjects); + assertEquals(2, v8Runtime.getExecutor("a.length").executeInteger()); + List v8CustomObjects = v8Runtime.getGlobalObject().getObject("a"); + assertNotNull(v8CustomObjects); + assertEquals(2, v8CustomObjects.size()); + for (int i = 0; i < customObjects.length; i++) { + assertEquals(customObjects[i].getName(), v8Runtime.getExecutor("a[" + i + "].name").executeString()); + assertEquals(customObjects[i].getValue(), v8Runtime.getExecutor("a[" + i + "].value").executeInteger()); + assertEquals(customObjects[i].getName(), v8CustomObjects.get(i).getName()); + assertEquals(customObjects[i].getValue(), v8CustomObjects.get(i).getValue()); + } + +Highlights +---------- + +* PROS: This is a built-in feature so there is no need to deal with a POJO converter. +* CONS: This is a little bit intrusive to the custom objects. + +How does It Work? +----------------- + +As V8 supports private properties, ``JavetObjectConverter`` sets the custom object class name to the V8 object in ``toMap()`` and gets the name from the V8 object in ``fromMap()``. So it is the V8 object that carries the type information all the time and ``JavetObjectConverter`` is free from memorizing the complicated relationship between the Java objects and V8 objects. + +Design a POJO Converter +======================= + +A POJO converter usually is designed for the Java objects that are now owned by the application. So, it has to deal with reflection heavily. The following sample code runs in JDK 11. It's easy to tweak few API for JDK 8. + +Define POJO Object +------------------ + +Let's say you have a Pojo that allows you to define a name-value pair. + +.. code-block:: java + + public class Pojo { + private String name; + private String value; + + public Pojo() { + this(null, null); + } + + public Pojo(String name, String value) { + this.name = name; + this.value = value; + } + + public String getName() { + return name; + } + + public void setName(String name) { + this.name = name; + } + + public String getValue() { + return value; + } + + public void setValue(String value) { + this.value = value; + } + } + +Create PojoConverter +-------------------- + +Then, create a generic PojoConverter. + +* It is generic enough to cover all kinds of Pojo objects in a recursive way. +* There is no need to deal with primitive types because the parent converter handles that. +* Always override the methods with depth as argument for circular structure detection. +* Always increment the depth in recursive call. + +.. code-block:: java + + @SuppressWarnings("unchecked") + public class PojoConverter extends JavetObjectConverter { + public static final String METHOD_PREFIX_GET = "get"; + public static final String METHOD_PREFIX_IS = "is"; + protected static final Set EXCLUDED_METHODS; + + static { + EXCLUDED_METHODS = new HashSet<>(); + for (Method method : Object.class.getMethods()) { + if (method.getParameterCount() == 0) { + String methodName = method.getName(); + if (methodName.startsWith(METHOD_PREFIX_IS) || methodName.startsWith(METHOD_PREFIX_GET)) { + EXCLUDED_METHODS.add(methodName); + } + } + } + } + + @Override + protected V8Value toV8Value( + V8Runtime v8Runtime, Object object, final int depth) throws JavetException { + V8Value v8Value = super.toV8Value(v8Runtime, object, depth); + if (v8Value != null && !(v8Value.isUndefined())) { + return v8Value; + } + Class objectClass = object.getClass(); + V8ValueObject v8ValueObject = v8Runtime.createV8ValueObject(); + for (Method method : objectClass.getMethods()) { + if (method.getParameterCount() == 0 && method.canAccess(object)) { + String methodName = method.getName(); + String propertyName = null; + if (methodName.startsWith(METHOD_PREFIX_IS) && !EXCLUDED_METHODS.contains(methodName) + && methodName.length() > METHOD_PREFIX_IS.length()) { + propertyName = methodName.substring(METHOD_PREFIX_IS.length(), METHOD_PREFIX_IS.length() + 1).toLowerCase(Locale.ROOT) + + methodName.substring(METHOD_PREFIX_IS.length() + 1); + } else if (methodName.startsWith(METHOD_PREFIX_GET) && !EXCLUDED_METHODS.contains(methodName) + && methodName.length() > METHOD_PREFIX_GET.length()) { + propertyName = methodName.substring(METHOD_PREFIX_GET.length(), METHOD_PREFIX_GET.length() + 1).toLowerCase(Locale.ROOT) + + methodName.substring(METHOD_PREFIX_GET.length() + 1); + } + if (propertyName != null) { + try (V8Value v8ValueTemp = toV8Value(v8Runtime, method.invoke(object), depth + 1)) { + v8ValueObject.set(propertyName, v8ValueTemp); + } catch (Exception e) { + e.printStackTrace(); + } + } + } + } + v8Value = v8ValueObject; + return v8Runtime.decorateV8Value(v8Value); + } + } + +Ready! Go! +---------- + +Just write few lines of code to interact with Javet. + +.. code-block:: java + + public class TestPojo { + public static void main(String[] args) throws JavetException { + Pojo[] pojoArray = new Pojo[]{ + new Pojo("Tom", "CEO"), + new Pojo("Jerry", "CFO")}; + try (V8Runtime v8Runtime = V8Host.getNodeInstance().createV8Runtime()) { + v8Runtime.setConverter(new PojoConverter()); + v8Runtime.getGlobalObject().set("pojoArray", pojoArray); + v8Runtime.getExecutor("console.log(pojoArray);").executeVoid(); + } + } + } + +The console output is: + +.. code-block:: js + + [ { name: 'Tom', value: 'CEO' }, { name: 'Jerry', value: 'CFO' } ] + +This process is transparent and fully automated once the converter is set to ``V8Runtime``. + +Universal Converter +=================== + +Can I inject arbitrary Java objects and call all the API in JavaScript? Yes, ``JavetProxyConverter`` is designed for that. In general, the user experience is very much close to the one provided by GraalJS. As ``JavetProxyConverter`` opens almost the whole JVM to V8, it is very dangerous to allow end users to touch that V8 runtime, so ``JavetProxyConverter`` is not enabled by default. Here are the steps on how to enable that. + +Preparation +----------- + +.. code-block:: java + + // Step 1: Create an instance of JavetProxyConverter. + JavetProxyConverter javetProxyConverter = new JavetProxyConverter(); + // Step 2: Set the V8Runtime converter to JavetProxyConverter. + v8Runtime.setConverter(javetProxyConverter); + // Please feel free to inject arbitrary Java objects. + +Instance: File +-------------- + +.. code-block:: java + + File file = new File("/tmp/i-am-not-accessible"); + v8Runtime.getGlobalObject().set("file", file); + assertEquals(file, v8Runtime.getGlobalObject().getObject("file")); + assertEquals(file.exists(), v8Runtime.getExecutor("file.exists()").executeBoolean()); + assertEquals(file.isFile(), v8Runtime.getExecutor("file.isFile()").executeBoolean()); + assertEquals(file.isDirectory(), v8Runtime.getExecutor("file.isDirectory()").executeBoolean()); + assertEquals(file.canRead(), v8Runtime.getExecutor("file.canRead()").executeBoolean()); + assertEquals(file.canWrite(), v8Runtime.getExecutor("file.canWrite()").executeBoolean()); + assertEquals(file.canExecute(), v8Runtime.getExecutor("file.canExecute()").executeBoolean()); + v8Runtime.getGlobalObject().delete("file"); + v8Runtime.lowMemoryNotification(); + +Instance: Map +------------- + +.. code-block:: java + + javetProxyConverter.getConfig().setProxyMapEnabled(true); + Map map = new HashMap() {{ + put("x", 1); + put("y", "2"); + }}; + v8Runtime.getGlobalObject().set("map", map); + assertTrue(map == v8Runtime.getGlobalObject().getObject("map")); + assertEquals(1, v8Runtime.getExecutor("map['x']").executeInteger()); + assertEquals("2", v8Runtime.getExecutor("map['y']").executeString()); + assertEquals(1, v8Runtime.getExecutor("map.x").executeInteger()); + assertEquals("2", v8Runtime.getExecutor("map.y").executeString()); + assertEquals("3", v8Runtime.getExecutor("map['z'] = '3'; map.z;").executeString()); + assertEquals("3", map.get("z")); + assertEquals("4", v8Runtime.getExecutor("map.z = '4'; map.z;").executeString()); + assertEquals("4", map.get("z")); + v8Runtime.getGlobalObject().delete("map"); + v8Runtime.lowMemoryNotification(); + javetProxyConverter.getConfig().setProxyMapEnabled(false); + +Instance: Path +-------------- + +.. code-block:: java + + Path path = new File("/tmp/i-am-not-accessible").toPath(); + v8Runtime.getGlobalObject().set("path", path); + assertEquals(path, v8Runtime.getGlobalObject().getObject("path")); + assertEquals(path.toString(), v8Runtime.getExecutor("path.toString()").executeString()); + Path newPath = v8Runtime.toObject(v8Runtime.getExecutor("path.resolve('abc')").execute(), true); + assertNotNull(newPath); + assertEquals(path.resolve("abc").toString(), newPath.toString()); + assertEquals(path.resolve("abc").toString(), v8Runtime.getExecutor("path.resolve('abc').toString()").executeString()); + v8Runtime.getGlobalObject().delete("path"); + v8Runtime.lowMemoryNotification(); + +Static: StringBuilder +--------------------- + +.. code-block:: java + + v8Runtime.getGlobalObject().set("StringBuilder", StringBuilder.class); + assertEquals("abc def", v8Runtime.getExecutor( + "function main() {\n" + + " return new StringBuilder().append('abc').append(' ').append('def').toString();\n" + + "}\n" + + "main();").executeString()); + v8Runtime.getGlobalObject().delete("StringBuilder"); + v8Runtime.lowMemoryNotification(); + +Static: Pattern +--------------- + +.. code-block:: java + + v8Runtime.getGlobalObject().set("Pattern", Pattern.class); + assertTrue(v8Runtime.getExecutor("let p = Pattern.compile('^\\\\d+$'); p;").executeObject() instanceof Pattern); + assertTrue(v8Runtime.getExecutor("p.matcher('123').matches();").executeBoolean()); + assertFalse(v8Runtime.getExecutor("p.matcher('a123').matches();").executeBoolean()); + v8Runtime.getGlobalObject().delete("Pattern"); + v8Runtime.getExecutor("p = undefined;").executeVoid(); + v8Runtime.lowMemoryNotification(); + +Static: Enum +------------ + +Static class usually does not have an instance. The universal proxy based converter is smart enough to handle that. + +.. code-block:: java + + v8Runtime.getGlobalObject().set("JavetErrorType", JavetErrorType.class); + assertEquals(JavetErrorType.Converter, v8Runtime.getExecutor("JavetErrorType.Converter").executeObject()); + assertThrows( + JavetExecutionException.class, + () -> v8Runtime.getExecutor("JavetErrorType.Converter = 1;").executeVoid(), + "Public final field should not be writable."); + v8Runtime.getGlobalObject().delete("JavetErrorType"); + v8Runtime.getGlobalObject().set("Converter", JavetErrorType.Converter); + assertEquals(JavetErrorType.Converter, v8Runtime.getGlobalObject().getObject("Converter")); + v8Runtime.getGlobalObject().delete("Converter"); + v8Runtime.lowMemoryNotification(); + +Static: Interface +----------------- + +Sometimes an interface or annotation class can be injected for enabling Java reflection in V8. + +.. code-block:: java + + v8Runtime.getGlobalObject().set("AutoCloseable", AutoCloseable.class); + v8Runtime.getGlobalObject().set("IJavetClosable", IJavetClosable.class); + assertTrue(AutoCloseable.class.isAssignableFrom(IJavetClosable.class)); + assertTrue(v8Runtime.getExecutor("AutoCloseable.isAssignableFrom(IJavetClosable);").executeBoolean()); + assertEquals(AutoCloseable.class, v8Runtime.getExecutor("AutoCloseable").executeObject()); + assertEquals(IJavetClosable.class, v8Runtime.getExecutor("IJavetClosable").executeObject()); + v8Runtime.getGlobalObject().delete("AutoCloseable"); + v8Runtime.getGlobalObject().delete("IJavetClosable"); + v8Runtime.lowMemoryNotification(); + +Dynamic: Anonymous Function +--------------------------- + +This feature is quite special as it allows implementing Java interfaces in JavaScript via anonymous functions, also known as lambda expressions. + +1. Define a simple interface ``IStringJoiner`` for joining two strings. + +.. code-block:: java + + interface IStringJoiner extends AutoCloseable { + String join(String a, String b); + } + +2. Define a simple class ``StringJoiner`` which holds the interface ``IStringJoiner``. + +.. code-block:: java + + public class StringJoiner implements AutoCloseable { + private IStringJoiner joiner; + + public StringJoiner() { + joiner = null; + } + + @Override + public void close() throws Exception { + if (joiner != null) { + joiner.close(); + joiner = null; + } + } + + public IStringJoiner getJoiner() { + return joiner; + } + + public void setJoiner(IStringJoiner joiner) { + this.joiner = joiner; + } + } + +3. Inject the implementation from JavaScript. + +.. code-block:: java + + try (StringJoiner stringJoiner = new StringJoiner()) { + v8Runtime.getGlobalObject().set("stringJoiner", stringJoiner); + v8Runtime.getExecutor("stringJoiner.setJoiner((a, b) => a + ',' + b);").executeVoid(); + IStringJoiner joiner = stringJoiner.getJoiner(); + assertEquals("a,b", joiner.join("a", "b")); + assertEquals("a,b,c", joiner.join(joiner.join("a", "b"), "c")); + v8Runtime.getGlobalObject().delete("stringJoiner"); + } + v8Runtime.lowMemoryNotification(); + +Voilà! It works. + +Note: The JavaScript implementation is backed up by ``V8ValueFunction`` which is an orphan object. After its internal ``V8Runtime`` is closed, it will no longer callable. It's recommended to have the interface implement ``AutoClosable`` as the sample shows so that the orphan ``V8ValueFunction`` can be recycled explicitly. If you don't own the interface, Javet will force the recycle of the orphan ``V8ValueFunction`` when the ``V8Runtime`` is being closed. Be careful, if you keep the application running for long while without recycling them in time, ``OutOfMemoryError`` may occur. + +Dynamic: Anonymous Object +------------------------- + +This feature is similar to the dynamic anonymous function, but is an enhanced version because it allows implementing all methods exposed by the Java interface. + +1. Define a simple interface ``IStringUtils`` for joining two strings. + +.. code-block:: java + + interface IStringUtils extends AutoCloseable { + String hello(); + String join(String separator, String... strings); + List split(String separator, String string); + } + +2. Define a simple class ``StringUtils`` which holds the interface ``IStringUtils``. + +.. code-block:: java + + public class StringUtils implements AutoCloseable { + private IStringUtils utils; + + public StringUtils() { + utils = null; + } + + @Override + public void close() throws Exception { + if (utils != null) { + utils.close(); + utils = null; + } + } + + public IStringUtils getUtils() { + return utils; + } + + public void setUtils(IStringUtils utils) { + this.utils = utils; + } + } + +3. Inject the implementation from JavaScript. + +.. code-block:: java + + try (StringUtils stringUtils = new StringUtils()) { + v8Runtime.getGlobalObject().set("stringUtils", stringUtils); + v8Runtime.getExecutor( + "stringUtils.setUtils({\n" + + " hello: () => 'hello',\n" + + " join: (separator, ...strings) => [...strings].join(separator),\n" + + " split: (separator, str) => str.split(separator),\n" + + "});" + ).executeVoid(); + IStringUtils utils = stringUtils.getUtils(); + assertEquals("hello", utils.hello()); + assertEquals("a,b,c", utils.join(",", "a", "b", "c")); + assertArrayEquals( + new String[]{"a", "b", "c"}, + utils.split(",", "a,b,c").toArray(new String[0])); + v8Runtime.getGlobalObject().delete("stringUtils"); + } + v8Runtime.lowMemoryNotification(); + +Voilà aussi! It works again. + +Note: The JavaScript implementation is backed up by ``V8ValueObject`` which is an orphan object. After its internal ``V8Runtime`` is closed, it will no longer callable. It's recommended to have the interface implement ``AutoClosable`` as the sample shows so that the orphan ``V8ValueObject`` can be recycled explicitly. If you don't own the interface, Javet will force the recycle of the orphan ``V8ValueObject`` when the ``V8Runtime`` is being closed. Be careful, if you keep the application running for long while without recycling them in time, ``OutOfMemoryError`` may occur. + +Features +-------- + +* Any Java objects generated inside V8 are automatically handled by the converter. +* Getters and setters (``get``, ``is``, ``set`` and ``put``) are smartly handled. +* Overloaded methods and varargs methods are identified well. +* Primitive types, Set, Map, List, Array are not handled. Map is special because it can be enabled. +* Java interfaces can be implemented by anonymous functions in JavaScript. + +How does JavetProxyConverter Work? +---------------------------------- + +``JavetProxyConverter`` creates a JavaScript proxy per Java object. For now, the proxy intercepts ``get``, ``has`` and ``set`` to achieve the complete virtualization of Java objects in JavaScript runtime. + +How to Customize JavetProxyConverter? +------------------------------------- + +It is recommended to subclass ``JavetProxyConverter`` and override few internal API to achieve complete customization. + +Null Safety +=========== + +What if the object converter meets ``null`` or ``undefined`` when target type is primitive? This is a quite famous topic in Java because converting null to primitive type results in ``java.lang.NullPointerException``. Luckily, Javet object converter is null safe by injecting default primitive values to ``JavetConverterConfig`` and these default primitive values can be overridden. + +Functions and Objects +===================== + +There are few challenges in the object conversion. + +* V8 functions cannot be easily represented by Java objects. +* V8 objects and maps cannot be easily differentiated in Java. +* Sometimes unexpected functions from object conversion may break applications. + +So, Javet introduced ``IJavetEntityFunction`` and ``IJavetEntityMap`` so that V8 functions and V8 maps can be precisely represented in Java. + +Also, ``JavetConverterConfig`` exposes ``setSkipFunctionInObject(boolean)`` and ``setExtractFunctionSourceCode(boolean)`` to give application the opportunity to skip functions in objects or extract source code of functions. + +If the source code is provided to a user defined function, Javet object converter will inject that function from the source code automatically. That makes sure Java object from V8 object can be smoothly converted back to V8 object at both property and function levels. + +Circular Structure +================== + +It is inefficient and inconvenient for Javet to substantially detect circular structure during object conversion. Instead, Javet converter keeps increasing the depth of recursion and throws ``JavetConverterException`` when maximum depth is reach. Maximum depth can be changed before object conversion is started. This is a cheap operation with high performance. + +Please avoid setting maximum depth to an unrealistic number because JVM will throw ``StackOverflowError`` which brings considerable performance overhead. The thing worse than that is there will be memory leak because resource recycling logic written in ``finally`` block sometimes won't be called when stack overflow occurs. Attackers may easily drain the server resource in minutes by sending tiny circular structure data. + +Final Note +========== + +The built-in converter supports bi-directional conversion. The sample above shows the way of how to convert Java objects to V8 values. The opposite way follows the same pattern. + +Please refer to :extsource3:`source code <../../../src/test/java/com/caoccao/javet/interop/converters/TestJavetCustomConverter.java>` for detail. diff --git a/docs/_sources/tutorial/basic/engine_pool.rst.txt b/docs/_sources/tutorial/basic/engine_pool.rst.txt new file mode 100644 index 000000000..749d9d29f --- /dev/null +++ b/docs/_sources/tutorial/basic/engine_pool.rst.txt @@ -0,0 +1,46 @@ +================= +Javet Engine Pool +================= + +Motivation +========== + +* It takes quite some time to spawn a ``V8Runtime``, especially in Node.js mode. +* It takes a lot of time to initialize a ``V8Runtime`` to prepare for script execution. +* ``V8Runtime`` is not recommended to be used in multi-threaded environments. (Though Javet allows it to be used that way.) + +Goals +===== + +* Provide a basic user experience similar to a database connection pool. +* Minimize the performance overhead of ``V8Runtime`` creation and initialization. +* Free applications from explicitly closing ``V8Runtime`` from time to time. +* Allow easy extension. + +Usage +===== + +.. code-block:: java + + // Create a Javet engine pool. + try (IJavetEnginePool javetEnginePool = new JavetEnginePool<>()) { + // Get a Javet engine from the pool. + try (IJavetEngine javetEngine = javetEnginePool.getEngine()) { + // Get a V8 runtime from the engine. + V8Runtime v8Runtime = javetEngine.getV8Runtime(); + // Create a Javet console interceptor. + JavetStandardConsoleInterceptor javetConsoleInterceptor = + new JavetStandardConsoleInterceptor(v8Runtime); + // Register the Javet console to V8 global object. + javetConsoleInterceptor.register(v8Runtime.getGlobalObject()); + // V8 console log is redirected to JVM console log. + v8Runtime.getExecutor("console.log('Hello Javet from Pool');").executeVoid(); + // Unregister the Javet console to V8 global object. + javetConsoleInterceptor.unregister(v8Runtime.getGlobalObject()); + // close() is not necessary because the Javet engine pool handles that. + v8Runtime.lowMemoryNotification(); + // Force V8 to GC. + } + } + +Please refer to the :extsource3:`source code <../../../src/test/java/com/caoccao/javet/tutorial/HelloJavet.java>` for more detail. diff --git a/docs/_sources/tutorial/basic/hello_javet.rst.txt b/docs/_sources/tutorial/basic/hello_javet.rst.txt new file mode 100644 index 000000000..e0b213764 --- /dev/null +++ b/docs/_sources/tutorial/basic/hello_javet.rst.txt @@ -0,0 +1,29 @@ +=========== +Hello Javet +=========== + +Print **Hello Javet** in V8 Mode +================================ + +.. code-block:: java + + // Step 1: Create a V8 runtime from V8 host in try-with-resource. + try (V8Runtime v8Runtime = V8Host.getV8Instance().createV8Runtime()) { + // Step 2: Execute a string as JavaScript code and print the result to console. + System.out.println(v8Runtime.getExecutor("'Hello Javet'").executeString()); // Hello Javet + // Step 3: Resource is recycled automatically at the end of the try-with-resource block. + } + +Print **1 + 1** in Node.js Mode +=============================== + +.. code-block:: java + + // Step 1: Create a Node runtime from V8 host in try-with-resource. + try (NodeRuntime nodeRuntime = V8Host.getNodeInstance().createV8Runtime()) { + // Step 2: Execute a string as JavaScript code and print the result to console. + System.out.println("1 + 1 = " + nodeRuntime.getExecutor("1 + 1").executeInteger()); // 2 + // Step 3: Resource is recycled automatically at the end of the try-with-resource block. + } + +Please refer to the :extsource3:`source code <../../../src/test/java/com/caoccao/javet/tutorial/HelloJavet.java>` for more detail. diff --git a/docs/_sources/tutorial/basic/index.rst.txt b/docs/_sources/tutorial/basic/index.rst.txt new file mode 100644 index 000000000..ea2320a2c --- /dev/null +++ b/docs/_sources/tutorial/basic/index.rst.txt @@ -0,0 +1,15 @@ +===== +Basic +===== + +.. toctree:: + :maxdepth: 1 + + installation + hello_javet + engine_pool + interception + javet_shell + node_js_mode_and_v8_mode + spring_integration + polyfill diff --git a/docs/_sources/tutorial/basic/installation.rst.txt b/docs/_sources/tutorial/basic/installation.rst.txt new file mode 100644 index 000000000..e75b3fb42 --- /dev/null +++ b/docs/_sources/tutorial/basic/installation.rst.txt @@ -0,0 +1,58 @@ +============ +Installation +============ + +Dependency +========== + +Maven +----- + +.. code-block:: xml + + + + com.caoccao.javet + javet + 0.9.12 + + + + + com.caoccao.javet + javet-macos + 0.9.12 + + +Gradle Kotlin DSL +----------------- + +.. code-block:: kotlin + + implementation("com.caoccao.javet:javet:0.9.12") // Linux or Windows + implementation("com.caoccao.javet:javet-macos:0.9.12") // Mac OS (x86_64 Only) + +Gradle Groovy DSL +----------------- + +.. code-block:: groovy + + implementation 'com.caoccao.javet:javet:0.9.12' // Linux or Windows + implementation 'com.caoccao.javet:javet-macos:0.9.12' // Mac OS (x86_64 Only) + +OS Compatibility +================ + +=========================== ======================================================================================================================= +OS Compatible +=========================== ======================================================================================================================= +Windows 10 Yes +Windows 7 Yes +Windows Server Not Tested +Ubuntu 20.04 Yes +Ubuntu 18.04 Yes (`Private Build `_) +Ubuntu 16.04 Yes (`Private Build `_) +Other Linux Distributions Not Tested +MacOS x86_64 Yes +MacOS arm64 No (:doc:`../../faq/environment/can_javet_support_mac`) +=========================== ======================================================================================================================= diff --git a/docs/_sources/tutorial/basic/interception.rst.txt b/docs/_sources/tutorial/basic/interception.rst.txt new file mode 100644 index 000000000..5d0919f1f --- /dev/null +++ b/docs/_sources/tutorial/basic/interception.rst.txt @@ -0,0 +1,110 @@ +============ +Interception +============ + +Javet provides ``@V8Property`` and ``@V8Function`` which allow Java applications to intercept JavaScript properties and functions in an automatic way as following. + +* Decorate a Java class with ``@V8Property`` or ``@V8Function``. +* Bind an instance of that Java class to a V8 value object. +* Call the properties or functions of that V8 value object in JavaScript. +* The calls are intercepted by that instance of the Java class. + +Sample +====== + +@V8Property and @V8Function +--------------------------- + +``@V8Property`` is for registering getters and setters. Javet is good at guessing the property name, e.g. getName => name, setValue => value. + +``@V8Function`` is for registering functions. By default, the Java function name is identical to the JavaScript function name, e.g. increaseAndGet => increaseAndGet, add => add. + +If the default name is not suitable, please tell Javet which one to bind via ``@V8Property(name = "...")`` and ``@V8Function(name = "...")``. + +.. code-block:: java + + public class TestInterception { + private String name; + private int value; + + @V8Property + public String getName() { + return name; + } + + @V8Property + public void setName(String name) { + this.name = name; + } + + @V8Property + public int getValue() { + return value; + } + + @V8Property + public void setValue(int value) { + this.value = value; + } + + @V8Function + public int increaseAndGet() { + return ++value; + } + + @V8Function + public int add(int delta) { + value += delta; + return value; + } + } + +Test +---- + +.. code-block:: java + + // Step 1: Create a V8 runtime from V8 host in try-with-resource. + try (V8Runtime v8Runtime = V8Host.getV8Instance().createV8Runtime()) { + // Step 2: Register console. + JavetStandardConsoleInterceptor javetStandardConsoleInterceptor = new JavetStandardConsoleInterceptor(v8Runtime); + javetStandardConsoleInterceptor.register(v8Runtime.getGlobalObject()); + // Step 3: Create an interceptor. + TestInterception testInterceptor = new TestInterception(); + // Step 4: Bind the interceptor to a variable. + try (V8ValueObject v8ValueObject = v8Runtime.createV8ValueObject()) { + v8Runtime.getGlobalObject().set("a", v8ValueObject); + v8ValueObject.bind(testInterceptor); + } + + // Test property name + v8Runtime.getExecutor("console.log(`a.name is initially ${a.name}.`);").executeVoid(); // null + // a.name setter => setName(String name) + v8Runtime.getExecutor("a.name = 'Javet';").executeVoid(); + // name is changed + System.out.println("Interceptor name is " + testInterceptor.getName() + "."); // Javet + // a.name getter => getName() + v8Runtime.getExecutor("console.log(`a.name is now ${a.name}.`);").executeVoid(); // Javet + + // Test property value + v8Runtime.getExecutor("console.log(`a.value is initially ${a.value}.`);").executeVoid(); // 0 + // a.value setter => setValue(String value) + v8Runtime.getExecutor("a.value = 123;").executeVoid(); + // value is changed + System.out.println("Interceptor value is " + testInterceptor.getValue() + "."); // 123 + // a.value getter => getValue() + v8Runtime.getExecutor("console.log(`a.value is now ${a.value}.`);").executeVoid(); // 123 + + // Test functions + v8Runtime.getExecutor("console.log(`a.increaseAndGet() is ${a.increaseAndGet()}.`);").executeVoid(); // 124 + v8Runtime.getExecutor("console.log(`a.add(76) is ${a.add(76)}.`);").executeVoid(); // 200 + + // Step 5: Delete the interceptor. + v8Runtime.getGlobalObject().delete("a"); + // Step 6: Unregister console. + javetStandardConsoleInterceptor.unregister(v8Runtime.getGlobalObject()); + // Step 7: Notify V8 to perform GC. (Optional) + v8Runtime.lowMemoryNotification(); + } + +Please refer to the :extsource3:`source code <../../../src/test/java/com/caoccao/javet/tutorial/TestInterception.java>` for more detail. diff --git a/docs/_sources/tutorial/basic/javet_shell.rst.txt b/docs/_sources/tutorial/basic/javet_shell.rst.txt new file mode 100644 index 000000000..4fa51120c --- /dev/null +++ b/docs/_sources/tutorial/basic/javet_shell.rst.txt @@ -0,0 +1,47 @@ +=========== +Javet Shell +=========== + +It is very easy to create a node flavored interactive shell application with a few lines of code. + +.. code-block:: java + + // Step 1: Create a V8 runtime from V8 host in try resource. + try (V8Runtime v8Runtime = V8Host.getV8Instance().createV8Runtime()) { + System.out.println("Welcome to CDT Shell!"); + System.out.println("Input the script or '.exit' to exit."); + // Step 2: Create a scanner to take console input line by line. + try (Scanner scanner = new Scanner(System.in)) { + // Step 3: Create an infinite loop. + while (true) { + System.out.print("> "); + String command = scanner.nextLine(); + // Step 4: If the command is ".exit", exit the loop. + if (".exit".equals(command)) { + break; + } + // Step 5: Execute the command and capture the result. + try (V8Value v8Value = v8Runtime.getExecutor(command).execute()) { + if (v8Value != null) { + // Step 6: Print the result as string. + System.out.println(v8Value.toString()); + } + } catch (Throwable t) { + System.err.println(t.getMessage()); + } + } + } + } + +The user experience is very much like the one in node. + +.. code-block:: js + + > let a = 3 + undefined + > let b = 4 + undefined + > a + b + 7 + +Please refer to the :extsource3:`source code <../../../src/test/java/com/caoccao/javet/tutorial/cdt/CDTShell.java>` for more detail. diff --git a/docs/_sources/tutorial/basic/node_js_mode_and_v8_mode.rst.txt b/docs/_sources/tutorial/basic/node_js_mode_and_v8_mode.rst.txt new file mode 100644 index 000000000..8c5f05236 --- /dev/null +++ b/docs/_sources/tutorial/basic/node_js_mode_and_v8_mode.rst.txt @@ -0,0 +1,55 @@ +======================== +Node.js Mode and V8 Mode +======================== + +Co-existence +============ + +Javet support both Node.js mode and V8 mode both of which can co-exist in one JVM. This is an awesome feature with the following highlights. + +* Latest V8 features are available in V8 mode. +* Node.js ecosystem is available in Node.js mode. +* There are 2 versions of V8 runtime in 1 JVM and they don't see each other. + +Usage +===== + +It's very simple to get into Node.js mode or V8 mode. E.g. + +V8Host +------ + +.. code-block:: java + + // Node.js Mode + try (V8Runtime v8Runtime = V8Host.getNodeInstance().createV8Runtime()) { + // ... + } + + // V8 Mode + try (V8Runtime v8Runtime = V8Host.getV8Instance().createV8Runtime()) { + // ... + } + +Pool +---- + +.. code-block:: java + + // Node.js Mode + try (JavetEnginePool javetEnginePool = new JavetEnginePool()) { + javetEnginePool.getConfig().setJSRuntimeType(JSRuntimeType.Node); + try (IJavetEngine javetEngine = javetEnginePool.getEngine()) { + // ... + } + } + + // V8 Mode + try (JavetEnginePool javetEnginePool = new JavetEnginePool()) { + javetEnginePool.getConfig().setJSRuntimeType(JSRuntimeType.V8); // Optional, because it defaults to V8. + try (IJavetEngine javetEngine = javetEnginePool.getEngine()) { + // ... + } + } + +Note: The default mode in pool is V8 mode. More technical detail is available at :doc:`../../development/design`. diff --git a/docs/_sources/tutorial/basic/polyfill.rst.txt b/docs/_sources/tutorial/basic/polyfill.rst.txt new file mode 100644 index 000000000..8e86c1612 --- /dev/null +++ b/docs/_sources/tutorial/basic/polyfill.rst.txt @@ -0,0 +1,56 @@ +======== +Polyfill +======== + +Node.js Mode +============ + +Yes, you can polyfill Javet with Node.js modules. + +decimal.js +---------- + +.. code-block:: java + + public void loadJS() throws JavetException { + File decimalJSFile = new File( + JavetOSUtils.WORKING_DIRECTORY, + "scripts/node/node_modules/decimal.js/decimal.js"); + if (decimalJSFile.exists() && decimalJSFile.canRead()) { + getLogger().logInfo("Loading {0}.", decimalJSFile.getAbsolutePath()); + V8Runtime v8Runtime = iJavetEngine.getV8Runtime(); + v8Runtime.getExecutor(decimalJSFile).executeVoid(); + } else { + getLogger().logError("{0} is not found.", decimalJSFile.getAbsolutePath()); + getLogger().logError("Please make sure Node.js is installed, then visit script/node directory and run npm install."); + } + } + + public void test() throws JavetException { + V8Runtime v8Runtime = iJavetEngine.getV8Runtime(); + getLogger().logInfo("1.23 + 2.34 = {0}", v8Runtime.getExecutor( + "const a = new Decimal(1.23);" + + "const b = new Decimal(2.34);" + + "a.add(b).toString();").executeString()); + try (V8ValueFunction v8ValueFunctionDecimal = v8Runtime.getGlobalObject().get("Decimal")) { + try (V8ValueObject v8ValueObjectDecimal = v8ValueFunctionDecimal.callAsConstructor("123.45")) { + getLogger().logInfo(v8ValueObjectDecimal.toString()); + if (v8ValueObjectDecimal.hasOwnProperty("constructor")) { + try (V8ValueFunction v8ValueFunction = v8ValueObjectDecimal.get("constructor")) { + String name = v8ValueFunction.getString("name"); + if ("Decimal".equals(name)) { + BigDecimal bigDecimal = new BigDecimal(v8ValueObjectDecimal.toString()); + getLogger().logInfo("BigDecimal: {0}", bigDecimal.toString()); + } + } + } + } + } + } + +Please refer to the :extsource3:`source code <../../../src/test/java/com/caoccao/javet/tutorial/DecimalJavetInV8Mode.java>` for more detail. + +V8 Mode +======= + +Polyfilling V8 mode is at another project `Javenode `_ which aims at simulating Node.js with Java in Javet V8 mode. Why? Because Javet V8 mode is much more secure than the Node.js mode, but lacks of some basic features, e.g. setTimeout, setInterval, etc. So, these must-have API can be found in Javenode. diff --git a/docs/_sources/tutorial/basic/spring_integration.rst.txt b/docs/_sources/tutorial/basic/spring_integration.rst.txt new file mode 100644 index 000000000..2b9cdbca7 --- /dev/null +++ b/docs/_sources/tutorial/basic/spring_integration.rst.txt @@ -0,0 +1,64 @@ +================== +Spring Integration +================== + +As Javet is a fundamental SDK, it doesn't rely on Spring Framework so that Javet users don't get dependency hell. But, Javet can be integrated with Spring easily. + +Configuration +============= + +* Create a Spring configuration. +* Declare ``IJavetEnginePool`` as ``@Bean``. + +.. code-block:: java + + @Configuration + @PropertySource("classpath:javet-engine.properties") + @ConfigurationProperties(prefix = "javet.engine") + public class MyJavetEngineConfig { + + @Bean(name = "JavetEnginePoolNode") + public IJavetEnginePool getJavetEnginePoolNode() { + JavetEngineConfig javetEngineConfigNode = new JavetEngineConfig(); + javetEngineConfigNode.setAllowEval(...); + javetEngineConfigNode.setAutoSendGCNotification(...); + javetEngineConfigNode.setDefaultEngineGuardTimeoutMillis(...); + javetEngineConfigNode.setEngineGuardCheckIntervalMillis(...); + javetEngineConfigNode.setPoolDaemonCheckIntervalMillis(...); + javetEngineConfigNode.setPoolIdleTimeoutSeconds(...); + javetEngineConfigNode.setPoolMinSize(...); + javetEngineConfigNode.setPoolMaxSize(...); + javetEngineConfigNode.setPoolShutdownTimeoutSeconds(...); + javetEngineConfigNode.setResetEngineTimeoutSeconds(...); + javetEngineConfigNode.setJavetLogger(new MyJavetLogger(MyJavetLogger.class.getName())); + javetEngineConfigNode.setJSRuntimeType(JSRuntimeType.Node); + return new JavetEnginePool<>(javetEngineConfigNode); + } + + @Bean(name = "JavetEnginePoolV8") + public IJavetEnginePool getJavetEnginePoolV8() { + JavetEngineConfig javetEngineConfigV8 = new JavetEngineConfig(); + javetEngineConfigV8.setAllowEval(...); + javetEngineConfigV8.setAutoSendGCNotification(...); + javetEngineConfigV8.setDefaultEngineGuardTimeoutMillis(...); + javetEngineConfigV8.setEngineGuardCheckIntervalMillis(...); + javetEngineConfigV8.setPoolDaemonCheckIntervalMillis(...); + javetEngineConfigV8.setPoolIdleTimeoutSeconds(...); + javetEngineConfigV8.setPoolMinSize(...); + javetEngineConfigV8.setPoolMaxSize(...); + javetEngineConfigV8.setPoolShutdownTimeoutSeconds(...); + javetEngineConfigV8.setResetEngineTimeoutSeconds(...); + javetEngineConfigV8.setJavetLogger(new MyJavetLogger(MyJavetLogger.class.getName())); + javetEngineConfigV8.setJSRuntimeType(JSRuntimeType.V8); + return new JavetEnginePool<>(javetEngineConfigV8); + } + +Injection +========= + +You may easily inject your engine pool in the Spring way. + +.. code-block:: java + + @Resource + protected IJavetEnginePool javetEnginePool; diff --git a/docs/_sources/tutorial/index.rst.txt b/docs/_sources/tutorial/index.rst.txt new file mode 100644 index 000000000..6535b252a --- /dev/null +++ b/docs/_sources/tutorial/index.rst.txt @@ -0,0 +1,10 @@ +======== +Tutorial +======== + +.. toctree:: + :maxdepth: 2 + + basic/index + advanced/index + migration_guides/index diff --git a/docs/_sources/tutorial/migration_guides/index.rst.txt b/docs/_sources/tutorial/migration_guides/index.rst.txt new file mode 100644 index 000000000..719198d9d --- /dev/null +++ b/docs/_sources/tutorial/migration_guides/index.rst.txt @@ -0,0 +1,8 @@ +================ +Migration Guides +================ + +.. toctree:: + :maxdepth: 1 + + migrate_from_j2v8 diff --git a/docs/_sources/tutorial/migration_guides/migrate_from_j2v8.rst.txt b/docs/_sources/tutorial/migration_guides/migrate_from_j2v8.rst.txt new file mode 100644 index 000000000..6be6232b5 --- /dev/null +++ b/docs/_sources/tutorial/migration_guides/migrate_from_j2v8.rst.txt @@ -0,0 +1,77 @@ +================= +Migrate from J2V8 +================= + +How to migrate from J2V8 to Javet is a frequently asked question, especially when people are evaluating Javet. I created Javet in Jan, 2021 for various reasons (:doc:`../../faq/background/what_is_the_motivation`, :doc:`../../faq/background/history_with_j2v8`). After the first release v0.7.0 was published, I started migrating from J2V8 to Javet. It was quite smooth, though it took a week. + +Why Migrate from J2V8 to Javet? +=============================== + +* Its Linux, Mac OS and Windows releases have been abandoned for years. +* Its type hierarchy is inconsistent because primitive types are out of the hierarchy so that tedious ``if-else`` sentences have to be repeated all over the code base. +* Its function registration API is kind of verbose. +* Segfaults take place so frequently and don't get maintainers' attention for years. +* Its locking mechanism heavily increases mental pressure in the code base. +* Its V8 runtime is not multi-threaded friendly unless application adds a synchronous layer on top of it. + +Migration Guides +================ + +V8 ⟶ V8Runtime +--------------- + +* ``V8`` in J2V8 is ``V8Runtime`` in Javet. +* ``V8`` in J2V8 carries 2 roles: 1 as the V8 runtime and 1 as the global object (``globalThis`` or ``global``). In Javet, ``V8Runtime`` no longer inherits from ``V8Value`` so that it literally represents the V8 runtime. ``V8Runtime.getGlobalObject()`` is dedicated to the global object. +* ``V8Runtime`` has much richer API than ``V8`` has. E.g. ``compileV8Module()``, ``lowMemoryNotification()``, ``terminateExecution()``. + +Primitive Types +--------------- + +* Primitive types in Javet inherit from ``V8ValuePrimitive`` ⟶ ``V8Value`` ⟶ ``V8Data``. +* The Javet type hierarchy is consistent so that ``V8Value`` in all supported API can represent all V8 types. This is hard in J2V8 because ``Object`` has to be used to represent all types, however, by using ``Object`` the type check during compilation doesn't work at all and that is a rich source of runtime bugs or even segfaults. + +registerJavaMethod() ⟶ @V8Function +----------------------------------- + +* It is quite painful to register many functions in J2V8. Javet makes that a declarative one instead of the imperative one. Just decorate the target function with ``@V8Function``, then call ``V8ValueObject.bind(javaObject)`` to bind that Java object, it's done. +* In addition, Javet provides ``@V8Property`` which allows registering getters and setters in the same manner. That feature has never been delivered by J2V8. +* Javet also allows unbinding the registration. Just call ``V8ValueObject.unbind(javaObject)``. + +Please refer to :doc:`../../reference/v8_function` for more details. + +V8Locker +-------- + +* Javet introduced **Implicit Mode** which allows applications to eliminate ``V8Locker`` from the code base and still be able to share the same ``V8Runtime`` among multiple threads, because Javet does the synchronization automatically. That frees application developers from the tedious ``acquire()`` and ``release()`` calls, and gets the rid of the runtime exceptions caused by multiple threads. +* Javet also has **Explicit Mode** for performance sensitive scenarios. + +Please refer to :doc:`../../reference/lock` for more details. + +Type Conversion +--------------- + +* Javet has built-in ``JavetObjectConverter`` which covers the majority cases on type conversion so that the arguments of Javet API can be of any type and the converter just does the conversion transparently. That frees application developers from writing tedious type conversion code everywhere. +* Javet also provides ``JavetProxyConverter`` which allows injecting arbitrary Java objects in V8 and polyfilling Java interfaces with JavaScript functions or objects. Especially the polyfilling feature implies hotfixing business logic without restarting the JVM. + +Please refer to :doc:`../advanced/object_converter` for more details. + +Node.js and V8 +-------------- + +* Javet provides both Node.js mode and V8 mode for various usages. Each mode stays at a dedicated classloader so that both modes don't cross each other, and are completely isolated. If the application only uses one mode, it doesn't need to pay extra amount of memory for the other mode because the other mode is not loaded at all. Of course, both modes can be unloaded as well without shutting down the JVM. +* In Node.js mode, all node modules can be directly used including the native modules. Please refer to :doc:`../../reference/modularization` for more detail. +* In V8 mode, it is much more secure than the Node.js mode is, but lacks of some basic ES API, e.g. ``setTimeout()``. Project `Javenode `_ is the one that aims at simulating Node.js with Java in Javet V8 mode. + +Please refer to :doc:`../../development/design` for more details. + +ES6 Module +---------- + +* Javet supports ``import { *** } from '***.js'`` and exposes module resolve event for applications to specify where to locate the modules. + +Please refer to :doc:`../../reference/modularization` for more detail. + +Blessing +======== + +In case this migration guide couldn't cover all your use cases, please contact the maintainer at `discord `_. Wish you a successful migration! diff --git a/docs/_static/basic.css b/docs/_static/basic.css new file mode 100644 index 000000000..acd4167e0 --- /dev/null +++ b/docs/_static/basic.css @@ -0,0 +1,904 @@ +/* + * basic.css + * ~~~~~~~~~ + * + * Sphinx stylesheet -- basic theme. + * + * :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/* -- main layout ----------------------------------------------------------- */ + +div.clearer { + clear: both; +} + +div.section::after { + display: block; + content: ''; + clear: left; +} + +/* -- relbar ---------------------------------------------------------------- */ + +div.related { + width: 100%; + font-size: 90%; +} + +div.related h3 { + display: none; +} + +div.related ul { + margin: 0; + padding: 0 0 0 10px; + list-style: none; +} + +div.related li { + display: inline; +} + +div.related li.right { + float: right; + margin-right: 5px; +} + +/* -- sidebar --------------------------------------------------------------- */ + +div.sphinxsidebarwrapper { + padding: 10px 5px 0 10px; +} + +div.sphinxsidebar { + float: left; + width: 230px; + margin-left: -100%; + font-size: 90%; + word-wrap: break-word; + overflow-wrap : break-word; +} + +div.sphinxsidebar ul { + list-style: none; +} + +div.sphinxsidebar ul ul, +div.sphinxsidebar ul.want-points { + margin-left: 20px; + list-style: square; +} + +div.sphinxsidebar ul ul { + margin-top: 0; + margin-bottom: 0; +} + +div.sphinxsidebar form { + margin-top: 10px; +} + +div.sphinxsidebar input { + border: 1px solid #98dbcc; + font-family: sans-serif; + font-size: 1em; +} + +div.sphinxsidebar #searchbox form.search { + overflow: hidden; +} + +div.sphinxsidebar #searchbox input[type="text"] { + float: left; + width: 80%; + padding: 0.25em; + box-sizing: border-box; +} + +div.sphinxsidebar #searchbox input[type="submit"] { + float: left; + width: 20%; + border-left: none; + padding: 0.25em; + box-sizing: border-box; +} + + +img { + border: 0; + max-width: 100%; +} + +/* -- search page ----------------------------------------------------------- */ + +ul.search { + margin: 10px 0 0 20px; + padding: 0; +} + +ul.search li { + padding: 5px 0 5px 20px; + background-image: url(file.png); + background-repeat: no-repeat; + background-position: 0 7px; +} + +ul.search li a { + font-weight: bold; +} + +ul.search li p.context { + color: #888; + margin: 2px 0 0 30px; + text-align: left; +} + +ul.keywordmatches li.goodmatch a { + font-weight: bold; +} + +/* -- index page ------------------------------------------------------------ */ + +table.contentstable { + width: 90%; + margin-left: auto; + margin-right: auto; +} + +table.contentstable p.biglink { + line-height: 150%; +} + +a.biglink { + font-size: 1.3em; +} + +span.linkdescr { + font-style: italic; + padding-top: 5px; + font-size: 90%; +} + +/* -- general index --------------------------------------------------------- */ + +table.indextable { + width: 100%; +} + +table.indextable td { + text-align: left; + vertical-align: top; +} + +table.indextable ul { + margin-top: 0; + margin-bottom: 0; + list-style-type: none; +} + +table.indextable > tbody > tr > td > ul { + padding-left: 0em; +} + +table.indextable tr.pcap { + height: 10px; +} + +table.indextable tr.cap { + margin-top: 10px; + background-color: #f2f2f2; +} + +img.toggler { + margin-right: 3px; + margin-top: 3px; + cursor: pointer; +} + +div.modindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +div.genindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +/* -- domain module index --------------------------------------------------- */ + +table.modindextable td { + padding: 2px; + border-collapse: collapse; +} + +/* -- general body styles --------------------------------------------------- */ + +div.body { + min-width: 450px; + max-width: 800px; +} + +div.body p, div.body dd, div.body li, div.body blockquote { + -moz-hyphens: auto; + -ms-hyphens: auto; + -webkit-hyphens: auto; + hyphens: auto; +} + +a.headerlink { + visibility: hidden; +} + +a.brackets:before, +span.brackets > a:before{ + content: "["; +} + +a.brackets:after, +span.brackets > a:after { + content: "]"; +} + +h1:hover > a.headerlink, +h2:hover > a.headerlink, +h3:hover > a.headerlink, +h4:hover > a.headerlink, +h5:hover > a.headerlink, +h6:hover > a.headerlink, +dt:hover > a.headerlink, +caption:hover > a.headerlink, +p.caption:hover > a.headerlink, +div.code-block-caption:hover > a.headerlink { + visibility: visible; +} + +div.body p.caption { + text-align: inherit; +} + +div.body td { + text-align: left; +} + +.first { + margin-top: 0 !important; +} + +p.rubric { + margin-top: 30px; + font-weight: bold; +} + +img.align-left, figure.align-left, .figure.align-left, object.align-left { + clear: left; + float: left; + margin-right: 1em; +} + +img.align-right, figure.align-right, .figure.align-right, object.align-right { + clear: right; + float: right; + margin-left: 1em; +} + +img.align-center, figure.align-center, .figure.align-center, object.align-center { + display: block; + margin-left: auto; + margin-right: auto; +} + +img.align-default, figure.align-default, .figure.align-default { + display: block; + margin-left: auto; + margin-right: auto; +} + +.align-left { + text-align: left; +} + +.align-center { + text-align: center; +} + +.align-default { + text-align: center; +} + +.align-right { + text-align: right; +} + +/* -- sidebars -------------------------------------------------------------- */ + +div.sidebar, +aside.sidebar { + margin: 0 0 0.5em 1em; + border: 1px solid #ddb; + padding: 7px; + background-color: #ffe; + width: 40%; + float: right; + clear: right; + overflow-x: auto; +} + +p.sidebar-title { + font-weight: bold; +} + +div.admonition, div.topic, blockquote { + clear: left; +} + +/* -- topics ---------------------------------------------------------------- */ + +div.topic { + border: 1px solid #ccc; + padding: 7px; + margin: 10px 0 10px 0; +} + +p.topic-title { + font-size: 1.1em; + font-weight: bold; + margin-top: 10px; +} + +/* -- admonitions ----------------------------------------------------------- */ + +div.admonition { + margin-top: 10px; + margin-bottom: 10px; + padding: 7px; +} + +div.admonition dt { + font-weight: bold; +} + +p.admonition-title { + margin: 0px 10px 5px 0px; + font-weight: bold; +} + +div.body p.centered { + text-align: center; + margin-top: 25px; +} + +/* -- content of sidebars/topics/admonitions -------------------------------- */ + +div.sidebar > :last-child, +aside.sidebar > :last-child, +div.topic > :last-child, +div.admonition > :last-child { + margin-bottom: 0; +} + +div.sidebar::after, +aside.sidebar::after, +div.topic::after, +div.admonition::after, +blockquote::after { + display: block; + content: ''; + clear: both; +} + +/* -- tables ---------------------------------------------------------------- */ + +table.docutils { + margin-top: 10px; + margin-bottom: 10px; + border: 0; + border-collapse: collapse; +} + +table.align-center { + margin-left: auto; + margin-right: auto; +} + +table.align-default { + margin-left: auto; + margin-right: auto; +} + +table caption span.caption-number { + font-style: italic; +} + +table caption span.caption-text { +} + +table.docutils td, table.docutils th { + padding: 1px 8px 1px 5px; + border-top: 0; + border-left: 0; + border-right: 0; + border-bottom: 1px solid #aaa; +} + +table.footnote td, table.footnote th { + border: 0 !important; +} + +th { + text-align: left; + padding-right: 5px; +} + +table.citation { + border-left: solid 1px gray; + margin-left: 1px; +} + +table.citation td { + border-bottom: none; +} + +th > :first-child, +td > :first-child { + margin-top: 0px; +} + +th > :last-child, +td > :last-child { + margin-bottom: 0px; +} + +/* -- figures --------------------------------------------------------------- */ + +div.figure, figure { + margin: 0.5em; + padding: 0.5em; +} + +div.figure p.caption, figcaption { + padding: 0.3em; +} + +div.figure p.caption span.caption-number, +figcaption span.caption-number { + font-style: italic; +} + +div.figure p.caption span.caption-text, +figcaption span.caption-text { +} + +/* -- field list styles ----------------------------------------------------- */ + +table.field-list td, table.field-list th { + border: 0 !important; +} + +.field-list ul { + margin: 0; + padding-left: 1em; +} + +.field-list p { + margin: 0; +} + +.field-name { + -moz-hyphens: manual; + -ms-hyphens: manual; + -webkit-hyphens: manual; + hyphens: manual; +} + +/* -- hlist styles ---------------------------------------------------------- */ + +table.hlist { + margin: 1em 0; +} + +table.hlist td { + vertical-align: top; +} + +/* -- object description styles --------------------------------------------- */ + +.sig { + font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace; +} + +.sig-name, code.descname { + background-color: transparent; + font-weight: bold; +} + +.sig-name { + font-size: 1.1em; +} + +code.descname { + font-size: 1.2em; +} + +.sig-prename, code.descclassname { + background-color: transparent; +} + +.optional { + font-size: 1.3em; +} + +.sig-paren { + font-size: larger; +} + +.sig-param.n { + font-style: italic; +} + +/* C++ specific styling */ + +.sig-inline.c-texpr, +.sig-inline.cpp-texpr { + font-family: unset; +} + +.sig.c .k, .sig.c .kt, +.sig.cpp .k, .sig.cpp .kt { + color: #0033B3; +} + +.sig.c .m, +.sig.cpp .m { + color: #1750EB; +} + +.sig.c .s, .sig.c .sc, +.sig.cpp .s, .sig.cpp .sc { + color: #067D17; +} + + +/* -- other body styles ----------------------------------------------------- */ + +ol.arabic { + list-style: decimal; +} + +ol.loweralpha { + list-style: lower-alpha; +} + +ol.upperalpha { + list-style: upper-alpha; +} + +ol.lowerroman { + list-style: lower-roman; +} + +ol.upperroman { + list-style: upper-roman; +} + +:not(li) > ol > li:first-child > :first-child, +:not(li) > ul > li:first-child > :first-child { + margin-top: 0px; +} + +:not(li) > ol > li:last-child > :last-child, +:not(li) > ul > li:last-child > :last-child { + margin-bottom: 0px; +} + +ol.simple ol p, +ol.simple ul p, +ul.simple ol p, +ul.simple ul p { + margin-top: 0; +} + +ol.simple > li:not(:first-child) > p, +ul.simple > li:not(:first-child) > p { + margin-top: 0; +} + +ol.simple p, +ul.simple p { + margin-bottom: 0; +} + +dl.footnote > dt, +dl.citation > dt { + float: left; + margin-right: 0.5em; +} + +dl.footnote > dd, +dl.citation > dd { + margin-bottom: 0em; +} + +dl.footnote > dd:after, +dl.citation > dd:after { + content: ""; + clear: both; +} + +dl.field-list { + display: grid; + grid-template-columns: fit-content(30%) auto; +} + +dl.field-list > dt { + font-weight: bold; + word-break: break-word; + padding-left: 0.5em; + padding-right: 5px; +} + +dl.field-list > dt:after { + content: ":"; +} + +dl.field-list > dd { + padding-left: 0.5em; + margin-top: 0em; + margin-left: 0em; + margin-bottom: 0em; +} + +dl { + margin-bottom: 15px; +} + +dd > :first-child { + margin-top: 0px; +} + +dd ul, dd table { + margin-bottom: 10px; +} + +dd { + margin-top: 3px; + margin-bottom: 10px; + margin-left: 30px; +} + +dl > dd:last-child, +dl > dd:last-child > :last-child { + margin-bottom: 0; +} + +dt:target, span.highlighted { + background-color: #fbe54e; +} + +rect.highlighted { + fill: #fbe54e; +} + +dl.glossary dt { + font-weight: bold; + font-size: 1.1em; +} + +.versionmodified { + font-style: italic; +} + +.system-message { + background-color: #fda; + padding: 5px; + border: 3px solid red; +} + +.footnote:target { + background-color: #ffa; +} + +.line-block { + display: block; + margin-top: 1em; + margin-bottom: 1em; +} + +.line-block .line-block { + margin-top: 0; + margin-bottom: 0; + margin-left: 1.5em; +} + +.guilabel, .menuselection { + font-family: sans-serif; +} + +.accelerator { + text-decoration: underline; +} + +.classifier { + font-style: oblique; +} + +.classifier:before { + font-style: normal; + margin: 0.5em; + content: ":"; +} + +abbr, acronym { + border-bottom: dotted 1px; + cursor: help; +} + +/* -- code displays --------------------------------------------------------- */ + +pre { + overflow: auto; + overflow-y: hidden; /* fixes display issues on Chrome browsers */ +} + +pre, div[class*="highlight-"] { + clear: both; +} + +span.pre { + -moz-hyphens: none; + -ms-hyphens: none; + -webkit-hyphens: none; + hyphens: none; +} + +div[class*="highlight-"] { + margin: 1em 0; +} + +td.linenos pre { + border: 0; + background-color: transparent; + color: #aaa; +} + +table.highlighttable { + display: block; +} + +table.highlighttable tbody { + display: block; +} + +table.highlighttable tr { + display: flex; +} + +table.highlighttable td { + margin: 0; + padding: 0; +} + +table.highlighttable td.linenos { + padding-right: 0.5em; +} + +table.highlighttable td.code { + flex: 1; + overflow: hidden; +} + +.highlight .hll { + display: block; +} + +div.highlight pre, +table.highlighttable pre { + margin: 0; +} + +div.code-block-caption + div { + margin-top: 0; +} + +div.code-block-caption { + margin-top: 1em; + padding: 2px 5px; + font-size: small; +} + +div.code-block-caption code { + background-color: transparent; +} + +table.highlighttable td.linenos, +span.linenos, +div.highlight span.gp { /* gp: Generic.Prompt */ + user-select: none; + -webkit-user-select: text; /* Safari fallback only */ + -webkit-user-select: none; /* Chrome/Safari */ + -moz-user-select: none; /* Firefox */ + -ms-user-select: none; /* IE10+ */ +} + +div.code-block-caption span.caption-number { + padding: 0.1em 0.3em; + font-style: italic; +} + +div.code-block-caption span.caption-text { +} + +div.literal-block-wrapper { + margin: 1em 0; +} + +code.xref, a code { + background-color: transparent; + font-weight: bold; +} + +h1 code, h2 code, h3 code, h4 code, h5 code, h6 code { + background-color: transparent; +} + +.viewcode-link { + float: right; +} + +.viewcode-back { + float: right; + font-family: sans-serif; +} + +div.viewcode-block:target { + margin: -1px -10px; + padding: 0 10px; +} + +/* -- math display ---------------------------------------------------------- */ + +img.math { + vertical-align: middle; +} + +div.body div.math p { + text-align: center; +} + +span.eqno { + float: right; +} + +span.eqno a.headerlink { + position: absolute; + z-index: 1; +} + +div.math:hover a.headerlink { + visibility: visible; +} + +/* -- printout stylesheet --------------------------------------------------- */ + +@media print { + div.document, + div.documentwrapper, + div.bodywrapper { + margin: 0 !important; + width: 100%; + } + + div.sphinxsidebar, + div.related, + div.footer, + #top-link { + display: none; + } +} \ No newline at end of file diff --git a/docs/_static/css/custom.css b/docs/_static/css/custom.css new file mode 100644 index 000000000..ca805991e --- /dev/null +++ b/docs/_static/css/custom.css @@ -0,0 +1,7 @@ +h4, h5, h6 { + text-transform: initial; +} + +code.literal { + background-color: lightgray; +} \ No newline at end of file diff --git a/docs/_static/doctools.js b/docs/_static/doctools.js new file mode 100644 index 000000000..8cbf1b161 --- /dev/null +++ b/docs/_static/doctools.js @@ -0,0 +1,323 @@ +/* + * doctools.js + * ~~~~~~~~~~~ + * + * Sphinx JavaScript utilities for all documentation. + * + * :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/** + * select a different prefix for underscore + */ +$u = _.noConflict(); + +/** + * make the code below compatible with browsers without + * an installed firebug like debugger +if (!window.console || !console.firebug) { + var names = ["log", "debug", "info", "warn", "error", "assert", "dir", + "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace", + "profile", "profileEnd"]; + window.console = {}; + for (var i = 0; i < names.length; ++i) + window.console[names[i]] = function() {}; +} + */ + +/** + * small helper function to urldecode strings + * + * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent#Decoding_query_parameters_from_a_URL + */ +jQuery.urldecode = function(x) { + if (!x) { + return x + } + return decodeURIComponent(x.replace(/\+/g, ' ')); +}; + +/** + * small helper function to urlencode strings + */ +jQuery.urlencode = encodeURIComponent; + +/** + * This function returns the parsed url parameters of the + * current request. Multiple values per key are supported, + * it will always return arrays of strings for the value parts. + */ +jQuery.getQueryParameters = function(s) { + if (typeof s === 'undefined') + s = document.location.search; + var parts = s.substr(s.indexOf('?') + 1).split('&'); + var result = {}; + for (var i = 0; i < parts.length; i++) { + var tmp = parts[i].split('=', 2); + var key = jQuery.urldecode(tmp[0]); + var value = jQuery.urldecode(tmp[1]); + if (key in result) + result[key].push(value); + else + result[key] = [value]; + } + return result; +}; + +/** + * highlight a given string on a jquery object by wrapping it in + * span elements with the given class name. + */ +jQuery.fn.highlightText = function(text, className) { + function highlight(node, addItems) { + if (node.nodeType === 3) { + var val = node.nodeValue; + var pos = val.toLowerCase().indexOf(text); + if (pos >= 0 && + !jQuery(node.parentNode).hasClass(className) && + !jQuery(node.parentNode).hasClass("nohighlight")) { + var span; + var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg"); + if (isInSVG) { + span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); + } else { + span = document.createElement("span"); + span.className = className; + } + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + node.parentNode.insertBefore(span, node.parentNode.insertBefore( + document.createTextNode(val.substr(pos + text.length)), + node.nextSibling)); + node.nodeValue = val.substr(0, pos); + if (isInSVG) { + var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect"); + var bbox = node.parentElement.getBBox(); + rect.x.baseVal.value = bbox.x; + rect.y.baseVal.value = bbox.y; + rect.width.baseVal.value = bbox.width; + rect.height.baseVal.value = bbox.height; + rect.setAttribute('class', className); + addItems.push({ + "parent": node.parentNode, + "target": rect}); + } + } + } + else if (!jQuery(node).is("button, select, textarea")) { + jQuery.each(node.childNodes, function() { + highlight(this, addItems); + }); + } + } + var addItems = []; + var result = this.each(function() { + highlight(this, addItems); + }); + for (var i = 0; i < addItems.length; ++i) { + jQuery(addItems[i].parent).before(addItems[i].target); + } + return result; +}; + +/* + * backward compatibility for jQuery.browser + * This will be supported until firefox bug is fixed. + */ +if (!jQuery.browser) { + jQuery.uaMatch = function(ua) { + ua = ua.toLowerCase(); + + var match = /(chrome)[ \/]([\w.]+)/.exec(ua) || + /(webkit)[ \/]([\w.]+)/.exec(ua) || + /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) || + /(msie) ([\w.]+)/.exec(ua) || + ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) || + []; + + return { + browser: match[ 1 ] || "", + version: match[ 2 ] || "0" + }; + }; + jQuery.browser = {}; + jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true; +} + +/** + * Small JavaScript module for the documentation. + */ +var Documentation = { + + init : function() { + this.fixFirefoxAnchorBug(); + this.highlightSearchWords(); + this.initIndexTable(); + if (DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) { + this.initOnKeyListeners(); + } + }, + + /** + * i18n support + */ + TRANSLATIONS : {}, + PLURAL_EXPR : function(n) { return n === 1 ? 0 : 1; }, + LOCALE : 'unknown', + + // gettext and ngettext don't access this so that the functions + // can safely bound to a different name (_ = Documentation.gettext) + gettext : function(string) { + var translated = Documentation.TRANSLATIONS[string]; + if (typeof translated === 'undefined') + return string; + return (typeof translated === 'string') ? translated : translated[0]; + }, + + ngettext : function(singular, plural, n) { + var translated = Documentation.TRANSLATIONS[singular]; + if (typeof translated === 'undefined') + return (n == 1) ? singular : plural; + return translated[Documentation.PLURALEXPR(n)]; + }, + + addTranslations : function(catalog) { + for (var key in catalog.messages) + this.TRANSLATIONS[key] = catalog.messages[key]; + this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); + this.LOCALE = catalog.locale; + }, + + /** + * add context elements like header anchor links + */ + addContextElements : function() { + $('div[id] > :header:first').each(function() { + $('\u00B6'). + attr('href', '#' + this.id). + attr('title', _('Permalink to this headline')). + appendTo(this); + }); + $('dt[id]').each(function() { + $('\u00B6'). + attr('href', '#' + this.id). + attr('title', _('Permalink to this definition')). + appendTo(this); + }); + }, + + /** + * workaround a firefox stupidity + * see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075 + */ + fixFirefoxAnchorBug : function() { + if (document.location.hash && $.browser.mozilla) + window.setTimeout(function() { + document.location.href += ''; + }, 10); + }, + + /** + * highlight the search words provided in the url in the text + */ + highlightSearchWords : function() { + var params = $.getQueryParameters(); + var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; + if (terms.length) { + var body = $('div.body'); + if (!body.length) { + body = $('body'); + } + window.setTimeout(function() { + $.each(terms, function() { + body.highlightText(this.toLowerCase(), 'highlighted'); + }); + }, 10); + $('

' + _('Hide Search Matches') + '

') + .appendTo($('#searchbox')); + } + }, + + /** + * init the domain index toggle buttons + */ + initIndexTable : function() { + var togglers = $('img.toggler').click(function() { + var src = $(this).attr('src'); + var idnum = $(this).attr('id').substr(7); + $('tr.cg-' + idnum).toggle(); + if (src.substr(-9) === 'minus.png') + $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); + else + $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); + }).css('display', ''); + if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) { + togglers.click(); + } + }, + + /** + * helper function to hide the search marks again + */ + hideSearchWords : function() { + $('#searchbox .highlight-link').fadeOut(300); + $('span.highlighted').removeClass('highlighted'); + }, + + /** + * make the url absolute + */ + makeURL : function(relativeURL) { + return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; + }, + + /** + * get the current relative url + */ + getCurrentURL : function() { + var path = document.location.pathname; + var parts = path.split(/\//); + $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { + if (this === '..') + parts.pop(); + }); + var url = parts.join('/'); + return path.substring(url.lastIndexOf('/') + 1, path.length - 1); + }, + + initOnKeyListeners: function() { + $(document).keydown(function(event) { + var activeElementType = document.activeElement.tagName; + // don't navigate when in search box, textarea, dropdown or button + if (activeElementType !== 'TEXTAREA' && activeElementType !== 'INPUT' && activeElementType !== 'SELECT' + && activeElementType !== 'BUTTON' && !event.altKey && !event.ctrlKey && !event.metaKey + && !event.shiftKey) { + switch (event.keyCode) { + case 37: // left + var prevHref = $('link[rel="prev"]').prop('href'); + if (prevHref) { + window.location.href = prevHref; + return false; + } + break; + case 39: // right + var nextHref = $('link[rel="next"]').prop('href'); + if (nextHref) { + window.location.href = nextHref; + return false; + } + break; + } + } + }); + } +}; + +// quick alias for translations +_ = Documentation.gettext; + +$(document).ready(function() { + Documentation.init(); +}); diff --git a/docs/_static/documentation_options.js b/docs/_static/documentation_options.js new file mode 100644 index 000000000..489373b83 --- /dev/null +++ b/docs/_static/documentation_options.js @@ -0,0 +1,12 @@ +var DOCUMENTATION_OPTIONS = { + URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), + VERSION: '0.9.12', + LANGUAGE: 'en, zh-CN', + COLLAPSE_INDEX: false, + BUILDER: 'html', + FILE_SUFFIX: '.html', + LINK_SUFFIX: '.html', + HAS_SOURCE: true, + SOURCELINK_SUFFIX: '.txt', + NAVIGATION_WITH_KEYS: false +}; \ No newline at end of file diff --git a/docs/_static/file.png b/docs/_static/file.png new file mode 100644 index 000000000..a858a410e Binary files /dev/null and b/docs/_static/file.png differ diff --git a/docs/_static/images/chome_developer_tools_console.png b/docs/_static/images/chome_developer_tools_console.png new file mode 100644 index 000000000..5387dc092 Binary files /dev/null and b/docs/_static/images/chome_developer_tools_console.png differ diff --git a/docs/_static/images/chome_developer_tools_devices_remote_target_javet.png b/docs/_static/images/chome_developer_tools_devices_remote_target_javet.png new file mode 100644 index 000000000..0d4a8c66f Binary files /dev/null and b/docs/_static/images/chome_developer_tools_devices_remote_target_javet.png differ diff --git a/docs/_static/images/javet_architecture.drawio b/docs/_static/images/javet_architecture.drawio new file mode 100644 index 000000000..128975c74 --- /dev/null +++ b/docs/_static/images/javet_architecture.drawio @@ -0,0 +1 @@ +7Z1bd5s4EIB/jR83BxBg/Jhr25ymm2160mbfZJCxshjlYDmx++tXwgIDIyfOrrl0tfFDzAAC5huNNGLmeITOF+sPGX6a37CIJCPHitYjdDFyHNtFvvgnJRslsWwliTMaKdlOcEd/kuJAJV3RiCxrB3LGEk6f6sKQpSkJeU2Gs4y91A+bsaR+1SccEyC4C3ECpd9pxOdbaeBZO/lHQuN5cWXbUnsWuDhYCZZzHLGXighdjtB5xhjfflusz0kitVfoZXve1Z695Y1lJOWHnDB5/PjlDza/9n8u3Yg+4IdH9OG3YNvKM05W6oHVzfJNoYGMrdKIyEasETp7mVNO7p5wKPe+COhCNueLRGzZ4uuMpVxBtOXh8CbVfT+TjJN1RaRu+gNhC8KzjThE7UVKfy879XuF+ucV1aOJEmKFPC6b2mlFfFGKeYeS7PcoyT5ASTRJzlnCsvxcNJsRPwyFfMkz9hep7InGk6l1JDW6Sjub+mZFq7av0aoTtKVVB2j1PgB6FQ/H68qrKyllKWloVIlwQuNUbIZCZUTIz6SqqOjYp2rHgkaRvIyWVt3oc6tWN6Xpd+9mUToJBcODMFwdi7ZQoHYNPMIkmGkN3A8DMp0dx8APsPCgUwN3gVavv3wyxMIdf1gW7rVs4R4JIldn4YEzRb5/pJHQf9PCy3lTNybuQxO/vzHExF3XG5SJTyAL/Ey4EJ1modROyFcZ+SXg1OeRR+o9jeHB1kwrUZe8iht4zSeRNDqVQcxO6RFezksnVYEm5beYCxDp1r4tVKIsAhdHo1ihz2zzQzWSbzxIJCdesXmxVoi2W5tia035j8r3yllia3eS3CjO2QtxyVZZSF7T1fY4jrOY8LfdPIlqQR00iSp0DfNClpEEc/pcDwV1hqCucMtoyncW5zUsrumGt4+tTqpGbo12mtNFGzUa2uoFNJSbZfnU/8JS4VT9NqMLmqtmmP7kCP5i0lC6Dx2GNmBqzV/AWfpXMiPiCcM2KCRkxgfHIOibAZzTf2ZCO0D/75tMNhZNQEdoLhh48qONp/I/sSfOcETF6ZV90/zTyliKNGs03XKB8/tbki3pkhPlEtuDo1E1wf40x9AEF4REv9IzDTzXa2elB/XuuGCUkK4WU6E8w3rNuB4waJxZpwGDPQZcpjSmrXeYoXOxNaFBt2DgqvyUsYTg1HQymhWPbsnAIFvohqaxaWBsZ1i+rGi4AuYCczgvNgxL766sfIQdl5P8z3gyfbuyYrWpQub36aN8hW7YdLmxSuNYfYOBcf5pluGN6Vw0MWa3XGDsfyO0bDgVTXDZLRUY+d8R433YpG8qMOS/WqUhp6ztEGZwaJqL9/2PLzDsv9sspqztRczhk+l9hIFx/1cSX66NG2QAmd5HGRj332ZsQZdtR5jDR9P3UFN02jqatXHTZXtocQyCof8noTvMxdObzqbvkQbBGPMyy/4H0/tAgzQvmOmMhJtQEBHnLuVFZWpInkpqzcpJtZWQ57z2AqfRSFYfpDgm8ttUPu59ABfchpAi0EK5QLnk+cq7aW3ST3tMYYgKmDZ4FZl7VJK9vr8xl56mQ3ZMD4ZLAEaVQlHlIxVSJutpveFezYs2nmTLi3Usq6pOtnVMzgl/Yd/xRiUEnuUlVdaJ9J15vRXyNEheW9V+/xr5EQA7DcC2Jm3W7tblwqjrnD1tSteZi4/f/Y6WNVuhLbcr3NwL+WmJm8atdswNxmS/dsfsdyoEAGsCu24BFxfb0zHbTH7soHNeXVnWsWr7mux0ye0ds4PB332gd6WtvvglduSRsa7vTPwxwscqLWi+3B1D/Wtrz1pTP4zv9mds/8ffvAM4hxYGtgYHxnj7fVm7cN4eWV4bp1qAo1u16hbOAZWCsCrnFQbvnpO9WQxT+NaBVLm4dgOh3WBzaJmL6zc6qt9oqOUyF/eASO8o6Muaq0qZ1cOoWmX1Rs1VWWf1oK7cRs1VYWZvFl0V/mwg9uh4DXv0/qE9ImuPb+rKHmFgemZmGjAaWoa2C2PPC7aaJsZNrtBkWHnAHowZPwndxeYVmzTL03snAyPCz8y8xHl3aB3GAVjujKxo8OyBjTEejOH/FFPOSNY1fKML44YaEMdrAHUaKvpwrDEzgx4Vy11DSW/w4VhjZAo9ANN3eoMPRxsDc+gBlr5z6Hw41BiYRO86Q3NjcKG4k+K5wZEBaVq9dxi4SmxqfQPoNb2PMbD2xMz6BkCm914DF9gNzaL3Btdp4FqzkVn07uBCGbjSbGSmNgDTd48p7sf4Yi3gy/ruMmNd9B+vFuIRl6bBAd1GMwcYHweO2Nz9mMH2HejuNyHQ5d8= \ No newline at end of file diff --git a/docs/_static/images/javet_architecture.png b/docs/_static/images/javet_architecture.png new file mode 100644 index 000000000..295eeac6c Binary files /dev/null and b/docs/_static/images/javet_architecture.png differ diff --git a/docs/_static/images/javet_cross_platform.png b/docs/_static/images/javet_cross_platform.png new file mode 100644 index 000000000..77cfa6028 Binary files /dev/null and b/docs/_static/images/javet_cross_platform.png differ diff --git a/docs/_static/images/javet_engine_pool.png b/docs/_static/images/javet_engine_pool.png new file mode 100644 index 000000000..e523eab8c Binary files /dev/null and b/docs/_static/images/javet_engine_pool.png differ diff --git a/docs/_static/images/javet_interception.png b/docs/_static/images/javet_interception.png new file mode 100644 index 000000000..949265cfa Binary files /dev/null and b/docs/_static/images/javet_interception.png differ diff --git a/docs/_static/images/javet_memory_management_passive_gc.png b/docs/_static/images/javet_memory_management_passive_gc.png new file mode 100644 index 000000000..b0b90bab7 Binary files /dev/null and b/docs/_static/images/javet_memory_management_passive_gc.png differ diff --git a/docs/_static/images/javet_modes.png b/docs/_static/images/javet_modes.png new file mode 100644 index 000000000..b650a3127 Binary files /dev/null and b/docs/_static/images/javet_modes.png differ diff --git a/docs/_static/images/javet_module_system.drawio b/docs/_static/images/javet_module_system.drawio new file mode 100644 index 000000000..3b1f68341 --- /dev/null +++ b/docs/_static/images/javet_module_system.drawio @@ -0,0 +1 @@ +7Vtrd6I4GP41fmwPd/Bjb9OeObO7ne3sbrtf9kSIkA4QFmLV/vpJIMglQZkRtbbWc6p5CZE8z3sHR/pVtLhNQRL8hj0YjjTFW4z065GmWY5N/zPBshDoY6MQ+CnyCpFaCR7QK+RChUtnyINZYyLBOCQoaQpdHMfQJQ0ZSFM8b06b4rD5rQnwoSB4cEEoSv9BHgkKqWMqlfwOIj8ov1lV+JEIlJO5IAuAh+c1kX4z0q9SjEnxKVpcwZBhV+JSnPep4+jqwlIYkz4njJ/vfv+Kg8/Wa2Z46Ak8Peu3Z06xygsIZ3zD/GLJskQgxbPYg2wRZaRfzgNE4EMCXHZ0TimnsoBEIR2p9OMUx4STqLLpGUnxd3iFQ5xSUYxjeuRSvHK+mReYErioifhObiGOIEmXdAo/anBQ5xUneqkyQY2P1UTA9cBfLVVBRT9wtH4CubGA3GfwAgkVURuYUfA05WGZERgJgNItkiZqUpSmKAxbIhAiP6ZDlwIHqfySAYaosl7wAxHyPPY1UpqaROZM8YtqM2cNS9KyadIbOdsVZbYucPa3cxT0bM+F1eRCYj/GXqkYC7hDjzpePsQpCbCPYxDeVNIWQtWcLxgnnKpnSMiSqzGYEdwkEi4QeWSnn5t89FQ7cr3gK+eDZTmI6X4f64OnagU2rE7LR9V53gWLP5V6UMknxGCqCK55SjYu9Wmk6cY1e62zQ4bXWuZTGAKCXpqBTMZkfiq9WLCsTUgwiklWW/meCSqFspsKVVp3pRTFgr1OVsctPcvwLHUhP6mlaqsd9tK+wNe/f7Xvv6nJ+MKfKEaQTa7PRD/AffeHcAWqczBfIGVDszYnISHKYS3gLxMxusdLD6U07UOYYUq1hsnrfHkgC3Igy8E9IJSQuIBS0QRKqeld5q9hQqBtNqC2RKhlEVAdImuRY22/X6zV8VsDW8yuV7kh3YoVMucySRvoW//PWEGQG/1ZlseHCzrBSRY5SOVh+sln7zdsbUAo7N1pu7o5bRd4cbSJblkt30blngkdz2iGL2cY+sxWQFFE+iwJffoA7F3bxv1f02//PtozlKnpH/9dBIuzI8xQqqTkqZGTyDMUKYWtrELKaRGd10BXFuog9SFZM8/aMnHZit9SQQcrfZuWMjXZqwmztdlLSq3Ryv/EJLH4W3En2JqEvU7zW8V3bn+OxHtqEvvbmfcU+Vk5T307b9diRMjV2kxOXU9zZLx49niiMNXwU+Ah2OBmOgVmfmwA16iN25V0v5RN3Vlk6+ZmnRW9S270w3Ej9WsiN6zJofw5iwmKoMDOG6pxKtqH8GfWRn+2qypHSotYc57CTd1sZNm6LN5YuyJIrEJPdtNBzF4Np0fFKvbauiNKV7asburnSTPzVTIuzcxHw6XUvLStp9TyxqohZ7fGnilhr5T9XM9Q6OsJytPODjsae8JCqxsDfKF2g7DAYYgGoRTtHrfFhtC5TRXar1SDv6Zza3SpRx130rkBdM4QdO6Y653tYlCr3pH1gvaaU5vd3BxhvbMdN/rhuFnrpTq6rMdGznbFaNsX9qx6dtYokAXSou/NsB316HxbyUJse5ePWrg4SlAIM3bpscfiHu+HM0lUM1G6PwtEjN7iP3Oq5+Wl0J0VV1MsLuhMPccvH+JR6rWV0iern2BCcFSskbCVo4XPHpk6Lx5T0op3tuyyCPl5xcaItc9NFv9jTNyAf1tnWz5Eyd1oY1O/2fkNcIpeqQiUuwzBBIb3OEP8Zo+wpy+tCQQnwyhw69Zk3ybkzvRXfMrnOINyigngXJ2p5jBcqe0OiymQpe+TK1XsfB3A2agnt/Lm3YoqeRRtv35FFduBx5m07MOxqOqhPYuYYg7iWfIGI8i+MwdSepkphfhD5S5Tx4WuW3My4nPDdNbEMQ1Tctf6DTsZQzsX9XbPbua9FK67cDPtm6qGLeFrv35mTbr54elStebjXYdON0tDPtUGPch6A8a12sSOyoMUJiHKa4E5ohusygPvY8Xzd1s0lD8fOVg018QC9+RxOosG2zmwv1lT4p2CeTs+7I4tOqx+ZFncrKt+qarf/AA= \ No newline at end of file diff --git a/docs/_static/images/javet_module_system.png b/docs/_static/images/javet_module_system.png new file mode 100644 index 000000000..9b416a887 Binary files /dev/null and b/docs/_static/images/javet_module_system.png differ diff --git a/docs/_static/images/lifecycle_of_v8_function.png b/docs/_static/images/lifecycle_of_v8_function.png new file mode 100644 index 000000000..7c5c601a0 Binary files /dev/null and b/docs/_static/images/lifecycle_of_v8_function.png differ diff --git a/docs/_static/images/logo.drawio b/docs/_static/images/logo.drawio new file mode 100644 index 000000000..8da09ac9c --- /dev/null +++ b/docs/_static/images/logo.drawio @@ -0,0 +1 @@ +zVbbctowEP0aHsP4xu0xMZc0k3bSSdqEvKlY2KKy15UFGL6+kr3GFoYmnaGdwAx4z14s7Tlau+P6cT4TJI0+Q0B5x7GCvOOOO47jDBz1q4EdAh4CoWBBCdk18Mj2FEEL0TULaGYESgAuWWqCC0gSupAGRoSArRm2BG7eNSUhbQGPC8Lb6DMLZFSiw55V47eUhVF1Z9tCT0yqYASyiASwbUDupOP6AkCWV3HuU657V/WlzJue8R4WJmgi35MwWt1++QrRXX+feQGbk/nKnV0NRrg4uat2TAPVADRByAhCSAif1OiNgHUSUF3WUlYdcw+QKtBW4IpKuUM2yVqCgiIZc/TSnMkXnd7toTVveMY5Vi6MXWUkUuxemsa8rqDNOq2w6rzgWutAmQkktESmjHP0LyGRuFC7sn3gIIpuuN5YfxXebjcyoPvVALD5MwoxVetQAYJyItnGFBRBXYaHOExViyW7RkAKLJFZo/KDBlQAnrAByqs6X7ahAnVRFnxXsj2yzNVlsBYLiklG1cYOa6hQ3Gn1PT/d7Gfh/vUb+3Q3vk/ms3D1ejUs77YhfI3daalxGzFJH1Oy0PZWjRhTSSRLy1O/ZLlWZEHflMSM6y3dUr6hki2IybPjtXm2rH7f9xW+oUJn8GvOwkT5YhYEheozKeAnrVJQS0slpEYV35/0ptODWnQtmp89r2f0UiX0tbgNeqqhuK0nkYc9jBpDqMJOacyg8G/5clt83V23GFM7liZJb3YOIYItX6gOUfEnLk6pwpxKnPyg/AEyJhmcrHl/FHCoXQgFt2NfhMcjFpX8jlm0nW6l/SaRjvWPiPRaRE46Tp9r3rKUJAah/V9r/Ygq+nKFsGLdSkDEhNd+dRXq/6eqklpZWazEP6hQmnS7l6B7OOoOhm8z7v1fxnstxr9/YELOTvBTE9s8sO1JfwlSB27XbX68I4Lbg9nRR7r5uQjZyqzfGMvHcP3a7U5+Aw== \ No newline at end of file diff --git a/docs/_static/images/logo.ico b/docs/_static/images/logo.ico new file mode 100644 index 000000000..2ebbc2723 Binary files /dev/null and b/docs/_static/images/logo.ico differ diff --git a/docs/_static/images/logo.png b/docs/_static/images/logo.png new file mode 100644 index 000000000..fca42ab03 Binary files /dev/null and b/docs/_static/images/logo.png differ diff --git a/docs/_static/images/memory_layout_of_v8_function.png b/docs/_static/images/memory_layout_of_v8_function.png new file mode 100644 index 000000000..d2a460537 Binary files /dev/null and b/docs/_static/images/memory_layout_of_v8_function.png differ diff --git a/docs/_static/images/v8_promise_and_resolver.png b/docs/_static/images/v8_promise_and_resolver.png new file mode 100644 index 000000000..ba4b397d9 Binary files /dev/null and b/docs/_static/images/v8_promise_and_resolver.png differ diff --git a/docs/_static/images/v8_promise_lifecycle.png b/docs/_static/images/v8_promise_lifecycle.png new file mode 100644 index 000000000..919cd3260 Binary files /dev/null and b/docs/_static/images/v8_promise_lifecycle.png differ diff --git a/docs/_static/jquery-3.5.1.js b/docs/_static/jquery-3.5.1.js new file mode 100644 index 000000000..50937333b --- /dev/null +++ b/docs/_static/jquery-3.5.1.js @@ -0,0 +1,10872 @@ +/*! + * jQuery JavaScript Library v3.5.1 + * https://jquery.com/ + * + * Includes Sizzle.js + * https://sizzlejs.com/ + * + * Copyright JS Foundation and other contributors + * Released under the MIT license + * https://jquery.org/license + * + * Date: 2020-05-04T22:49Z + */ +( function( global, factory ) { + + "use strict"; + + if ( typeof module === "object" && typeof module.exports === "object" ) { + + // For CommonJS and CommonJS-like environments where a proper `window` + // is present, execute the factory and get jQuery. + // For environments that do not have a `window` with a `document` + // (such as Node.js), expose a factory as module.exports. + // This accentuates the need for the creation of a real `window`. + // e.g. var jQuery = require("jquery")(window); + // See ticket #14549 for more info. + module.exports = global.document ? + factory( global, true ) : + function( w ) { + if ( !w.document ) { + throw new Error( "jQuery requires a window with a document" ); + } + return factory( w ); + }; + } else { + factory( global ); + } + +// Pass this if window is not defined yet +} )( typeof window !== "undefined" ? window : this, function( window, noGlobal ) { + +// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1 +// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode +// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common +// enough that all such attempts are guarded in a try block. +"use strict"; + +var arr = []; + +var getProto = Object.getPrototypeOf; + +var slice = arr.slice; + +var flat = arr.flat ? function( array ) { + return arr.flat.call( array ); +} : function( array ) { + return arr.concat.apply( [], array ); +}; + + +var push = arr.push; + +var indexOf = arr.indexOf; + +var class2type = {}; + +var toString = class2type.toString; + +var hasOwn = class2type.hasOwnProperty; + +var fnToString = hasOwn.toString; + +var ObjectFunctionString = fnToString.call( Object ); + +var support = {}; + +var isFunction = function isFunction( obj ) { + + // Support: Chrome <=57, Firefox <=52 + // In some browsers, typeof returns "function" for HTML elements + // (i.e., `typeof document.createElement( "object" ) === "function"`). + // We don't want to classify *any* DOM node as a function. + return typeof obj === "function" && typeof obj.nodeType !== "number"; + }; + + +var isWindow = function isWindow( obj ) { + return obj != null && obj === obj.window; + }; + + +var document = window.document; + + + + var preservedScriptAttributes = { + type: true, + src: true, + nonce: true, + noModule: true + }; + + function DOMEval( code, node, doc ) { + doc = doc || document; + + var i, val, + script = doc.createElement( "script" ); + + script.text = code; + if ( node ) { + for ( i in preservedScriptAttributes ) { + + // Support: Firefox 64+, Edge 18+ + // Some browsers don't support the "nonce" property on scripts. + // On the other hand, just using `getAttribute` is not enough as + // the `nonce` attribute is reset to an empty string whenever it + // becomes browsing-context connected. + // See https://github.com/whatwg/html/issues/2369 + // See https://html.spec.whatwg.org/#nonce-attributes + // The `node.getAttribute` check was added for the sake of + // `jQuery.globalEval` so that it can fake a nonce-containing node + // via an object. + val = node[ i ] || node.getAttribute && node.getAttribute( i ); + if ( val ) { + script.setAttribute( i, val ); + } + } + } + doc.head.appendChild( script ).parentNode.removeChild( script ); + } + + +function toType( obj ) { + if ( obj == null ) { + return obj + ""; + } + + // Support: Android <=2.3 only (functionish RegExp) + return typeof obj === "object" || typeof obj === "function" ? + class2type[ toString.call( obj ) ] || "object" : + typeof obj; +} +/* global Symbol */ +// Defining this global in .eslintrc.json would create a danger of using the global +// unguarded in another place, it seems safer to define global only for this module + + + +var + version = "3.5.1", + + // Define a local copy of jQuery + jQuery = function( selector, context ) { + + // The jQuery object is actually just the init constructor 'enhanced' + // Need init if jQuery is called (just allow error to be thrown if not included) + return new jQuery.fn.init( selector, context ); + }; + +jQuery.fn = jQuery.prototype = { + + // The current version of jQuery being used + jquery: version, + + constructor: jQuery, + + // The default length of a jQuery object is 0 + length: 0, + + toArray: function() { + return slice.call( this ); + }, + + // Get the Nth element in the matched element set OR + // Get the whole matched element set as a clean array + get: function( num ) { + + // Return all the elements in a clean array + if ( num == null ) { + return slice.call( this ); + } + + // Return just the one element from the set + return num < 0 ? this[ num + this.length ] : this[ num ]; + }, + + // Take an array of elements and push it onto the stack + // (returning the new matched element set) + pushStack: function( elems ) { + + // Build a new jQuery matched element set + var ret = jQuery.merge( this.constructor(), elems ); + + // Add the old object onto the stack (as a reference) + ret.prevObject = this; + + // Return the newly-formed element set + return ret; + }, + + // Execute a callback for every element in the matched set. + each: function( callback ) { + return jQuery.each( this, callback ); + }, + + map: function( callback ) { + return this.pushStack( jQuery.map( this, function( elem, i ) { + return callback.call( elem, i, elem ); + } ) ); + }, + + slice: function() { + return this.pushStack( slice.apply( this, arguments ) ); + }, + + first: function() { + return this.eq( 0 ); + }, + + last: function() { + return this.eq( -1 ); + }, + + even: function() { + return this.pushStack( jQuery.grep( this, function( _elem, i ) { + return ( i + 1 ) % 2; + } ) ); + }, + + odd: function() { + return this.pushStack( jQuery.grep( this, function( _elem, i ) { + return i % 2; + } ) ); + }, + + eq: function( i ) { + var len = this.length, + j = +i + ( i < 0 ? len : 0 ); + return this.pushStack( j >= 0 && j < len ? [ this[ j ] ] : [] ); + }, + + end: function() { + return this.prevObject || this.constructor(); + }, + + // For internal use only. + // Behaves like an Array's method, not like a jQuery method. + push: push, + sort: arr.sort, + splice: arr.splice +}; + +jQuery.extend = jQuery.fn.extend = function() { + var options, name, src, copy, copyIsArray, clone, + target = arguments[ 0 ] || {}, + i = 1, + length = arguments.length, + deep = false; + + // Handle a deep copy situation + if ( typeof target === "boolean" ) { + deep = target; + + // Skip the boolean and the target + target = arguments[ i ] || {}; + i++; + } + + // Handle case when target is a string or something (possible in deep copy) + if ( typeof target !== "object" && !isFunction( target ) ) { + target = {}; + } + + // Extend jQuery itself if only one argument is passed + if ( i === length ) { + target = this; + i--; + } + + for ( ; i < length; i++ ) { + + // Only deal with non-null/undefined values + if ( ( options = arguments[ i ] ) != null ) { + + // Extend the base object + for ( name in options ) { + copy = options[ name ]; + + // Prevent Object.prototype pollution + // Prevent never-ending loop + if ( name === "__proto__" || target === copy ) { + continue; + } + + // Recurse if we're merging plain objects or arrays + if ( deep && copy && ( jQuery.isPlainObject( copy ) || + ( copyIsArray = Array.isArray( copy ) ) ) ) { + src = target[ name ]; + + // Ensure proper type for the source value + if ( copyIsArray && !Array.isArray( src ) ) { + clone = []; + } else if ( !copyIsArray && !jQuery.isPlainObject( src ) ) { + clone = {}; + } else { + clone = src; + } + copyIsArray = false; + + // Never move original objects, clone them + target[ name ] = jQuery.extend( deep, clone, copy ); + + // Don't bring in undefined values + } else if ( copy !== undefined ) { + target[ name ] = copy; + } + } + } + } + + // Return the modified object + return target; +}; + +jQuery.extend( { + + // Unique for each copy of jQuery on the page + expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ), + + // Assume jQuery is ready without the ready module + isReady: true, + + error: function( msg ) { + throw new Error( msg ); + }, + + noop: function() {}, + + isPlainObject: function( obj ) { + var proto, Ctor; + + // Detect obvious negatives + // Use toString instead of jQuery.type to catch host objects + if ( !obj || toString.call( obj ) !== "[object Object]" ) { + return false; + } + + proto = getProto( obj ); + + // Objects with no prototype (e.g., `Object.create( null )`) are plain + if ( !proto ) { + return true; + } + + // Objects with prototype are plain iff they were constructed by a global Object function + Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor; + return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString; + }, + + isEmptyObject: function( obj ) { + var name; + + for ( name in obj ) { + return false; + } + return true; + }, + + // Evaluates a script in a provided context; falls back to the global one + // if not specified. + globalEval: function( code, options, doc ) { + DOMEval( code, { nonce: options && options.nonce }, doc ); + }, + + each: function( obj, callback ) { + var length, i = 0; + + if ( isArrayLike( obj ) ) { + length = obj.length; + for ( ; i < length; i++ ) { + if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { + break; + } + } + } else { + for ( i in obj ) { + if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { + break; + } + } + } + + return obj; + }, + + // results is for internal usage only + makeArray: function( arr, results ) { + var ret = results || []; + + if ( arr != null ) { + if ( isArrayLike( Object( arr ) ) ) { + jQuery.merge( ret, + typeof arr === "string" ? + [ arr ] : arr + ); + } else { + push.call( ret, arr ); + } + } + + return ret; + }, + + inArray: function( elem, arr, i ) { + return arr == null ? -1 : indexOf.call( arr, elem, i ); + }, + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + merge: function( first, second ) { + var len = +second.length, + j = 0, + i = first.length; + + for ( ; j < len; j++ ) { + first[ i++ ] = second[ j ]; + } + + first.length = i; + + return first; + }, + + grep: function( elems, callback, invert ) { + var callbackInverse, + matches = [], + i = 0, + length = elems.length, + callbackExpect = !invert; + + // Go through the array, only saving the items + // that pass the validator function + for ( ; i < length; i++ ) { + callbackInverse = !callback( elems[ i ], i ); + if ( callbackInverse !== callbackExpect ) { + matches.push( elems[ i ] ); + } + } + + return matches; + }, + + // arg is for internal usage only + map: function( elems, callback, arg ) { + var length, value, + i = 0, + ret = []; + + // Go through the array, translating each of the items to their new values + if ( isArrayLike( elems ) ) { + length = elems.length; + for ( ; i < length; i++ ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret.push( value ); + } + } + + // Go through every key on the object, + } else { + for ( i in elems ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret.push( value ); + } + } + } + + // Flatten any nested arrays + return flat( ret ); + }, + + // A global GUID counter for objects + guid: 1, + + // jQuery.support is not used in Core but other projects attach their + // properties to it so it needs to exist. + support: support +} ); + +if ( typeof Symbol === "function" ) { + jQuery.fn[ Symbol.iterator ] = arr[ Symbol.iterator ]; +} + +// Populate the class2type map +jQuery.each( "Boolean Number String Function Array Date RegExp Object Error Symbol".split( " " ), +function( _i, name ) { + class2type[ "[object " + name + "]" ] = name.toLowerCase(); +} ); + +function isArrayLike( obj ) { + + // Support: real iOS 8.2 only (not reproducible in simulator) + // `in` check used to prevent JIT error (gh-2145) + // hasOwn isn't used here due to false negatives + // regarding Nodelist length in IE + var length = !!obj && "length" in obj && obj.length, + type = toType( obj ); + + if ( isFunction( obj ) || isWindow( obj ) ) { + return false; + } + + return type === "array" || length === 0 || + typeof length === "number" && length > 0 && ( length - 1 ) in obj; +} +var Sizzle = +/*! + * Sizzle CSS Selector Engine v2.3.5 + * https://sizzlejs.com/ + * + * Copyright JS Foundation and other contributors + * Released under the MIT license + * https://js.foundation/ + * + * Date: 2020-03-14 + */ +( function( window ) { +var i, + support, + Expr, + getText, + isXML, + tokenize, + compile, + select, + outermostContext, + sortInput, + hasDuplicate, + + // Local document vars + setDocument, + document, + docElem, + documentIsHTML, + rbuggyQSA, + rbuggyMatches, + matches, + contains, + + // Instance-specific data + expando = "sizzle" + 1 * new Date(), + preferredDoc = window.document, + dirruns = 0, + done = 0, + classCache = createCache(), + tokenCache = createCache(), + compilerCache = createCache(), + nonnativeSelectorCache = createCache(), + sortOrder = function( a, b ) { + if ( a === b ) { + hasDuplicate = true; + } + return 0; + }, + + // Instance methods + hasOwn = ( {} ).hasOwnProperty, + arr = [], + pop = arr.pop, + pushNative = arr.push, + push = arr.push, + slice = arr.slice, + + // Use a stripped-down indexOf as it's faster than native + // https://jsperf.com/thor-indexof-vs-for/5 + indexOf = function( list, elem ) { + var i = 0, + len = list.length; + for ( ; i < len; i++ ) { + if ( list[ i ] === elem ) { + return i; + } + } + return -1; + }, + + booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|" + + "ismap|loop|multiple|open|readonly|required|scoped", + + // Regular expressions + + // http://www.w3.org/TR/css3-selectors/#whitespace + whitespace = "[\\x20\\t\\r\\n\\f]", + + // https://www.w3.org/TR/css-syntax-3/#ident-token-diagram + identifier = "(?:\\\\[\\da-fA-F]{1,6}" + whitespace + + "?|\\\\[^\\r\\n\\f]|[\\w-]|[^\0-\\x7f])+", + + // Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors + attributes = "\\[" + whitespace + "*(" + identifier + ")(?:" + whitespace + + + // Operator (capture 2) + "*([*^$|!~]?=)" + whitespace + + + // "Attribute values must be CSS identifiers [capture 5] + // or strings [capture 3 or capture 4]" + "*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|(" + identifier + "))|)" + + whitespace + "*\\]", + + pseudos = ":(" + identifier + ")(?:\\((" + + + // To reduce the number of selectors needing tokenize in the preFilter, prefer arguments: + // 1. quoted (capture 3; capture 4 or capture 5) + "('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|" + + + // 2. simple (capture 6) + "((?:\\\\.|[^\\\\()[\\]]|" + attributes + ")*)|" + + + // 3. anything else (capture 2) + ".*" + + ")\\)|)", + + // Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter + rwhitespace = new RegExp( whitespace + "+", "g" ), + rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + + whitespace + "+$", "g" ), + + rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ), + rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace + + "*" ), + rdescend = new RegExp( whitespace + "|>" ), + + rpseudo = new RegExp( pseudos ), + ridentifier = new RegExp( "^" + identifier + "$" ), + + matchExpr = { + "ID": new RegExp( "^#(" + identifier + ")" ), + "CLASS": new RegExp( "^\\.(" + identifier + ")" ), + "TAG": new RegExp( "^(" + identifier + "|[*])" ), + "ATTR": new RegExp( "^" + attributes ), + "PSEUDO": new RegExp( "^" + pseudos ), + "CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" + + whitespace + "*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + + whitespace + "*(\\d+)|))" + whitespace + "*\\)|)", "i" ), + "bool": new RegExp( "^(?:" + booleans + ")$", "i" ), + + // For use in libraries implementing .is() + // We use this for POS matching in `select` + "needsContext": new RegExp( "^" + whitespace + + "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" + whitespace + + "*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" ) + }, + + rhtml = /HTML$/i, + rinputs = /^(?:input|select|textarea|button)$/i, + rheader = /^h\d$/i, + + rnative = /^[^{]+\{\s*\[native \w/, + + // Easily-parseable/retrievable ID or TAG or CLASS selectors + rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/, + + rsibling = /[+~]/, + + // CSS escapes + // http://www.w3.org/TR/CSS21/syndata.html#escaped-characters + runescape = new RegExp( "\\\\[\\da-fA-F]{1,6}" + whitespace + "?|\\\\([^\\r\\n\\f])", "g" ), + funescape = function( escape, nonHex ) { + var high = "0x" + escape.slice( 1 ) - 0x10000; + + return nonHex ? + + // Strip the backslash prefix from a non-hex escape sequence + nonHex : + + // Replace a hexadecimal escape sequence with the encoded Unicode code point + // Support: IE <=11+ + // For values outside the Basic Multilingual Plane (BMP), manually construct a + // surrogate pair + high < 0 ? + String.fromCharCode( high + 0x10000 ) : + String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 ); + }, + + // CSS string/identifier serialization + // https://drafts.csswg.org/cssom/#common-serializing-idioms + rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g, + fcssescape = function( ch, asCodePoint ) { + if ( asCodePoint ) { + + // U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER + if ( ch === "\0" ) { + return "\uFFFD"; + } + + // Control characters and (dependent upon position) numbers get escaped as code points + return ch.slice( 0, -1 ) + "\\" + + ch.charCodeAt( ch.length - 1 ).toString( 16 ) + " "; + } + + // Other potentially-special ASCII characters get backslash-escaped + return "\\" + ch; + }, + + // Used for iframes + // See setDocument() + // Removing the function wrapper causes a "Permission Denied" + // error in IE + unloadHandler = function() { + setDocument(); + }, + + inDisabledFieldset = addCombinator( + function( elem ) { + return elem.disabled === true && elem.nodeName.toLowerCase() === "fieldset"; + }, + { dir: "parentNode", next: "legend" } + ); + +// Optimize for push.apply( _, NodeList ) +try { + push.apply( + ( arr = slice.call( preferredDoc.childNodes ) ), + preferredDoc.childNodes + ); + + // Support: Android<4.0 + // Detect silently failing push.apply + // eslint-disable-next-line no-unused-expressions + arr[ preferredDoc.childNodes.length ].nodeType; +} catch ( e ) { + push = { apply: arr.length ? + + // Leverage slice if possible + function( target, els ) { + pushNative.apply( target, slice.call( els ) ); + } : + + // Support: IE<9 + // Otherwise append directly + function( target, els ) { + var j = target.length, + i = 0; + + // Can't trust NodeList.length + while ( ( target[ j++ ] = els[ i++ ] ) ) {} + target.length = j - 1; + } + }; +} + +function Sizzle( selector, context, results, seed ) { + var m, i, elem, nid, match, groups, newSelector, + newContext = context && context.ownerDocument, + + // nodeType defaults to 9, since context defaults to document + nodeType = context ? context.nodeType : 9; + + results = results || []; + + // Return early from calls with invalid selector or context + if ( typeof selector !== "string" || !selector || + nodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) { + + return results; + } + + // Try to shortcut find operations (as opposed to filters) in HTML documents + if ( !seed ) { + setDocument( context ); + context = context || document; + + if ( documentIsHTML ) { + + // If the selector is sufficiently simple, try using a "get*By*" DOM method + // (excepting DocumentFragment context, where the methods don't exist) + if ( nodeType !== 11 && ( match = rquickExpr.exec( selector ) ) ) { + + // ID selector + if ( ( m = match[ 1 ] ) ) { + + // Document context + if ( nodeType === 9 ) { + if ( ( elem = context.getElementById( m ) ) ) { + + // Support: IE, Opera, Webkit + // TODO: identify versions + // getElementById can match elements by name instead of ID + if ( elem.id === m ) { + results.push( elem ); + return results; + } + } else { + return results; + } + + // Element context + } else { + + // Support: IE, Opera, Webkit + // TODO: identify versions + // getElementById can match elements by name instead of ID + if ( newContext && ( elem = newContext.getElementById( m ) ) && + contains( context, elem ) && + elem.id === m ) { + + results.push( elem ); + return results; + } + } + + // Type selector + } else if ( match[ 2 ] ) { + push.apply( results, context.getElementsByTagName( selector ) ); + return results; + + // Class selector + } else if ( ( m = match[ 3 ] ) && support.getElementsByClassName && + context.getElementsByClassName ) { + + push.apply( results, context.getElementsByClassName( m ) ); + return results; + } + } + + // Take advantage of querySelectorAll + if ( support.qsa && + !nonnativeSelectorCache[ selector + " " ] && + ( !rbuggyQSA || !rbuggyQSA.test( selector ) ) && + + // Support: IE 8 only + // Exclude object elements + ( nodeType !== 1 || context.nodeName.toLowerCase() !== "object" ) ) { + + newSelector = selector; + newContext = context; + + // qSA considers elements outside a scoping root when evaluating child or + // descendant combinators, which is not what we want. + // In such cases, we work around the behavior by prefixing every selector in the + // list with an ID selector referencing the scope context. + // The technique has to be used as well when a leading combinator is used + // as such selectors are not recognized by querySelectorAll. + // Thanks to Andrew Dupont for this technique. + if ( nodeType === 1 && + ( rdescend.test( selector ) || rcombinators.test( selector ) ) ) { + + // Expand context for sibling selectors + newContext = rsibling.test( selector ) && testContext( context.parentNode ) || + context; + + // We can use :scope instead of the ID hack if the browser + // supports it & if we're not changing the context. + if ( newContext !== context || !support.scope ) { + + // Capture the context ID, setting it first if necessary + if ( ( nid = context.getAttribute( "id" ) ) ) { + nid = nid.replace( rcssescape, fcssescape ); + } else { + context.setAttribute( "id", ( nid = expando ) ); + } + } + + // Prefix every selector in the list + groups = tokenize( selector ); + i = groups.length; + while ( i-- ) { + groups[ i ] = ( nid ? "#" + nid : ":scope" ) + " " + + toSelector( groups[ i ] ); + } + newSelector = groups.join( "," ); + } + + try { + push.apply( results, + newContext.querySelectorAll( newSelector ) + ); + return results; + } catch ( qsaError ) { + nonnativeSelectorCache( selector, true ); + } finally { + if ( nid === expando ) { + context.removeAttribute( "id" ); + } + } + } + } + } + + // All others + return select( selector.replace( rtrim, "$1" ), context, results, seed ); +} + +/** + * Create key-value caches of limited size + * @returns {function(string, object)} Returns the Object data after storing it on itself with + * property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength) + * deleting the oldest entry + */ +function createCache() { + var keys = []; + + function cache( key, value ) { + + // Use (key + " ") to avoid collision with native prototype properties (see Issue #157) + if ( keys.push( key + " " ) > Expr.cacheLength ) { + + // Only keep the most recent entries + delete cache[ keys.shift() ]; + } + return ( cache[ key + " " ] = value ); + } + return cache; +} + +/** + * Mark a function for special use by Sizzle + * @param {Function} fn The function to mark + */ +function markFunction( fn ) { + fn[ expando ] = true; + return fn; +} + +/** + * Support testing using an element + * @param {Function} fn Passed the created element and returns a boolean result + */ +function assert( fn ) { + var el = document.createElement( "fieldset" ); + + try { + return !!fn( el ); + } catch ( e ) { + return false; + } finally { + + // Remove from its parent by default + if ( el.parentNode ) { + el.parentNode.removeChild( el ); + } + + // release memory in IE + el = null; + } +} + +/** + * Adds the same handler for all of the specified attrs + * @param {String} attrs Pipe-separated list of attributes + * @param {Function} handler The method that will be applied + */ +function addHandle( attrs, handler ) { + var arr = attrs.split( "|" ), + i = arr.length; + + while ( i-- ) { + Expr.attrHandle[ arr[ i ] ] = handler; + } +} + +/** + * Checks document order of two siblings + * @param {Element} a + * @param {Element} b + * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b + */ +function siblingCheck( a, b ) { + var cur = b && a, + diff = cur && a.nodeType === 1 && b.nodeType === 1 && + a.sourceIndex - b.sourceIndex; + + // Use IE sourceIndex if available on both nodes + if ( diff ) { + return diff; + } + + // Check if b follows a + if ( cur ) { + while ( ( cur = cur.nextSibling ) ) { + if ( cur === b ) { + return -1; + } + } + } + + return a ? 1 : -1; +} + +/** + * Returns a function to use in pseudos for input types + * @param {String} type + */ +function createInputPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for buttons + * @param {String} type + */ +function createButtonPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return ( name === "input" || name === "button" ) && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for :enabled/:disabled + * @param {Boolean} disabled true for :disabled; false for :enabled + */ +function createDisabledPseudo( disabled ) { + + // Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable + return function( elem ) { + + // Only certain elements can match :enabled or :disabled + // https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled + // https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled + if ( "form" in elem ) { + + // Check for inherited disabledness on relevant non-disabled elements: + // * listed form-associated elements in a disabled fieldset + // https://html.spec.whatwg.org/multipage/forms.html#category-listed + // https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled + // * option elements in a disabled optgroup + // https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled + // All such elements have a "form" property. + if ( elem.parentNode && elem.disabled === false ) { + + // Option elements defer to a parent optgroup if present + if ( "label" in elem ) { + if ( "label" in elem.parentNode ) { + return elem.parentNode.disabled === disabled; + } else { + return elem.disabled === disabled; + } + } + + // Support: IE 6 - 11 + // Use the isDisabled shortcut property to check for disabled fieldset ancestors + return elem.isDisabled === disabled || + + // Where there is no isDisabled, check manually + /* jshint -W018 */ + elem.isDisabled !== !disabled && + inDisabledFieldset( elem ) === disabled; + } + + return elem.disabled === disabled; + + // Try to winnow out elements that can't be disabled before trusting the disabled property. + // Some victims get caught in our net (label, legend, menu, track), but it shouldn't + // even exist on them, let alone have a boolean value. + } else if ( "label" in elem ) { + return elem.disabled === disabled; + } + + // Remaining elements are neither :enabled nor :disabled + return false; + }; +} + +/** + * Returns a function to use in pseudos for positionals + * @param {Function} fn + */ +function createPositionalPseudo( fn ) { + return markFunction( function( argument ) { + argument = +argument; + return markFunction( function( seed, matches ) { + var j, + matchIndexes = fn( [], seed.length, argument ), + i = matchIndexes.length; + + // Match elements found at the specified indexes + while ( i-- ) { + if ( seed[ ( j = matchIndexes[ i ] ) ] ) { + seed[ j ] = !( matches[ j ] = seed[ j ] ); + } + } + } ); + } ); +} + +/** + * Checks a node for validity as a Sizzle context + * @param {Element|Object=} context + * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value + */ +function testContext( context ) { + return context && typeof context.getElementsByTagName !== "undefined" && context; +} + +// Expose support vars for convenience +support = Sizzle.support = {}; + +/** + * Detects XML nodes + * @param {Element|Object} elem An element or a document + * @returns {Boolean} True iff elem is a non-HTML XML node + */ +isXML = Sizzle.isXML = function( elem ) { + var namespace = elem.namespaceURI, + docElem = ( elem.ownerDocument || elem ).documentElement; + + // Support: IE <=8 + // Assume HTML when documentElement doesn't yet exist, such as inside loading iframes + // https://bugs.jquery.com/ticket/4833 + return !rhtml.test( namespace || docElem && docElem.nodeName || "HTML" ); +}; + +/** + * Sets document-related variables once based on the current document + * @param {Element|Object} [doc] An element or document object to use to set the document + * @returns {Object} Returns the current document + */ +setDocument = Sizzle.setDocument = function( node ) { + var hasCompare, subWindow, + doc = node ? node.ownerDocument || node : preferredDoc; + + // Return early if doc is invalid or already selected + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( doc == document || doc.nodeType !== 9 || !doc.documentElement ) { + return document; + } + + // Update global variables + document = doc; + docElem = document.documentElement; + documentIsHTML = !isXML( document ); + + // Support: IE 9 - 11+, Edge 12 - 18+ + // Accessing iframe documents after unload throws "permission denied" errors (jQuery #13936) + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( preferredDoc != document && + ( subWindow = document.defaultView ) && subWindow.top !== subWindow ) { + + // Support: IE 11, Edge + if ( subWindow.addEventListener ) { + subWindow.addEventListener( "unload", unloadHandler, false ); + + // Support: IE 9 - 10 only + } else if ( subWindow.attachEvent ) { + subWindow.attachEvent( "onunload", unloadHandler ); + } + } + + // Support: IE 8 - 11+, Edge 12 - 18+, Chrome <=16 - 25 only, Firefox <=3.6 - 31 only, + // Safari 4 - 5 only, Opera <=11.6 - 12.x only + // IE/Edge & older browsers don't support the :scope pseudo-class. + // Support: Safari 6.0 only + // Safari 6.0 supports :scope but it's an alias of :root there. + support.scope = assert( function( el ) { + docElem.appendChild( el ).appendChild( document.createElement( "div" ) ); + return typeof el.querySelectorAll !== "undefined" && + !el.querySelectorAll( ":scope fieldset div" ).length; + } ); + + /* Attributes + ---------------------------------------------------------------------- */ + + // Support: IE<8 + // Verify that getAttribute really returns attributes and not properties + // (excepting IE8 booleans) + support.attributes = assert( function( el ) { + el.className = "i"; + return !el.getAttribute( "className" ); + } ); + + /* getElement(s)By* + ---------------------------------------------------------------------- */ + + // Check if getElementsByTagName("*") returns only elements + support.getElementsByTagName = assert( function( el ) { + el.appendChild( document.createComment( "" ) ); + return !el.getElementsByTagName( "*" ).length; + } ); + + // Support: IE<9 + support.getElementsByClassName = rnative.test( document.getElementsByClassName ); + + // Support: IE<10 + // Check if getElementById returns elements by name + // The broken getElementById methods don't pick up programmatically-set names, + // so use a roundabout getElementsByName test + support.getById = assert( function( el ) { + docElem.appendChild( el ).id = expando; + return !document.getElementsByName || !document.getElementsByName( expando ).length; + } ); + + // ID filter and find + if ( support.getById ) { + Expr.filter[ "ID" ] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + return elem.getAttribute( "id" ) === attrId; + }; + }; + Expr.find[ "ID" ] = function( id, context ) { + if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { + var elem = context.getElementById( id ); + return elem ? [ elem ] : []; + } + }; + } else { + Expr.filter[ "ID" ] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + var node = typeof elem.getAttributeNode !== "undefined" && + elem.getAttributeNode( "id" ); + return node && node.value === attrId; + }; + }; + + // Support: IE 6 - 7 only + // getElementById is not reliable as a find shortcut + Expr.find[ "ID" ] = function( id, context ) { + if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { + var node, i, elems, + elem = context.getElementById( id ); + + if ( elem ) { + + // Verify the id attribute + node = elem.getAttributeNode( "id" ); + if ( node && node.value === id ) { + return [ elem ]; + } + + // Fall back on getElementsByName + elems = context.getElementsByName( id ); + i = 0; + while ( ( elem = elems[ i++ ] ) ) { + node = elem.getAttributeNode( "id" ); + if ( node && node.value === id ) { + return [ elem ]; + } + } + } + + return []; + } + }; + } + + // Tag + Expr.find[ "TAG" ] = support.getElementsByTagName ? + function( tag, context ) { + if ( typeof context.getElementsByTagName !== "undefined" ) { + return context.getElementsByTagName( tag ); + + // DocumentFragment nodes don't have gEBTN + } else if ( support.qsa ) { + return context.querySelectorAll( tag ); + } + } : + + function( tag, context ) { + var elem, + tmp = [], + i = 0, + + // By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too + results = context.getElementsByTagName( tag ); + + // Filter out possible comments + if ( tag === "*" ) { + while ( ( elem = results[ i++ ] ) ) { + if ( elem.nodeType === 1 ) { + tmp.push( elem ); + } + } + + return tmp; + } + return results; + }; + + // Class + Expr.find[ "CLASS" ] = support.getElementsByClassName && function( className, context ) { + if ( typeof context.getElementsByClassName !== "undefined" && documentIsHTML ) { + return context.getElementsByClassName( className ); + } + }; + + /* QSA/matchesSelector + ---------------------------------------------------------------------- */ + + // QSA and matchesSelector support + + // matchesSelector(:active) reports false when true (IE9/Opera 11.5) + rbuggyMatches = []; + + // qSa(:focus) reports false when true (Chrome 21) + // We allow this because of a bug in IE8/9 that throws an error + // whenever `document.activeElement` is accessed on an iframe + // So, we allow :focus to pass through QSA all the time to avoid the IE error + // See https://bugs.jquery.com/ticket/13378 + rbuggyQSA = []; + + if ( ( support.qsa = rnative.test( document.querySelectorAll ) ) ) { + + // Build QSA regex + // Regex strategy adopted from Diego Perini + assert( function( el ) { + + var input; + + // Select is set to empty string on purpose + // This is to test IE's treatment of not explicitly + // setting a boolean content attribute, + // since its presence should be enough + // https://bugs.jquery.com/ticket/12359 + docElem.appendChild( el ).innerHTML = "" + + ""; + + // Support: IE8, Opera 11-12.16 + // Nothing should be selected when empty strings follow ^= or $= or *= + // The test attribute must be unknown in Opera but "safe" for WinRT + // https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section + if ( el.querySelectorAll( "[msallowcapture^='']" ).length ) { + rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" ); + } + + // Support: IE8 + // Boolean attributes and "value" are not treated correctly + if ( !el.querySelectorAll( "[selected]" ).length ) { + rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" ); + } + + // Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+ + if ( !el.querySelectorAll( "[id~=" + expando + "-]" ).length ) { + rbuggyQSA.push( "~=" ); + } + + // Support: IE 11+, Edge 15 - 18+ + // IE 11/Edge don't find elements on a `[name='']` query in some cases. + // Adding a temporary attribute to the document before the selection works + // around the issue. + // Interestingly, IE 10 & older don't seem to have the issue. + input = document.createElement( "input" ); + input.setAttribute( "name", "" ); + el.appendChild( input ); + if ( !el.querySelectorAll( "[name='']" ).length ) { + rbuggyQSA.push( "\\[" + whitespace + "*name" + whitespace + "*=" + + whitespace + "*(?:''|\"\")" ); + } + + // Webkit/Opera - :checked should return selected option elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + // IE8 throws error here and will not see later tests + if ( !el.querySelectorAll( ":checked" ).length ) { + rbuggyQSA.push( ":checked" ); + } + + // Support: Safari 8+, iOS 8+ + // https://bugs.webkit.org/show_bug.cgi?id=136851 + // In-page `selector#id sibling-combinator selector` fails + if ( !el.querySelectorAll( "a#" + expando + "+*" ).length ) { + rbuggyQSA.push( ".#.+[+~]" ); + } + + // Support: Firefox <=3.6 - 5 only + // Old Firefox doesn't throw on a badly-escaped identifier. + el.querySelectorAll( "\\\f" ); + rbuggyQSA.push( "[\\r\\n\\f]" ); + } ); + + assert( function( el ) { + el.innerHTML = "" + + ""; + + // Support: Windows 8 Native Apps + // The type and name attributes are restricted during .innerHTML assignment + var input = document.createElement( "input" ); + input.setAttribute( "type", "hidden" ); + el.appendChild( input ).setAttribute( "name", "D" ); + + // Support: IE8 + // Enforce case-sensitivity of name attribute + if ( el.querySelectorAll( "[name=d]" ).length ) { + rbuggyQSA.push( "name" + whitespace + "*[*^$|!~]?=" ); + } + + // FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled) + // IE8 throws error here and will not see later tests + if ( el.querySelectorAll( ":enabled" ).length !== 2 ) { + rbuggyQSA.push( ":enabled", ":disabled" ); + } + + // Support: IE9-11+ + // IE's :disabled selector does not pick up the children of disabled fieldsets + docElem.appendChild( el ).disabled = true; + if ( el.querySelectorAll( ":disabled" ).length !== 2 ) { + rbuggyQSA.push( ":enabled", ":disabled" ); + } + + // Support: Opera 10 - 11 only + // Opera 10-11 does not throw on post-comma invalid pseudos + el.querySelectorAll( "*,:x" ); + rbuggyQSA.push( ",.*:" ); + } ); + } + + if ( ( support.matchesSelector = rnative.test( ( matches = docElem.matches || + docElem.webkitMatchesSelector || + docElem.mozMatchesSelector || + docElem.oMatchesSelector || + docElem.msMatchesSelector ) ) ) ) { + + assert( function( el ) { + + // Check to see if it's possible to do matchesSelector + // on a disconnected node (IE 9) + support.disconnectedMatch = matches.call( el, "*" ); + + // This should fail with an exception + // Gecko does not error, returns false instead + matches.call( el, "[s!='']:x" ); + rbuggyMatches.push( "!=", pseudos ); + } ); + } + + rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join( "|" ) ); + rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join( "|" ) ); + + /* Contains + ---------------------------------------------------------------------- */ + hasCompare = rnative.test( docElem.compareDocumentPosition ); + + // Element contains another + // Purposefully self-exclusive + // As in, an element does not contain itself + contains = hasCompare || rnative.test( docElem.contains ) ? + function( a, b ) { + var adown = a.nodeType === 9 ? a.documentElement : a, + bup = b && b.parentNode; + return a === bup || !!( bup && bup.nodeType === 1 && ( + adown.contains ? + adown.contains( bup ) : + a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16 + ) ); + } : + function( a, b ) { + if ( b ) { + while ( ( b = b.parentNode ) ) { + if ( b === a ) { + return true; + } + } + } + return false; + }; + + /* Sorting + ---------------------------------------------------------------------- */ + + // Document order sorting + sortOrder = hasCompare ? + function( a, b ) { + + // Flag for duplicate removal + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + // Sort on method existence if only one input has compareDocumentPosition + var compare = !a.compareDocumentPosition - !b.compareDocumentPosition; + if ( compare ) { + return compare; + } + + // Calculate position if both inputs belong to the same document + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + compare = ( a.ownerDocument || a ) == ( b.ownerDocument || b ) ? + a.compareDocumentPosition( b ) : + + // Otherwise we know they are disconnected + 1; + + // Disconnected nodes + if ( compare & 1 || + ( !support.sortDetached && b.compareDocumentPosition( a ) === compare ) ) { + + // Choose the first element that is related to our preferred document + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( a == document || a.ownerDocument == preferredDoc && + contains( preferredDoc, a ) ) { + return -1; + } + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( b == document || b.ownerDocument == preferredDoc && + contains( preferredDoc, b ) ) { + return 1; + } + + // Maintain original order + return sortInput ? + ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : + 0; + } + + return compare & 4 ? -1 : 1; + } : + function( a, b ) { + + // Exit early if the nodes are identical + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + var cur, + i = 0, + aup = a.parentNode, + bup = b.parentNode, + ap = [ a ], + bp = [ b ]; + + // Parentless nodes are either documents or disconnected + if ( !aup || !bup ) { + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + /* eslint-disable eqeqeq */ + return a == document ? -1 : + b == document ? 1 : + /* eslint-enable eqeqeq */ + aup ? -1 : + bup ? 1 : + sortInput ? + ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : + 0; + + // If the nodes are siblings, we can do a quick check + } else if ( aup === bup ) { + return siblingCheck( a, b ); + } + + // Otherwise we need full lists of their ancestors for comparison + cur = a; + while ( ( cur = cur.parentNode ) ) { + ap.unshift( cur ); + } + cur = b; + while ( ( cur = cur.parentNode ) ) { + bp.unshift( cur ); + } + + // Walk down the tree looking for a discrepancy + while ( ap[ i ] === bp[ i ] ) { + i++; + } + + return i ? + + // Do a sibling check if the nodes have a common ancestor + siblingCheck( ap[ i ], bp[ i ] ) : + + // Otherwise nodes in our document sort first + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + /* eslint-disable eqeqeq */ + ap[ i ] == preferredDoc ? -1 : + bp[ i ] == preferredDoc ? 1 : + /* eslint-enable eqeqeq */ + 0; + }; + + return document; +}; + +Sizzle.matches = function( expr, elements ) { + return Sizzle( expr, null, null, elements ); +}; + +Sizzle.matchesSelector = function( elem, expr ) { + setDocument( elem ); + + if ( support.matchesSelector && documentIsHTML && + !nonnativeSelectorCache[ expr + " " ] && + ( !rbuggyMatches || !rbuggyMatches.test( expr ) ) && + ( !rbuggyQSA || !rbuggyQSA.test( expr ) ) ) { + + try { + var ret = matches.call( elem, expr ); + + // IE 9's matchesSelector returns false on disconnected nodes + if ( ret || support.disconnectedMatch || + + // As well, disconnected nodes are said to be in a document + // fragment in IE 9 + elem.document && elem.document.nodeType !== 11 ) { + return ret; + } + } catch ( e ) { + nonnativeSelectorCache( expr, true ); + } + } + + return Sizzle( expr, document, null, [ elem ] ).length > 0; +}; + +Sizzle.contains = function( context, elem ) { + + // Set document vars if needed + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( ( context.ownerDocument || context ) != document ) { + setDocument( context ); + } + return contains( context, elem ); +}; + +Sizzle.attr = function( elem, name ) { + + // Set document vars if needed + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( ( elem.ownerDocument || elem ) != document ) { + setDocument( elem ); + } + + var fn = Expr.attrHandle[ name.toLowerCase() ], + + // Don't get fooled by Object.prototype properties (jQuery #13807) + val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ? + fn( elem, name, !documentIsHTML ) : + undefined; + + return val !== undefined ? + val : + support.attributes || !documentIsHTML ? + elem.getAttribute( name ) : + ( val = elem.getAttributeNode( name ) ) && val.specified ? + val.value : + null; +}; + +Sizzle.escape = function( sel ) { + return ( sel + "" ).replace( rcssescape, fcssescape ); +}; + +Sizzle.error = function( msg ) { + throw new Error( "Syntax error, unrecognized expression: " + msg ); +}; + +/** + * Document sorting and removing duplicates + * @param {ArrayLike} results + */ +Sizzle.uniqueSort = function( results ) { + var elem, + duplicates = [], + j = 0, + i = 0; + + // Unless we *know* we can detect duplicates, assume their presence + hasDuplicate = !support.detectDuplicates; + sortInput = !support.sortStable && results.slice( 0 ); + results.sort( sortOrder ); + + if ( hasDuplicate ) { + while ( ( elem = results[ i++ ] ) ) { + if ( elem === results[ i ] ) { + j = duplicates.push( i ); + } + } + while ( j-- ) { + results.splice( duplicates[ j ], 1 ); + } + } + + // Clear input after sorting to release objects + // See https://github.com/jquery/sizzle/pull/225 + sortInput = null; + + return results; +}; + +/** + * Utility function for retrieving the text value of an array of DOM nodes + * @param {Array|Element} elem + */ +getText = Sizzle.getText = function( elem ) { + var node, + ret = "", + i = 0, + nodeType = elem.nodeType; + + if ( !nodeType ) { + + // If no nodeType, this is expected to be an array + while ( ( node = elem[ i++ ] ) ) { + + // Do not traverse comment nodes + ret += getText( node ); + } + } else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) { + + // Use textContent for elements + // innerText usage removed for consistency of new lines (jQuery #11153) + if ( typeof elem.textContent === "string" ) { + return elem.textContent; + } else { + + // Traverse its children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + ret += getText( elem ); + } + } + } else if ( nodeType === 3 || nodeType === 4 ) { + return elem.nodeValue; + } + + // Do not include comment or processing instruction nodes + + return ret; +}; + +Expr = Sizzle.selectors = { + + // Can be adjusted by the user + cacheLength: 50, + + createPseudo: markFunction, + + match: matchExpr, + + attrHandle: {}, + + find: {}, + + relative: { + ">": { dir: "parentNode", first: true }, + " ": { dir: "parentNode" }, + "+": { dir: "previousSibling", first: true }, + "~": { dir: "previousSibling" } + }, + + preFilter: { + "ATTR": function( match ) { + match[ 1 ] = match[ 1 ].replace( runescape, funescape ); + + // Move the given value to match[3] whether quoted or unquoted + match[ 3 ] = ( match[ 3 ] || match[ 4 ] || + match[ 5 ] || "" ).replace( runescape, funescape ); + + if ( match[ 2 ] === "~=" ) { + match[ 3 ] = " " + match[ 3 ] + " "; + } + + return match.slice( 0, 4 ); + }, + + "CHILD": function( match ) { + + /* matches from matchExpr["CHILD"] + 1 type (only|nth|...) + 2 what (child|of-type) + 3 argument (even|odd|\d*|\d*n([+-]\d+)?|...) + 4 xn-component of xn+y argument ([+-]?\d*n|) + 5 sign of xn-component + 6 x of xn-component + 7 sign of y-component + 8 y of y-component + */ + match[ 1 ] = match[ 1 ].toLowerCase(); + + if ( match[ 1 ].slice( 0, 3 ) === "nth" ) { + + // nth-* requires argument + if ( !match[ 3 ] ) { + Sizzle.error( match[ 0 ] ); + } + + // numeric x and y parameters for Expr.filter.CHILD + // remember that false/true cast respectively to 0/1 + match[ 4 ] = +( match[ 4 ] ? + match[ 5 ] + ( match[ 6 ] || 1 ) : + 2 * ( match[ 3 ] === "even" || match[ 3 ] === "odd" ) ); + match[ 5 ] = +( ( match[ 7 ] + match[ 8 ] ) || match[ 3 ] === "odd" ); + + // other types prohibit arguments + } else if ( match[ 3 ] ) { + Sizzle.error( match[ 0 ] ); + } + + return match; + }, + + "PSEUDO": function( match ) { + var excess, + unquoted = !match[ 6 ] && match[ 2 ]; + + if ( matchExpr[ "CHILD" ].test( match[ 0 ] ) ) { + return null; + } + + // Accept quoted arguments as-is + if ( match[ 3 ] ) { + match[ 2 ] = match[ 4 ] || match[ 5 ] || ""; + + // Strip excess characters from unquoted arguments + } else if ( unquoted && rpseudo.test( unquoted ) && + + // Get excess from tokenize (recursively) + ( excess = tokenize( unquoted, true ) ) && + + // advance to the next closing parenthesis + ( excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length ) ) { + + // excess is a negative index + match[ 0 ] = match[ 0 ].slice( 0, excess ); + match[ 2 ] = unquoted.slice( 0, excess ); + } + + // Return only captures needed by the pseudo filter method (type and argument) + return match.slice( 0, 3 ); + } + }, + + filter: { + + "TAG": function( nodeNameSelector ) { + var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase(); + return nodeNameSelector === "*" ? + function() { + return true; + } : + function( elem ) { + return elem.nodeName && elem.nodeName.toLowerCase() === nodeName; + }; + }, + + "CLASS": function( className ) { + var pattern = classCache[ className + " " ]; + + return pattern || + ( pattern = new RegExp( "(^|" + whitespace + + ")" + className + "(" + whitespace + "|$)" ) ) && classCache( + className, function( elem ) { + return pattern.test( + typeof elem.className === "string" && elem.className || + typeof elem.getAttribute !== "undefined" && + elem.getAttribute( "class" ) || + "" + ); + } ); + }, + + "ATTR": function( name, operator, check ) { + return function( elem ) { + var result = Sizzle.attr( elem, name ); + + if ( result == null ) { + return operator === "!="; + } + if ( !operator ) { + return true; + } + + result += ""; + + /* eslint-disable max-len */ + + return operator === "=" ? result === check : + operator === "!=" ? result !== check : + operator === "^=" ? check && result.indexOf( check ) === 0 : + operator === "*=" ? check && result.indexOf( check ) > -1 : + operator === "$=" ? check && result.slice( -check.length ) === check : + operator === "~=" ? ( " " + result.replace( rwhitespace, " " ) + " " ).indexOf( check ) > -1 : + operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" : + false; + /* eslint-enable max-len */ + + }; + }, + + "CHILD": function( type, what, _argument, first, last ) { + var simple = type.slice( 0, 3 ) !== "nth", + forward = type.slice( -4 ) !== "last", + ofType = what === "of-type"; + + return first === 1 && last === 0 ? + + // Shortcut for :nth-*(n) + function( elem ) { + return !!elem.parentNode; + } : + + function( elem, _context, xml ) { + var cache, uniqueCache, outerCache, node, nodeIndex, start, + dir = simple !== forward ? "nextSibling" : "previousSibling", + parent = elem.parentNode, + name = ofType && elem.nodeName.toLowerCase(), + useCache = !xml && !ofType, + diff = false; + + if ( parent ) { + + // :(first|last|only)-(child|of-type) + if ( simple ) { + while ( dir ) { + node = elem; + while ( ( node = node[ dir ] ) ) { + if ( ofType ? + node.nodeName.toLowerCase() === name : + node.nodeType === 1 ) { + + return false; + } + } + + // Reverse direction for :only-* (if we haven't yet done so) + start = dir = type === "only" && !start && "nextSibling"; + } + return true; + } + + start = [ forward ? parent.firstChild : parent.lastChild ]; + + // non-xml :nth-child(...) stores cache data on `parent` + if ( forward && useCache ) { + + // Seek `elem` from a previously-cached index + + // ...in a gzip-friendly way + node = parent; + outerCache = node[ expando ] || ( node[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + ( outerCache[ node.uniqueID ] = {} ); + + cache = uniqueCache[ type ] || []; + nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; + diff = nodeIndex && cache[ 2 ]; + node = nodeIndex && parent.childNodes[ nodeIndex ]; + + while ( ( node = ++nodeIndex && node && node[ dir ] || + + // Fallback to seeking `elem` from the start + ( diff = nodeIndex = 0 ) || start.pop() ) ) { + + // When found, cache indexes on `parent` and break + if ( node.nodeType === 1 && ++diff && node === elem ) { + uniqueCache[ type ] = [ dirruns, nodeIndex, diff ]; + break; + } + } + + } else { + + // Use previously-cached element index if available + if ( useCache ) { + + // ...in a gzip-friendly way + node = elem; + outerCache = node[ expando ] || ( node[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + ( outerCache[ node.uniqueID ] = {} ); + + cache = uniqueCache[ type ] || []; + nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; + diff = nodeIndex; + } + + // xml :nth-child(...) + // or :nth-last-child(...) or :nth(-last)?-of-type(...) + if ( diff === false ) { + + // Use the same loop as above to seek `elem` from the start + while ( ( node = ++nodeIndex && node && node[ dir ] || + ( diff = nodeIndex = 0 ) || start.pop() ) ) { + + if ( ( ofType ? + node.nodeName.toLowerCase() === name : + node.nodeType === 1 ) && + ++diff ) { + + // Cache the index of each encountered element + if ( useCache ) { + outerCache = node[ expando ] || + ( node[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + ( outerCache[ node.uniqueID ] = {} ); + + uniqueCache[ type ] = [ dirruns, diff ]; + } + + if ( node === elem ) { + break; + } + } + } + } + } + + // Incorporate the offset, then check against cycle size + diff -= last; + return diff === first || ( diff % first === 0 && diff / first >= 0 ); + } + }; + }, + + "PSEUDO": function( pseudo, argument ) { + + // pseudo-class names are case-insensitive + // http://www.w3.org/TR/selectors/#pseudo-classes + // Prioritize by case sensitivity in case custom pseudos are added with uppercase letters + // Remember that setFilters inherits from pseudos + var args, + fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] || + Sizzle.error( "unsupported pseudo: " + pseudo ); + + // The user may use createPseudo to indicate that + // arguments are needed to create the filter function + // just as Sizzle does + if ( fn[ expando ] ) { + return fn( argument ); + } + + // But maintain support for old signatures + if ( fn.length > 1 ) { + args = [ pseudo, pseudo, "", argument ]; + return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ? + markFunction( function( seed, matches ) { + var idx, + matched = fn( seed, argument ), + i = matched.length; + while ( i-- ) { + idx = indexOf( seed, matched[ i ] ); + seed[ idx ] = !( matches[ idx ] = matched[ i ] ); + } + } ) : + function( elem ) { + return fn( elem, 0, args ); + }; + } + + return fn; + } + }, + + pseudos: { + + // Potentially complex pseudos + "not": markFunction( function( selector ) { + + // Trim the selector passed to compile + // to avoid treating leading and trailing + // spaces as combinators + var input = [], + results = [], + matcher = compile( selector.replace( rtrim, "$1" ) ); + + return matcher[ expando ] ? + markFunction( function( seed, matches, _context, xml ) { + var elem, + unmatched = matcher( seed, null, xml, [] ), + i = seed.length; + + // Match elements unmatched by `matcher` + while ( i-- ) { + if ( ( elem = unmatched[ i ] ) ) { + seed[ i ] = !( matches[ i ] = elem ); + } + } + } ) : + function( elem, _context, xml ) { + input[ 0 ] = elem; + matcher( input, null, xml, results ); + + // Don't keep the element (issue #299) + input[ 0 ] = null; + return !results.pop(); + }; + } ), + + "has": markFunction( function( selector ) { + return function( elem ) { + return Sizzle( selector, elem ).length > 0; + }; + } ), + + "contains": markFunction( function( text ) { + text = text.replace( runescape, funescape ); + return function( elem ) { + return ( elem.textContent || getText( elem ) ).indexOf( text ) > -1; + }; + } ), + + // "Whether an element is represented by a :lang() selector + // is based solely on the element's language value + // being equal to the identifier C, + // or beginning with the identifier C immediately followed by "-". + // The matching of C against the element's language value is performed case-insensitively. + // The identifier C does not have to be a valid language name." + // http://www.w3.org/TR/selectors/#lang-pseudo + "lang": markFunction( function( lang ) { + + // lang value must be a valid identifier + if ( !ridentifier.test( lang || "" ) ) { + Sizzle.error( "unsupported lang: " + lang ); + } + lang = lang.replace( runescape, funescape ).toLowerCase(); + return function( elem ) { + var elemLang; + do { + if ( ( elemLang = documentIsHTML ? + elem.lang : + elem.getAttribute( "xml:lang" ) || elem.getAttribute( "lang" ) ) ) { + + elemLang = elemLang.toLowerCase(); + return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0; + } + } while ( ( elem = elem.parentNode ) && elem.nodeType === 1 ); + return false; + }; + } ), + + // Miscellaneous + "target": function( elem ) { + var hash = window.location && window.location.hash; + return hash && hash.slice( 1 ) === elem.id; + }, + + "root": function( elem ) { + return elem === docElem; + }, + + "focus": function( elem ) { + return elem === document.activeElement && + ( !document.hasFocus || document.hasFocus() ) && + !!( elem.type || elem.href || ~elem.tabIndex ); + }, + + // Boolean properties + "enabled": createDisabledPseudo( false ), + "disabled": createDisabledPseudo( true ), + + "checked": function( elem ) { + + // In CSS3, :checked should return both checked and selected elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + var nodeName = elem.nodeName.toLowerCase(); + return ( nodeName === "input" && !!elem.checked ) || + ( nodeName === "option" && !!elem.selected ); + }, + + "selected": function( elem ) { + + // Accessing this property makes selected-by-default + // options in Safari work properly + if ( elem.parentNode ) { + // eslint-disable-next-line no-unused-expressions + elem.parentNode.selectedIndex; + } + + return elem.selected === true; + }, + + // Contents + "empty": function( elem ) { + + // http://www.w3.org/TR/selectors/#empty-pseudo + // :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5), + // but not by others (comment: 8; processing instruction: 7; etc.) + // nodeType < 6 works because attributes (2) do not appear as children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + if ( elem.nodeType < 6 ) { + return false; + } + } + return true; + }, + + "parent": function( elem ) { + return !Expr.pseudos[ "empty" ]( elem ); + }, + + // Element/input types + "header": function( elem ) { + return rheader.test( elem.nodeName ); + }, + + "input": function( elem ) { + return rinputs.test( elem.nodeName ); + }, + + "button": function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === "button" || name === "button"; + }, + + "text": function( elem ) { + var attr; + return elem.nodeName.toLowerCase() === "input" && + elem.type === "text" && + + // Support: IE<8 + // New HTML5 attribute values (e.g., "search") appear with elem.type === "text" + ( ( attr = elem.getAttribute( "type" ) ) == null || + attr.toLowerCase() === "text" ); + }, + + // Position-in-collection + "first": createPositionalPseudo( function() { + return [ 0 ]; + } ), + + "last": createPositionalPseudo( function( _matchIndexes, length ) { + return [ length - 1 ]; + } ), + + "eq": createPositionalPseudo( function( _matchIndexes, length, argument ) { + return [ argument < 0 ? argument + length : argument ]; + } ), + + "even": createPositionalPseudo( function( matchIndexes, length ) { + var i = 0; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ), + + "odd": createPositionalPseudo( function( matchIndexes, length ) { + var i = 1; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ), + + "lt": createPositionalPseudo( function( matchIndexes, length, argument ) { + var i = argument < 0 ? + argument + length : + argument > length ? + length : + argument; + for ( ; --i >= 0; ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ), + + "gt": createPositionalPseudo( function( matchIndexes, length, argument ) { + var i = argument < 0 ? argument + length : argument; + for ( ; ++i < length; ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ) + } +}; + +Expr.pseudos[ "nth" ] = Expr.pseudos[ "eq" ]; + +// Add button/input type pseudos +for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) { + Expr.pseudos[ i ] = createInputPseudo( i ); +} +for ( i in { submit: true, reset: true } ) { + Expr.pseudos[ i ] = createButtonPseudo( i ); +} + +// Easy API for creating new setFilters +function setFilters() {} +setFilters.prototype = Expr.filters = Expr.pseudos; +Expr.setFilters = new setFilters(); + +tokenize = Sizzle.tokenize = function( selector, parseOnly ) { + var matched, match, tokens, type, + soFar, groups, preFilters, + cached = tokenCache[ selector + " " ]; + + if ( cached ) { + return parseOnly ? 0 : cached.slice( 0 ); + } + + soFar = selector; + groups = []; + preFilters = Expr.preFilter; + + while ( soFar ) { + + // Comma and first run + if ( !matched || ( match = rcomma.exec( soFar ) ) ) { + if ( match ) { + + // Don't consume trailing commas as valid + soFar = soFar.slice( match[ 0 ].length ) || soFar; + } + groups.push( ( tokens = [] ) ); + } + + matched = false; + + // Combinators + if ( ( match = rcombinators.exec( soFar ) ) ) { + matched = match.shift(); + tokens.push( { + value: matched, + + // Cast descendant combinators to space + type: match[ 0 ].replace( rtrim, " " ) + } ); + soFar = soFar.slice( matched.length ); + } + + // Filters + for ( type in Expr.filter ) { + if ( ( match = matchExpr[ type ].exec( soFar ) ) && ( !preFilters[ type ] || + ( match = preFilters[ type ]( match ) ) ) ) { + matched = match.shift(); + tokens.push( { + value: matched, + type: type, + matches: match + } ); + soFar = soFar.slice( matched.length ); + } + } + + if ( !matched ) { + break; + } + } + + // Return the length of the invalid excess + // if we're just parsing + // Otherwise, throw an error or return tokens + return parseOnly ? + soFar.length : + soFar ? + Sizzle.error( selector ) : + + // Cache the tokens + tokenCache( selector, groups ).slice( 0 ); +}; + +function toSelector( tokens ) { + var i = 0, + len = tokens.length, + selector = ""; + for ( ; i < len; i++ ) { + selector += tokens[ i ].value; + } + return selector; +} + +function addCombinator( matcher, combinator, base ) { + var dir = combinator.dir, + skip = combinator.next, + key = skip || dir, + checkNonElements = base && key === "parentNode", + doneName = done++; + + return combinator.first ? + + // Check against closest ancestor/preceding element + function( elem, context, xml ) { + while ( ( elem = elem[ dir ] ) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + return matcher( elem, context, xml ); + } + } + return false; + } : + + // Check against all ancestor/preceding elements + function( elem, context, xml ) { + var oldCache, uniqueCache, outerCache, + newCache = [ dirruns, doneName ]; + + // We can't set arbitrary data on XML nodes, so they don't benefit from combinator caching + if ( xml ) { + while ( ( elem = elem[ dir ] ) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + if ( matcher( elem, context, xml ) ) { + return true; + } + } + } + } else { + while ( ( elem = elem[ dir ] ) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + outerCache = elem[ expando ] || ( elem[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ elem.uniqueID ] || + ( outerCache[ elem.uniqueID ] = {} ); + + if ( skip && skip === elem.nodeName.toLowerCase() ) { + elem = elem[ dir ] || elem; + } else if ( ( oldCache = uniqueCache[ key ] ) && + oldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) { + + // Assign to newCache so results back-propagate to previous elements + return ( newCache[ 2 ] = oldCache[ 2 ] ); + } else { + + // Reuse newcache so results back-propagate to previous elements + uniqueCache[ key ] = newCache; + + // A match means we're done; a fail means we have to keep checking + if ( ( newCache[ 2 ] = matcher( elem, context, xml ) ) ) { + return true; + } + } + } + } + } + return false; + }; +} + +function elementMatcher( matchers ) { + return matchers.length > 1 ? + function( elem, context, xml ) { + var i = matchers.length; + while ( i-- ) { + if ( !matchers[ i ]( elem, context, xml ) ) { + return false; + } + } + return true; + } : + matchers[ 0 ]; +} + +function multipleContexts( selector, contexts, results ) { + var i = 0, + len = contexts.length; + for ( ; i < len; i++ ) { + Sizzle( selector, contexts[ i ], results ); + } + return results; +} + +function condense( unmatched, map, filter, context, xml ) { + var elem, + newUnmatched = [], + i = 0, + len = unmatched.length, + mapped = map != null; + + for ( ; i < len; i++ ) { + if ( ( elem = unmatched[ i ] ) ) { + if ( !filter || filter( elem, context, xml ) ) { + newUnmatched.push( elem ); + if ( mapped ) { + map.push( i ); + } + } + } + } + + return newUnmatched; +} + +function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) { + if ( postFilter && !postFilter[ expando ] ) { + postFilter = setMatcher( postFilter ); + } + if ( postFinder && !postFinder[ expando ] ) { + postFinder = setMatcher( postFinder, postSelector ); + } + return markFunction( function( seed, results, context, xml ) { + var temp, i, elem, + preMap = [], + postMap = [], + preexisting = results.length, + + // Get initial elements from seed or context + elems = seed || multipleContexts( + selector || "*", + context.nodeType ? [ context ] : context, + [] + ), + + // Prefilter to get matcher input, preserving a map for seed-results synchronization + matcherIn = preFilter && ( seed || !selector ) ? + condense( elems, preMap, preFilter, context, xml ) : + elems, + + matcherOut = matcher ? + + // If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results, + postFinder || ( seed ? preFilter : preexisting || postFilter ) ? + + // ...intermediate processing is necessary + [] : + + // ...otherwise use results directly + results : + matcherIn; + + // Find primary matches + if ( matcher ) { + matcher( matcherIn, matcherOut, context, xml ); + } + + // Apply postFilter + if ( postFilter ) { + temp = condense( matcherOut, postMap ); + postFilter( temp, [], context, xml ); + + // Un-match failing elements by moving them back to matcherIn + i = temp.length; + while ( i-- ) { + if ( ( elem = temp[ i ] ) ) { + matcherOut[ postMap[ i ] ] = !( matcherIn[ postMap[ i ] ] = elem ); + } + } + } + + if ( seed ) { + if ( postFinder || preFilter ) { + if ( postFinder ) { + + // Get the final matcherOut by condensing this intermediate into postFinder contexts + temp = []; + i = matcherOut.length; + while ( i-- ) { + if ( ( elem = matcherOut[ i ] ) ) { + + // Restore matcherIn since elem is not yet a final match + temp.push( ( matcherIn[ i ] = elem ) ); + } + } + postFinder( null, ( matcherOut = [] ), temp, xml ); + } + + // Move matched elements from seed to results to keep them synchronized + i = matcherOut.length; + while ( i-- ) { + if ( ( elem = matcherOut[ i ] ) && + ( temp = postFinder ? indexOf( seed, elem ) : preMap[ i ] ) > -1 ) { + + seed[ temp ] = !( results[ temp ] = elem ); + } + } + } + + // Add elements to results, through postFinder if defined + } else { + matcherOut = condense( + matcherOut === results ? + matcherOut.splice( preexisting, matcherOut.length ) : + matcherOut + ); + if ( postFinder ) { + postFinder( null, results, matcherOut, xml ); + } else { + push.apply( results, matcherOut ); + } + } + } ); +} + +function matcherFromTokens( tokens ) { + var checkContext, matcher, j, + len = tokens.length, + leadingRelative = Expr.relative[ tokens[ 0 ].type ], + implicitRelative = leadingRelative || Expr.relative[ " " ], + i = leadingRelative ? 1 : 0, + + // The foundational matcher ensures that elements are reachable from top-level context(s) + matchContext = addCombinator( function( elem ) { + return elem === checkContext; + }, implicitRelative, true ), + matchAnyContext = addCombinator( function( elem ) { + return indexOf( checkContext, elem ) > -1; + }, implicitRelative, true ), + matchers = [ function( elem, context, xml ) { + var ret = ( !leadingRelative && ( xml || context !== outermostContext ) ) || ( + ( checkContext = context ).nodeType ? + matchContext( elem, context, xml ) : + matchAnyContext( elem, context, xml ) ); + + // Avoid hanging onto element (issue #299) + checkContext = null; + return ret; + } ]; + + for ( ; i < len; i++ ) { + if ( ( matcher = Expr.relative[ tokens[ i ].type ] ) ) { + matchers = [ addCombinator( elementMatcher( matchers ), matcher ) ]; + } else { + matcher = Expr.filter[ tokens[ i ].type ].apply( null, tokens[ i ].matches ); + + // Return special upon seeing a positional matcher + if ( matcher[ expando ] ) { + + // Find the next relative operator (if any) for proper handling + j = ++i; + for ( ; j < len; j++ ) { + if ( Expr.relative[ tokens[ j ].type ] ) { + break; + } + } + return setMatcher( + i > 1 && elementMatcher( matchers ), + i > 1 && toSelector( + + // If the preceding token was a descendant combinator, insert an implicit any-element `*` + tokens + .slice( 0, i - 1 ) + .concat( { value: tokens[ i - 2 ].type === " " ? "*" : "" } ) + ).replace( rtrim, "$1" ), + matcher, + i < j && matcherFromTokens( tokens.slice( i, j ) ), + j < len && matcherFromTokens( ( tokens = tokens.slice( j ) ) ), + j < len && toSelector( tokens ) + ); + } + matchers.push( matcher ); + } + } + + return elementMatcher( matchers ); +} + +function matcherFromGroupMatchers( elementMatchers, setMatchers ) { + var bySet = setMatchers.length > 0, + byElement = elementMatchers.length > 0, + superMatcher = function( seed, context, xml, results, outermost ) { + var elem, j, matcher, + matchedCount = 0, + i = "0", + unmatched = seed && [], + setMatched = [], + contextBackup = outermostContext, + + // We must always have either seed elements or outermost context + elems = seed || byElement && Expr.find[ "TAG" ]( "*", outermost ), + + // Use integer dirruns iff this is the outermost matcher + dirrunsUnique = ( dirruns += contextBackup == null ? 1 : Math.random() || 0.1 ), + len = elems.length; + + if ( outermost ) { + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + outermostContext = context == document || context || outermost; + } + + // Add elements passing elementMatchers directly to results + // Support: IE<9, Safari + // Tolerate NodeList properties (IE: "length"; Safari: ) matching elements by id + for ( ; i !== len && ( elem = elems[ i ] ) != null; i++ ) { + if ( byElement && elem ) { + j = 0; + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( !context && elem.ownerDocument != document ) { + setDocument( elem ); + xml = !documentIsHTML; + } + while ( ( matcher = elementMatchers[ j++ ] ) ) { + if ( matcher( elem, context || document, xml ) ) { + results.push( elem ); + break; + } + } + if ( outermost ) { + dirruns = dirrunsUnique; + } + } + + // Track unmatched elements for set filters + if ( bySet ) { + + // They will have gone through all possible matchers + if ( ( elem = !matcher && elem ) ) { + matchedCount--; + } + + // Lengthen the array for every element, matched or not + if ( seed ) { + unmatched.push( elem ); + } + } + } + + // `i` is now the count of elements visited above, and adding it to `matchedCount` + // makes the latter nonnegative. + matchedCount += i; + + // Apply set filters to unmatched elements + // NOTE: This can be skipped if there are no unmatched elements (i.e., `matchedCount` + // equals `i`), unless we didn't visit _any_ elements in the above loop because we have + // no element matchers and no seed. + // Incrementing an initially-string "0" `i` allows `i` to remain a string only in that + // case, which will result in a "00" `matchedCount` that differs from `i` but is also + // numerically zero. + if ( bySet && i !== matchedCount ) { + j = 0; + while ( ( matcher = setMatchers[ j++ ] ) ) { + matcher( unmatched, setMatched, context, xml ); + } + + if ( seed ) { + + // Reintegrate element matches to eliminate the need for sorting + if ( matchedCount > 0 ) { + while ( i-- ) { + if ( !( unmatched[ i ] || setMatched[ i ] ) ) { + setMatched[ i ] = pop.call( results ); + } + } + } + + // Discard index placeholder values to get only actual matches + setMatched = condense( setMatched ); + } + + // Add matches to results + push.apply( results, setMatched ); + + // Seedless set matches succeeding multiple successful matchers stipulate sorting + if ( outermost && !seed && setMatched.length > 0 && + ( matchedCount + setMatchers.length ) > 1 ) { + + Sizzle.uniqueSort( results ); + } + } + + // Override manipulation of globals by nested matchers + if ( outermost ) { + dirruns = dirrunsUnique; + outermostContext = contextBackup; + } + + return unmatched; + }; + + return bySet ? + markFunction( superMatcher ) : + superMatcher; +} + +compile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) { + var i, + setMatchers = [], + elementMatchers = [], + cached = compilerCache[ selector + " " ]; + + if ( !cached ) { + + // Generate a function of recursive functions that can be used to check each element + if ( !match ) { + match = tokenize( selector ); + } + i = match.length; + while ( i-- ) { + cached = matcherFromTokens( match[ i ] ); + if ( cached[ expando ] ) { + setMatchers.push( cached ); + } else { + elementMatchers.push( cached ); + } + } + + // Cache the compiled function + cached = compilerCache( + selector, + matcherFromGroupMatchers( elementMatchers, setMatchers ) + ); + + // Save selector and tokenization + cached.selector = selector; + } + return cached; +}; + +/** + * A low-level selection function that works with Sizzle's compiled + * selector functions + * @param {String|Function} selector A selector or a pre-compiled + * selector function built with Sizzle.compile + * @param {Element} context + * @param {Array} [results] + * @param {Array} [seed] A set of elements to match against + */ +select = Sizzle.select = function( selector, context, results, seed ) { + var i, tokens, token, type, find, + compiled = typeof selector === "function" && selector, + match = !seed && tokenize( ( selector = compiled.selector || selector ) ); + + results = results || []; + + // Try to minimize operations if there is only one selector in the list and no seed + // (the latter of which guarantees us context) + if ( match.length === 1 ) { + + // Reduce context if the leading compound selector is an ID + tokens = match[ 0 ] = match[ 0 ].slice( 0 ); + if ( tokens.length > 2 && ( token = tokens[ 0 ] ).type === "ID" && + context.nodeType === 9 && documentIsHTML && Expr.relative[ tokens[ 1 ].type ] ) { + + context = ( Expr.find[ "ID" ]( token.matches[ 0 ] + .replace( runescape, funescape ), context ) || [] )[ 0 ]; + if ( !context ) { + return results; + + // Precompiled matchers will still verify ancestry, so step up a level + } else if ( compiled ) { + context = context.parentNode; + } + + selector = selector.slice( tokens.shift().value.length ); + } + + // Fetch a seed set for right-to-left matching + i = matchExpr[ "needsContext" ].test( selector ) ? 0 : tokens.length; + while ( i-- ) { + token = tokens[ i ]; + + // Abort if we hit a combinator + if ( Expr.relative[ ( type = token.type ) ] ) { + break; + } + if ( ( find = Expr.find[ type ] ) ) { + + // Search, expanding context for leading sibling combinators + if ( ( seed = find( + token.matches[ 0 ].replace( runescape, funescape ), + rsibling.test( tokens[ 0 ].type ) && testContext( context.parentNode ) || + context + ) ) ) { + + // If seed is empty or no tokens remain, we can return early + tokens.splice( i, 1 ); + selector = seed.length && toSelector( tokens ); + if ( !selector ) { + push.apply( results, seed ); + return results; + } + + break; + } + } + } + } + + // Compile and execute a filtering function if one is not provided + // Provide `match` to avoid retokenization if we modified the selector above + ( compiled || compile( selector, match ) )( + seed, + context, + !documentIsHTML, + results, + !context || rsibling.test( selector ) && testContext( context.parentNode ) || context + ); + return results; +}; + +// One-time assignments + +// Sort stability +support.sortStable = expando.split( "" ).sort( sortOrder ).join( "" ) === expando; + +// Support: Chrome 14-35+ +// Always assume duplicates if they aren't passed to the comparison function +support.detectDuplicates = !!hasDuplicate; + +// Initialize against the default document +setDocument(); + +// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27) +// Detached nodes confoundingly follow *each other* +support.sortDetached = assert( function( el ) { + + // Should return 1, but returns 4 (following) + return el.compareDocumentPosition( document.createElement( "fieldset" ) ) & 1; +} ); + +// Support: IE<8 +// Prevent attribute/property "interpolation" +// https://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx +if ( !assert( function( el ) { + el.innerHTML = ""; + return el.firstChild.getAttribute( "href" ) === "#"; +} ) ) { + addHandle( "type|href|height|width", function( elem, name, isXML ) { + if ( !isXML ) { + return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 ); + } + } ); +} + +// Support: IE<9 +// Use defaultValue in place of getAttribute("value") +if ( !support.attributes || !assert( function( el ) { + el.innerHTML = ""; + el.firstChild.setAttribute( "value", "" ); + return el.firstChild.getAttribute( "value" ) === ""; +} ) ) { + addHandle( "value", function( elem, _name, isXML ) { + if ( !isXML && elem.nodeName.toLowerCase() === "input" ) { + return elem.defaultValue; + } + } ); +} + +// Support: IE<9 +// Use getAttributeNode to fetch booleans when getAttribute lies +if ( !assert( function( el ) { + return el.getAttribute( "disabled" ) == null; +} ) ) { + addHandle( booleans, function( elem, name, isXML ) { + var val; + if ( !isXML ) { + return elem[ name ] === true ? name.toLowerCase() : + ( val = elem.getAttributeNode( name ) ) && val.specified ? + val.value : + null; + } + } ); +} + +return Sizzle; + +} )( window ); + + + +jQuery.find = Sizzle; +jQuery.expr = Sizzle.selectors; + +// Deprecated +jQuery.expr[ ":" ] = jQuery.expr.pseudos; +jQuery.uniqueSort = jQuery.unique = Sizzle.uniqueSort; +jQuery.text = Sizzle.getText; +jQuery.isXMLDoc = Sizzle.isXML; +jQuery.contains = Sizzle.contains; +jQuery.escapeSelector = Sizzle.escape; + + + + +var dir = function( elem, dir, until ) { + var matched = [], + truncate = until !== undefined; + + while ( ( elem = elem[ dir ] ) && elem.nodeType !== 9 ) { + if ( elem.nodeType === 1 ) { + if ( truncate && jQuery( elem ).is( until ) ) { + break; + } + matched.push( elem ); + } + } + return matched; +}; + + +var siblings = function( n, elem ) { + var matched = []; + + for ( ; n; n = n.nextSibling ) { + if ( n.nodeType === 1 && n !== elem ) { + matched.push( n ); + } + } + + return matched; +}; + + +var rneedsContext = jQuery.expr.match.needsContext; + + + +function nodeName( elem, name ) { + + return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase(); + +}; +var rsingleTag = ( /^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i ); + + + +// Implement the identical functionality for filter and not +function winnow( elements, qualifier, not ) { + if ( isFunction( qualifier ) ) { + return jQuery.grep( elements, function( elem, i ) { + return !!qualifier.call( elem, i, elem ) !== not; + } ); + } + + // Single element + if ( qualifier.nodeType ) { + return jQuery.grep( elements, function( elem ) { + return ( elem === qualifier ) !== not; + } ); + } + + // Arraylike of elements (jQuery, arguments, Array) + if ( typeof qualifier !== "string" ) { + return jQuery.grep( elements, function( elem ) { + return ( indexOf.call( qualifier, elem ) > -1 ) !== not; + } ); + } + + // Filtered directly for both simple and complex selectors + return jQuery.filter( qualifier, elements, not ); +} + +jQuery.filter = function( expr, elems, not ) { + var elem = elems[ 0 ]; + + if ( not ) { + expr = ":not(" + expr + ")"; + } + + if ( elems.length === 1 && elem.nodeType === 1 ) { + return jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : []; + } + + return jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) { + return elem.nodeType === 1; + } ) ); +}; + +jQuery.fn.extend( { + find: function( selector ) { + var i, ret, + len = this.length, + self = this; + + if ( typeof selector !== "string" ) { + return this.pushStack( jQuery( selector ).filter( function() { + for ( i = 0; i < len; i++ ) { + if ( jQuery.contains( self[ i ], this ) ) { + return true; + } + } + } ) ); + } + + ret = this.pushStack( [] ); + + for ( i = 0; i < len; i++ ) { + jQuery.find( selector, self[ i ], ret ); + } + + return len > 1 ? jQuery.uniqueSort( ret ) : ret; + }, + filter: function( selector ) { + return this.pushStack( winnow( this, selector || [], false ) ); + }, + not: function( selector ) { + return this.pushStack( winnow( this, selector || [], true ) ); + }, + is: function( selector ) { + return !!winnow( + this, + + // If this is a positional/relative selector, check membership in the returned set + // so $("p:first").is("p:last") won't return true for a doc with two "p". + typeof selector === "string" && rneedsContext.test( selector ) ? + jQuery( selector ) : + selector || [], + false + ).length; + } +} ); + + +// Initialize a jQuery object + + +// A central reference to the root jQuery(document) +var rootjQuery, + + // A simple way to check for HTML strings + // Prioritize #id over to avoid XSS via location.hash (#9521) + // Strict HTML recognition (#11290: must start with <) + // Shortcut simple #id case for speed + rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/, + + init = jQuery.fn.init = function( selector, context, root ) { + var match, elem; + + // HANDLE: $(""), $(null), $(undefined), $(false) + if ( !selector ) { + return this; + } + + // Method init() accepts an alternate rootjQuery + // so migrate can support jQuery.sub (gh-2101) + root = root || rootjQuery; + + // Handle HTML strings + if ( typeof selector === "string" ) { + if ( selector[ 0 ] === "<" && + selector[ selector.length - 1 ] === ">" && + selector.length >= 3 ) { + + // Assume that strings that start and end with <> are HTML and skip the regex check + match = [ null, selector, null ]; + + } else { + match = rquickExpr.exec( selector ); + } + + // Match html or make sure no context is specified for #id + if ( match && ( match[ 1 ] || !context ) ) { + + // HANDLE: $(html) -> $(array) + if ( match[ 1 ] ) { + context = context instanceof jQuery ? context[ 0 ] : context; + + // Option to run scripts is true for back-compat + // Intentionally let the error be thrown if parseHTML is not present + jQuery.merge( this, jQuery.parseHTML( + match[ 1 ], + context && context.nodeType ? context.ownerDocument || context : document, + true + ) ); + + // HANDLE: $(html, props) + if ( rsingleTag.test( match[ 1 ] ) && jQuery.isPlainObject( context ) ) { + for ( match in context ) { + + // Properties of context are called as methods if possible + if ( isFunction( this[ match ] ) ) { + this[ match ]( context[ match ] ); + + // ...and otherwise set as attributes + } else { + this.attr( match, context[ match ] ); + } + } + } + + return this; + + // HANDLE: $(#id) + } else { + elem = document.getElementById( match[ 2 ] ); + + if ( elem ) { + + // Inject the element directly into the jQuery object + this[ 0 ] = elem; + this.length = 1; + } + return this; + } + + // HANDLE: $(expr, $(...)) + } else if ( !context || context.jquery ) { + return ( context || root ).find( selector ); + + // HANDLE: $(expr, context) + // (which is just equivalent to: $(context).find(expr) + } else { + return this.constructor( context ).find( selector ); + } + + // HANDLE: $(DOMElement) + } else if ( selector.nodeType ) { + this[ 0 ] = selector; + this.length = 1; + return this; + + // HANDLE: $(function) + // Shortcut for document ready + } else if ( isFunction( selector ) ) { + return root.ready !== undefined ? + root.ready( selector ) : + + // Execute immediately if ready is not present + selector( jQuery ); + } + + return jQuery.makeArray( selector, this ); + }; + +// Give the init function the jQuery prototype for later instantiation +init.prototype = jQuery.fn; + +// Initialize central reference +rootjQuery = jQuery( document ); + + +var rparentsprev = /^(?:parents|prev(?:Until|All))/, + + // Methods guaranteed to produce a unique set when starting from a unique set + guaranteedUnique = { + children: true, + contents: true, + next: true, + prev: true + }; + +jQuery.fn.extend( { + has: function( target ) { + var targets = jQuery( target, this ), + l = targets.length; + + return this.filter( function() { + var i = 0; + for ( ; i < l; i++ ) { + if ( jQuery.contains( this, targets[ i ] ) ) { + return true; + } + } + } ); + }, + + closest: function( selectors, context ) { + var cur, + i = 0, + l = this.length, + matched = [], + targets = typeof selectors !== "string" && jQuery( selectors ); + + // Positional selectors never match, since there's no _selection_ context + if ( !rneedsContext.test( selectors ) ) { + for ( ; i < l; i++ ) { + for ( cur = this[ i ]; cur && cur !== context; cur = cur.parentNode ) { + + // Always skip document fragments + if ( cur.nodeType < 11 && ( targets ? + targets.index( cur ) > -1 : + + // Don't pass non-elements to Sizzle + cur.nodeType === 1 && + jQuery.find.matchesSelector( cur, selectors ) ) ) { + + matched.push( cur ); + break; + } + } + } + } + + return this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched ); + }, + + // Determine the position of an element within the set + index: function( elem ) { + + // No argument, return index in parent + if ( !elem ) { + return ( this[ 0 ] && this[ 0 ].parentNode ) ? this.first().prevAll().length : -1; + } + + // Index in selector + if ( typeof elem === "string" ) { + return indexOf.call( jQuery( elem ), this[ 0 ] ); + } + + // Locate the position of the desired element + return indexOf.call( this, + + // If it receives a jQuery object, the first element is used + elem.jquery ? elem[ 0 ] : elem + ); + }, + + add: function( selector, context ) { + return this.pushStack( + jQuery.uniqueSort( + jQuery.merge( this.get(), jQuery( selector, context ) ) + ) + ); + }, + + addBack: function( selector ) { + return this.add( selector == null ? + this.prevObject : this.prevObject.filter( selector ) + ); + } +} ); + +function sibling( cur, dir ) { + while ( ( cur = cur[ dir ] ) && cur.nodeType !== 1 ) {} + return cur; +} + +jQuery.each( { + parent: function( elem ) { + var parent = elem.parentNode; + return parent && parent.nodeType !== 11 ? parent : null; + }, + parents: function( elem ) { + return dir( elem, "parentNode" ); + }, + parentsUntil: function( elem, _i, until ) { + return dir( elem, "parentNode", until ); + }, + next: function( elem ) { + return sibling( elem, "nextSibling" ); + }, + prev: function( elem ) { + return sibling( elem, "previousSibling" ); + }, + nextAll: function( elem ) { + return dir( elem, "nextSibling" ); + }, + prevAll: function( elem ) { + return dir( elem, "previousSibling" ); + }, + nextUntil: function( elem, _i, until ) { + return dir( elem, "nextSibling", until ); + }, + prevUntil: function( elem, _i, until ) { + return dir( elem, "previousSibling", until ); + }, + siblings: function( elem ) { + return siblings( ( elem.parentNode || {} ).firstChild, elem ); + }, + children: function( elem ) { + return siblings( elem.firstChild ); + }, + contents: function( elem ) { + if ( elem.contentDocument != null && + + // Support: IE 11+ + // elements with no `data` attribute has an object + // `contentDocument` with a `null` prototype. + getProto( elem.contentDocument ) ) { + + return elem.contentDocument; + } + + // Support: IE 9 - 11 only, iOS 7 only, Android Browser <=4.3 only + // Treat the template element as a regular one in browsers that + // don't support it. + if ( nodeName( elem, "template" ) ) { + elem = elem.content || elem; + } + + return jQuery.merge( [], elem.childNodes ); + } +}, function( name, fn ) { + jQuery.fn[ name ] = function( until, selector ) { + var matched = jQuery.map( this, fn, until ); + + if ( name.slice( -5 ) !== "Until" ) { + selector = until; + } + + if ( selector && typeof selector === "string" ) { + matched = jQuery.filter( selector, matched ); + } + + if ( this.length > 1 ) { + + // Remove duplicates + if ( !guaranteedUnique[ name ] ) { + jQuery.uniqueSort( matched ); + } + + // Reverse order for parents* and prev-derivatives + if ( rparentsprev.test( name ) ) { + matched.reverse(); + } + } + + return this.pushStack( matched ); + }; +} ); +var rnothtmlwhite = ( /[^\x20\t\r\n\f]+/g ); + + + +// Convert String-formatted options into Object-formatted ones +function createOptions( options ) { + var object = {}; + jQuery.each( options.match( rnothtmlwhite ) || [], function( _, flag ) { + object[ flag ] = true; + } ); + return object; +} + +/* + * Create a callback list using the following parameters: + * + * options: an optional list of space-separated options that will change how + * the callback list behaves or a more traditional option object + * + * By default a callback list will act like an event callback list and can be + * "fired" multiple times. + * + * Possible options: + * + * once: will ensure the callback list can only be fired once (like a Deferred) + * + * memory: will keep track of previous values and will call any callback added + * after the list has been fired right away with the latest "memorized" + * values (like a Deferred) + * + * unique: will ensure a callback can only be added once (no duplicate in the list) + * + * stopOnFalse: interrupt callings when a callback returns false + * + */ +jQuery.Callbacks = function( options ) { + + // Convert options from String-formatted to Object-formatted if needed + // (we check in cache first) + options = typeof options === "string" ? + createOptions( options ) : + jQuery.extend( {}, options ); + + var // Flag to know if list is currently firing + firing, + + // Last fire value for non-forgettable lists + memory, + + // Flag to know if list was already fired + fired, + + // Flag to prevent firing + locked, + + // Actual callback list + list = [], + + // Queue of execution data for repeatable lists + queue = [], + + // Index of currently firing callback (modified by add/remove as needed) + firingIndex = -1, + + // Fire callbacks + fire = function() { + + // Enforce single-firing + locked = locked || options.once; + + // Execute callbacks for all pending executions, + // respecting firingIndex overrides and runtime changes + fired = firing = true; + for ( ; queue.length; firingIndex = -1 ) { + memory = queue.shift(); + while ( ++firingIndex < list.length ) { + + // Run callback and check for early termination + if ( list[ firingIndex ].apply( memory[ 0 ], memory[ 1 ] ) === false && + options.stopOnFalse ) { + + // Jump to end and forget the data so .add doesn't re-fire + firingIndex = list.length; + memory = false; + } + } + } + + // Forget the data if we're done with it + if ( !options.memory ) { + memory = false; + } + + firing = false; + + // Clean up if we're done firing for good + if ( locked ) { + + // Keep an empty list if we have data for future add calls + if ( memory ) { + list = []; + + // Otherwise, this object is spent + } else { + list = ""; + } + } + }, + + // Actual Callbacks object + self = { + + // Add a callback or a collection of callbacks to the list + add: function() { + if ( list ) { + + // If we have memory from a past run, we should fire after adding + if ( memory && !firing ) { + firingIndex = list.length - 1; + queue.push( memory ); + } + + ( function add( args ) { + jQuery.each( args, function( _, arg ) { + if ( isFunction( arg ) ) { + if ( !options.unique || !self.has( arg ) ) { + list.push( arg ); + } + } else if ( arg && arg.length && toType( arg ) !== "string" ) { + + // Inspect recursively + add( arg ); + } + } ); + } )( arguments ); + + if ( memory && !firing ) { + fire(); + } + } + return this; + }, + + // Remove a callback from the list + remove: function() { + jQuery.each( arguments, function( _, arg ) { + var index; + while ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) { + list.splice( index, 1 ); + + // Handle firing indexes + if ( index <= firingIndex ) { + firingIndex--; + } + } + } ); + return this; + }, + + // Check if a given callback is in the list. + // If no argument is given, return whether or not list has callbacks attached. + has: function( fn ) { + return fn ? + jQuery.inArray( fn, list ) > -1 : + list.length > 0; + }, + + // Remove all callbacks from the list + empty: function() { + if ( list ) { + list = []; + } + return this; + }, + + // Disable .fire and .add + // Abort any current/pending executions + // Clear all callbacks and values + disable: function() { + locked = queue = []; + list = memory = ""; + return this; + }, + disabled: function() { + return !list; + }, + + // Disable .fire + // Also disable .add unless we have memory (since it would have no effect) + // Abort any pending executions + lock: function() { + locked = queue = []; + if ( !memory && !firing ) { + list = memory = ""; + } + return this; + }, + locked: function() { + return !!locked; + }, + + // Call all callbacks with the given context and arguments + fireWith: function( context, args ) { + if ( !locked ) { + args = args || []; + args = [ context, args.slice ? args.slice() : args ]; + queue.push( args ); + if ( !firing ) { + fire(); + } + } + return this; + }, + + // Call all the callbacks with the given arguments + fire: function() { + self.fireWith( this, arguments ); + return this; + }, + + // To know if the callbacks have already been called at least once + fired: function() { + return !!fired; + } + }; + + return self; +}; + + +function Identity( v ) { + return v; +} +function Thrower( ex ) { + throw ex; +} + +function adoptValue( value, resolve, reject, noValue ) { + var method; + + try { + + // Check for promise aspect first to privilege synchronous behavior + if ( value && isFunction( ( method = value.promise ) ) ) { + method.call( value ).done( resolve ).fail( reject ); + + // Other thenables + } else if ( value && isFunction( ( method = value.then ) ) ) { + method.call( value, resolve, reject ); + + // Other non-thenables + } else { + + // Control `resolve` arguments by letting Array#slice cast boolean `noValue` to integer: + // * false: [ value ].slice( 0 ) => resolve( value ) + // * true: [ value ].slice( 1 ) => resolve() + resolve.apply( undefined, [ value ].slice( noValue ) ); + } + + // For Promises/A+, convert exceptions into rejections + // Since jQuery.when doesn't unwrap thenables, we can skip the extra checks appearing in + // Deferred#then to conditionally suppress rejection. + } catch ( value ) { + + // Support: Android 4.0 only + // Strict mode functions invoked without .call/.apply get global-object context + reject.apply( undefined, [ value ] ); + } +} + +jQuery.extend( { + + Deferred: function( func ) { + var tuples = [ + + // action, add listener, callbacks, + // ... .then handlers, argument index, [final state] + [ "notify", "progress", jQuery.Callbacks( "memory" ), + jQuery.Callbacks( "memory" ), 2 ], + [ "resolve", "done", jQuery.Callbacks( "once memory" ), + jQuery.Callbacks( "once memory" ), 0, "resolved" ], + [ "reject", "fail", jQuery.Callbacks( "once memory" ), + jQuery.Callbacks( "once memory" ), 1, "rejected" ] + ], + state = "pending", + promise = { + state: function() { + return state; + }, + always: function() { + deferred.done( arguments ).fail( arguments ); + return this; + }, + "catch": function( fn ) { + return promise.then( null, fn ); + }, + + // Keep pipe for back-compat + pipe: function( /* fnDone, fnFail, fnProgress */ ) { + var fns = arguments; + + return jQuery.Deferred( function( newDefer ) { + jQuery.each( tuples, function( _i, tuple ) { + + // Map tuples (progress, done, fail) to arguments (done, fail, progress) + var fn = isFunction( fns[ tuple[ 4 ] ] ) && fns[ tuple[ 4 ] ]; + + // deferred.progress(function() { bind to newDefer or newDefer.notify }) + // deferred.done(function() { bind to newDefer or newDefer.resolve }) + // deferred.fail(function() { bind to newDefer or newDefer.reject }) + deferred[ tuple[ 1 ] ]( function() { + var returned = fn && fn.apply( this, arguments ); + if ( returned && isFunction( returned.promise ) ) { + returned.promise() + .progress( newDefer.notify ) + .done( newDefer.resolve ) + .fail( newDefer.reject ); + } else { + newDefer[ tuple[ 0 ] + "With" ]( + this, + fn ? [ returned ] : arguments + ); + } + } ); + } ); + fns = null; + } ).promise(); + }, + then: function( onFulfilled, onRejected, onProgress ) { + var maxDepth = 0; + function resolve( depth, deferred, handler, special ) { + return function() { + var that = this, + args = arguments, + mightThrow = function() { + var returned, then; + + // Support: Promises/A+ section 2.3.3.3.3 + // https://promisesaplus.com/#point-59 + // Ignore double-resolution attempts + if ( depth < maxDepth ) { + return; + } + + returned = handler.apply( that, args ); + + // Support: Promises/A+ section 2.3.1 + // https://promisesaplus.com/#point-48 + if ( returned === deferred.promise() ) { + throw new TypeError( "Thenable self-resolution" ); + } + + // Support: Promises/A+ sections 2.3.3.1, 3.5 + // https://promisesaplus.com/#point-54 + // https://promisesaplus.com/#point-75 + // Retrieve `then` only once + then = returned && + + // Support: Promises/A+ section 2.3.4 + // https://promisesaplus.com/#point-64 + // Only check objects and functions for thenability + ( typeof returned === "object" || + typeof returned === "function" ) && + returned.then; + + // Handle a returned thenable + if ( isFunction( then ) ) { + + // Special processors (notify) just wait for resolution + if ( special ) { + then.call( + returned, + resolve( maxDepth, deferred, Identity, special ), + resolve( maxDepth, deferred, Thrower, special ) + ); + + // Normal processors (resolve) also hook into progress + } else { + + // ...and disregard older resolution values + maxDepth++; + + then.call( + returned, + resolve( maxDepth, deferred, Identity, special ), + resolve( maxDepth, deferred, Thrower, special ), + resolve( maxDepth, deferred, Identity, + deferred.notifyWith ) + ); + } + + // Handle all other returned values + } else { + + // Only substitute handlers pass on context + // and multiple values (non-spec behavior) + if ( handler !== Identity ) { + that = undefined; + args = [ returned ]; + } + + // Process the value(s) + // Default process is resolve + ( special || deferred.resolveWith )( that, args ); + } + }, + + // Only normal processors (resolve) catch and reject exceptions + process = special ? + mightThrow : + function() { + try { + mightThrow(); + } catch ( e ) { + + if ( jQuery.Deferred.exceptionHook ) { + jQuery.Deferred.exceptionHook( e, + process.stackTrace ); + } + + // Support: Promises/A+ section 2.3.3.3.4.1 + // https://promisesaplus.com/#point-61 + // Ignore post-resolution exceptions + if ( depth + 1 >= maxDepth ) { + + // Only substitute handlers pass on context + // and multiple values (non-spec behavior) + if ( handler !== Thrower ) { + that = undefined; + args = [ e ]; + } + + deferred.rejectWith( that, args ); + } + } + }; + + // Support: Promises/A+ section 2.3.3.3.1 + // https://promisesaplus.com/#point-57 + // Re-resolve promises immediately to dodge false rejection from + // subsequent errors + if ( depth ) { + process(); + } else { + + // Call an optional hook to record the stack, in case of exception + // since it's otherwise lost when execution goes async + if ( jQuery.Deferred.getStackHook ) { + process.stackTrace = jQuery.Deferred.getStackHook(); + } + window.setTimeout( process ); + } + }; + } + + return jQuery.Deferred( function( newDefer ) { + + // progress_handlers.add( ... ) + tuples[ 0 ][ 3 ].add( + resolve( + 0, + newDefer, + isFunction( onProgress ) ? + onProgress : + Identity, + newDefer.notifyWith + ) + ); + + // fulfilled_handlers.add( ... ) + tuples[ 1 ][ 3 ].add( + resolve( + 0, + newDefer, + isFunction( onFulfilled ) ? + onFulfilled : + Identity + ) + ); + + // rejected_handlers.add( ... ) + tuples[ 2 ][ 3 ].add( + resolve( + 0, + newDefer, + isFunction( onRejected ) ? + onRejected : + Thrower + ) + ); + } ).promise(); + }, + + // Get a promise for this deferred + // If obj is provided, the promise aspect is added to the object + promise: function( obj ) { + return obj != null ? jQuery.extend( obj, promise ) : promise; + } + }, + deferred = {}; + + // Add list-specific methods + jQuery.each( tuples, function( i, tuple ) { + var list = tuple[ 2 ], + stateString = tuple[ 5 ]; + + // promise.progress = list.add + // promise.done = list.add + // promise.fail = list.add + promise[ tuple[ 1 ] ] = list.add; + + // Handle state + if ( stateString ) { + list.add( + function() { + + // state = "resolved" (i.e., fulfilled) + // state = "rejected" + state = stateString; + }, + + // rejected_callbacks.disable + // fulfilled_callbacks.disable + tuples[ 3 - i ][ 2 ].disable, + + // rejected_handlers.disable + // fulfilled_handlers.disable + tuples[ 3 - i ][ 3 ].disable, + + // progress_callbacks.lock + tuples[ 0 ][ 2 ].lock, + + // progress_handlers.lock + tuples[ 0 ][ 3 ].lock + ); + } + + // progress_handlers.fire + // fulfilled_handlers.fire + // rejected_handlers.fire + list.add( tuple[ 3 ].fire ); + + // deferred.notify = function() { deferred.notifyWith(...) } + // deferred.resolve = function() { deferred.resolveWith(...) } + // deferred.reject = function() { deferred.rejectWith(...) } + deferred[ tuple[ 0 ] ] = function() { + deferred[ tuple[ 0 ] + "With" ]( this === deferred ? undefined : this, arguments ); + return this; + }; + + // deferred.notifyWith = list.fireWith + // deferred.resolveWith = list.fireWith + // deferred.rejectWith = list.fireWith + deferred[ tuple[ 0 ] + "With" ] = list.fireWith; + } ); + + // Make the deferred a promise + promise.promise( deferred ); + + // Call given func if any + if ( func ) { + func.call( deferred, deferred ); + } + + // All done! + return deferred; + }, + + // Deferred helper + when: function( singleValue ) { + var + + // count of uncompleted subordinates + remaining = arguments.length, + + // count of unprocessed arguments + i = remaining, + + // subordinate fulfillment data + resolveContexts = Array( i ), + resolveValues = slice.call( arguments ), + + // the master Deferred + master = jQuery.Deferred(), + + // subordinate callback factory + updateFunc = function( i ) { + return function( value ) { + resolveContexts[ i ] = this; + resolveValues[ i ] = arguments.length > 1 ? slice.call( arguments ) : value; + if ( !( --remaining ) ) { + master.resolveWith( resolveContexts, resolveValues ); + } + }; + }; + + // Single- and empty arguments are adopted like Promise.resolve + if ( remaining <= 1 ) { + adoptValue( singleValue, master.done( updateFunc( i ) ).resolve, master.reject, + !remaining ); + + // Use .then() to unwrap secondary thenables (cf. gh-3000) + if ( master.state() === "pending" || + isFunction( resolveValues[ i ] && resolveValues[ i ].then ) ) { + + return master.then(); + } + } + + // Multiple arguments are aggregated like Promise.all array elements + while ( i-- ) { + adoptValue( resolveValues[ i ], updateFunc( i ), master.reject ); + } + + return master.promise(); + } +} ); + + +// These usually indicate a programmer mistake during development, +// warn about them ASAP rather than swallowing them by default. +var rerrorNames = /^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/; + +jQuery.Deferred.exceptionHook = function( error, stack ) { + + // Support: IE 8 - 9 only + // Console exists when dev tools are open, which can happen at any time + if ( window.console && window.console.warn && error && rerrorNames.test( error.name ) ) { + window.console.warn( "jQuery.Deferred exception: " + error.message, error.stack, stack ); + } +}; + + + + +jQuery.readyException = function( error ) { + window.setTimeout( function() { + throw error; + } ); +}; + + + + +// The deferred used on DOM ready +var readyList = jQuery.Deferred(); + +jQuery.fn.ready = function( fn ) { + + readyList + .then( fn ) + + // Wrap jQuery.readyException in a function so that the lookup + // happens at the time of error handling instead of callback + // registration. + .catch( function( error ) { + jQuery.readyException( error ); + } ); + + return this; +}; + +jQuery.extend( { + + // Is the DOM ready to be used? Set to true once it occurs. + isReady: false, + + // A counter to track how many items to wait for before + // the ready event fires. See #6781 + readyWait: 1, + + // Handle when the DOM is ready + ready: function( wait ) { + + // Abort if there are pending holds or we're already ready + if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) { + return; + } + + // Remember that the DOM is ready + jQuery.isReady = true; + + // If a normal DOM Ready event fired, decrement, and wait if need be + if ( wait !== true && --jQuery.readyWait > 0 ) { + return; + } + + // If there are functions bound, to execute + readyList.resolveWith( document, [ jQuery ] ); + } +} ); + +jQuery.ready.then = readyList.then; + +// The ready event handler and self cleanup method +function completed() { + document.removeEventListener( "DOMContentLoaded", completed ); + window.removeEventListener( "load", completed ); + jQuery.ready(); +} + +// Catch cases where $(document).ready() is called +// after the browser event has already occurred. +// Support: IE <=9 - 10 only +// Older IE sometimes signals "interactive" too soon +if ( document.readyState === "complete" || + ( document.readyState !== "loading" && !document.documentElement.doScroll ) ) { + + // Handle it asynchronously to allow scripts the opportunity to delay ready + window.setTimeout( jQuery.ready ); + +} else { + + // Use the handy event callback + document.addEventListener( "DOMContentLoaded", completed ); + + // A fallback to window.onload, that will always work + window.addEventListener( "load", completed ); +} + + + + +// Multifunctional method to get and set values of a collection +// The value/s can optionally be executed if it's a function +var access = function( elems, fn, key, value, chainable, emptyGet, raw ) { + var i = 0, + len = elems.length, + bulk = key == null; + + // Sets many values + if ( toType( key ) === "object" ) { + chainable = true; + for ( i in key ) { + access( elems, fn, i, key[ i ], true, emptyGet, raw ); + } + + // Sets one value + } else if ( value !== undefined ) { + chainable = true; + + if ( !isFunction( value ) ) { + raw = true; + } + + if ( bulk ) { + + // Bulk operations run against the entire set + if ( raw ) { + fn.call( elems, value ); + fn = null; + + // ...except when executing function values + } else { + bulk = fn; + fn = function( elem, _key, value ) { + return bulk.call( jQuery( elem ), value ); + }; + } + } + + if ( fn ) { + for ( ; i < len; i++ ) { + fn( + elems[ i ], key, raw ? + value : + value.call( elems[ i ], i, fn( elems[ i ], key ) ) + ); + } + } + } + + if ( chainable ) { + return elems; + } + + // Gets + if ( bulk ) { + return fn.call( elems ); + } + + return len ? fn( elems[ 0 ], key ) : emptyGet; +}; + + +// Matches dashed string for camelizing +var rmsPrefix = /^-ms-/, + rdashAlpha = /-([a-z])/g; + +// Used by camelCase as callback to replace() +function fcamelCase( _all, letter ) { + return letter.toUpperCase(); +} + +// Convert dashed to camelCase; used by the css and data modules +// Support: IE <=9 - 11, Edge 12 - 15 +// Microsoft forgot to hump their vendor prefix (#9572) +function camelCase( string ) { + return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); +} +var acceptData = function( owner ) { + + // Accepts only: + // - Node + // - Node.ELEMENT_NODE + // - Node.DOCUMENT_NODE + // - Object + // - Any + return owner.nodeType === 1 || owner.nodeType === 9 || !( +owner.nodeType ); +}; + + + + +function Data() { + this.expando = jQuery.expando + Data.uid++; +} + +Data.uid = 1; + +Data.prototype = { + + cache: function( owner ) { + + // Check if the owner object already has a cache + var value = owner[ this.expando ]; + + // If not, create one + if ( !value ) { + value = {}; + + // We can accept data for non-element nodes in modern browsers, + // but we should not, see #8335. + // Always return an empty object. + if ( acceptData( owner ) ) { + + // If it is a node unlikely to be stringify-ed or looped over + // use plain assignment + if ( owner.nodeType ) { + owner[ this.expando ] = value; + + // Otherwise secure it in a non-enumerable property + // configurable must be true to allow the property to be + // deleted when data is removed + } else { + Object.defineProperty( owner, this.expando, { + value: value, + configurable: true + } ); + } + } + } + + return value; + }, + set: function( owner, data, value ) { + var prop, + cache = this.cache( owner ); + + // Handle: [ owner, key, value ] args + // Always use camelCase key (gh-2257) + if ( typeof data === "string" ) { + cache[ camelCase( data ) ] = value; + + // Handle: [ owner, { properties } ] args + } else { + + // Copy the properties one-by-one to the cache object + for ( prop in data ) { + cache[ camelCase( prop ) ] = data[ prop ]; + } + } + return cache; + }, + get: function( owner, key ) { + return key === undefined ? + this.cache( owner ) : + + // Always use camelCase key (gh-2257) + owner[ this.expando ] && owner[ this.expando ][ camelCase( key ) ]; + }, + access: function( owner, key, value ) { + + // In cases where either: + // + // 1. No key was specified + // 2. A string key was specified, but no value provided + // + // Take the "read" path and allow the get method to determine + // which value to return, respectively either: + // + // 1. The entire cache object + // 2. The data stored at the key + // + if ( key === undefined || + ( ( key && typeof key === "string" ) && value === undefined ) ) { + + return this.get( owner, key ); + } + + // When the key is not a string, or both a key and value + // are specified, set or extend (existing objects) with either: + // + // 1. An object of properties + // 2. A key and value + // + this.set( owner, key, value ); + + // Since the "set" path can have two possible entry points + // return the expected data based on which path was taken[*] + return value !== undefined ? value : key; + }, + remove: function( owner, key ) { + var i, + cache = owner[ this.expando ]; + + if ( cache === undefined ) { + return; + } + + if ( key !== undefined ) { + + // Support array or space separated string of keys + if ( Array.isArray( key ) ) { + + // If key is an array of keys... + // We always set camelCase keys, so remove that. + key = key.map( camelCase ); + } else { + key = camelCase( key ); + + // If a key with the spaces exists, use it. + // Otherwise, create an array by matching non-whitespace + key = key in cache ? + [ key ] : + ( key.match( rnothtmlwhite ) || [] ); + } + + i = key.length; + + while ( i-- ) { + delete cache[ key[ i ] ]; + } + } + + // Remove the expando if there's no more data + if ( key === undefined || jQuery.isEmptyObject( cache ) ) { + + // Support: Chrome <=35 - 45 + // Webkit & Blink performance suffers when deleting properties + // from DOM nodes, so set to undefined instead + // https://bugs.chromium.org/p/chromium/issues/detail?id=378607 (bug restricted) + if ( owner.nodeType ) { + owner[ this.expando ] = undefined; + } else { + delete owner[ this.expando ]; + } + } + }, + hasData: function( owner ) { + var cache = owner[ this.expando ]; + return cache !== undefined && !jQuery.isEmptyObject( cache ); + } +}; +var dataPriv = new Data(); + +var dataUser = new Data(); + + + +// Implementation Summary +// +// 1. Enforce API surface and semantic compatibility with 1.9.x branch +// 2. Improve the module's maintainability by reducing the storage +// paths to a single mechanism. +// 3. Use the same single mechanism to support "private" and "user" data. +// 4. _Never_ expose "private" data to user code (TODO: Drop _data, _removeData) +// 5. Avoid exposing implementation details on user objects (eg. expando properties) +// 6. Provide a clear path for implementation upgrade to WeakMap in 2014 + +var rbrace = /^(?:\{[\w\W]*\}|\[[\w\W]*\])$/, + rmultiDash = /[A-Z]/g; + +function getData( data ) { + if ( data === "true" ) { + return true; + } + + if ( data === "false" ) { + return false; + } + + if ( data === "null" ) { + return null; + } + + // Only convert to a number if it doesn't change the string + if ( data === +data + "" ) { + return +data; + } + + if ( rbrace.test( data ) ) { + return JSON.parse( data ); + } + + return data; +} + +function dataAttr( elem, key, data ) { + var name; + + // If nothing was found internally, try to fetch any + // data from the HTML5 data-* attribute + if ( data === undefined && elem.nodeType === 1 ) { + name = "data-" + key.replace( rmultiDash, "-$&" ).toLowerCase(); + data = elem.getAttribute( name ); + + if ( typeof data === "string" ) { + try { + data = getData( data ); + } catch ( e ) {} + + // Make sure we set the data so it isn't changed later + dataUser.set( elem, key, data ); + } else { + data = undefined; + } + } + return data; +} + +jQuery.extend( { + hasData: function( elem ) { + return dataUser.hasData( elem ) || dataPriv.hasData( elem ); + }, + + data: function( elem, name, data ) { + return dataUser.access( elem, name, data ); + }, + + removeData: function( elem, name ) { + dataUser.remove( elem, name ); + }, + + // TODO: Now that all calls to _data and _removeData have been replaced + // with direct calls to dataPriv methods, these can be deprecated. + _data: function( elem, name, data ) { + return dataPriv.access( elem, name, data ); + }, + + _removeData: function( elem, name ) { + dataPriv.remove( elem, name ); + } +} ); + +jQuery.fn.extend( { + data: function( key, value ) { + var i, name, data, + elem = this[ 0 ], + attrs = elem && elem.attributes; + + // Gets all values + if ( key === undefined ) { + if ( this.length ) { + data = dataUser.get( elem ); + + if ( elem.nodeType === 1 && !dataPriv.get( elem, "hasDataAttrs" ) ) { + i = attrs.length; + while ( i-- ) { + + // Support: IE 11 only + // The attrs elements can be null (#14894) + if ( attrs[ i ] ) { + name = attrs[ i ].name; + if ( name.indexOf( "data-" ) === 0 ) { + name = camelCase( name.slice( 5 ) ); + dataAttr( elem, name, data[ name ] ); + } + } + } + dataPriv.set( elem, "hasDataAttrs", true ); + } + } + + return data; + } + + // Sets multiple values + if ( typeof key === "object" ) { + return this.each( function() { + dataUser.set( this, key ); + } ); + } + + return access( this, function( value ) { + var data; + + // The calling jQuery object (element matches) is not empty + // (and therefore has an element appears at this[ 0 ]) and the + // `value` parameter was not undefined. An empty jQuery object + // will result in `undefined` for elem = this[ 0 ] which will + // throw an exception if an attempt to read a data cache is made. + if ( elem && value === undefined ) { + + // Attempt to get data from the cache + // The key will always be camelCased in Data + data = dataUser.get( elem, key ); + if ( data !== undefined ) { + return data; + } + + // Attempt to "discover" the data in + // HTML5 custom data-* attrs + data = dataAttr( elem, key ); + if ( data !== undefined ) { + return data; + } + + // We tried really hard, but the data doesn't exist. + return; + } + + // Set the data... + this.each( function() { + + // We always store the camelCased key + dataUser.set( this, key, value ); + } ); + }, null, value, arguments.length > 1, null, true ); + }, + + removeData: function( key ) { + return this.each( function() { + dataUser.remove( this, key ); + } ); + } +} ); + + +jQuery.extend( { + queue: function( elem, type, data ) { + var queue; + + if ( elem ) { + type = ( type || "fx" ) + "queue"; + queue = dataPriv.get( elem, type ); + + // Speed up dequeue by getting out quickly if this is just a lookup + if ( data ) { + if ( !queue || Array.isArray( data ) ) { + queue = dataPriv.access( elem, type, jQuery.makeArray( data ) ); + } else { + queue.push( data ); + } + } + return queue || []; + } + }, + + dequeue: function( elem, type ) { + type = type || "fx"; + + var queue = jQuery.queue( elem, type ), + startLength = queue.length, + fn = queue.shift(), + hooks = jQuery._queueHooks( elem, type ), + next = function() { + jQuery.dequeue( elem, type ); + }; + + // If the fx queue is dequeued, always remove the progress sentinel + if ( fn === "inprogress" ) { + fn = queue.shift(); + startLength--; + } + + if ( fn ) { + + // Add a progress sentinel to prevent the fx queue from being + // automatically dequeued + if ( type === "fx" ) { + queue.unshift( "inprogress" ); + } + + // Clear up the last queue stop function + delete hooks.stop; + fn.call( elem, next, hooks ); + } + + if ( !startLength && hooks ) { + hooks.empty.fire(); + } + }, + + // Not public - generate a queueHooks object, or return the current one + _queueHooks: function( elem, type ) { + var key = type + "queueHooks"; + return dataPriv.get( elem, key ) || dataPriv.access( elem, key, { + empty: jQuery.Callbacks( "once memory" ).add( function() { + dataPriv.remove( elem, [ type + "queue", key ] ); + } ) + } ); + } +} ); + +jQuery.fn.extend( { + queue: function( type, data ) { + var setter = 2; + + if ( typeof type !== "string" ) { + data = type; + type = "fx"; + setter--; + } + + if ( arguments.length < setter ) { + return jQuery.queue( this[ 0 ], type ); + } + + return data === undefined ? + this : + this.each( function() { + var queue = jQuery.queue( this, type, data ); + + // Ensure a hooks for this queue + jQuery._queueHooks( this, type ); + + if ( type === "fx" && queue[ 0 ] !== "inprogress" ) { + jQuery.dequeue( this, type ); + } + } ); + }, + dequeue: function( type ) { + return this.each( function() { + jQuery.dequeue( this, type ); + } ); + }, + clearQueue: function( type ) { + return this.queue( type || "fx", [] ); + }, + + // Get a promise resolved when queues of a certain type + // are emptied (fx is the type by default) + promise: function( type, obj ) { + var tmp, + count = 1, + defer = jQuery.Deferred(), + elements = this, + i = this.length, + resolve = function() { + if ( !( --count ) ) { + defer.resolveWith( elements, [ elements ] ); + } + }; + + if ( typeof type !== "string" ) { + obj = type; + type = undefined; + } + type = type || "fx"; + + while ( i-- ) { + tmp = dataPriv.get( elements[ i ], type + "queueHooks" ); + if ( tmp && tmp.empty ) { + count++; + tmp.empty.add( resolve ); + } + } + resolve(); + return defer.promise( obj ); + } +} ); +var pnum = ( /[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/ ).source; + +var rcssNum = new RegExp( "^(?:([+-])=|)(" + pnum + ")([a-z%]*)$", "i" ); + + +var cssExpand = [ "Top", "Right", "Bottom", "Left" ]; + +var documentElement = document.documentElement; + + + + var isAttached = function( elem ) { + return jQuery.contains( elem.ownerDocument, elem ); + }, + composed = { composed: true }; + + // Support: IE 9 - 11+, Edge 12 - 18+, iOS 10.0 - 10.2 only + // Check attachment across shadow DOM boundaries when possible (gh-3504) + // Support: iOS 10.0-10.2 only + // Early iOS 10 versions support `attachShadow` but not `getRootNode`, + // leading to errors. We need to check for `getRootNode`. + if ( documentElement.getRootNode ) { + isAttached = function( elem ) { + return jQuery.contains( elem.ownerDocument, elem ) || + elem.getRootNode( composed ) === elem.ownerDocument; + }; + } +var isHiddenWithinTree = function( elem, el ) { + + // isHiddenWithinTree might be called from jQuery#filter function; + // in that case, element will be second argument + elem = el || elem; + + // Inline style trumps all + return elem.style.display === "none" || + elem.style.display === "" && + + // Otherwise, check computed style + // Support: Firefox <=43 - 45 + // Disconnected elements can have computed display: none, so first confirm that elem is + // in the document. + isAttached( elem ) && + + jQuery.css( elem, "display" ) === "none"; + }; + + + +function adjustCSS( elem, prop, valueParts, tween ) { + var adjusted, scale, + maxIterations = 20, + currentValue = tween ? + function() { + return tween.cur(); + } : + function() { + return jQuery.css( elem, prop, "" ); + }, + initial = currentValue(), + unit = valueParts && valueParts[ 3 ] || ( jQuery.cssNumber[ prop ] ? "" : "px" ), + + // Starting value computation is required for potential unit mismatches + initialInUnit = elem.nodeType && + ( jQuery.cssNumber[ prop ] || unit !== "px" && +initial ) && + rcssNum.exec( jQuery.css( elem, prop ) ); + + if ( initialInUnit && initialInUnit[ 3 ] !== unit ) { + + // Support: Firefox <=54 + // Halve the iteration target value to prevent interference from CSS upper bounds (gh-2144) + initial = initial / 2; + + // Trust units reported by jQuery.css + unit = unit || initialInUnit[ 3 ]; + + // Iteratively approximate from a nonzero starting point + initialInUnit = +initial || 1; + + while ( maxIterations-- ) { + + // Evaluate and update our best guess (doubling guesses that zero out). + // Finish if the scale equals or crosses 1 (making the old*new product non-positive). + jQuery.style( elem, prop, initialInUnit + unit ); + if ( ( 1 - scale ) * ( 1 - ( scale = currentValue() / initial || 0.5 ) ) <= 0 ) { + maxIterations = 0; + } + initialInUnit = initialInUnit / scale; + + } + + initialInUnit = initialInUnit * 2; + jQuery.style( elem, prop, initialInUnit + unit ); + + // Make sure we update the tween properties later on + valueParts = valueParts || []; + } + + if ( valueParts ) { + initialInUnit = +initialInUnit || +initial || 0; + + // Apply relative offset (+=/-=) if specified + adjusted = valueParts[ 1 ] ? + initialInUnit + ( valueParts[ 1 ] + 1 ) * valueParts[ 2 ] : + +valueParts[ 2 ]; + if ( tween ) { + tween.unit = unit; + tween.start = initialInUnit; + tween.end = adjusted; + } + } + return adjusted; +} + + +var defaultDisplayMap = {}; + +function getDefaultDisplay( elem ) { + var temp, + doc = elem.ownerDocument, + nodeName = elem.nodeName, + display = defaultDisplayMap[ nodeName ]; + + if ( display ) { + return display; + } + + temp = doc.body.appendChild( doc.createElement( nodeName ) ); + display = jQuery.css( temp, "display" ); + + temp.parentNode.removeChild( temp ); + + if ( display === "none" ) { + display = "block"; + } + defaultDisplayMap[ nodeName ] = display; + + return display; +} + +function showHide( elements, show ) { + var display, elem, + values = [], + index = 0, + length = elements.length; + + // Determine new display value for elements that need to change + for ( ; index < length; index++ ) { + elem = elements[ index ]; + if ( !elem.style ) { + continue; + } + + display = elem.style.display; + if ( show ) { + + // Since we force visibility upon cascade-hidden elements, an immediate (and slow) + // check is required in this first loop unless we have a nonempty display value (either + // inline or about-to-be-restored) + if ( display === "none" ) { + values[ index ] = dataPriv.get( elem, "display" ) || null; + if ( !values[ index ] ) { + elem.style.display = ""; + } + } + if ( elem.style.display === "" && isHiddenWithinTree( elem ) ) { + values[ index ] = getDefaultDisplay( elem ); + } + } else { + if ( display !== "none" ) { + values[ index ] = "none"; + + // Remember what we're overwriting + dataPriv.set( elem, "display", display ); + } + } + } + + // Set the display of the elements in a second loop to avoid constant reflow + for ( index = 0; index < length; index++ ) { + if ( values[ index ] != null ) { + elements[ index ].style.display = values[ index ]; + } + } + + return elements; +} + +jQuery.fn.extend( { + show: function() { + return showHide( this, true ); + }, + hide: function() { + return showHide( this ); + }, + toggle: function( state ) { + if ( typeof state === "boolean" ) { + return state ? this.show() : this.hide(); + } + + return this.each( function() { + if ( isHiddenWithinTree( this ) ) { + jQuery( this ).show(); + } else { + jQuery( this ).hide(); + } + } ); + } +} ); +var rcheckableType = ( /^(?:checkbox|radio)$/i ); + +var rtagName = ( /<([a-z][^\/\0>\x20\t\r\n\f]*)/i ); + +var rscriptType = ( /^$|^module$|\/(?:java|ecma)script/i ); + + + +( function() { + var fragment = document.createDocumentFragment(), + div = fragment.appendChild( document.createElement( "div" ) ), + input = document.createElement( "input" ); + + // Support: Android 4.0 - 4.3 only + // Check state lost if the name is set (#11217) + // Support: Windows Web Apps (WWA) + // `name` and `type` must use .setAttribute for WWA (#14901) + input.setAttribute( "type", "radio" ); + input.setAttribute( "checked", "checked" ); + input.setAttribute( "name", "t" ); + + div.appendChild( input ); + + // Support: Android <=4.1 only + // Older WebKit doesn't clone checked state correctly in fragments + support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked; + + // Support: IE <=11 only + // Make sure textarea (and checkbox) defaultValue is properly cloned + div.innerHTML = ""; + support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue; + + // Support: IE <=9 only + // IE <=9 replaces "; + support.option = !!div.lastChild; +} )(); + + +// We have to close these tags to support XHTML (#13200) +var wrapMap = { + + // XHTML parsers do not magically insert elements in the + // same way that tag soup parsers do. So we cannot shorten + // this by omitting or other required elements. + thead: [ 1, "", "
" ], + col: [ 2, "", "
" ], + tr: [ 2, "", "
" ], + td: [ 3, "", "
" ], + + _default: [ 0, "", "" ] +}; + +wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; +wrapMap.th = wrapMap.td; + +// Support: IE <=9 only +if ( !support.option ) { + wrapMap.optgroup = wrapMap.option = [ 1, "" ]; +} + + +function getAll( context, tag ) { + + // Support: IE <=9 - 11 only + // Use typeof to avoid zero-argument method invocation on host objects (#15151) + var ret; + + if ( typeof context.getElementsByTagName !== "undefined" ) { + ret = context.getElementsByTagName( tag || "*" ); + + } else if ( typeof context.querySelectorAll !== "undefined" ) { + ret = context.querySelectorAll( tag || "*" ); + + } else { + ret = []; + } + + if ( tag === undefined || tag && nodeName( context, tag ) ) { + return jQuery.merge( [ context ], ret ); + } + + return ret; +} + + +// Mark scripts as having already been evaluated +function setGlobalEval( elems, refElements ) { + var i = 0, + l = elems.length; + + for ( ; i < l; i++ ) { + dataPriv.set( + elems[ i ], + "globalEval", + !refElements || dataPriv.get( refElements[ i ], "globalEval" ) + ); + } +} + + +var rhtml = /<|&#?\w+;/; + +function buildFragment( elems, context, scripts, selection, ignored ) { + var elem, tmp, tag, wrap, attached, j, + fragment = context.createDocumentFragment(), + nodes = [], + i = 0, + l = elems.length; + + for ( ; i < l; i++ ) { + elem = elems[ i ]; + + if ( elem || elem === 0 ) { + + // Add nodes directly + if ( toType( elem ) === "object" ) { + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem ); + + // Convert non-html into a text node + } else if ( !rhtml.test( elem ) ) { + nodes.push( context.createTextNode( elem ) ); + + // Convert html into DOM nodes + } else { + tmp = tmp || fragment.appendChild( context.createElement( "div" ) ); + + // Deserialize a standard representation + tag = ( rtagName.exec( elem ) || [ "", "" ] )[ 1 ].toLowerCase(); + wrap = wrapMap[ tag ] || wrapMap._default; + tmp.innerHTML = wrap[ 1 ] + jQuery.htmlPrefilter( elem ) + wrap[ 2 ]; + + // Descend through wrappers to the right content + j = wrap[ 0 ]; + while ( j-- ) { + tmp = tmp.lastChild; + } + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( nodes, tmp.childNodes ); + + // Remember the top-level container + tmp = fragment.firstChild; + + // Ensure the created nodes are orphaned (#12392) + tmp.textContent = ""; + } + } + } + + // Remove wrapper from fragment + fragment.textContent = ""; + + i = 0; + while ( ( elem = nodes[ i++ ] ) ) { + + // Skip elements already in the context collection (trac-4087) + if ( selection && jQuery.inArray( elem, selection ) > -1 ) { + if ( ignored ) { + ignored.push( elem ); + } + continue; + } + + attached = isAttached( elem ); + + // Append to fragment + tmp = getAll( fragment.appendChild( elem ), "script" ); + + // Preserve script evaluation history + if ( attached ) { + setGlobalEval( tmp ); + } + + // Capture executables + if ( scripts ) { + j = 0; + while ( ( elem = tmp[ j++ ] ) ) { + if ( rscriptType.test( elem.type || "" ) ) { + scripts.push( elem ); + } + } + } + } + + return fragment; +} + + +var + rkeyEvent = /^key/, + rmouseEvent = /^(?:mouse|pointer|contextmenu|drag|drop)|click/, + rtypenamespace = /^([^.]*)(?:\.(.+)|)/; + +function returnTrue() { + return true; +} + +function returnFalse() { + return false; +} + +// Support: IE <=9 - 11+ +// focus() and blur() are asynchronous, except when they are no-op. +// So expect focus to be synchronous when the element is already active, +// and blur to be synchronous when the element is not already active. +// (focus and blur are always synchronous in other supported browsers, +// this just defines when we can count on it). +function expectSync( elem, type ) { + return ( elem === safeActiveElement() ) === ( type === "focus" ); +} + +// Support: IE <=9 only +// Accessing document.activeElement can throw unexpectedly +// https://bugs.jquery.com/ticket/13393 +function safeActiveElement() { + try { + return document.activeElement; + } catch ( err ) { } +} + +function on( elem, types, selector, data, fn, one ) { + var origFn, type; + + // Types can be a map of types/handlers + if ( typeof types === "object" ) { + + // ( types-Object, selector, data ) + if ( typeof selector !== "string" ) { + + // ( types-Object, data ) + data = data || selector; + selector = undefined; + } + for ( type in types ) { + on( elem, type, selector, data, types[ type ], one ); + } + return elem; + } + + if ( data == null && fn == null ) { + + // ( types, fn ) + fn = selector; + data = selector = undefined; + } else if ( fn == null ) { + if ( typeof selector === "string" ) { + + // ( types, selector, fn ) + fn = data; + data = undefined; + } else { + + // ( types, data, fn ) + fn = data; + data = selector; + selector = undefined; + } + } + if ( fn === false ) { + fn = returnFalse; + } else if ( !fn ) { + return elem; + } + + if ( one === 1 ) { + origFn = fn; + fn = function( event ) { + + // Can use an empty set, since event contains the info + jQuery().off( event ); + return origFn.apply( this, arguments ); + }; + + // Use same guid so caller can remove using origFn + fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ ); + } + return elem.each( function() { + jQuery.event.add( this, types, fn, data, selector ); + } ); +} + +/* + * Helper functions for managing events -- not part of the public interface. + * Props to Dean Edwards' addEvent library for many of the ideas. + */ +jQuery.event = { + + global: {}, + + add: function( elem, types, handler, data, selector ) { + + var handleObjIn, eventHandle, tmp, + events, t, handleObj, + special, handlers, type, namespaces, origType, + elemData = dataPriv.get( elem ); + + // Only attach events to objects that accept data + if ( !acceptData( elem ) ) { + return; + } + + // Caller can pass in an object of custom data in lieu of the handler + if ( handler.handler ) { + handleObjIn = handler; + handler = handleObjIn.handler; + selector = handleObjIn.selector; + } + + // Ensure that invalid selectors throw exceptions at attach time + // Evaluate against documentElement in case elem is a non-element node (e.g., document) + if ( selector ) { + jQuery.find.matchesSelector( documentElement, selector ); + } + + // Make sure that the handler has a unique ID, used to find/remove it later + if ( !handler.guid ) { + handler.guid = jQuery.guid++; + } + + // Init the element's event structure and main handler, if this is the first + if ( !( events = elemData.events ) ) { + events = elemData.events = Object.create( null ); + } + if ( !( eventHandle = elemData.handle ) ) { + eventHandle = elemData.handle = function( e ) { + + // Discard the second event of a jQuery.event.trigger() and + // when an event is called after a page has unloaded + return typeof jQuery !== "undefined" && jQuery.event.triggered !== e.type ? + jQuery.event.dispatch.apply( elem, arguments ) : undefined; + }; + } + + // Handle multiple events separated by a space + types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[ t ] ) || []; + type = origType = tmp[ 1 ]; + namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); + + // There *must* be a type, no attaching namespace-only handlers + if ( !type ) { + continue; + } + + // If event changes its type, use the special event handlers for the changed type + special = jQuery.event.special[ type ] || {}; + + // If selector defined, determine special event api type, otherwise given type + type = ( selector ? special.delegateType : special.bindType ) || type; + + // Update special based on newly reset type + special = jQuery.event.special[ type ] || {}; + + // handleObj is passed to all event handlers + handleObj = jQuery.extend( { + type: type, + origType: origType, + data: data, + handler: handler, + guid: handler.guid, + selector: selector, + needsContext: selector && jQuery.expr.match.needsContext.test( selector ), + namespace: namespaces.join( "." ) + }, handleObjIn ); + + // Init the event handler queue if we're the first + if ( !( handlers = events[ type ] ) ) { + handlers = events[ type ] = []; + handlers.delegateCount = 0; + + // Only use addEventListener if the special events handler returns false + if ( !special.setup || + special.setup.call( elem, data, namespaces, eventHandle ) === false ) { + + if ( elem.addEventListener ) { + elem.addEventListener( type, eventHandle ); + } + } + } + + if ( special.add ) { + special.add.call( elem, handleObj ); + + if ( !handleObj.handler.guid ) { + handleObj.handler.guid = handler.guid; + } + } + + // Add to the element's handler list, delegates in front + if ( selector ) { + handlers.splice( handlers.delegateCount++, 0, handleObj ); + } else { + handlers.push( handleObj ); + } + + // Keep track of which events have ever been used, for event optimization + jQuery.event.global[ type ] = true; + } + + }, + + // Detach an event or set of events from an element + remove: function( elem, types, handler, selector, mappedTypes ) { + + var j, origCount, tmp, + events, t, handleObj, + special, handlers, type, namespaces, origType, + elemData = dataPriv.hasData( elem ) && dataPriv.get( elem ); + + if ( !elemData || !( events = elemData.events ) ) { + return; + } + + // Once for each type.namespace in types; type may be omitted + types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[ t ] ) || []; + type = origType = tmp[ 1 ]; + namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); + + // Unbind all events (on this namespace, if provided) for the element + if ( !type ) { + for ( type in events ) { + jQuery.event.remove( elem, type + types[ t ], handler, selector, true ); + } + continue; + } + + special = jQuery.event.special[ type ] || {}; + type = ( selector ? special.delegateType : special.bindType ) || type; + handlers = events[ type ] || []; + tmp = tmp[ 2 ] && + new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ); + + // Remove matching events + origCount = j = handlers.length; + while ( j-- ) { + handleObj = handlers[ j ]; + + if ( ( mappedTypes || origType === handleObj.origType ) && + ( !handler || handler.guid === handleObj.guid ) && + ( !tmp || tmp.test( handleObj.namespace ) ) && + ( !selector || selector === handleObj.selector || + selector === "**" && handleObj.selector ) ) { + handlers.splice( j, 1 ); + + if ( handleObj.selector ) { + handlers.delegateCount--; + } + if ( special.remove ) { + special.remove.call( elem, handleObj ); + } + } + } + + // Remove generic event handler if we removed something and no more handlers exist + // (avoids potential for endless recursion during removal of special event handlers) + if ( origCount && !handlers.length ) { + if ( !special.teardown || + special.teardown.call( elem, namespaces, elemData.handle ) === false ) { + + jQuery.removeEvent( elem, type, elemData.handle ); + } + + delete events[ type ]; + } + } + + // Remove data and the expando if it's no longer used + if ( jQuery.isEmptyObject( events ) ) { + dataPriv.remove( elem, "handle events" ); + } + }, + + dispatch: function( nativeEvent ) { + + var i, j, ret, matched, handleObj, handlerQueue, + args = new Array( arguments.length ), + + // Make a writable jQuery.Event from the native event object + event = jQuery.event.fix( nativeEvent ), + + handlers = ( + dataPriv.get( this, "events" ) || Object.create( null ) + )[ event.type ] || [], + special = jQuery.event.special[ event.type ] || {}; + + // Use the fix-ed jQuery.Event rather than the (read-only) native event + args[ 0 ] = event; + + for ( i = 1; i < arguments.length; i++ ) { + args[ i ] = arguments[ i ]; + } + + event.delegateTarget = this; + + // Call the preDispatch hook for the mapped type, and let it bail if desired + if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) { + return; + } + + // Determine handlers + handlerQueue = jQuery.event.handlers.call( this, event, handlers ); + + // Run delegates first; they may want to stop propagation beneath us + i = 0; + while ( ( matched = handlerQueue[ i++ ] ) && !event.isPropagationStopped() ) { + event.currentTarget = matched.elem; + + j = 0; + while ( ( handleObj = matched.handlers[ j++ ] ) && + !event.isImmediatePropagationStopped() ) { + + // If the event is namespaced, then each handler is only invoked if it is + // specially universal or its namespaces are a superset of the event's. + if ( !event.rnamespace || handleObj.namespace === false || + event.rnamespace.test( handleObj.namespace ) ) { + + event.handleObj = handleObj; + event.data = handleObj.data; + + ret = ( ( jQuery.event.special[ handleObj.origType ] || {} ).handle || + handleObj.handler ).apply( matched.elem, args ); + + if ( ret !== undefined ) { + if ( ( event.result = ret ) === false ) { + event.preventDefault(); + event.stopPropagation(); + } + } + } + } + } + + // Call the postDispatch hook for the mapped type + if ( special.postDispatch ) { + special.postDispatch.call( this, event ); + } + + return event.result; + }, + + handlers: function( event, handlers ) { + var i, handleObj, sel, matchedHandlers, matchedSelectors, + handlerQueue = [], + delegateCount = handlers.delegateCount, + cur = event.target; + + // Find delegate handlers + if ( delegateCount && + + // Support: IE <=9 + // Black-hole SVG instance trees (trac-13180) + cur.nodeType && + + // Support: Firefox <=42 + // Suppress spec-violating clicks indicating a non-primary pointer button (trac-3861) + // https://www.w3.org/TR/DOM-Level-3-Events/#event-type-click + // Support: IE 11 only + // ...but not arrow key "clicks" of radio inputs, which can have `button` -1 (gh-2343) + !( event.type === "click" && event.button >= 1 ) ) { + + for ( ; cur !== this; cur = cur.parentNode || this ) { + + // Don't check non-elements (#13208) + // Don't process clicks on disabled elements (#6911, #8165, #11382, #11764) + if ( cur.nodeType === 1 && !( event.type === "click" && cur.disabled === true ) ) { + matchedHandlers = []; + matchedSelectors = {}; + for ( i = 0; i < delegateCount; i++ ) { + handleObj = handlers[ i ]; + + // Don't conflict with Object.prototype properties (#13203) + sel = handleObj.selector + " "; + + if ( matchedSelectors[ sel ] === undefined ) { + matchedSelectors[ sel ] = handleObj.needsContext ? + jQuery( sel, this ).index( cur ) > -1 : + jQuery.find( sel, this, null, [ cur ] ).length; + } + if ( matchedSelectors[ sel ] ) { + matchedHandlers.push( handleObj ); + } + } + if ( matchedHandlers.length ) { + handlerQueue.push( { elem: cur, handlers: matchedHandlers } ); + } + } + } + } + + // Add the remaining (directly-bound) handlers + cur = this; + if ( delegateCount < handlers.length ) { + handlerQueue.push( { elem: cur, handlers: handlers.slice( delegateCount ) } ); + } + + return handlerQueue; + }, + + addProp: function( name, hook ) { + Object.defineProperty( jQuery.Event.prototype, name, { + enumerable: true, + configurable: true, + + get: isFunction( hook ) ? + function() { + if ( this.originalEvent ) { + return hook( this.originalEvent ); + } + } : + function() { + if ( this.originalEvent ) { + return this.originalEvent[ name ]; + } + }, + + set: function( value ) { + Object.defineProperty( this, name, { + enumerable: true, + configurable: true, + writable: true, + value: value + } ); + } + } ); + }, + + fix: function( originalEvent ) { + return originalEvent[ jQuery.expando ] ? + originalEvent : + new jQuery.Event( originalEvent ); + }, + + special: { + load: { + + // Prevent triggered image.load events from bubbling to window.load + noBubble: true + }, + click: { + + // Utilize native event to ensure correct state for checkable inputs + setup: function( data ) { + + // For mutual compressibility with _default, replace `this` access with a local var. + // `|| data` is dead code meant only to preserve the variable through minification. + var el = this || data; + + // Claim the first handler + if ( rcheckableType.test( el.type ) && + el.click && nodeName( el, "input" ) ) { + + // dataPriv.set( el, "click", ... ) + leverageNative( el, "click", returnTrue ); + } + + // Return false to allow normal processing in the caller + return false; + }, + trigger: function( data ) { + + // For mutual compressibility with _default, replace `this` access with a local var. + // `|| data` is dead code meant only to preserve the variable through minification. + var el = this || data; + + // Force setup before triggering a click + if ( rcheckableType.test( el.type ) && + el.click && nodeName( el, "input" ) ) { + + leverageNative( el, "click" ); + } + + // Return non-false to allow normal event-path propagation + return true; + }, + + // For cross-browser consistency, suppress native .click() on links + // Also prevent it if we're currently inside a leveraged native-event stack + _default: function( event ) { + var target = event.target; + return rcheckableType.test( target.type ) && + target.click && nodeName( target, "input" ) && + dataPriv.get( target, "click" ) || + nodeName( target, "a" ); + } + }, + + beforeunload: { + postDispatch: function( event ) { + + // Support: Firefox 20+ + // Firefox doesn't alert if the returnValue field is not set. + if ( event.result !== undefined && event.originalEvent ) { + event.originalEvent.returnValue = event.result; + } + } + } + } +}; + +// Ensure the presence of an event listener that handles manually-triggered +// synthetic events by interrupting progress until reinvoked in response to +// *native* events that it fires directly, ensuring that state changes have +// already occurred before other listeners are invoked. +function leverageNative( el, type, expectSync ) { + + // Missing expectSync indicates a trigger call, which must force setup through jQuery.event.add + if ( !expectSync ) { + if ( dataPriv.get( el, type ) === undefined ) { + jQuery.event.add( el, type, returnTrue ); + } + return; + } + + // Register the controller as a special universal handler for all event namespaces + dataPriv.set( el, type, false ); + jQuery.event.add( el, type, { + namespace: false, + handler: function( event ) { + var notAsync, result, + saved = dataPriv.get( this, type ); + + if ( ( event.isTrigger & 1 ) && this[ type ] ) { + + // Interrupt processing of the outer synthetic .trigger()ed event + // Saved data should be false in such cases, but might be a leftover capture object + // from an async native handler (gh-4350) + if ( !saved.length ) { + + // Store arguments for use when handling the inner native event + // There will always be at least one argument (an event object), so this array + // will not be confused with a leftover capture object. + saved = slice.call( arguments ); + dataPriv.set( this, type, saved ); + + // Trigger the native event and capture its result + // Support: IE <=9 - 11+ + // focus() and blur() are asynchronous + notAsync = expectSync( this, type ); + this[ type ](); + result = dataPriv.get( this, type ); + if ( saved !== result || notAsync ) { + dataPriv.set( this, type, false ); + } else { + result = {}; + } + if ( saved !== result ) { + + // Cancel the outer synthetic event + event.stopImmediatePropagation(); + event.preventDefault(); + return result.value; + } + + // If this is an inner synthetic event for an event with a bubbling surrogate + // (focus or blur), assume that the surrogate already propagated from triggering the + // native event and prevent that from happening again here. + // This technically gets the ordering wrong w.r.t. to `.trigger()` (in which the + // bubbling surrogate propagates *after* the non-bubbling base), but that seems + // less bad than duplication. + } else if ( ( jQuery.event.special[ type ] || {} ).delegateType ) { + event.stopPropagation(); + } + + // If this is a native event triggered above, everything is now in order + // Fire an inner synthetic event with the original arguments + } else if ( saved.length ) { + + // ...and capture the result + dataPriv.set( this, type, { + value: jQuery.event.trigger( + + // Support: IE <=9 - 11+ + // Extend with the prototype to reset the above stopImmediatePropagation() + jQuery.extend( saved[ 0 ], jQuery.Event.prototype ), + saved.slice( 1 ), + this + ) + } ); + + // Abort handling of the native event + event.stopImmediatePropagation(); + } + } + } ); +} + +jQuery.removeEvent = function( elem, type, handle ) { + + // This "if" is needed for plain objects + if ( elem.removeEventListener ) { + elem.removeEventListener( type, handle ); + } +}; + +jQuery.Event = function( src, props ) { + + // Allow instantiation without the 'new' keyword + if ( !( this instanceof jQuery.Event ) ) { + return new jQuery.Event( src, props ); + } + + // Event object + if ( src && src.type ) { + this.originalEvent = src; + this.type = src.type; + + // Events bubbling up the document may have been marked as prevented + // by a handler lower down the tree; reflect the correct value. + this.isDefaultPrevented = src.defaultPrevented || + src.defaultPrevented === undefined && + + // Support: Android <=2.3 only + src.returnValue === false ? + returnTrue : + returnFalse; + + // Create target properties + // Support: Safari <=6 - 7 only + // Target should not be a text node (#504, #13143) + this.target = ( src.target && src.target.nodeType === 3 ) ? + src.target.parentNode : + src.target; + + this.currentTarget = src.currentTarget; + this.relatedTarget = src.relatedTarget; + + // Event type + } else { + this.type = src; + } + + // Put explicitly provided properties onto the event object + if ( props ) { + jQuery.extend( this, props ); + } + + // Create a timestamp if incoming event doesn't have one + this.timeStamp = src && src.timeStamp || Date.now(); + + // Mark it as fixed + this[ jQuery.expando ] = true; +}; + +// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding +// https://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html +jQuery.Event.prototype = { + constructor: jQuery.Event, + isDefaultPrevented: returnFalse, + isPropagationStopped: returnFalse, + isImmediatePropagationStopped: returnFalse, + isSimulated: false, + + preventDefault: function() { + var e = this.originalEvent; + + this.isDefaultPrevented = returnTrue; + + if ( e && !this.isSimulated ) { + e.preventDefault(); + } + }, + stopPropagation: function() { + var e = this.originalEvent; + + this.isPropagationStopped = returnTrue; + + if ( e && !this.isSimulated ) { + e.stopPropagation(); + } + }, + stopImmediatePropagation: function() { + var e = this.originalEvent; + + this.isImmediatePropagationStopped = returnTrue; + + if ( e && !this.isSimulated ) { + e.stopImmediatePropagation(); + } + + this.stopPropagation(); + } +}; + +// Includes all common event props including KeyEvent and MouseEvent specific props +jQuery.each( { + altKey: true, + bubbles: true, + cancelable: true, + changedTouches: true, + ctrlKey: true, + detail: true, + eventPhase: true, + metaKey: true, + pageX: true, + pageY: true, + shiftKey: true, + view: true, + "char": true, + code: true, + charCode: true, + key: true, + keyCode: true, + button: true, + buttons: true, + clientX: true, + clientY: true, + offsetX: true, + offsetY: true, + pointerId: true, + pointerType: true, + screenX: true, + screenY: true, + targetTouches: true, + toElement: true, + touches: true, + + which: function( event ) { + var button = event.button; + + // Add which for key events + if ( event.which == null && rkeyEvent.test( event.type ) ) { + return event.charCode != null ? event.charCode : event.keyCode; + } + + // Add which for click: 1 === left; 2 === middle; 3 === right + if ( !event.which && button !== undefined && rmouseEvent.test( event.type ) ) { + if ( button & 1 ) { + return 1; + } + + if ( button & 2 ) { + return 3; + } + + if ( button & 4 ) { + return 2; + } + + return 0; + } + + return event.which; + } +}, jQuery.event.addProp ); + +jQuery.each( { focus: "focusin", blur: "focusout" }, function( type, delegateType ) { + jQuery.event.special[ type ] = { + + // Utilize native event if possible so blur/focus sequence is correct + setup: function() { + + // Claim the first handler + // dataPriv.set( this, "focus", ... ) + // dataPriv.set( this, "blur", ... ) + leverageNative( this, type, expectSync ); + + // Return false to allow normal processing in the caller + return false; + }, + trigger: function() { + + // Force setup before trigger + leverageNative( this, type ); + + // Return non-false to allow normal event-path propagation + return true; + }, + + delegateType: delegateType + }; +} ); + +// Create mouseenter/leave events using mouseover/out and event-time checks +// so that event delegation works in jQuery. +// Do the same for pointerenter/pointerleave and pointerover/pointerout +// +// Support: Safari 7 only +// Safari sends mouseenter too often; see: +// https://bugs.chromium.org/p/chromium/issues/detail?id=470258 +// for the description of the bug (it existed in older Chrome versions as well). +jQuery.each( { + mouseenter: "mouseover", + mouseleave: "mouseout", + pointerenter: "pointerover", + pointerleave: "pointerout" +}, function( orig, fix ) { + jQuery.event.special[ orig ] = { + delegateType: fix, + bindType: fix, + + handle: function( event ) { + var ret, + target = this, + related = event.relatedTarget, + handleObj = event.handleObj; + + // For mouseenter/leave call the handler if related is outside the target. + // NB: No relatedTarget if the mouse left/entered the browser window + if ( !related || ( related !== target && !jQuery.contains( target, related ) ) ) { + event.type = handleObj.origType; + ret = handleObj.handler.apply( this, arguments ); + event.type = fix; + } + return ret; + } + }; +} ); + +jQuery.fn.extend( { + + on: function( types, selector, data, fn ) { + return on( this, types, selector, data, fn ); + }, + one: function( types, selector, data, fn ) { + return on( this, types, selector, data, fn, 1 ); + }, + off: function( types, selector, fn ) { + var handleObj, type; + if ( types && types.preventDefault && types.handleObj ) { + + // ( event ) dispatched jQuery.Event + handleObj = types.handleObj; + jQuery( types.delegateTarget ).off( + handleObj.namespace ? + handleObj.origType + "." + handleObj.namespace : + handleObj.origType, + handleObj.selector, + handleObj.handler + ); + return this; + } + if ( typeof types === "object" ) { + + // ( types-object [, selector] ) + for ( type in types ) { + this.off( type, selector, types[ type ] ); + } + return this; + } + if ( selector === false || typeof selector === "function" ) { + + // ( types [, fn] ) + fn = selector; + selector = undefined; + } + if ( fn === false ) { + fn = returnFalse; + } + return this.each( function() { + jQuery.event.remove( this, types, fn, selector ); + } ); + } +} ); + + +var + + // Support: IE <=10 - 11, Edge 12 - 13 only + // In IE/Edge using regex groups here causes severe slowdowns. + // See https://connect.microsoft.com/IE/feedback/details/1736512/ + rnoInnerhtml = /\s*$/g; + +// Prefer a tbody over its parent table for containing new rows +function manipulationTarget( elem, content ) { + if ( nodeName( elem, "table" ) && + nodeName( content.nodeType !== 11 ? content : content.firstChild, "tr" ) ) { + + return jQuery( elem ).children( "tbody" )[ 0 ] || elem; + } + + return elem; +} + +// Replace/restore the type attribute of script elements for safe DOM manipulation +function disableScript( elem ) { + elem.type = ( elem.getAttribute( "type" ) !== null ) + "/" + elem.type; + return elem; +} +function restoreScript( elem ) { + if ( ( elem.type || "" ).slice( 0, 5 ) === "true/" ) { + elem.type = elem.type.slice( 5 ); + } else { + elem.removeAttribute( "type" ); + } + + return elem; +} + +function cloneCopyEvent( src, dest ) { + var i, l, type, pdataOld, udataOld, udataCur, events; + + if ( dest.nodeType !== 1 ) { + return; + } + + // 1. Copy private data: events, handlers, etc. + if ( dataPriv.hasData( src ) ) { + pdataOld = dataPriv.get( src ); + events = pdataOld.events; + + if ( events ) { + dataPriv.remove( dest, "handle events" ); + + for ( type in events ) { + for ( i = 0, l = events[ type ].length; i < l; i++ ) { + jQuery.event.add( dest, type, events[ type ][ i ] ); + } + } + } + } + + // 2. Copy user data + if ( dataUser.hasData( src ) ) { + udataOld = dataUser.access( src ); + udataCur = jQuery.extend( {}, udataOld ); + + dataUser.set( dest, udataCur ); + } +} + +// Fix IE bugs, see support tests +function fixInput( src, dest ) { + var nodeName = dest.nodeName.toLowerCase(); + + // Fails to persist the checked state of a cloned checkbox or radio button. + if ( nodeName === "input" && rcheckableType.test( src.type ) ) { + dest.checked = src.checked; + + // Fails to return the selected option to the default selected state when cloning options + } else if ( nodeName === "input" || nodeName === "textarea" ) { + dest.defaultValue = src.defaultValue; + } +} + +function domManip( collection, args, callback, ignored ) { + + // Flatten any nested arrays + args = flat( args ); + + var fragment, first, scripts, hasScripts, node, doc, + i = 0, + l = collection.length, + iNoClone = l - 1, + value = args[ 0 ], + valueIsFunction = isFunction( value ); + + // We can't cloneNode fragments that contain checked, in WebKit + if ( valueIsFunction || + ( l > 1 && typeof value === "string" && + !support.checkClone && rchecked.test( value ) ) ) { + return collection.each( function( index ) { + var self = collection.eq( index ); + if ( valueIsFunction ) { + args[ 0 ] = value.call( this, index, self.html() ); + } + domManip( self, args, callback, ignored ); + } ); + } + + if ( l ) { + fragment = buildFragment( args, collection[ 0 ].ownerDocument, false, collection, ignored ); + first = fragment.firstChild; + + if ( fragment.childNodes.length === 1 ) { + fragment = first; + } + + // Require either new content or an interest in ignored elements to invoke the callback + if ( first || ignored ) { + scripts = jQuery.map( getAll( fragment, "script" ), disableScript ); + hasScripts = scripts.length; + + // Use the original fragment for the last item + // instead of the first because it can end up + // being emptied incorrectly in certain situations (#8070). + for ( ; i < l; i++ ) { + node = fragment; + + if ( i !== iNoClone ) { + node = jQuery.clone( node, true, true ); + + // Keep references to cloned scripts for later restoration + if ( hasScripts ) { + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( scripts, getAll( node, "script" ) ); + } + } + + callback.call( collection[ i ], node, i ); + } + + if ( hasScripts ) { + doc = scripts[ scripts.length - 1 ].ownerDocument; + + // Reenable scripts + jQuery.map( scripts, restoreScript ); + + // Evaluate executable scripts on first document insertion + for ( i = 0; i < hasScripts; i++ ) { + node = scripts[ i ]; + if ( rscriptType.test( node.type || "" ) && + !dataPriv.access( node, "globalEval" ) && + jQuery.contains( doc, node ) ) { + + if ( node.src && ( node.type || "" ).toLowerCase() !== "module" ) { + + // Optional AJAX dependency, but won't run scripts if not present + if ( jQuery._evalUrl && !node.noModule ) { + jQuery._evalUrl( node.src, { + nonce: node.nonce || node.getAttribute( "nonce" ) + }, doc ); + } + } else { + DOMEval( node.textContent.replace( rcleanScript, "" ), node, doc ); + } + } + } + } + } + } + + return collection; +} + +function remove( elem, selector, keepData ) { + var node, + nodes = selector ? jQuery.filter( selector, elem ) : elem, + i = 0; + + for ( ; ( node = nodes[ i ] ) != null; i++ ) { + if ( !keepData && node.nodeType === 1 ) { + jQuery.cleanData( getAll( node ) ); + } + + if ( node.parentNode ) { + if ( keepData && isAttached( node ) ) { + setGlobalEval( getAll( node, "script" ) ); + } + node.parentNode.removeChild( node ); + } + } + + return elem; +} + +jQuery.extend( { + htmlPrefilter: function( html ) { + return html; + }, + + clone: function( elem, dataAndEvents, deepDataAndEvents ) { + var i, l, srcElements, destElements, + clone = elem.cloneNode( true ), + inPage = isAttached( elem ); + + // Fix IE cloning issues + if ( !support.noCloneChecked && ( elem.nodeType === 1 || elem.nodeType === 11 ) && + !jQuery.isXMLDoc( elem ) ) { + + // We eschew Sizzle here for performance reasons: https://jsperf.com/getall-vs-sizzle/2 + destElements = getAll( clone ); + srcElements = getAll( elem ); + + for ( i = 0, l = srcElements.length; i < l; i++ ) { + fixInput( srcElements[ i ], destElements[ i ] ); + } + } + + // Copy the events from the original to the clone + if ( dataAndEvents ) { + if ( deepDataAndEvents ) { + srcElements = srcElements || getAll( elem ); + destElements = destElements || getAll( clone ); + + for ( i = 0, l = srcElements.length; i < l; i++ ) { + cloneCopyEvent( srcElements[ i ], destElements[ i ] ); + } + } else { + cloneCopyEvent( elem, clone ); + } + } + + // Preserve script evaluation history + destElements = getAll( clone, "script" ); + if ( destElements.length > 0 ) { + setGlobalEval( destElements, !inPage && getAll( elem, "script" ) ); + } + + // Return the cloned set + return clone; + }, + + cleanData: function( elems ) { + var data, elem, type, + special = jQuery.event.special, + i = 0; + + for ( ; ( elem = elems[ i ] ) !== undefined; i++ ) { + if ( acceptData( elem ) ) { + if ( ( data = elem[ dataPriv.expando ] ) ) { + if ( data.events ) { + for ( type in data.events ) { + if ( special[ type ] ) { + jQuery.event.remove( elem, type ); + + // This is a shortcut to avoid jQuery.event.remove's overhead + } else { + jQuery.removeEvent( elem, type, data.handle ); + } + } + } + + // Support: Chrome <=35 - 45+ + // Assign undefined instead of using delete, see Data#remove + elem[ dataPriv.expando ] = undefined; + } + if ( elem[ dataUser.expando ] ) { + + // Support: Chrome <=35 - 45+ + // Assign undefined instead of using delete, see Data#remove + elem[ dataUser.expando ] = undefined; + } + } + } + } +} ); + +jQuery.fn.extend( { + detach: function( selector ) { + return remove( this, selector, true ); + }, + + remove: function( selector ) { + return remove( this, selector ); + }, + + text: function( value ) { + return access( this, function( value ) { + return value === undefined ? + jQuery.text( this ) : + this.empty().each( function() { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + this.textContent = value; + } + } ); + }, null, value, arguments.length ); + }, + + append: function() { + return domManip( this, arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.appendChild( elem ); + } + } ); + }, + + prepend: function() { + return domManip( this, arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.insertBefore( elem, target.firstChild ); + } + } ); + }, + + before: function() { + return domManip( this, arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this ); + } + } ); + }, + + after: function() { + return domManip( this, arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this.nextSibling ); + } + } ); + }, + + empty: function() { + var elem, + i = 0; + + for ( ; ( elem = this[ i ] ) != null; i++ ) { + if ( elem.nodeType === 1 ) { + + // Prevent memory leaks + jQuery.cleanData( getAll( elem, false ) ); + + // Remove any remaining nodes + elem.textContent = ""; + } + } + + return this; + }, + + clone: function( dataAndEvents, deepDataAndEvents ) { + dataAndEvents = dataAndEvents == null ? false : dataAndEvents; + deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents; + + return this.map( function() { + return jQuery.clone( this, dataAndEvents, deepDataAndEvents ); + } ); + }, + + html: function( value ) { + return access( this, function( value ) { + var elem = this[ 0 ] || {}, + i = 0, + l = this.length; + + if ( value === undefined && elem.nodeType === 1 ) { + return elem.innerHTML; + } + + // See if we can take a shortcut and just use innerHTML + if ( typeof value === "string" && !rnoInnerhtml.test( value ) && + !wrapMap[ ( rtagName.exec( value ) || [ "", "" ] )[ 1 ].toLowerCase() ] ) { + + value = jQuery.htmlPrefilter( value ); + + try { + for ( ; i < l; i++ ) { + elem = this[ i ] || {}; + + // Remove element nodes and prevent memory leaks + if ( elem.nodeType === 1 ) { + jQuery.cleanData( getAll( elem, false ) ); + elem.innerHTML = value; + } + } + + elem = 0; + + // If using innerHTML throws an exception, use the fallback method + } catch ( e ) {} + } + + if ( elem ) { + this.empty().append( value ); + } + }, null, value, arguments.length ); + }, + + replaceWith: function() { + var ignored = []; + + // Make the changes, replacing each non-ignored context element with the new content + return domManip( this, arguments, function( elem ) { + var parent = this.parentNode; + + if ( jQuery.inArray( this, ignored ) < 0 ) { + jQuery.cleanData( getAll( this ) ); + if ( parent ) { + parent.replaceChild( elem, this ); + } + } + + // Force callback invocation + }, ignored ); + } +} ); + +jQuery.each( { + appendTo: "append", + prependTo: "prepend", + insertBefore: "before", + insertAfter: "after", + replaceAll: "replaceWith" +}, function( name, original ) { + jQuery.fn[ name ] = function( selector ) { + var elems, + ret = [], + insert = jQuery( selector ), + last = insert.length - 1, + i = 0; + + for ( ; i <= last; i++ ) { + elems = i === last ? this : this.clone( true ); + jQuery( insert[ i ] )[ original ]( elems ); + + // Support: Android <=4.0 only, PhantomJS 1 only + // .get() because push.apply(_, arraylike) throws on ancient WebKit + push.apply( ret, elems.get() ); + } + + return this.pushStack( ret ); + }; +} ); +var rnumnonpx = new RegExp( "^(" + pnum + ")(?!px)[a-z%]+$", "i" ); + +var getStyles = function( elem ) { + + // Support: IE <=11 only, Firefox <=30 (#15098, #14150) + // IE throws on elements created in popups + // FF meanwhile throws on frame elements through "defaultView.getComputedStyle" + var view = elem.ownerDocument.defaultView; + + if ( !view || !view.opener ) { + view = window; + } + + return view.getComputedStyle( elem ); + }; + +var swap = function( elem, options, callback ) { + var ret, name, + old = {}; + + // Remember the old values, and insert the new ones + for ( name in options ) { + old[ name ] = elem.style[ name ]; + elem.style[ name ] = options[ name ]; + } + + ret = callback.call( elem ); + + // Revert the old values + for ( name in options ) { + elem.style[ name ] = old[ name ]; + } + + return ret; +}; + + +var rboxStyle = new RegExp( cssExpand.join( "|" ), "i" ); + + + +( function() { + + // Executing both pixelPosition & boxSizingReliable tests require only one layout + // so they're executed at the same time to save the second computation. + function computeStyleTests() { + + // This is a singleton, we need to execute it only once + if ( !div ) { + return; + } + + container.style.cssText = "position:absolute;left:-11111px;width:60px;" + + "margin-top:1px;padding:0;border:0"; + div.style.cssText = + "position:relative;display:block;box-sizing:border-box;overflow:scroll;" + + "margin:auto;border:1px;padding:1px;" + + "width:60%;top:1%"; + documentElement.appendChild( container ).appendChild( div ); + + var divStyle = window.getComputedStyle( div ); + pixelPositionVal = divStyle.top !== "1%"; + + // Support: Android 4.0 - 4.3 only, Firefox <=3 - 44 + reliableMarginLeftVal = roundPixelMeasures( divStyle.marginLeft ) === 12; + + // Support: Android 4.0 - 4.3 only, Safari <=9.1 - 10.1, iOS <=7.0 - 9.3 + // Some styles come back with percentage values, even though they shouldn't + div.style.right = "60%"; + pixelBoxStylesVal = roundPixelMeasures( divStyle.right ) === 36; + + // Support: IE 9 - 11 only + // Detect misreporting of content dimensions for box-sizing:border-box elements + boxSizingReliableVal = roundPixelMeasures( divStyle.width ) === 36; + + // Support: IE 9 only + // Detect overflow:scroll screwiness (gh-3699) + // Support: Chrome <=64 + // Don't get tricked when zoom affects offsetWidth (gh-4029) + div.style.position = "absolute"; + scrollboxSizeVal = roundPixelMeasures( div.offsetWidth / 3 ) === 12; + + documentElement.removeChild( container ); + + // Nullify the div so it wouldn't be stored in the memory and + // it will also be a sign that checks already performed + div = null; + } + + function roundPixelMeasures( measure ) { + return Math.round( parseFloat( measure ) ); + } + + var pixelPositionVal, boxSizingReliableVal, scrollboxSizeVal, pixelBoxStylesVal, + reliableTrDimensionsVal, reliableMarginLeftVal, + container = document.createElement( "div" ), + div = document.createElement( "div" ); + + // Finish early in limited (non-browser) environments + if ( !div.style ) { + return; + } + + // Support: IE <=9 - 11 only + // Style of cloned element affects source element cloned (#8908) + div.style.backgroundClip = "content-box"; + div.cloneNode( true ).style.backgroundClip = ""; + support.clearCloneStyle = div.style.backgroundClip === "content-box"; + + jQuery.extend( support, { + boxSizingReliable: function() { + computeStyleTests(); + return boxSizingReliableVal; + }, + pixelBoxStyles: function() { + computeStyleTests(); + return pixelBoxStylesVal; + }, + pixelPosition: function() { + computeStyleTests(); + return pixelPositionVal; + }, + reliableMarginLeft: function() { + computeStyleTests(); + return reliableMarginLeftVal; + }, + scrollboxSize: function() { + computeStyleTests(); + return scrollboxSizeVal; + }, + + // Support: IE 9 - 11+, Edge 15 - 18+ + // IE/Edge misreport `getComputedStyle` of table rows with width/height + // set in CSS while `offset*` properties report correct values. + // Behavior in IE 9 is more subtle than in newer versions & it passes + // some versions of this test; make sure not to make it pass there! + reliableTrDimensions: function() { + var table, tr, trChild, trStyle; + if ( reliableTrDimensionsVal == null ) { + table = document.createElement( "table" ); + tr = document.createElement( "tr" ); + trChild = document.createElement( "div" ); + + table.style.cssText = "position:absolute;left:-11111px"; + tr.style.height = "1px"; + trChild.style.height = "9px"; + + documentElement + .appendChild( table ) + .appendChild( tr ) + .appendChild( trChild ); + + trStyle = window.getComputedStyle( tr ); + reliableTrDimensionsVal = parseInt( trStyle.height ) > 3; + + documentElement.removeChild( table ); + } + return reliableTrDimensionsVal; + } + } ); +} )(); + + +function curCSS( elem, name, computed ) { + var width, minWidth, maxWidth, ret, + + // Support: Firefox 51+ + // Retrieving style before computed somehow + // fixes an issue with getting wrong values + // on detached elements + style = elem.style; + + computed = computed || getStyles( elem ); + + // getPropertyValue is needed for: + // .css('filter') (IE 9 only, #12537) + // .css('--customProperty) (#3144) + if ( computed ) { + ret = computed.getPropertyValue( name ) || computed[ name ]; + + if ( ret === "" && !isAttached( elem ) ) { + ret = jQuery.style( elem, name ); + } + + // A tribute to the "awesome hack by Dean Edwards" + // Android Browser returns percentage for some values, + // but width seems to be reliably pixels. + // This is against the CSSOM draft spec: + // https://drafts.csswg.org/cssom/#resolved-values + if ( !support.pixelBoxStyles() && rnumnonpx.test( ret ) && rboxStyle.test( name ) ) { + + // Remember the original values + width = style.width; + minWidth = style.minWidth; + maxWidth = style.maxWidth; + + // Put in the new values to get a computed value out + style.minWidth = style.maxWidth = style.width = ret; + ret = computed.width; + + // Revert the changed values + style.width = width; + style.minWidth = minWidth; + style.maxWidth = maxWidth; + } + } + + return ret !== undefined ? + + // Support: IE <=9 - 11 only + // IE returns zIndex value as an integer. + ret + "" : + ret; +} + + +function addGetHookIf( conditionFn, hookFn ) { + + // Define the hook, we'll check on the first run if it's really needed. + return { + get: function() { + if ( conditionFn() ) { + + // Hook not needed (or it's not possible to use it due + // to missing dependency), remove it. + delete this.get; + return; + } + + // Hook needed; redefine it so that the support test is not executed again. + return ( this.get = hookFn ).apply( this, arguments ); + } + }; +} + + +var cssPrefixes = [ "Webkit", "Moz", "ms" ], + emptyStyle = document.createElement( "div" ).style, + vendorProps = {}; + +// Return a vendor-prefixed property or undefined +function vendorPropName( name ) { + + // Check for vendor prefixed names + var capName = name[ 0 ].toUpperCase() + name.slice( 1 ), + i = cssPrefixes.length; + + while ( i-- ) { + name = cssPrefixes[ i ] + capName; + if ( name in emptyStyle ) { + return name; + } + } +} + +// Return a potentially-mapped jQuery.cssProps or vendor prefixed property +function finalPropName( name ) { + var final = jQuery.cssProps[ name ] || vendorProps[ name ]; + + if ( final ) { + return final; + } + if ( name in emptyStyle ) { + return name; + } + return vendorProps[ name ] = vendorPropName( name ) || name; +} + + +var + + // Swappable if display is none or starts with table + // except "table", "table-cell", or "table-caption" + // See here for display values: https://developer.mozilla.org/en-US/docs/CSS/display + rdisplayswap = /^(none|table(?!-c[ea]).+)/, + rcustomProp = /^--/, + cssShow = { position: "absolute", visibility: "hidden", display: "block" }, + cssNormalTransform = { + letterSpacing: "0", + fontWeight: "400" + }; + +function setPositiveNumber( _elem, value, subtract ) { + + // Any relative (+/-) values have already been + // normalized at this point + var matches = rcssNum.exec( value ); + return matches ? + + // Guard against undefined "subtract", e.g., when used as in cssHooks + Math.max( 0, matches[ 2 ] - ( subtract || 0 ) ) + ( matches[ 3 ] || "px" ) : + value; +} + +function boxModelAdjustment( elem, dimension, box, isBorderBox, styles, computedVal ) { + var i = dimension === "width" ? 1 : 0, + extra = 0, + delta = 0; + + // Adjustment may not be necessary + if ( box === ( isBorderBox ? "border" : "content" ) ) { + return 0; + } + + for ( ; i < 4; i += 2 ) { + + // Both box models exclude margin + if ( box === "margin" ) { + delta += jQuery.css( elem, box + cssExpand[ i ], true, styles ); + } + + // If we get here with a content-box, we're seeking "padding" or "border" or "margin" + if ( !isBorderBox ) { + + // Add padding + delta += jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); + + // For "border" or "margin", add border + if ( box !== "padding" ) { + delta += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + + // But still keep track of it otherwise + } else { + extra += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + } + + // If we get here with a border-box (content + padding + border), we're seeking "content" or + // "padding" or "margin" + } else { + + // For "content", subtract padding + if ( box === "content" ) { + delta -= jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); + } + + // For "content" or "padding", subtract border + if ( box !== "margin" ) { + delta -= jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + } + } + } + + // Account for positive content-box scroll gutter when requested by providing computedVal + if ( !isBorderBox && computedVal >= 0 ) { + + // offsetWidth/offsetHeight is a rounded sum of content, padding, scroll gutter, and border + // Assuming integer scroll gutter, subtract the rest and round down + delta += Math.max( 0, Math.ceil( + elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - + computedVal - + delta - + extra - + 0.5 + + // If offsetWidth/offsetHeight is unknown, then we can't determine content-box scroll gutter + // Use an explicit zero to avoid NaN (gh-3964) + ) ) || 0; + } + + return delta; +} + +function getWidthOrHeight( elem, dimension, extra ) { + + // Start with computed style + var styles = getStyles( elem ), + + // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-4322). + // Fake content-box until we know it's needed to know the true value. + boxSizingNeeded = !support.boxSizingReliable() || extra, + isBorderBox = boxSizingNeeded && + jQuery.css( elem, "boxSizing", false, styles ) === "border-box", + valueIsBorderBox = isBorderBox, + + val = curCSS( elem, dimension, styles ), + offsetProp = "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ); + + // Support: Firefox <=54 + // Return a confounding non-pixel value or feign ignorance, as appropriate. + if ( rnumnonpx.test( val ) ) { + if ( !extra ) { + return val; + } + val = "auto"; + } + + + // Support: IE 9 - 11 only + // Use offsetWidth/offsetHeight for when box sizing is unreliable. + // In those cases, the computed value can be trusted to be border-box. + if ( ( !support.boxSizingReliable() && isBorderBox || + + // Support: IE 10 - 11+, Edge 15 - 18+ + // IE/Edge misreport `getComputedStyle` of table rows with width/height + // set in CSS while `offset*` properties report correct values. + // Interestingly, in some cases IE 9 doesn't suffer from this issue. + !support.reliableTrDimensions() && nodeName( elem, "tr" ) || + + // Fall back to offsetWidth/offsetHeight when value is "auto" + // This happens for inline elements with no explicit setting (gh-3571) + val === "auto" || + + // Support: Android <=4.1 - 4.3 only + // Also use offsetWidth/offsetHeight for misreported inline dimensions (gh-3602) + !parseFloat( val ) && jQuery.css( elem, "display", false, styles ) === "inline" ) && + + // Make sure the element is visible & connected + elem.getClientRects().length ) { + + isBorderBox = jQuery.css( elem, "boxSizing", false, styles ) === "border-box"; + + // Where available, offsetWidth/offsetHeight approximate border box dimensions. + // Where not available (e.g., SVG), assume unreliable box-sizing and interpret the + // retrieved value as a content box dimension. + valueIsBorderBox = offsetProp in elem; + if ( valueIsBorderBox ) { + val = elem[ offsetProp ]; + } + } + + // Normalize "" and auto + val = parseFloat( val ) || 0; + + // Adjust for the element's box model + return ( val + + boxModelAdjustment( + elem, + dimension, + extra || ( isBorderBox ? "border" : "content" ), + valueIsBorderBox, + styles, + + // Provide the current computed size to request scroll gutter calculation (gh-3589) + val + ) + ) + "px"; +} + +jQuery.extend( { + + // Add in style property hooks for overriding the default + // behavior of getting and setting a style property + cssHooks: { + opacity: { + get: function( elem, computed ) { + if ( computed ) { + + // We should always get a number back from opacity + var ret = curCSS( elem, "opacity" ); + return ret === "" ? "1" : ret; + } + } + } + }, + + // Don't automatically add "px" to these possibly-unitless properties + cssNumber: { + "animationIterationCount": true, + "columnCount": true, + "fillOpacity": true, + "flexGrow": true, + "flexShrink": true, + "fontWeight": true, + "gridArea": true, + "gridColumn": true, + "gridColumnEnd": true, + "gridColumnStart": true, + "gridRow": true, + "gridRowEnd": true, + "gridRowStart": true, + "lineHeight": true, + "opacity": true, + "order": true, + "orphans": true, + "widows": true, + "zIndex": true, + "zoom": true + }, + + // Add in properties whose names you wish to fix before + // setting or getting the value + cssProps: {}, + + // Get and set the style property on a DOM Node + style: function( elem, name, value, extra ) { + + // Don't set styles on text and comment nodes + if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) { + return; + } + + // Make sure that we're working with the right name + var ret, type, hooks, + origName = camelCase( name ), + isCustomProp = rcustomProp.test( name ), + style = elem.style; + + // Make sure that we're working with the right name. We don't + // want to query the value if it is a CSS custom property + // since they are user-defined. + if ( !isCustomProp ) { + name = finalPropName( origName ); + } + + // Gets hook for the prefixed version, then unprefixed version + hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; + + // Check if we're setting a value + if ( value !== undefined ) { + type = typeof value; + + // Convert "+=" or "-=" to relative numbers (#7345) + if ( type === "string" && ( ret = rcssNum.exec( value ) ) && ret[ 1 ] ) { + value = adjustCSS( elem, name, ret ); + + // Fixes bug #9237 + type = "number"; + } + + // Make sure that null and NaN values aren't set (#7116) + if ( value == null || value !== value ) { + return; + } + + // If a number was passed in, add the unit (except for certain CSS properties) + // The isCustomProp check can be removed in jQuery 4.0 when we only auto-append + // "px" to a few hardcoded values. + if ( type === "number" && !isCustomProp ) { + value += ret && ret[ 3 ] || ( jQuery.cssNumber[ origName ] ? "" : "px" ); + } + + // background-* props affect original clone's values + if ( !support.clearCloneStyle && value === "" && name.indexOf( "background" ) === 0 ) { + style[ name ] = "inherit"; + } + + // If a hook was provided, use that value, otherwise just set the specified value + if ( !hooks || !( "set" in hooks ) || + ( value = hooks.set( elem, value, extra ) ) !== undefined ) { + + if ( isCustomProp ) { + style.setProperty( name, value ); + } else { + style[ name ] = value; + } + } + + } else { + + // If a hook was provided get the non-computed value from there + if ( hooks && "get" in hooks && + ( ret = hooks.get( elem, false, extra ) ) !== undefined ) { + + return ret; + } + + // Otherwise just get the value from the style object + return style[ name ]; + } + }, + + css: function( elem, name, extra, styles ) { + var val, num, hooks, + origName = camelCase( name ), + isCustomProp = rcustomProp.test( name ); + + // Make sure that we're working with the right name. We don't + // want to modify the value if it is a CSS custom property + // since they are user-defined. + if ( !isCustomProp ) { + name = finalPropName( origName ); + } + + // Try prefixed name followed by the unprefixed name + hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; + + // If a hook was provided get the computed value from there + if ( hooks && "get" in hooks ) { + val = hooks.get( elem, true, extra ); + } + + // Otherwise, if a way to get the computed value exists, use that + if ( val === undefined ) { + val = curCSS( elem, name, styles ); + } + + // Convert "normal" to computed value + if ( val === "normal" && name in cssNormalTransform ) { + val = cssNormalTransform[ name ]; + } + + // Make numeric if forced or a qualifier was provided and val looks numeric + if ( extra === "" || extra ) { + num = parseFloat( val ); + return extra === true || isFinite( num ) ? num || 0 : val; + } + + return val; + } +} ); + +jQuery.each( [ "height", "width" ], function( _i, dimension ) { + jQuery.cssHooks[ dimension ] = { + get: function( elem, computed, extra ) { + if ( computed ) { + + // Certain elements can have dimension info if we invisibly show them + // but it must have a current display style that would benefit + return rdisplayswap.test( jQuery.css( elem, "display" ) ) && + + // Support: Safari 8+ + // Table columns in Safari have non-zero offsetWidth & zero + // getBoundingClientRect().width unless display is changed. + // Support: IE <=11 only + // Running getBoundingClientRect on a disconnected node + // in IE throws an error. + ( !elem.getClientRects().length || !elem.getBoundingClientRect().width ) ? + swap( elem, cssShow, function() { + return getWidthOrHeight( elem, dimension, extra ); + } ) : + getWidthOrHeight( elem, dimension, extra ); + } + }, + + set: function( elem, value, extra ) { + var matches, + styles = getStyles( elem ), + + // Only read styles.position if the test has a chance to fail + // to avoid forcing a reflow. + scrollboxSizeBuggy = !support.scrollboxSize() && + styles.position === "absolute", + + // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-3991) + boxSizingNeeded = scrollboxSizeBuggy || extra, + isBorderBox = boxSizingNeeded && + jQuery.css( elem, "boxSizing", false, styles ) === "border-box", + subtract = extra ? + boxModelAdjustment( + elem, + dimension, + extra, + isBorderBox, + styles + ) : + 0; + + // Account for unreliable border-box dimensions by comparing offset* to computed and + // faking a content-box to get border and padding (gh-3699) + if ( isBorderBox && scrollboxSizeBuggy ) { + subtract -= Math.ceil( + elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - + parseFloat( styles[ dimension ] ) - + boxModelAdjustment( elem, dimension, "border", false, styles ) - + 0.5 + ); + } + + // Convert to pixels if value adjustment is needed + if ( subtract && ( matches = rcssNum.exec( value ) ) && + ( matches[ 3 ] || "px" ) !== "px" ) { + + elem.style[ dimension ] = value; + value = jQuery.css( elem, dimension ); + } + + return setPositiveNumber( elem, value, subtract ); + } + }; +} ); + +jQuery.cssHooks.marginLeft = addGetHookIf( support.reliableMarginLeft, + function( elem, computed ) { + if ( computed ) { + return ( parseFloat( curCSS( elem, "marginLeft" ) ) || + elem.getBoundingClientRect().left - + swap( elem, { marginLeft: 0 }, function() { + return elem.getBoundingClientRect().left; + } ) + ) + "px"; + } + } +); + +// These hooks are used by animate to expand properties +jQuery.each( { + margin: "", + padding: "", + border: "Width" +}, function( prefix, suffix ) { + jQuery.cssHooks[ prefix + suffix ] = { + expand: function( value ) { + var i = 0, + expanded = {}, + + // Assumes a single number if not a string + parts = typeof value === "string" ? value.split( " " ) : [ value ]; + + for ( ; i < 4; i++ ) { + expanded[ prefix + cssExpand[ i ] + suffix ] = + parts[ i ] || parts[ i - 2 ] || parts[ 0 ]; + } + + return expanded; + } + }; + + if ( prefix !== "margin" ) { + jQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber; + } +} ); + +jQuery.fn.extend( { + css: function( name, value ) { + return access( this, function( elem, name, value ) { + var styles, len, + map = {}, + i = 0; + + if ( Array.isArray( name ) ) { + styles = getStyles( elem ); + len = name.length; + + for ( ; i < len; i++ ) { + map[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles ); + } + + return map; + } + + return value !== undefined ? + jQuery.style( elem, name, value ) : + jQuery.css( elem, name ); + }, name, value, arguments.length > 1 ); + } +} ); + + +function Tween( elem, options, prop, end, easing ) { + return new Tween.prototype.init( elem, options, prop, end, easing ); +} +jQuery.Tween = Tween; + +Tween.prototype = { + constructor: Tween, + init: function( elem, options, prop, end, easing, unit ) { + this.elem = elem; + this.prop = prop; + this.easing = easing || jQuery.easing._default; + this.options = options; + this.start = this.now = this.cur(); + this.end = end; + this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" ); + }, + cur: function() { + var hooks = Tween.propHooks[ this.prop ]; + + return hooks && hooks.get ? + hooks.get( this ) : + Tween.propHooks._default.get( this ); + }, + run: function( percent ) { + var eased, + hooks = Tween.propHooks[ this.prop ]; + + if ( this.options.duration ) { + this.pos = eased = jQuery.easing[ this.easing ]( + percent, this.options.duration * percent, 0, 1, this.options.duration + ); + } else { + this.pos = eased = percent; + } + this.now = ( this.end - this.start ) * eased + this.start; + + if ( this.options.step ) { + this.options.step.call( this.elem, this.now, this ); + } + + if ( hooks && hooks.set ) { + hooks.set( this ); + } else { + Tween.propHooks._default.set( this ); + } + return this; + } +}; + +Tween.prototype.init.prototype = Tween.prototype; + +Tween.propHooks = { + _default: { + get: function( tween ) { + var result; + + // Use a property on the element directly when it is not a DOM element, + // or when there is no matching style property that exists. + if ( tween.elem.nodeType !== 1 || + tween.elem[ tween.prop ] != null && tween.elem.style[ tween.prop ] == null ) { + return tween.elem[ tween.prop ]; + } + + // Passing an empty string as a 3rd parameter to .css will automatically + // attempt a parseFloat and fallback to a string if the parse fails. + // Simple values such as "10px" are parsed to Float; + // complex values such as "rotate(1rad)" are returned as-is. + result = jQuery.css( tween.elem, tween.prop, "" ); + + // Empty strings, null, undefined and "auto" are converted to 0. + return !result || result === "auto" ? 0 : result; + }, + set: function( tween ) { + + // Use step hook for back compat. + // Use cssHook if its there. + // Use .style if available and use plain properties where available. + if ( jQuery.fx.step[ tween.prop ] ) { + jQuery.fx.step[ tween.prop ]( tween ); + } else if ( tween.elem.nodeType === 1 && ( + jQuery.cssHooks[ tween.prop ] || + tween.elem.style[ finalPropName( tween.prop ) ] != null ) ) { + jQuery.style( tween.elem, tween.prop, tween.now + tween.unit ); + } else { + tween.elem[ tween.prop ] = tween.now; + } + } + } +}; + +// Support: IE <=9 only +// Panic based approach to setting things on disconnected nodes +Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = { + set: function( tween ) { + if ( tween.elem.nodeType && tween.elem.parentNode ) { + tween.elem[ tween.prop ] = tween.now; + } + } +}; + +jQuery.easing = { + linear: function( p ) { + return p; + }, + swing: function( p ) { + return 0.5 - Math.cos( p * Math.PI ) / 2; + }, + _default: "swing" +}; + +jQuery.fx = Tween.prototype.init; + +// Back compat <1.8 extension point +jQuery.fx.step = {}; + + + + +var + fxNow, inProgress, + rfxtypes = /^(?:toggle|show|hide)$/, + rrun = /queueHooks$/; + +function schedule() { + if ( inProgress ) { + if ( document.hidden === false && window.requestAnimationFrame ) { + window.requestAnimationFrame( schedule ); + } else { + window.setTimeout( schedule, jQuery.fx.interval ); + } + + jQuery.fx.tick(); + } +} + +// Animations created synchronously will run synchronously +function createFxNow() { + window.setTimeout( function() { + fxNow = undefined; + } ); + return ( fxNow = Date.now() ); +} + +// Generate parameters to create a standard animation +function genFx( type, includeWidth ) { + var which, + i = 0, + attrs = { height: type }; + + // If we include width, step value is 1 to do all cssExpand values, + // otherwise step value is 2 to skip over Left and Right + includeWidth = includeWidth ? 1 : 0; + for ( ; i < 4; i += 2 - includeWidth ) { + which = cssExpand[ i ]; + attrs[ "margin" + which ] = attrs[ "padding" + which ] = type; + } + + if ( includeWidth ) { + attrs.opacity = attrs.width = type; + } + + return attrs; +} + +function createTween( value, prop, animation ) { + var tween, + collection = ( Animation.tweeners[ prop ] || [] ).concat( Animation.tweeners[ "*" ] ), + index = 0, + length = collection.length; + for ( ; index < length; index++ ) { + if ( ( tween = collection[ index ].call( animation, prop, value ) ) ) { + + // We're done with this property + return tween; + } + } +} + +function defaultPrefilter( elem, props, opts ) { + var prop, value, toggle, hooks, oldfire, propTween, restoreDisplay, display, + isBox = "width" in props || "height" in props, + anim = this, + orig = {}, + style = elem.style, + hidden = elem.nodeType && isHiddenWithinTree( elem ), + dataShow = dataPriv.get( elem, "fxshow" ); + + // Queue-skipping animations hijack the fx hooks + if ( !opts.queue ) { + hooks = jQuery._queueHooks( elem, "fx" ); + if ( hooks.unqueued == null ) { + hooks.unqueued = 0; + oldfire = hooks.empty.fire; + hooks.empty.fire = function() { + if ( !hooks.unqueued ) { + oldfire(); + } + }; + } + hooks.unqueued++; + + anim.always( function() { + + // Ensure the complete handler is called before this completes + anim.always( function() { + hooks.unqueued--; + if ( !jQuery.queue( elem, "fx" ).length ) { + hooks.empty.fire(); + } + } ); + } ); + } + + // Detect show/hide animations + for ( prop in props ) { + value = props[ prop ]; + if ( rfxtypes.test( value ) ) { + delete props[ prop ]; + toggle = toggle || value === "toggle"; + if ( value === ( hidden ? "hide" : "show" ) ) { + + // Pretend to be hidden if this is a "show" and + // there is still data from a stopped show/hide + if ( value === "show" && dataShow && dataShow[ prop ] !== undefined ) { + hidden = true; + + // Ignore all other no-op show/hide data + } else { + continue; + } + } + orig[ prop ] = dataShow && dataShow[ prop ] || jQuery.style( elem, prop ); + } + } + + // Bail out if this is a no-op like .hide().hide() + propTween = !jQuery.isEmptyObject( props ); + if ( !propTween && jQuery.isEmptyObject( orig ) ) { + return; + } + + // Restrict "overflow" and "display" styles during box animations + if ( isBox && elem.nodeType === 1 ) { + + // Support: IE <=9 - 11, Edge 12 - 15 + // Record all 3 overflow attributes because IE does not infer the shorthand + // from identically-valued overflowX and overflowY and Edge just mirrors + // the overflowX value there. + opts.overflow = [ style.overflow, style.overflowX, style.overflowY ]; + + // Identify a display type, preferring old show/hide data over the CSS cascade + restoreDisplay = dataShow && dataShow.display; + if ( restoreDisplay == null ) { + restoreDisplay = dataPriv.get( elem, "display" ); + } + display = jQuery.css( elem, "display" ); + if ( display === "none" ) { + if ( restoreDisplay ) { + display = restoreDisplay; + } else { + + // Get nonempty value(s) by temporarily forcing visibility + showHide( [ elem ], true ); + restoreDisplay = elem.style.display || restoreDisplay; + display = jQuery.css( elem, "display" ); + showHide( [ elem ] ); + } + } + + // Animate inline elements as inline-block + if ( display === "inline" || display === "inline-block" && restoreDisplay != null ) { + if ( jQuery.css( elem, "float" ) === "none" ) { + + // Restore the original display value at the end of pure show/hide animations + if ( !propTween ) { + anim.done( function() { + style.display = restoreDisplay; + } ); + if ( restoreDisplay == null ) { + display = style.display; + restoreDisplay = display === "none" ? "" : display; + } + } + style.display = "inline-block"; + } + } + } + + if ( opts.overflow ) { + style.overflow = "hidden"; + anim.always( function() { + style.overflow = opts.overflow[ 0 ]; + style.overflowX = opts.overflow[ 1 ]; + style.overflowY = opts.overflow[ 2 ]; + } ); + } + + // Implement show/hide animations + propTween = false; + for ( prop in orig ) { + + // General show/hide setup for this element animation + if ( !propTween ) { + if ( dataShow ) { + if ( "hidden" in dataShow ) { + hidden = dataShow.hidden; + } + } else { + dataShow = dataPriv.access( elem, "fxshow", { display: restoreDisplay } ); + } + + // Store hidden/visible for toggle so `.stop().toggle()` "reverses" + if ( toggle ) { + dataShow.hidden = !hidden; + } + + // Show elements before animating them + if ( hidden ) { + showHide( [ elem ], true ); + } + + /* eslint-disable no-loop-func */ + + anim.done( function() { + + /* eslint-enable no-loop-func */ + + // The final step of a "hide" animation is actually hiding the element + if ( !hidden ) { + showHide( [ elem ] ); + } + dataPriv.remove( elem, "fxshow" ); + for ( prop in orig ) { + jQuery.style( elem, prop, orig[ prop ] ); + } + } ); + } + + // Per-property setup + propTween = createTween( hidden ? dataShow[ prop ] : 0, prop, anim ); + if ( !( prop in dataShow ) ) { + dataShow[ prop ] = propTween.start; + if ( hidden ) { + propTween.end = propTween.start; + propTween.start = 0; + } + } + } +} + +function propFilter( props, specialEasing ) { + var index, name, easing, value, hooks; + + // camelCase, specialEasing and expand cssHook pass + for ( index in props ) { + name = camelCase( index ); + easing = specialEasing[ name ]; + value = props[ index ]; + if ( Array.isArray( value ) ) { + easing = value[ 1 ]; + value = props[ index ] = value[ 0 ]; + } + + if ( index !== name ) { + props[ name ] = value; + delete props[ index ]; + } + + hooks = jQuery.cssHooks[ name ]; + if ( hooks && "expand" in hooks ) { + value = hooks.expand( value ); + delete props[ name ]; + + // Not quite $.extend, this won't overwrite existing keys. + // Reusing 'index' because we have the correct "name" + for ( index in value ) { + if ( !( index in props ) ) { + props[ index ] = value[ index ]; + specialEasing[ index ] = easing; + } + } + } else { + specialEasing[ name ] = easing; + } + } +} + +function Animation( elem, properties, options ) { + var result, + stopped, + index = 0, + length = Animation.prefilters.length, + deferred = jQuery.Deferred().always( function() { + + // Don't match elem in the :animated selector + delete tick.elem; + } ), + tick = function() { + if ( stopped ) { + return false; + } + var currentTime = fxNow || createFxNow(), + remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ), + + // Support: Android 2.3 only + // Archaic crash bug won't allow us to use `1 - ( 0.5 || 0 )` (#12497) + temp = remaining / animation.duration || 0, + percent = 1 - temp, + index = 0, + length = animation.tweens.length; + + for ( ; index < length; index++ ) { + animation.tweens[ index ].run( percent ); + } + + deferred.notifyWith( elem, [ animation, percent, remaining ] ); + + // If there's more to do, yield + if ( percent < 1 && length ) { + return remaining; + } + + // If this was an empty animation, synthesize a final progress notification + if ( !length ) { + deferred.notifyWith( elem, [ animation, 1, 0 ] ); + } + + // Resolve the animation and report its conclusion + deferred.resolveWith( elem, [ animation ] ); + return false; + }, + animation = deferred.promise( { + elem: elem, + props: jQuery.extend( {}, properties ), + opts: jQuery.extend( true, { + specialEasing: {}, + easing: jQuery.easing._default + }, options ), + originalProperties: properties, + originalOptions: options, + startTime: fxNow || createFxNow(), + duration: options.duration, + tweens: [], + createTween: function( prop, end ) { + var tween = jQuery.Tween( elem, animation.opts, prop, end, + animation.opts.specialEasing[ prop ] || animation.opts.easing ); + animation.tweens.push( tween ); + return tween; + }, + stop: function( gotoEnd ) { + var index = 0, + + // If we are going to the end, we want to run all the tweens + // otherwise we skip this part + length = gotoEnd ? animation.tweens.length : 0; + if ( stopped ) { + return this; + } + stopped = true; + for ( ; index < length; index++ ) { + animation.tweens[ index ].run( 1 ); + } + + // Resolve when we played the last frame; otherwise, reject + if ( gotoEnd ) { + deferred.notifyWith( elem, [ animation, 1, 0 ] ); + deferred.resolveWith( elem, [ animation, gotoEnd ] ); + } else { + deferred.rejectWith( elem, [ animation, gotoEnd ] ); + } + return this; + } + } ), + props = animation.props; + + propFilter( props, animation.opts.specialEasing ); + + for ( ; index < length; index++ ) { + result = Animation.prefilters[ index ].call( animation, elem, props, animation.opts ); + if ( result ) { + if ( isFunction( result.stop ) ) { + jQuery._queueHooks( animation.elem, animation.opts.queue ).stop = + result.stop.bind( result ); + } + return result; + } + } + + jQuery.map( props, createTween, animation ); + + if ( isFunction( animation.opts.start ) ) { + animation.opts.start.call( elem, animation ); + } + + // Attach callbacks from options + animation + .progress( animation.opts.progress ) + .done( animation.opts.done, animation.opts.complete ) + .fail( animation.opts.fail ) + .always( animation.opts.always ); + + jQuery.fx.timer( + jQuery.extend( tick, { + elem: elem, + anim: animation, + queue: animation.opts.queue + } ) + ); + + return animation; +} + +jQuery.Animation = jQuery.extend( Animation, { + + tweeners: { + "*": [ function( prop, value ) { + var tween = this.createTween( prop, value ); + adjustCSS( tween.elem, prop, rcssNum.exec( value ), tween ); + return tween; + } ] + }, + + tweener: function( props, callback ) { + if ( isFunction( props ) ) { + callback = props; + props = [ "*" ]; + } else { + props = props.match( rnothtmlwhite ); + } + + var prop, + index = 0, + length = props.length; + + for ( ; index < length; index++ ) { + prop = props[ index ]; + Animation.tweeners[ prop ] = Animation.tweeners[ prop ] || []; + Animation.tweeners[ prop ].unshift( callback ); + } + }, + + prefilters: [ defaultPrefilter ], + + prefilter: function( callback, prepend ) { + if ( prepend ) { + Animation.prefilters.unshift( callback ); + } else { + Animation.prefilters.push( callback ); + } + } +} ); + +jQuery.speed = function( speed, easing, fn ) { + var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : { + complete: fn || !fn && easing || + isFunction( speed ) && speed, + duration: speed, + easing: fn && easing || easing && !isFunction( easing ) && easing + }; + + // Go to the end state if fx are off + if ( jQuery.fx.off ) { + opt.duration = 0; + + } else { + if ( typeof opt.duration !== "number" ) { + if ( opt.duration in jQuery.fx.speeds ) { + opt.duration = jQuery.fx.speeds[ opt.duration ]; + + } else { + opt.duration = jQuery.fx.speeds._default; + } + } + } + + // Normalize opt.queue - true/undefined/null -> "fx" + if ( opt.queue == null || opt.queue === true ) { + opt.queue = "fx"; + } + + // Queueing + opt.old = opt.complete; + + opt.complete = function() { + if ( isFunction( opt.old ) ) { + opt.old.call( this ); + } + + if ( opt.queue ) { + jQuery.dequeue( this, opt.queue ); + } + }; + + return opt; +}; + +jQuery.fn.extend( { + fadeTo: function( speed, to, easing, callback ) { + + // Show any hidden elements after setting opacity to 0 + return this.filter( isHiddenWithinTree ).css( "opacity", 0 ).show() + + // Animate to the value specified + .end().animate( { opacity: to }, speed, easing, callback ); + }, + animate: function( prop, speed, easing, callback ) { + var empty = jQuery.isEmptyObject( prop ), + optall = jQuery.speed( speed, easing, callback ), + doAnimation = function() { + + // Operate on a copy of prop so per-property easing won't be lost + var anim = Animation( this, jQuery.extend( {}, prop ), optall ); + + // Empty animations, or finishing resolves immediately + if ( empty || dataPriv.get( this, "finish" ) ) { + anim.stop( true ); + } + }; + doAnimation.finish = doAnimation; + + return empty || optall.queue === false ? + this.each( doAnimation ) : + this.queue( optall.queue, doAnimation ); + }, + stop: function( type, clearQueue, gotoEnd ) { + var stopQueue = function( hooks ) { + var stop = hooks.stop; + delete hooks.stop; + stop( gotoEnd ); + }; + + if ( typeof type !== "string" ) { + gotoEnd = clearQueue; + clearQueue = type; + type = undefined; + } + if ( clearQueue ) { + this.queue( type || "fx", [] ); + } + + return this.each( function() { + var dequeue = true, + index = type != null && type + "queueHooks", + timers = jQuery.timers, + data = dataPriv.get( this ); + + if ( index ) { + if ( data[ index ] && data[ index ].stop ) { + stopQueue( data[ index ] ); + } + } else { + for ( index in data ) { + if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) { + stopQueue( data[ index ] ); + } + } + } + + for ( index = timers.length; index--; ) { + if ( timers[ index ].elem === this && + ( type == null || timers[ index ].queue === type ) ) { + + timers[ index ].anim.stop( gotoEnd ); + dequeue = false; + timers.splice( index, 1 ); + } + } + + // Start the next in the queue if the last step wasn't forced. + // Timers currently will call their complete callbacks, which + // will dequeue but only if they were gotoEnd. + if ( dequeue || !gotoEnd ) { + jQuery.dequeue( this, type ); + } + } ); + }, + finish: function( type ) { + if ( type !== false ) { + type = type || "fx"; + } + return this.each( function() { + var index, + data = dataPriv.get( this ), + queue = data[ type + "queue" ], + hooks = data[ type + "queueHooks" ], + timers = jQuery.timers, + length = queue ? queue.length : 0; + + // Enable finishing flag on private data + data.finish = true; + + // Empty the queue first + jQuery.queue( this, type, [] ); + + if ( hooks && hooks.stop ) { + hooks.stop.call( this, true ); + } + + // Look for any active animations, and finish them + for ( index = timers.length; index--; ) { + if ( timers[ index ].elem === this && timers[ index ].queue === type ) { + timers[ index ].anim.stop( true ); + timers.splice( index, 1 ); + } + } + + // Look for any animations in the old queue and finish them + for ( index = 0; index < length; index++ ) { + if ( queue[ index ] && queue[ index ].finish ) { + queue[ index ].finish.call( this ); + } + } + + // Turn off finishing flag + delete data.finish; + } ); + } +} ); + +jQuery.each( [ "toggle", "show", "hide" ], function( _i, name ) { + var cssFn = jQuery.fn[ name ]; + jQuery.fn[ name ] = function( speed, easing, callback ) { + return speed == null || typeof speed === "boolean" ? + cssFn.apply( this, arguments ) : + this.animate( genFx( name, true ), speed, easing, callback ); + }; +} ); + +// Generate shortcuts for custom animations +jQuery.each( { + slideDown: genFx( "show" ), + slideUp: genFx( "hide" ), + slideToggle: genFx( "toggle" ), + fadeIn: { opacity: "show" }, + fadeOut: { opacity: "hide" }, + fadeToggle: { opacity: "toggle" } +}, function( name, props ) { + jQuery.fn[ name ] = function( speed, easing, callback ) { + return this.animate( props, speed, easing, callback ); + }; +} ); + +jQuery.timers = []; +jQuery.fx.tick = function() { + var timer, + i = 0, + timers = jQuery.timers; + + fxNow = Date.now(); + + for ( ; i < timers.length; i++ ) { + timer = timers[ i ]; + + // Run the timer and safely remove it when done (allowing for external removal) + if ( !timer() && timers[ i ] === timer ) { + timers.splice( i--, 1 ); + } + } + + if ( !timers.length ) { + jQuery.fx.stop(); + } + fxNow = undefined; +}; + +jQuery.fx.timer = function( timer ) { + jQuery.timers.push( timer ); + jQuery.fx.start(); +}; + +jQuery.fx.interval = 13; +jQuery.fx.start = function() { + if ( inProgress ) { + return; + } + + inProgress = true; + schedule(); +}; + +jQuery.fx.stop = function() { + inProgress = null; +}; + +jQuery.fx.speeds = { + slow: 600, + fast: 200, + + // Default speed + _default: 400 +}; + + +// Based off of the plugin by Clint Helfers, with permission. +// https://web.archive.org/web/20100324014747/http://blindsignals.com/index.php/2009/07/jquery-delay/ +jQuery.fn.delay = function( time, type ) { + time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time; + type = type || "fx"; + + return this.queue( type, function( next, hooks ) { + var timeout = window.setTimeout( next, time ); + hooks.stop = function() { + window.clearTimeout( timeout ); + }; + } ); +}; + + +( function() { + var input = document.createElement( "input" ), + select = document.createElement( "select" ), + opt = select.appendChild( document.createElement( "option" ) ); + + input.type = "checkbox"; + + // Support: Android <=4.3 only + // Default value for a checkbox should be "on" + support.checkOn = input.value !== ""; + + // Support: IE <=11 only + // Must access selectedIndex to make default options select + support.optSelected = opt.selected; + + // Support: IE <=11 only + // An input loses its value after becoming a radio + input = document.createElement( "input" ); + input.value = "t"; + input.type = "radio"; + support.radioValue = input.value === "t"; +} )(); + + +var boolHook, + attrHandle = jQuery.expr.attrHandle; + +jQuery.fn.extend( { + attr: function( name, value ) { + return access( this, jQuery.attr, name, value, arguments.length > 1 ); + }, + + removeAttr: function( name ) { + return this.each( function() { + jQuery.removeAttr( this, name ); + } ); + } +} ); + +jQuery.extend( { + attr: function( elem, name, value ) { + var ret, hooks, + nType = elem.nodeType; + + // Don't get/set attributes on text, comment and attribute nodes + if ( nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + // Fallback to prop when attributes are not supported + if ( typeof elem.getAttribute === "undefined" ) { + return jQuery.prop( elem, name, value ); + } + + // Attribute hooks are determined by the lowercase version + // Grab necessary hook if one is defined + if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { + hooks = jQuery.attrHooks[ name.toLowerCase() ] || + ( jQuery.expr.match.bool.test( name ) ? boolHook : undefined ); + } + + if ( value !== undefined ) { + if ( value === null ) { + jQuery.removeAttr( elem, name ); + return; + } + + if ( hooks && "set" in hooks && + ( ret = hooks.set( elem, value, name ) ) !== undefined ) { + return ret; + } + + elem.setAttribute( name, value + "" ); + return value; + } + + if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { + return ret; + } + + ret = jQuery.find.attr( elem, name ); + + // Non-existent attributes return null, we normalize to undefined + return ret == null ? undefined : ret; + }, + + attrHooks: { + type: { + set: function( elem, value ) { + if ( !support.radioValue && value === "radio" && + nodeName( elem, "input" ) ) { + var val = elem.value; + elem.setAttribute( "type", value ); + if ( val ) { + elem.value = val; + } + return value; + } + } + } + }, + + removeAttr: function( elem, value ) { + var name, + i = 0, + + // Attribute names can contain non-HTML whitespace characters + // https://html.spec.whatwg.org/multipage/syntax.html#attributes-2 + attrNames = value && value.match( rnothtmlwhite ); + + if ( attrNames && elem.nodeType === 1 ) { + while ( ( name = attrNames[ i++ ] ) ) { + elem.removeAttribute( name ); + } + } + } +} ); + +// Hooks for boolean attributes +boolHook = { + set: function( elem, value, name ) { + if ( value === false ) { + + // Remove boolean attributes when set to false + jQuery.removeAttr( elem, name ); + } else { + elem.setAttribute( name, name ); + } + return name; + } +}; + +jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( _i, name ) { + var getter = attrHandle[ name ] || jQuery.find.attr; + + attrHandle[ name ] = function( elem, name, isXML ) { + var ret, handle, + lowercaseName = name.toLowerCase(); + + if ( !isXML ) { + + // Avoid an infinite loop by temporarily removing this function from the getter + handle = attrHandle[ lowercaseName ]; + attrHandle[ lowercaseName ] = ret; + ret = getter( elem, name, isXML ) != null ? + lowercaseName : + null; + attrHandle[ lowercaseName ] = handle; + } + return ret; + }; +} ); + + + + +var rfocusable = /^(?:input|select|textarea|button)$/i, + rclickable = /^(?:a|area)$/i; + +jQuery.fn.extend( { + prop: function( name, value ) { + return access( this, jQuery.prop, name, value, arguments.length > 1 ); + }, + + removeProp: function( name ) { + return this.each( function() { + delete this[ jQuery.propFix[ name ] || name ]; + } ); + } +} ); + +jQuery.extend( { + prop: function( elem, name, value ) { + var ret, hooks, + nType = elem.nodeType; + + // Don't get/set properties on text, comment and attribute nodes + if ( nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { + + // Fix name and attach hooks + name = jQuery.propFix[ name ] || name; + hooks = jQuery.propHooks[ name ]; + } + + if ( value !== undefined ) { + if ( hooks && "set" in hooks && + ( ret = hooks.set( elem, value, name ) ) !== undefined ) { + return ret; + } + + return ( elem[ name ] = value ); + } + + if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { + return ret; + } + + return elem[ name ]; + }, + + propHooks: { + tabIndex: { + get: function( elem ) { + + // Support: IE <=9 - 11 only + // elem.tabIndex doesn't always return the + // correct value when it hasn't been explicitly set + // https://web.archive.org/web/20141116233347/http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/ + // Use proper attribute retrieval(#12072) + var tabindex = jQuery.find.attr( elem, "tabindex" ); + + if ( tabindex ) { + return parseInt( tabindex, 10 ); + } + + if ( + rfocusable.test( elem.nodeName ) || + rclickable.test( elem.nodeName ) && + elem.href + ) { + return 0; + } + + return -1; + } + } + }, + + propFix: { + "for": "htmlFor", + "class": "className" + } +} ); + +// Support: IE <=11 only +// Accessing the selectedIndex property +// forces the browser to respect setting selected +// on the option +// The getter ensures a default option is selected +// when in an optgroup +// eslint rule "no-unused-expressions" is disabled for this code +// since it considers such accessions noop +if ( !support.optSelected ) { + jQuery.propHooks.selected = { + get: function( elem ) { + + /* eslint no-unused-expressions: "off" */ + + var parent = elem.parentNode; + if ( parent && parent.parentNode ) { + parent.parentNode.selectedIndex; + } + return null; + }, + set: function( elem ) { + + /* eslint no-unused-expressions: "off" */ + + var parent = elem.parentNode; + if ( parent ) { + parent.selectedIndex; + + if ( parent.parentNode ) { + parent.parentNode.selectedIndex; + } + } + } + }; +} + +jQuery.each( [ + "tabIndex", + "readOnly", + "maxLength", + "cellSpacing", + "cellPadding", + "rowSpan", + "colSpan", + "useMap", + "frameBorder", + "contentEditable" +], function() { + jQuery.propFix[ this.toLowerCase() ] = this; +} ); + + + + + // Strip and collapse whitespace according to HTML spec + // https://infra.spec.whatwg.org/#strip-and-collapse-ascii-whitespace + function stripAndCollapse( value ) { + var tokens = value.match( rnothtmlwhite ) || []; + return tokens.join( " " ); + } + + +function getClass( elem ) { + return elem.getAttribute && elem.getAttribute( "class" ) || ""; +} + +function classesToArray( value ) { + if ( Array.isArray( value ) ) { + return value; + } + if ( typeof value === "string" ) { + return value.match( rnothtmlwhite ) || []; + } + return []; +} + +jQuery.fn.extend( { + addClass: function( value ) { + var classes, elem, cur, curValue, clazz, j, finalValue, + i = 0; + + if ( isFunction( value ) ) { + return this.each( function( j ) { + jQuery( this ).addClass( value.call( this, j, getClass( this ) ) ); + } ); + } + + classes = classesToArray( value ); + + if ( classes.length ) { + while ( ( elem = this[ i++ ] ) ) { + curValue = getClass( elem ); + cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); + + if ( cur ) { + j = 0; + while ( ( clazz = classes[ j++ ] ) ) { + if ( cur.indexOf( " " + clazz + " " ) < 0 ) { + cur += clazz + " "; + } + } + + // Only assign if different to avoid unneeded rendering. + finalValue = stripAndCollapse( cur ); + if ( curValue !== finalValue ) { + elem.setAttribute( "class", finalValue ); + } + } + } + } + + return this; + }, + + removeClass: function( value ) { + var classes, elem, cur, curValue, clazz, j, finalValue, + i = 0; + + if ( isFunction( value ) ) { + return this.each( function( j ) { + jQuery( this ).removeClass( value.call( this, j, getClass( this ) ) ); + } ); + } + + if ( !arguments.length ) { + return this.attr( "class", "" ); + } + + classes = classesToArray( value ); + + if ( classes.length ) { + while ( ( elem = this[ i++ ] ) ) { + curValue = getClass( elem ); + + // This expression is here for better compressibility (see addClass) + cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); + + if ( cur ) { + j = 0; + while ( ( clazz = classes[ j++ ] ) ) { + + // Remove *all* instances + while ( cur.indexOf( " " + clazz + " " ) > -1 ) { + cur = cur.replace( " " + clazz + " ", " " ); + } + } + + // Only assign if different to avoid unneeded rendering. + finalValue = stripAndCollapse( cur ); + if ( curValue !== finalValue ) { + elem.setAttribute( "class", finalValue ); + } + } + } + } + + return this; + }, + + toggleClass: function( value, stateVal ) { + var type = typeof value, + isValidValue = type === "string" || Array.isArray( value ); + + if ( typeof stateVal === "boolean" && isValidValue ) { + return stateVal ? this.addClass( value ) : this.removeClass( value ); + } + + if ( isFunction( value ) ) { + return this.each( function( i ) { + jQuery( this ).toggleClass( + value.call( this, i, getClass( this ), stateVal ), + stateVal + ); + } ); + } + + return this.each( function() { + var className, i, self, classNames; + + if ( isValidValue ) { + + // Toggle individual class names + i = 0; + self = jQuery( this ); + classNames = classesToArray( value ); + + while ( ( className = classNames[ i++ ] ) ) { + + // Check each className given, space separated list + if ( self.hasClass( className ) ) { + self.removeClass( className ); + } else { + self.addClass( className ); + } + } + + // Toggle whole class name + } else if ( value === undefined || type === "boolean" ) { + className = getClass( this ); + if ( className ) { + + // Store className if set + dataPriv.set( this, "__className__", className ); + } + + // If the element has a class name or if we're passed `false`, + // then remove the whole classname (if there was one, the above saved it). + // Otherwise bring back whatever was previously saved (if anything), + // falling back to the empty string if nothing was stored. + if ( this.setAttribute ) { + this.setAttribute( "class", + className || value === false ? + "" : + dataPriv.get( this, "__className__" ) || "" + ); + } + } + } ); + }, + + hasClass: function( selector ) { + var className, elem, + i = 0; + + className = " " + selector + " "; + while ( ( elem = this[ i++ ] ) ) { + if ( elem.nodeType === 1 && + ( " " + stripAndCollapse( getClass( elem ) ) + " " ).indexOf( className ) > -1 ) { + return true; + } + } + + return false; + } +} ); + + + + +var rreturn = /\r/g; + +jQuery.fn.extend( { + val: function( value ) { + var hooks, ret, valueIsFunction, + elem = this[ 0 ]; + + if ( !arguments.length ) { + if ( elem ) { + hooks = jQuery.valHooks[ elem.type ] || + jQuery.valHooks[ elem.nodeName.toLowerCase() ]; + + if ( hooks && + "get" in hooks && + ( ret = hooks.get( elem, "value" ) ) !== undefined + ) { + return ret; + } + + ret = elem.value; + + // Handle most common string cases + if ( typeof ret === "string" ) { + return ret.replace( rreturn, "" ); + } + + // Handle cases where value is null/undef or number + return ret == null ? "" : ret; + } + + return; + } + + valueIsFunction = isFunction( value ); + + return this.each( function( i ) { + var val; + + if ( this.nodeType !== 1 ) { + return; + } + + if ( valueIsFunction ) { + val = value.call( this, i, jQuery( this ).val() ); + } else { + val = value; + } + + // Treat null/undefined as ""; convert numbers to string + if ( val == null ) { + val = ""; + + } else if ( typeof val === "number" ) { + val += ""; + + } else if ( Array.isArray( val ) ) { + val = jQuery.map( val, function( value ) { + return value == null ? "" : value + ""; + } ); + } + + hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ]; + + // If set returns undefined, fall back to normal setting + if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) { + this.value = val; + } + } ); + } +} ); + +jQuery.extend( { + valHooks: { + option: { + get: function( elem ) { + + var val = jQuery.find.attr( elem, "value" ); + return val != null ? + val : + + // Support: IE <=10 - 11 only + // option.text throws exceptions (#14686, #14858) + // Strip and collapse whitespace + // https://html.spec.whatwg.org/#strip-and-collapse-whitespace + stripAndCollapse( jQuery.text( elem ) ); + } + }, + select: { + get: function( elem ) { + var value, option, i, + options = elem.options, + index = elem.selectedIndex, + one = elem.type === "select-one", + values = one ? null : [], + max = one ? index + 1 : options.length; + + if ( index < 0 ) { + i = max; + + } else { + i = one ? index : 0; + } + + // Loop through all the selected options + for ( ; i < max; i++ ) { + option = options[ i ]; + + // Support: IE <=9 only + // IE8-9 doesn't update selected after form reset (#2551) + if ( ( option.selected || i === index ) && + + // Don't return options that are disabled or in a disabled optgroup + !option.disabled && + ( !option.parentNode.disabled || + !nodeName( option.parentNode, "optgroup" ) ) ) { + + // Get the specific value for the option + value = jQuery( option ).val(); + + // We don't need an array for one selects + if ( one ) { + return value; + } + + // Multi-Selects return an array + values.push( value ); + } + } + + return values; + }, + + set: function( elem, value ) { + var optionSet, option, + options = elem.options, + values = jQuery.makeArray( value ), + i = options.length; + + while ( i-- ) { + option = options[ i ]; + + /* eslint-disable no-cond-assign */ + + if ( option.selected = + jQuery.inArray( jQuery.valHooks.option.get( option ), values ) > -1 + ) { + optionSet = true; + } + + /* eslint-enable no-cond-assign */ + } + + // Force browsers to behave consistently when non-matching value is set + if ( !optionSet ) { + elem.selectedIndex = -1; + } + return values; + } + } + } +} ); + +// Radios and checkboxes getter/setter +jQuery.each( [ "radio", "checkbox" ], function() { + jQuery.valHooks[ this ] = { + set: function( elem, value ) { + if ( Array.isArray( value ) ) { + return ( elem.checked = jQuery.inArray( jQuery( elem ).val(), value ) > -1 ); + } + } + }; + if ( !support.checkOn ) { + jQuery.valHooks[ this ].get = function( elem ) { + return elem.getAttribute( "value" ) === null ? "on" : elem.value; + }; + } +} ); + + + + +// Return jQuery for attributes-only inclusion + + +support.focusin = "onfocusin" in window; + + +var rfocusMorph = /^(?:focusinfocus|focusoutblur)$/, + stopPropagationCallback = function( e ) { + e.stopPropagation(); + }; + +jQuery.extend( jQuery.event, { + + trigger: function( event, data, elem, onlyHandlers ) { + + var i, cur, tmp, bubbleType, ontype, handle, special, lastElement, + eventPath = [ elem || document ], + type = hasOwn.call( event, "type" ) ? event.type : event, + namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split( "." ) : []; + + cur = lastElement = tmp = elem = elem || document; + + // Don't do events on text and comment nodes + if ( elem.nodeType === 3 || elem.nodeType === 8 ) { + return; + } + + // focus/blur morphs to focusin/out; ensure we're not firing them right now + if ( rfocusMorph.test( type + jQuery.event.triggered ) ) { + return; + } + + if ( type.indexOf( "." ) > -1 ) { + + // Namespaced trigger; create a regexp to match event type in handle() + namespaces = type.split( "." ); + type = namespaces.shift(); + namespaces.sort(); + } + ontype = type.indexOf( ":" ) < 0 && "on" + type; + + // Caller can pass in a jQuery.Event object, Object, or just an event type string + event = event[ jQuery.expando ] ? + event : + new jQuery.Event( type, typeof event === "object" && event ); + + // Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true) + event.isTrigger = onlyHandlers ? 2 : 3; + event.namespace = namespaces.join( "." ); + event.rnamespace = event.namespace ? + new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ) : + null; + + // Clean up the event in case it is being reused + event.result = undefined; + if ( !event.target ) { + event.target = elem; + } + + // Clone any incoming data and prepend the event, creating the handler arg list + data = data == null ? + [ event ] : + jQuery.makeArray( data, [ event ] ); + + // Allow special events to draw outside the lines + special = jQuery.event.special[ type ] || {}; + if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) { + return; + } + + // Determine event propagation path in advance, per W3C events spec (#9951) + // Bubble up to document, then to window; watch for a global ownerDocument var (#9724) + if ( !onlyHandlers && !special.noBubble && !isWindow( elem ) ) { + + bubbleType = special.delegateType || type; + if ( !rfocusMorph.test( bubbleType + type ) ) { + cur = cur.parentNode; + } + for ( ; cur; cur = cur.parentNode ) { + eventPath.push( cur ); + tmp = cur; + } + + // Only add window if we got to document (e.g., not plain obj or detached DOM) + if ( tmp === ( elem.ownerDocument || document ) ) { + eventPath.push( tmp.defaultView || tmp.parentWindow || window ); + } + } + + // Fire handlers on the event path + i = 0; + while ( ( cur = eventPath[ i++ ] ) && !event.isPropagationStopped() ) { + lastElement = cur; + event.type = i > 1 ? + bubbleType : + special.bindType || type; + + // jQuery handler + handle = ( + dataPriv.get( cur, "events" ) || Object.create( null ) + )[ event.type ] && + dataPriv.get( cur, "handle" ); + if ( handle ) { + handle.apply( cur, data ); + } + + // Native handler + handle = ontype && cur[ ontype ]; + if ( handle && handle.apply && acceptData( cur ) ) { + event.result = handle.apply( cur, data ); + if ( event.result === false ) { + event.preventDefault(); + } + } + } + event.type = type; + + // If nobody prevented the default action, do it now + if ( !onlyHandlers && !event.isDefaultPrevented() ) { + + if ( ( !special._default || + special._default.apply( eventPath.pop(), data ) === false ) && + acceptData( elem ) ) { + + // Call a native DOM method on the target with the same name as the event. + // Don't do default actions on window, that's where global variables be (#6170) + if ( ontype && isFunction( elem[ type ] ) && !isWindow( elem ) ) { + + // Don't re-trigger an onFOO event when we call its FOO() method + tmp = elem[ ontype ]; + + if ( tmp ) { + elem[ ontype ] = null; + } + + // Prevent re-triggering of the same event, since we already bubbled it above + jQuery.event.triggered = type; + + if ( event.isPropagationStopped() ) { + lastElement.addEventListener( type, stopPropagationCallback ); + } + + elem[ type ](); + + if ( event.isPropagationStopped() ) { + lastElement.removeEventListener( type, stopPropagationCallback ); + } + + jQuery.event.triggered = undefined; + + if ( tmp ) { + elem[ ontype ] = tmp; + } + } + } + } + + return event.result; + }, + + // Piggyback on a donor event to simulate a different one + // Used only for `focus(in | out)` events + simulate: function( type, elem, event ) { + var e = jQuery.extend( + new jQuery.Event(), + event, + { + type: type, + isSimulated: true + } + ); + + jQuery.event.trigger( e, null, elem ); + } + +} ); + +jQuery.fn.extend( { + + trigger: function( type, data ) { + return this.each( function() { + jQuery.event.trigger( type, data, this ); + } ); + }, + triggerHandler: function( type, data ) { + var elem = this[ 0 ]; + if ( elem ) { + return jQuery.event.trigger( type, data, elem, true ); + } + } +} ); + + +// Support: Firefox <=44 +// Firefox doesn't have focus(in | out) events +// Related ticket - https://bugzilla.mozilla.org/show_bug.cgi?id=687787 +// +// Support: Chrome <=48 - 49, Safari <=9.0 - 9.1 +// focus(in | out) events fire after focus & blur events, +// which is spec violation - http://www.w3.org/TR/DOM-Level-3-Events/#events-focusevent-event-order +// Related ticket - https://bugs.chromium.org/p/chromium/issues/detail?id=449857 +if ( !support.focusin ) { + jQuery.each( { focus: "focusin", blur: "focusout" }, function( orig, fix ) { + + // Attach a single capturing handler on the document while someone wants focusin/focusout + var handler = function( event ) { + jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ) ); + }; + + jQuery.event.special[ fix ] = { + setup: function() { + + // Handle: regular nodes (via `this.ownerDocument`), window + // (via `this.document`) & document (via `this`). + var doc = this.ownerDocument || this.document || this, + attaches = dataPriv.access( doc, fix ); + + if ( !attaches ) { + doc.addEventListener( orig, handler, true ); + } + dataPriv.access( doc, fix, ( attaches || 0 ) + 1 ); + }, + teardown: function() { + var doc = this.ownerDocument || this.document || this, + attaches = dataPriv.access( doc, fix ) - 1; + + if ( !attaches ) { + doc.removeEventListener( orig, handler, true ); + dataPriv.remove( doc, fix ); + + } else { + dataPriv.access( doc, fix, attaches ); + } + } + }; + } ); +} +var location = window.location; + +var nonce = { guid: Date.now() }; + +var rquery = ( /\?/ ); + + + +// Cross-browser xml parsing +jQuery.parseXML = function( data ) { + var xml; + if ( !data || typeof data !== "string" ) { + return null; + } + + // Support: IE 9 - 11 only + // IE throws on parseFromString with invalid input. + try { + xml = ( new window.DOMParser() ).parseFromString( data, "text/xml" ); + } catch ( e ) { + xml = undefined; + } + + if ( !xml || xml.getElementsByTagName( "parsererror" ).length ) { + jQuery.error( "Invalid XML: " + data ); + } + return xml; +}; + + +var + rbracket = /\[\]$/, + rCRLF = /\r?\n/g, + rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i, + rsubmittable = /^(?:input|select|textarea|keygen)/i; + +function buildParams( prefix, obj, traditional, add ) { + var name; + + if ( Array.isArray( obj ) ) { + + // Serialize array item. + jQuery.each( obj, function( i, v ) { + if ( traditional || rbracket.test( prefix ) ) { + + // Treat each array item as a scalar. + add( prefix, v ); + + } else { + + // Item is non-scalar (array or object), encode its numeric index. + buildParams( + prefix + "[" + ( typeof v === "object" && v != null ? i : "" ) + "]", + v, + traditional, + add + ); + } + } ); + + } else if ( !traditional && toType( obj ) === "object" ) { + + // Serialize object item. + for ( name in obj ) { + buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add ); + } + + } else { + + // Serialize scalar item. + add( prefix, obj ); + } +} + +// Serialize an array of form elements or a set of +// key/values into a query string +jQuery.param = function( a, traditional ) { + var prefix, + s = [], + add = function( key, valueOrFunction ) { + + // If value is a function, invoke it and use its return value + var value = isFunction( valueOrFunction ) ? + valueOrFunction() : + valueOrFunction; + + s[ s.length ] = encodeURIComponent( key ) + "=" + + encodeURIComponent( value == null ? "" : value ); + }; + + if ( a == null ) { + return ""; + } + + // If an array was passed in, assume that it is an array of form elements. + if ( Array.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) { + + // Serialize the form elements + jQuery.each( a, function() { + add( this.name, this.value ); + } ); + + } else { + + // If traditional, encode the "old" way (the way 1.3.2 or older + // did it), otherwise encode params recursively. + for ( prefix in a ) { + buildParams( prefix, a[ prefix ], traditional, add ); + } + } + + // Return the resulting serialization + return s.join( "&" ); +}; + +jQuery.fn.extend( { + serialize: function() { + return jQuery.param( this.serializeArray() ); + }, + serializeArray: function() { + return this.map( function() { + + // Can add propHook for "elements" to filter or add form elements + var elements = jQuery.prop( this, "elements" ); + return elements ? jQuery.makeArray( elements ) : this; + } ) + .filter( function() { + var type = this.type; + + // Use .is( ":disabled" ) so that fieldset[disabled] works + return this.name && !jQuery( this ).is( ":disabled" ) && + rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) && + ( this.checked || !rcheckableType.test( type ) ); + } ) + .map( function( _i, elem ) { + var val = jQuery( this ).val(); + + if ( val == null ) { + return null; + } + + if ( Array.isArray( val ) ) { + return jQuery.map( val, function( val ) { + return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; + } ); + } + + return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; + } ).get(); + } +} ); + + +var + r20 = /%20/g, + rhash = /#.*$/, + rantiCache = /([?&])_=[^&]*/, + rheaders = /^(.*?):[ \t]*([^\r\n]*)$/mg, + + // #7653, #8125, #8152: local protocol detection + rlocalProtocol = /^(?:about|app|app-storage|.+-extension|file|res|widget):$/, + rnoContent = /^(?:GET|HEAD)$/, + rprotocol = /^\/\//, + + /* Prefilters + * 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example) + * 2) These are called: + * - BEFORE asking for a transport + * - AFTER param serialization (s.data is a string if s.processData is true) + * 3) key is the dataType + * 4) the catchall symbol "*" can be used + * 5) execution will start with transport dataType and THEN continue down to "*" if needed + */ + prefilters = {}, + + /* Transports bindings + * 1) key is the dataType + * 2) the catchall symbol "*" can be used + * 3) selection will start with transport dataType and THEN go to "*" if needed + */ + transports = {}, + + // Avoid comment-prolog char sequence (#10098); must appease lint and evade compression + allTypes = "*/".concat( "*" ), + + // Anchor tag for parsing the document origin + originAnchor = document.createElement( "a" ); + originAnchor.href = location.href; + +// Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport +function addToPrefiltersOrTransports( structure ) { + + // dataTypeExpression is optional and defaults to "*" + return function( dataTypeExpression, func ) { + + if ( typeof dataTypeExpression !== "string" ) { + func = dataTypeExpression; + dataTypeExpression = "*"; + } + + var dataType, + i = 0, + dataTypes = dataTypeExpression.toLowerCase().match( rnothtmlwhite ) || []; + + if ( isFunction( func ) ) { + + // For each dataType in the dataTypeExpression + while ( ( dataType = dataTypes[ i++ ] ) ) { + + // Prepend if requested + if ( dataType[ 0 ] === "+" ) { + dataType = dataType.slice( 1 ) || "*"; + ( structure[ dataType ] = structure[ dataType ] || [] ).unshift( func ); + + // Otherwise append + } else { + ( structure[ dataType ] = structure[ dataType ] || [] ).push( func ); + } + } + } + }; +} + +// Base inspection function for prefilters and transports +function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR ) { + + var inspected = {}, + seekingTransport = ( structure === transports ); + + function inspect( dataType ) { + var selected; + inspected[ dataType ] = true; + jQuery.each( structure[ dataType ] || [], function( _, prefilterOrFactory ) { + var dataTypeOrTransport = prefilterOrFactory( options, originalOptions, jqXHR ); + if ( typeof dataTypeOrTransport === "string" && + !seekingTransport && !inspected[ dataTypeOrTransport ] ) { + + options.dataTypes.unshift( dataTypeOrTransport ); + inspect( dataTypeOrTransport ); + return false; + } else if ( seekingTransport ) { + return !( selected = dataTypeOrTransport ); + } + } ); + return selected; + } + + return inspect( options.dataTypes[ 0 ] ) || !inspected[ "*" ] && inspect( "*" ); +} + +// A special extend for ajax options +// that takes "flat" options (not to be deep extended) +// Fixes #9887 +function ajaxExtend( target, src ) { + var key, deep, + flatOptions = jQuery.ajaxSettings.flatOptions || {}; + + for ( key in src ) { + if ( src[ key ] !== undefined ) { + ( flatOptions[ key ] ? target : ( deep || ( deep = {} ) ) )[ key ] = src[ key ]; + } + } + if ( deep ) { + jQuery.extend( true, target, deep ); + } + + return target; +} + +/* Handles responses to an ajax request: + * - finds the right dataType (mediates between content-type and expected dataType) + * - returns the corresponding response + */ +function ajaxHandleResponses( s, jqXHR, responses ) { + + var ct, type, finalDataType, firstDataType, + contents = s.contents, + dataTypes = s.dataTypes; + + // Remove auto dataType and get content-type in the process + while ( dataTypes[ 0 ] === "*" ) { + dataTypes.shift(); + if ( ct === undefined ) { + ct = s.mimeType || jqXHR.getResponseHeader( "Content-Type" ); + } + } + + // Check if we're dealing with a known content-type + if ( ct ) { + for ( type in contents ) { + if ( contents[ type ] && contents[ type ].test( ct ) ) { + dataTypes.unshift( type ); + break; + } + } + } + + // Check to see if we have a response for the expected dataType + if ( dataTypes[ 0 ] in responses ) { + finalDataType = dataTypes[ 0 ]; + } else { + + // Try convertible dataTypes + for ( type in responses ) { + if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[ 0 ] ] ) { + finalDataType = type; + break; + } + if ( !firstDataType ) { + firstDataType = type; + } + } + + // Or just use first one + finalDataType = finalDataType || firstDataType; + } + + // If we found a dataType + // We add the dataType to the list if needed + // and return the corresponding response + if ( finalDataType ) { + if ( finalDataType !== dataTypes[ 0 ] ) { + dataTypes.unshift( finalDataType ); + } + return responses[ finalDataType ]; + } +} + +/* Chain conversions given the request and the original response + * Also sets the responseXXX fields on the jqXHR instance + */ +function ajaxConvert( s, response, jqXHR, isSuccess ) { + var conv2, current, conv, tmp, prev, + converters = {}, + + // Work with a copy of dataTypes in case we need to modify it for conversion + dataTypes = s.dataTypes.slice(); + + // Create converters map with lowercased keys + if ( dataTypes[ 1 ] ) { + for ( conv in s.converters ) { + converters[ conv.toLowerCase() ] = s.converters[ conv ]; + } + } + + current = dataTypes.shift(); + + // Convert to each sequential dataType + while ( current ) { + + if ( s.responseFields[ current ] ) { + jqXHR[ s.responseFields[ current ] ] = response; + } + + // Apply the dataFilter if provided + if ( !prev && isSuccess && s.dataFilter ) { + response = s.dataFilter( response, s.dataType ); + } + + prev = current; + current = dataTypes.shift(); + + if ( current ) { + + // There's only work to do if current dataType is non-auto + if ( current === "*" ) { + + current = prev; + + // Convert response if prev dataType is non-auto and differs from current + } else if ( prev !== "*" && prev !== current ) { + + // Seek a direct converter + conv = converters[ prev + " " + current ] || converters[ "* " + current ]; + + // If none found, seek a pair + if ( !conv ) { + for ( conv2 in converters ) { + + // If conv2 outputs current + tmp = conv2.split( " " ); + if ( tmp[ 1 ] === current ) { + + // If prev can be converted to accepted input + conv = converters[ prev + " " + tmp[ 0 ] ] || + converters[ "* " + tmp[ 0 ] ]; + if ( conv ) { + + // Condense equivalence converters + if ( conv === true ) { + conv = converters[ conv2 ]; + + // Otherwise, insert the intermediate dataType + } else if ( converters[ conv2 ] !== true ) { + current = tmp[ 0 ]; + dataTypes.unshift( tmp[ 1 ] ); + } + break; + } + } + } + } + + // Apply converter (if not an equivalence) + if ( conv !== true ) { + + // Unless errors are allowed to bubble, catch and return them + if ( conv && s.throws ) { + response = conv( response ); + } else { + try { + response = conv( response ); + } catch ( e ) { + return { + state: "parsererror", + error: conv ? e : "No conversion from " + prev + " to " + current + }; + } + } + } + } + } + } + + return { state: "success", data: response }; +} + +jQuery.extend( { + + // Counter for holding the number of active queries + active: 0, + + // Last-Modified header cache for next request + lastModified: {}, + etag: {}, + + ajaxSettings: { + url: location.href, + type: "GET", + isLocal: rlocalProtocol.test( location.protocol ), + global: true, + processData: true, + async: true, + contentType: "application/x-www-form-urlencoded; charset=UTF-8", + + /* + timeout: 0, + data: null, + dataType: null, + username: null, + password: null, + cache: null, + throws: false, + traditional: false, + headers: {}, + */ + + accepts: { + "*": allTypes, + text: "text/plain", + html: "text/html", + xml: "application/xml, text/xml", + json: "application/json, text/javascript" + }, + + contents: { + xml: /\bxml\b/, + html: /\bhtml/, + json: /\bjson\b/ + }, + + responseFields: { + xml: "responseXML", + text: "responseText", + json: "responseJSON" + }, + + // Data converters + // Keys separate source (or catchall "*") and destination types with a single space + converters: { + + // Convert anything to text + "* text": String, + + // Text to html (true = no transformation) + "text html": true, + + // Evaluate text as a json expression + "text json": JSON.parse, + + // Parse text as xml + "text xml": jQuery.parseXML + }, + + // For options that shouldn't be deep extended: + // you can add your own custom options here if + // and when you create one that shouldn't be + // deep extended (see ajaxExtend) + flatOptions: { + url: true, + context: true + } + }, + + // Creates a full fledged settings object into target + // with both ajaxSettings and settings fields. + // If target is omitted, writes into ajaxSettings. + ajaxSetup: function( target, settings ) { + return settings ? + + // Building a settings object + ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) : + + // Extending ajaxSettings + ajaxExtend( jQuery.ajaxSettings, target ); + }, + + ajaxPrefilter: addToPrefiltersOrTransports( prefilters ), + ajaxTransport: addToPrefiltersOrTransports( transports ), + + // Main method + ajax: function( url, options ) { + + // If url is an object, simulate pre-1.5 signature + if ( typeof url === "object" ) { + options = url; + url = undefined; + } + + // Force options to be an object + options = options || {}; + + var transport, + + // URL without anti-cache param + cacheURL, + + // Response headers + responseHeadersString, + responseHeaders, + + // timeout handle + timeoutTimer, + + // Url cleanup var + urlAnchor, + + // Request state (becomes false upon send and true upon completion) + completed, + + // To know if global events are to be dispatched + fireGlobals, + + // Loop variable + i, + + // uncached part of the url + uncached, + + // Create the final options object + s = jQuery.ajaxSetup( {}, options ), + + // Callbacks context + callbackContext = s.context || s, + + // Context for global events is callbackContext if it is a DOM node or jQuery collection + globalEventContext = s.context && + ( callbackContext.nodeType || callbackContext.jquery ) ? + jQuery( callbackContext ) : + jQuery.event, + + // Deferreds + deferred = jQuery.Deferred(), + completeDeferred = jQuery.Callbacks( "once memory" ), + + // Status-dependent callbacks + statusCode = s.statusCode || {}, + + // Headers (they are sent all at once) + requestHeaders = {}, + requestHeadersNames = {}, + + // Default abort message + strAbort = "canceled", + + // Fake xhr + jqXHR = { + readyState: 0, + + // Builds headers hashtable if needed + getResponseHeader: function( key ) { + var match; + if ( completed ) { + if ( !responseHeaders ) { + responseHeaders = {}; + while ( ( match = rheaders.exec( responseHeadersString ) ) ) { + responseHeaders[ match[ 1 ].toLowerCase() + " " ] = + ( responseHeaders[ match[ 1 ].toLowerCase() + " " ] || [] ) + .concat( match[ 2 ] ); + } + } + match = responseHeaders[ key.toLowerCase() + " " ]; + } + return match == null ? null : match.join( ", " ); + }, + + // Raw string + getAllResponseHeaders: function() { + return completed ? responseHeadersString : null; + }, + + // Caches the header + setRequestHeader: function( name, value ) { + if ( completed == null ) { + name = requestHeadersNames[ name.toLowerCase() ] = + requestHeadersNames[ name.toLowerCase() ] || name; + requestHeaders[ name ] = value; + } + return this; + }, + + // Overrides response content-type header + overrideMimeType: function( type ) { + if ( completed == null ) { + s.mimeType = type; + } + return this; + }, + + // Status-dependent callbacks + statusCode: function( map ) { + var code; + if ( map ) { + if ( completed ) { + + // Execute the appropriate callbacks + jqXHR.always( map[ jqXHR.status ] ); + } else { + + // Lazy-add the new callbacks in a way that preserves old ones + for ( code in map ) { + statusCode[ code ] = [ statusCode[ code ], map[ code ] ]; + } + } + } + return this; + }, + + // Cancel the request + abort: function( statusText ) { + var finalText = statusText || strAbort; + if ( transport ) { + transport.abort( finalText ); + } + done( 0, finalText ); + return this; + } + }; + + // Attach deferreds + deferred.promise( jqXHR ); + + // Add protocol if not provided (prefilters might expect it) + // Handle falsy url in the settings object (#10093: consistency with old signature) + // We also use the url parameter if available + s.url = ( ( url || s.url || location.href ) + "" ) + .replace( rprotocol, location.protocol + "//" ); + + // Alias method option to type as per ticket #12004 + s.type = options.method || options.type || s.method || s.type; + + // Extract dataTypes list + s.dataTypes = ( s.dataType || "*" ).toLowerCase().match( rnothtmlwhite ) || [ "" ]; + + // A cross-domain request is in order when the origin doesn't match the current origin. + if ( s.crossDomain == null ) { + urlAnchor = document.createElement( "a" ); + + // Support: IE <=8 - 11, Edge 12 - 15 + // IE throws exception on accessing the href property if url is malformed, + // e.g. http://example.com:80x/ + try { + urlAnchor.href = s.url; + + // Support: IE <=8 - 11 only + // Anchor's host property isn't correctly set when s.url is relative + urlAnchor.href = urlAnchor.href; + s.crossDomain = originAnchor.protocol + "//" + originAnchor.host !== + urlAnchor.protocol + "//" + urlAnchor.host; + } catch ( e ) { + + // If there is an error parsing the URL, assume it is crossDomain, + // it can be rejected by the transport if it is invalid + s.crossDomain = true; + } + } + + // Convert data if not already a string + if ( s.data && s.processData && typeof s.data !== "string" ) { + s.data = jQuery.param( s.data, s.traditional ); + } + + // Apply prefilters + inspectPrefiltersOrTransports( prefilters, s, options, jqXHR ); + + // If request was aborted inside a prefilter, stop there + if ( completed ) { + return jqXHR; + } + + // We can fire global events as of now if asked to + // Don't fire events if jQuery.event is undefined in an AMD-usage scenario (#15118) + fireGlobals = jQuery.event && s.global; + + // Watch for a new set of requests + if ( fireGlobals && jQuery.active++ === 0 ) { + jQuery.event.trigger( "ajaxStart" ); + } + + // Uppercase the type + s.type = s.type.toUpperCase(); + + // Determine if request has content + s.hasContent = !rnoContent.test( s.type ); + + // Save the URL in case we're toying with the If-Modified-Since + // and/or If-None-Match header later on + // Remove hash to simplify url manipulation + cacheURL = s.url.replace( rhash, "" ); + + // More options handling for requests with no content + if ( !s.hasContent ) { + + // Remember the hash so we can put it back + uncached = s.url.slice( cacheURL.length ); + + // If data is available and should be processed, append data to url + if ( s.data && ( s.processData || typeof s.data === "string" ) ) { + cacheURL += ( rquery.test( cacheURL ) ? "&" : "?" ) + s.data; + + // #9682: remove data so that it's not used in an eventual retry + delete s.data; + } + + // Add or update anti-cache param if needed + if ( s.cache === false ) { + cacheURL = cacheURL.replace( rantiCache, "$1" ); + uncached = ( rquery.test( cacheURL ) ? "&" : "?" ) + "_=" + ( nonce.guid++ ) + + uncached; + } + + // Put hash and anti-cache on the URL that will be requested (gh-1732) + s.url = cacheURL + uncached; + + // Change '%20' to '+' if this is encoded form body content (gh-2658) + } else if ( s.data && s.processData && + ( s.contentType || "" ).indexOf( "application/x-www-form-urlencoded" ) === 0 ) { + s.data = s.data.replace( r20, "+" ); + } + + // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. + if ( s.ifModified ) { + if ( jQuery.lastModified[ cacheURL ] ) { + jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ cacheURL ] ); + } + if ( jQuery.etag[ cacheURL ] ) { + jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ cacheURL ] ); + } + } + + // Set the correct header, if data is being sent + if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) { + jqXHR.setRequestHeader( "Content-Type", s.contentType ); + } + + // Set the Accepts header for the server, depending on the dataType + jqXHR.setRequestHeader( + "Accept", + s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[ 0 ] ] ? + s.accepts[ s.dataTypes[ 0 ] ] + + ( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) : + s.accepts[ "*" ] + ); + + // Check for headers option + for ( i in s.headers ) { + jqXHR.setRequestHeader( i, s.headers[ i ] ); + } + + // Allow custom headers/mimetypes and early abort + if ( s.beforeSend && + ( s.beforeSend.call( callbackContext, jqXHR, s ) === false || completed ) ) { + + // Abort if not done already and return + return jqXHR.abort(); + } + + // Aborting is no longer a cancellation + strAbort = "abort"; + + // Install callbacks on deferreds + completeDeferred.add( s.complete ); + jqXHR.done( s.success ); + jqXHR.fail( s.error ); + + // Get transport + transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR ); + + // If no transport, we auto-abort + if ( !transport ) { + done( -1, "No Transport" ); + } else { + jqXHR.readyState = 1; + + // Send global event + if ( fireGlobals ) { + globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] ); + } + + // If request was aborted inside ajaxSend, stop there + if ( completed ) { + return jqXHR; + } + + // Timeout + if ( s.async && s.timeout > 0 ) { + timeoutTimer = window.setTimeout( function() { + jqXHR.abort( "timeout" ); + }, s.timeout ); + } + + try { + completed = false; + transport.send( requestHeaders, done ); + } catch ( e ) { + + // Rethrow post-completion exceptions + if ( completed ) { + throw e; + } + + // Propagate others as results + done( -1, e ); + } + } + + // Callback for when everything is done + function done( status, nativeStatusText, responses, headers ) { + var isSuccess, success, error, response, modified, + statusText = nativeStatusText; + + // Ignore repeat invocations + if ( completed ) { + return; + } + + completed = true; + + // Clear timeout if it exists + if ( timeoutTimer ) { + window.clearTimeout( timeoutTimer ); + } + + // Dereference transport for early garbage collection + // (no matter how long the jqXHR object will be used) + transport = undefined; + + // Cache response headers + responseHeadersString = headers || ""; + + // Set readyState + jqXHR.readyState = status > 0 ? 4 : 0; + + // Determine if successful + isSuccess = status >= 200 && status < 300 || status === 304; + + // Get response data + if ( responses ) { + response = ajaxHandleResponses( s, jqXHR, responses ); + } + + // Use a noop converter for missing script + if ( !isSuccess && jQuery.inArray( "script", s.dataTypes ) > -1 ) { + s.converters[ "text script" ] = function() {}; + } + + // Convert no matter what (that way responseXXX fields are always set) + response = ajaxConvert( s, response, jqXHR, isSuccess ); + + // If successful, handle type chaining + if ( isSuccess ) { + + // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. + if ( s.ifModified ) { + modified = jqXHR.getResponseHeader( "Last-Modified" ); + if ( modified ) { + jQuery.lastModified[ cacheURL ] = modified; + } + modified = jqXHR.getResponseHeader( "etag" ); + if ( modified ) { + jQuery.etag[ cacheURL ] = modified; + } + } + + // if no content + if ( status === 204 || s.type === "HEAD" ) { + statusText = "nocontent"; + + // if not modified + } else if ( status === 304 ) { + statusText = "notmodified"; + + // If we have data, let's convert it + } else { + statusText = response.state; + success = response.data; + error = response.error; + isSuccess = !error; + } + } else { + + // Extract error from statusText and normalize for non-aborts + error = statusText; + if ( status || !statusText ) { + statusText = "error"; + if ( status < 0 ) { + status = 0; + } + } + } + + // Set data for the fake xhr object + jqXHR.status = status; + jqXHR.statusText = ( nativeStatusText || statusText ) + ""; + + // Success/Error + if ( isSuccess ) { + deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] ); + } else { + deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] ); + } + + // Status-dependent callbacks + jqXHR.statusCode( statusCode ); + statusCode = undefined; + + if ( fireGlobals ) { + globalEventContext.trigger( isSuccess ? "ajaxSuccess" : "ajaxError", + [ jqXHR, s, isSuccess ? success : error ] ); + } + + // Complete + completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] ); + + if ( fireGlobals ) { + globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] ); + + // Handle the global AJAX counter + if ( !( --jQuery.active ) ) { + jQuery.event.trigger( "ajaxStop" ); + } + } + } + + return jqXHR; + }, + + getJSON: function( url, data, callback ) { + return jQuery.get( url, data, callback, "json" ); + }, + + getScript: function( url, callback ) { + return jQuery.get( url, undefined, callback, "script" ); + } +} ); + +jQuery.each( [ "get", "post" ], function( _i, method ) { + jQuery[ method ] = function( url, data, callback, type ) { + + // Shift arguments if data argument was omitted + if ( isFunction( data ) ) { + type = type || callback; + callback = data; + data = undefined; + } + + // The url can be an options object (which then must have .url) + return jQuery.ajax( jQuery.extend( { + url: url, + type: method, + dataType: type, + data: data, + success: callback + }, jQuery.isPlainObject( url ) && url ) ); + }; +} ); + +jQuery.ajaxPrefilter( function( s ) { + var i; + for ( i in s.headers ) { + if ( i.toLowerCase() === "content-type" ) { + s.contentType = s.headers[ i ] || ""; + } + } +} ); + + +jQuery._evalUrl = function( url, options, doc ) { + return jQuery.ajax( { + url: url, + + // Make this explicit, since user can override this through ajaxSetup (#11264) + type: "GET", + dataType: "script", + cache: true, + async: false, + global: false, + + // Only evaluate the response if it is successful (gh-4126) + // dataFilter is not invoked for failure responses, so using it instead + // of the default converter is kludgy but it works. + converters: { + "text script": function() {} + }, + dataFilter: function( response ) { + jQuery.globalEval( response, options, doc ); + } + } ); +}; + + +jQuery.fn.extend( { + wrapAll: function( html ) { + var wrap; + + if ( this[ 0 ] ) { + if ( isFunction( html ) ) { + html = html.call( this[ 0 ] ); + } + + // The elements to wrap the target around + wrap = jQuery( html, this[ 0 ].ownerDocument ).eq( 0 ).clone( true ); + + if ( this[ 0 ].parentNode ) { + wrap.insertBefore( this[ 0 ] ); + } + + wrap.map( function() { + var elem = this; + + while ( elem.firstElementChild ) { + elem = elem.firstElementChild; + } + + return elem; + } ).append( this ); + } + + return this; + }, + + wrapInner: function( html ) { + if ( isFunction( html ) ) { + return this.each( function( i ) { + jQuery( this ).wrapInner( html.call( this, i ) ); + } ); + } + + return this.each( function() { + var self = jQuery( this ), + contents = self.contents(); + + if ( contents.length ) { + contents.wrapAll( html ); + + } else { + self.append( html ); + } + } ); + }, + + wrap: function( html ) { + var htmlIsFunction = isFunction( html ); + + return this.each( function( i ) { + jQuery( this ).wrapAll( htmlIsFunction ? html.call( this, i ) : html ); + } ); + }, + + unwrap: function( selector ) { + this.parent( selector ).not( "body" ).each( function() { + jQuery( this ).replaceWith( this.childNodes ); + } ); + return this; + } +} ); + + +jQuery.expr.pseudos.hidden = function( elem ) { + return !jQuery.expr.pseudos.visible( elem ); +}; +jQuery.expr.pseudos.visible = function( elem ) { + return !!( elem.offsetWidth || elem.offsetHeight || elem.getClientRects().length ); +}; + + + + +jQuery.ajaxSettings.xhr = function() { + try { + return new window.XMLHttpRequest(); + } catch ( e ) {} +}; + +var xhrSuccessStatus = { + + // File protocol always yields status code 0, assume 200 + 0: 200, + + // Support: IE <=9 only + // #1450: sometimes IE returns 1223 when it should be 204 + 1223: 204 + }, + xhrSupported = jQuery.ajaxSettings.xhr(); + +support.cors = !!xhrSupported && ( "withCredentials" in xhrSupported ); +support.ajax = xhrSupported = !!xhrSupported; + +jQuery.ajaxTransport( function( options ) { + var callback, errorCallback; + + // Cross domain only allowed if supported through XMLHttpRequest + if ( support.cors || xhrSupported && !options.crossDomain ) { + return { + send: function( headers, complete ) { + var i, + xhr = options.xhr(); + + xhr.open( + options.type, + options.url, + options.async, + options.username, + options.password + ); + + // Apply custom fields if provided + if ( options.xhrFields ) { + for ( i in options.xhrFields ) { + xhr[ i ] = options.xhrFields[ i ]; + } + } + + // Override mime type if needed + if ( options.mimeType && xhr.overrideMimeType ) { + xhr.overrideMimeType( options.mimeType ); + } + + // X-Requested-With header + // For cross-domain requests, seeing as conditions for a preflight are + // akin to a jigsaw puzzle, we simply never set it to be sure. + // (it can always be set on a per-request basis or even using ajaxSetup) + // For same-domain requests, won't change header if already provided. + if ( !options.crossDomain && !headers[ "X-Requested-With" ] ) { + headers[ "X-Requested-With" ] = "XMLHttpRequest"; + } + + // Set headers + for ( i in headers ) { + xhr.setRequestHeader( i, headers[ i ] ); + } + + // Callback + callback = function( type ) { + return function() { + if ( callback ) { + callback = errorCallback = xhr.onload = + xhr.onerror = xhr.onabort = xhr.ontimeout = + xhr.onreadystatechange = null; + + if ( type === "abort" ) { + xhr.abort(); + } else if ( type === "error" ) { + + // Support: IE <=9 only + // On a manual native abort, IE9 throws + // errors on any property access that is not readyState + if ( typeof xhr.status !== "number" ) { + complete( 0, "error" ); + } else { + complete( + + // File: protocol always yields status 0; see #8605, #14207 + xhr.status, + xhr.statusText + ); + } + } else { + complete( + xhrSuccessStatus[ xhr.status ] || xhr.status, + xhr.statusText, + + // Support: IE <=9 only + // IE9 has no XHR2 but throws on binary (trac-11426) + // For XHR2 non-text, let the caller handle it (gh-2498) + ( xhr.responseType || "text" ) !== "text" || + typeof xhr.responseText !== "string" ? + { binary: xhr.response } : + { text: xhr.responseText }, + xhr.getAllResponseHeaders() + ); + } + } + }; + }; + + // Listen to events + xhr.onload = callback(); + errorCallback = xhr.onerror = xhr.ontimeout = callback( "error" ); + + // Support: IE 9 only + // Use onreadystatechange to replace onabort + // to handle uncaught aborts + if ( xhr.onabort !== undefined ) { + xhr.onabort = errorCallback; + } else { + xhr.onreadystatechange = function() { + + // Check readyState before timeout as it changes + if ( xhr.readyState === 4 ) { + + // Allow onerror to be called first, + // but that will not handle a native abort + // Also, save errorCallback to a variable + // as xhr.onerror cannot be accessed + window.setTimeout( function() { + if ( callback ) { + errorCallback(); + } + } ); + } + }; + } + + // Create the abort callback + callback = callback( "abort" ); + + try { + + // Do send the request (this may raise an exception) + xhr.send( options.hasContent && options.data || null ); + } catch ( e ) { + + // #14683: Only rethrow if this hasn't been notified as an error yet + if ( callback ) { + throw e; + } + } + }, + + abort: function() { + if ( callback ) { + callback(); + } + } + }; + } +} ); + + + + +// Prevent auto-execution of scripts when no explicit dataType was provided (See gh-2432) +jQuery.ajaxPrefilter( function( s ) { + if ( s.crossDomain ) { + s.contents.script = false; + } +} ); + +// Install script dataType +jQuery.ajaxSetup( { + accepts: { + script: "text/javascript, application/javascript, " + + "application/ecmascript, application/x-ecmascript" + }, + contents: { + script: /\b(?:java|ecma)script\b/ + }, + converters: { + "text script": function( text ) { + jQuery.globalEval( text ); + return text; + } + } +} ); + +// Handle cache's special case and crossDomain +jQuery.ajaxPrefilter( "script", function( s ) { + if ( s.cache === undefined ) { + s.cache = false; + } + if ( s.crossDomain ) { + s.type = "GET"; + } +} ); + +// Bind script tag hack transport +jQuery.ajaxTransport( "script", function( s ) { + + // This transport only deals with cross domain or forced-by-attrs requests + if ( s.crossDomain || s.scriptAttrs ) { + var script, callback; + return { + send: function( _, complete ) { + script = jQuery( " + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Build Javet

+

It's quite hard for developers to build Javet successfully for various reasons.

+
    +

  • Node.js needs to be built to static libraries.

    • +

  • V8 needs to be built to monolith.

    • +

  • Every OS platform has its own pitfalls which usually make developers frustrated, or even desperate.

    • +
+

Here are 3 ways of building Javet.

+
+ +
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/development/build.rst b/docs/development/build.rst index 5d47f1c0d..743b30f33 100644 --- a/docs/development/build.rst +++ b/docs/development/build.rst @@ -10,8 +10,9 @@ It's quite hard for developers to build Javet successfully for various reasons. Here are 3 ways of building Javet. -1. `Build Javet with Docker `_ (Linux and Windows) -2. `Build Javet with Pre-built Binaries `_ (Linux, Mac OS and Windows) -3. `Build Javet from Scratch `_ (Linux, Mac OS and Windows) +.. toctree:: + :maxdepth: 1 -[`Home <../../README.rst>`_] [`Development `_] + build_javet_with_docker + build_javet_with_pre_built_binaries + build_javet_from_scratch diff --git a/docs/development/build_javet_from_scratch.html b/docs/development/build_javet_from_scratch.html new file mode 100644 index 000000000..ea2b10024 --- /dev/null +++ b/docs/development/build_javet_from_scratch.html @@ -0,0 +1,512 @@ + + + + + + + + Build Javet from Scratch - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Build Javet from Scratch

+
+

Build Environment

+
+

Linux Environment

+
    +

  • Ubuntu 20.04

    • +

  • CMake 3.10+

    • +

  • JDK 8

    • +

  • Gradle 7.0+

    • +
+
+
+

MacOS Environment

+
    +

  • MacOS Catalina+

    • +

  • Latest Brew

    • +

  • Xcode 11.4.1+

    • +

  • Cmake 3.16+

    • +

  • JDK 8

    • +

  • Gradle 7.0+

    • +
+
+
+

Windows Environment

+
    +

  • Latest Windows 10

    • +

  • Visual Studio 2019 Community

    • +

  • CMake 3.16+ (comes with Visual Studio)

    • +

  • Latest Windows 10 SDK with WinDbg

    • +

  • JDK 8

    • +

  • Gradle 7.0+

    • +
+
+
+
+

Build V8

+

Please follow the official guide to build V8. If you face any issues, you may contact @sjtucaocao.

+
+

Prepare V8

+
    +

  • Clone the source code.

    • +

  • Checkout a proper version.

    • +
+

Also, please make sure args.gn file looks like the following.

+
is_debug = false
+target_cpu = "x64"
+v8_monolithic = true
+v8_use_external_startup_data = false
+is_component_build = false
+v8_enable_i18n_support= false
+v8_enable_pointer_compression = false
+v8_static_library = true
+symbol_level = 0
+use_custom_libcxx = false
+
+
+
+
+

Build V8 on Linux and Mac OS

+
export PATH=path_to_depot_tools:$PATH
+cd root_path_to_v8
+ninja -C out.gn/x64.release v8_monolith
+
+
+

⚠️ In V8 v9.3, the following file needs to be patched.

+
+

./include/cppgc/allocation.h

+
#include <cstdint>
+#include <utility> // This line needs to be added.
+#include <new>
+
+
+
+
+
+

Build V8 on Windows

+

⚠️ The patch script requires Python 3.

+
set PATH=path_to_depot_tools;%PATH%
+set DEPOT_TOOLS_WIN_TOOLCHAIN=0
+cd root_path_to_v8
+ninja -C out.gn/x64.release v8_monolith
+python root_path_to_javet\scripts\python\patch_v8_build.py -p .\
+ninja -C out.gn/x64.release v8_monolith
+gn gen --ide=vs out.gn\x64.solution
+
+
+

Why Patching?

+

A few ninja files set certain warnings as errors so that MSVC stops compilation. The patch is to turn off those errors.

+
+
+
+

Build Node.js

+

Please follow Building Node.js to build the static and LTS version of Node.js libraries.

+
+

Prepare Node.js

+
    +

  • Clone the source code.

    • +

  • Checkout a proper version.

    • +
+
+
+

Build Node.js on Linux

+

⚠️ The patch script requires Python 3.

+
cd root_path_to_node_js
+python3 root_path_to_javet/scripts/python/patch_node_build.py -p ./
+./configure --enable-static --without-intl
+python3 root_path_to_javet/scripts/python/patch_node_build.py -p ./
+make -j4
+
+
+

Why Patching?

+
    +

  • First patch: All static node libraries are <thin> libraries. The patch is to disable <thin>.

    • +

  • Second patch: Many static node libraries are not compiled to position independent code and link phase is broken with the following error. The patch is to set -fPIC to those make files.

    +
    +

    /usr/bin/ld: /....../out/Release/libnode.a(node_binding.o): +relocation R_X86_64_TPOFF32 against _ZN4nodeL23thread_local_modpendingE +can not be used when making a shared object; +recompile with -fPIC

    +
    +
    • +
+
+
+

Build Node.js on Mac OS

+
./configure --enable-static --without-intl
+make -j4
+
+
+
+
+

Build Node.js on Windows

+
vcbuild.bat static without-intl
+
+
+
+
+
+

Build Javet

+

Once Node.js and V8 are ready, please proceed with Build Javet with Pre-built Binaries.

+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/development/build_javet_from_scratch.rst b/docs/development/build_javet_from_scratch.rst index 1abb81194..786b9b0ff 100644 --- a/docs/development/build_javet_from_scratch.rst +++ b/docs/development/build_javet_from_scratch.rst @@ -150,6 +150,4 @@ Build Node.js on Windows Build Javet =========== -Once Node.js and V8 are ready, please proceed with `Build Javet with Pre-built Binaries `_. - -[`Home <../../README.rst>`_] [`Development `_] +Once Node.js and V8 are ready, please proceed with :doc:`build_javet_with_pre_built_binaries`. diff --git a/docs/development/build_javet_with_docker.html b/docs/development/build_javet_with_docker.html new file mode 100644 index 000000000..25be3a81a --- /dev/null +++ b/docs/development/build_javet_with_docker.html @@ -0,0 +1,420 @@ + + + + + + + + Build Javet with Docker - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Build Javet with Docker

+

The Docker build supports building Javet for Linux and Windows. As Docker supports Linux and Windows with WSL2, Javet for Linux can also be built on Windows.

+

Regarding Docker build for Mac OS, contributors are welcome if you are interested. Or, you will have to wait for a long while.

+
+

Build Environment

+
+

Linux Environment

+
    +

  • Ubuntu 20.04

    • +

  • Git

    • +

  • Docker

    • +
+
+
+

Windows Environment

+
    +

  • Latest Windows 10

    • +

  • WSL2 + Ubuntu 20.04

    • +

  • Git

    • +

  • Docker

    • +
+
+
+

Docker Hub and Github

+

Please make sure the network connection to the Docker Hub and Github is up and running. The Docker repository of the Javet images are available at https://hub.docker.com/repository/docker/sjtucaocao.

+
+
+
+

Build Javet for Linux on Linux or Windows

+
    +

  1. Clone Javet.

    2. +

  2. Navigate to the root directory of the Javet repository.

    3. +

  3. Execute docker build -f docker/linux-x86_64/build.Dockerfile . (Be careful, please include the last .).

    +
      +

    • Docker will pull the corresponding image (~10GB) from Docker Hub.

      • +

    • The actual build takes few minutes including pulling dependent libraries from Maven Central, building and testing.

      • +
    +
    4. +
+
+
+

Build Javet for Windows on Windows

+
    +

  1. Update daemon.json

    2. +
+
"storage-opts": [
+  "dm.basesize=120GB",
+  "size=120GB"
+]
+
+
+
    +

  1. Restart WSL2

    2. +

  2. Restart docker

    3. +

  3. Clone Javet.

    4. +

  4. Navigate to the root directory of the Javet repository.

    5. +

  5. Execute docker build -t sjtucaocao/javet-windows:x.x.x -m 4G -f docker/windows-x86_64/base.Dockerfile . (Be careful, please include the last .).

    6. +

  6. Execute docker build -f docker/windows-x86_64/build.Dockerfile . (Be careful, please include the last .).

    7. +
+

Note:

+
    +

  • The base image is so large (60+GB) that it's not efficient to push the base image to docker hub. Of course, without the base image at docker hub, it's not wise to enable the github workflow for Windows build.

    • +

  • Building the base image takes many hours and may experience intermittent errors.

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/development/build_javet_with_docker.rst b/docs/development/build_javet_with_docker.rst index 138030a6a..71c78fdce 100644 --- a/docs/development/build_javet_with_docker.rst +++ b/docs/development/build_javet_with_docker.rst @@ -62,5 +62,3 @@ Note: * The base image is so large (60+GB) that it's not efficient to push the base image to docker hub. Of course, without the base image at docker hub, it's not wise to enable the github workflow for Windows build. * Building the base image takes many hours and may experience intermittent errors. - -[`Home <../../README.rst>`_] [`Development `_] diff --git a/docs/development/build_javet_with_pre_built_binaries.html b/docs/development/build_javet_with_pre_built_binaries.html new file mode 100644 index 000000000..35ae073b6 --- /dev/null +++ b/docs/development/build_javet_with_pre_built_binaries.html @@ -0,0 +1,473 @@ + + + + + + + + Build Javet with Pre-built Binaries - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Build Javet with Pre-built Binaries

+
+

Build Environment

+
+

Linux Environment

+
    +

  • Ubuntu 20.04

    • +

  • CMake 3.10+

    • +

  • JDK 8

    • +

  • Gradle 7.0+

    • +
+
+
+

MacOS Environment

+
    +

  • MacOS Catalina+

    • +

  • Latest Brew

    • +

  • Xcode 11.4.1+

    • +

  • Cmake 3.16+

    • +

  • JDK 8

    • +

  • Gradle 7.0+

    • +
+
+
+

Windows Environment

+
    +

  • Latest Windows 10

    • +

  • Visual Studio 2019 Community

    • +

  • CMake 3.16+ (comes with Visual Studio)

    • +

  • Latest Windows 10 SDK with WinDbg

    • +

  • JDK 8

    • +

  • Gradle 7.0+

    • +
+
+
+
+

Download Pre-built Node.js and V8

+

⚠️ As the docker builds are available, I have stopped publishing pre-built binaries. If you really need them, please contact the maintainer wisely. Legacy pre-built binaries are at this drive.

+
+
+

Build Javet JNI Library

+

Once Node.js and V8 are ready, please navigate to ./cpp, make sure CMake is accessible and execute corresponding build script.

+
+++++ + + + + + + + + + + + + + + + + + + + + +

OS

Node.js

V8

Linux

sh build-linux.sh -DNODE_DIR=/absolute_path_to_node_js_build

build-linux.sh -DV8_DIR=\absolute_path_to_v8_build

Mac OS

sh build-macos.sh -DNODE_DIR=/absolute_path_to_node_js_build

build-macos.sh -DV8_DIR=\absolute_path_to_v8_build

Windows

sh build-windows.cmd -DNODE_DIR=/absolute_path_to_node_js_build

build-windows.cmd -DV8_DIR=\absolute_path_to_v8_build

+

After a while, the following libraries will be placed in folder src/main/resources.

+
+++++ + + + + + + + + + + + + + + + + + + + + +

OS

Node.js

V8

Linux

libjavet-node-linux-x86_64.v.*.*.*.so

libjavet-v8-linux-x86_64.v.*.*.*.so

Mac OS

libjavet-node-macos-x86_64.v.*.*.*.dylib

libjavet-v8-macos-x86_64.v.*.*.*.dylib

Windows

libjavet-node-windows-x86_64.v.*.*.*.dll

libjavet-v8-windows-x86_64.v.*.*.*.dll

+
+
+

Build Javet Jar

+

Once all these libraries are built, please put them altogether under src/main/resources then kick off gradle build test.

+

After a while, javet-*.*.*.jar will be placed in folder build/libs.

+
+

Upload Javet to Maven Central (Optional)

+

Package Jar files in Maven.

+
# mvn package
+mvn clean
+mvn release:prepare
+mvn release:perform
+
+
+

Jar files are built under ./target.

+
+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/development/build_javet_with_pre_built_binaries.rst b/docs/development/build_javet_with_pre_built_binaries.rst index 666273943..6ca9c1db0 100644 --- a/docs/development/build_javet_with_pre_built_binaries.rst +++ b/docs/development/build_javet_with_pre_built_binaries.rst @@ -36,9 +36,7 @@ Windows Environment Download Pre-built Node.js and V8 ================================= -I have prepared pre-built Linux and Windows version of Node.js ``v14.17.6`` and V8 ``v9.3.345.16``. Please download the zipped headers and binaries from this `drive `_ and unzip them to local folders respectively. - -Note: As the docker builds are available, I'll stop publishing pre-built binaries. If you really need them, please contact the maintainer wisely. +⚠️ As the docker builds are available, I have stopped publishing pre-built binaries. If you really need them, please contact the maintainer wisely. Legacy pre-built binaries are at this `drive `_. Build Javet JNI Library ======================= @@ -83,5 +81,3 @@ Package Jar files in Maven. mvn release:perform Jar files are built under ``./target``. - -[`Home <../../README.rst>`_] [`Development `_] diff --git a/docs/development/debug_with_chrome_developer_tools.html b/docs/development/debug_with_chrome_developer_tools.html new file mode 100644 index 000000000..c9df8411a --- /dev/null +++ b/docs/development/debug_with_chrome_developer_tools.html @@ -0,0 +1,434 @@ + + + + + + + + Debug with Chrome Developer Tools - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Debug with Chrome Developer Tools

+

Chrome DevTools (aka. CDT) is a set of web developer tools built directly into the Google Chrome browser. DevTools can help you edit pages on-the-fly and diagnose problems quickly, which ultimately helps you build better websites, faster.

+
+

CDT Shell

+

Javet ships a demo CDT Shell application to demonstrate how to work with CDT to perform a live debugging.

+
+

1. Run CDT Shell

+

Run CDT Shell as a normal Java console application and an interactive console will appear working just like a node console does.

+
+
+

2. Run Script in CDT Shell

+

Run arbitrary code in the console just like what can be done in a node console.

+
> let a = 3
+undefined
+> let b = 4
+undefined
+> a + b
+7
+
+
+
+
+

3. Open CDT

+

Open chrome://inspect/ in Chrome, wait few seconds and Javet will appear as a remote target.

+Remote Target Javet +
+
+

4. Debug as Usual

+

Click inspect. Voilà, DevTools is up. As the screenshot shows, live evaluation and auto-completion work successfully. Enjoy the live debugging.

+Remote Target Javet +
+
+
+

Chrome Developer Tools Internals

+
+

Handshake

+ +
Chrome: {"id":1,"method":"Runtime.enable","params":{}}
+Javet Notification: {"method":"Runtime.executionContextCreated","params":{"context":{"id":1,"origin":"","name":"Javet Inspector 00000000","uniqueId":"00000000.00000000"}}}
+Javet Response: {"id":1,"result":{}}
+Chrome: {"id":2,"method":"Debugger.enable","params":{"maxScriptsCacheSize":100000000}}
+Javet Response: {"id":2,"result":{"debuggerId":"00000000.00000000"}}
+Chrome: {"id":3,"method":"Debugger.setPauseOnExceptions","params":{"state":"none"}}
+Javet Response: {"id":3,"result":{}}
+Chrome: {"id":4,"method":"Debugger.setAsyncCallStackDepth","params":{"maxDepth":32}}
+Javet Response: {"id":4,"result":{}}
+Chrome: {"id":5,"method":"Profiler.enable","params":{}}
+Javet Response: {"id":5,"result":{}}
+Chrome: {"id":6,"method":"Runtime.getIsolateId","params":{}}
+Javet Response: {"id":6,"result":{"id":"00000000"}}
+Chrome: {"id":7,"method":"Debugger.setBlackboxPatterns","params":{"patterns":[]}}
+Javet Response: {"id":7,"result":{}}
+Chrome: {"id":8,"method":"Runtime.runIfWaitingForDebugger","params":{}}
+Javet Response: {"id":8,"result":{}}
+
+
+

Note: Method Runtime.runIfWaitingForDebugger can be regarded as the handshake completion and there is no need to parse this message because it is exposed as a callback in IV8InspectorListener.

+

Actually, inside V8, the first message can enable the debugging without the rest of them. Please refer to the source code for detail.

+
+
+
+

Customization

+

Yes, please feel free to customize the debugging server in your environment. CDT Shell is created as a showcase for further customization. Here are some tips.

+
    +

  • Integrate with your HTTP and WebSocket servers. CDT Shell currently uses embedded Jetty. Be careful, HTTP and WebSocket servers need to be hosted together, otherwise, CDT refuses to communicate with the WebSocket server.

    • +

  • Add your IV8InspectorListener to intercept all the event messages. In practice, a decent JSON library like JackSon, GSon may help interpret those messages. As a demo, CDT Shell doesn't process those messages. Why intercept those messages? Because:

    +
    +
      +

    • To set up breakpoints before script is executed.

      • +

    • To send messages to CDT right after CDT is connected.

      • +

    • To turn on / off certain features.

      • +

    • To enforce authentication and authorization.

      • +

    • To change V8 runtime.

      • +
    +
    +
    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/development/debug_with_chrome_developer_tools.rst b/docs/development/debug_with_chrome_developer_tools.rst index a60636bba..94cf38767 100644 --- a/docs/development/debug_with_chrome_developer_tools.rst +++ b/docs/development/debug_with_chrome_developer_tools.rst @@ -7,7 +7,7 @@ Debug with Chrome Developer Tools CDT Shell ========= -Javet ships a demo `CDT Shell <../../src/test/java/com/caoccao/javet/tutorial/cdt/TestCDT.java>`_ application to demonstrate how to work with CDT to perform a live debugging. +Javet ships a demo :extsource2:`CDT Shell <../../src/test/java/com/caoccao/javet/tutorial/cdt/TestCDT.java>` application to demonstrate how to work with CDT to perform a live debugging. 1. Run CDT Shell ---------------- @@ -33,7 +33,7 @@ Run arbitrary code in the console just like what can be done in a node console. Open chrome://inspect/ in Chrome, wait few seconds and Javet will appear as a remote target. -.. image:: ../resources/images/chome_developer_tools_devices_remote_target_javet.png?raw=true +.. image:: ../resources/images/chome_developer_tools_devices_remote_target_javet.png :alt: Remote Target Javet 4. Debug as Usual @@ -41,7 +41,7 @@ Open chrome://inspect/ in Chrome, wait few seconds and Javet will appear as a re Click ``inspect``. Voilà, DevTools is up. As the screenshot shows, live evaluation and auto-completion work successfully. Enjoy the live debugging. -.. image:: ../resources/images/chome_developer_tools_console.png?raw=true +.. image:: ../resources/images/chome_developer_tools_console.png :alt: Remote Target Javet Chrome Developer Tools Internals @@ -55,7 +55,7 @@ Handshake * CDT queries http://127.0.0.1:9229/javet with a websocket upgrade request. CDT Shell responses with websocket upgrade accepted. * CDT switches to ws://127.0.0.1:9229/javet and sends the following 8 messages to perform a handshake with a node flavored remote target. -.. code-block:: json +.. code-block:: js Chrome: {"id":1,"method":"Runtime.enable","params":{}} Javet Notification: {"method":"Runtime.executionContextCreated","params":{"context":{"id":1,"origin":"","name":"Javet Inspector 00000000","uniqueId":"00000000.00000000"}}} @@ -77,7 +77,7 @@ Handshake Note: Method ``Runtime.runIfWaitingForDebugger`` can be regarded as the handshake completion and there is no need to parse this message because it is exposed as a callback in ``IV8InspectorListener``. -Actually, inside V8, the first message can enable the debugging without the rest of them. Please visit `TestV8Inspector.java <../../src/test/java/com/caoccao/javet/interop/TestV8Inspector.java>`_ for detail. +Actually, inside V8, the first message can enable the debugging without the rest of them. Please refer to the :extsource2:`source code <../../src/test/java/com/caoccao/javet/interop/TestV8Inspector.java>` for detail. Customization ============= diff --git a/docs/development/design.html b/docs/development/design.html new file mode 100644 index 000000000..fedb9a473 --- /dev/null +++ b/docs/development/design.html @@ -0,0 +1,567 @@ + + + + + + + + Javet Design - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Javet Design

+
+

Architecture

+Javet Architecture +
+

Primitive and Reference Types in Javet

+

There is a vague boundary between V8 primitive and reference types. In Javet, the definition of primitive is a mixture of both V8 and Java primitive types as a trade-off in design.

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + +

Feature

Primitive

Reference

Interception

No

Yes

Memory Copy

Copy by Value

Copy by Reference

Resource Leak

Not Possible

Possible

Set to Weak

No

Yes

+

Reference typed objects keep memory footprint in V8 + JNI + JVM. All resource will be recycled when close() is called. That is quite an old school way of managing resource. Javet tries to hide that kind of tedious work from Java applications via try-with-resource.

+

Please refer to Best Practices for detail.

+
+
+
+

Node.js Mode vs. V8 Mode

+

Javet supports both Node.js mode and V8 mode both of which can co-exist in one JVM. In other words, they can run side by side and don't interfere with each other.

+Javet Modes +

As the diagram shows, both Node.js and V8 are lazy loaded in dedicated custom classloaders. Detailed comparisons are as following.

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Feature

Node.js Mode

V8 Mode

Lazy Loadable

Yes

Yes

Customization

High

High

Node.js Ecosystem

Complete

No

Security

Low

High

Unload

Yes

Yes

V8 Ecosystem

Complete

Complete

V8 Version

Low

High

+

One of the beauties of Javet is all the features in V8 mode can be applied to Node.js mode. Here are some examples.

+
    +

  • Virtualization - All Node.js modules can be virtualized. E.g. console, fs, HTTP, Net, OS, etc.

    • +

  • Zero-copy - JVM can share the same byte buffer with Node.js and V8 to achieve zero-copy.

    • +

  • Multi-threading - Multiple Java threads can host multiple Node.js runtime instances with only one copy of V8 objects visible to those instances.

    • +

  • Beyond Node.js - Javet allows explicit await() so that applications can take more control over async execution.

    • +
+
+
+

Module

+

Executing all scripts in global context is not recommended when project size increases. Javet provides complete support to applications so that V8 runtime context is aligned with the way Node or Chrome does. That brings the module system.

+

Unfortunately, V8 has very limited support to the JS module system. However, that is not bad because V8 leaves all the possibilities to Javet. The typical challenges Javet faces are as following.

+
    +

  • Sync or Async

    • +

  • Module Location

    • +

  • Module Dependency

    • +
+
+

require() vs. import()

+
+++++++ + + + + + + + + + + + + + + + + + + + + + + +

Feature

Async

Original V8

Javet Node.js Mode

Javet V8 Mode

require()

No

No

Yes (Complete)

Yes (with an Interceptor)

import()

Yes

Yes (Partial)

Yes (Complete)

Yes (Complete)

+
+
+

Module Virtualization

+

Javet doesn't build require() in but allows applications to set an interceptor because Javet doesn't know how to locate the modules and doesn't want to know for security issues. So it's up to the applications to define their own ways of locating the modules.

+

Javet provides complete support to ES6 import() because certain work inside JNI has to be in place as V8 only partially supports import(). So, in Javet the module is kind of virtualized, in other words, the module is represented by an arbitrary string that can be interpreted by applications during runtime. E.g. module.js may come from a file, a URL, a string in memory or whatever. Javet stores the compiled and evaluated module in a map with that string as key, and feeds V8 that module when V8 looks it up by that string.

+Javet Module System +
+
+
+

Engine Pool

+Javet Engine Pool +
+

V8 Isolate and Context in Javet

+

Getting started with embedding V8 is an excellent article that explains the concepts, design, insights of V8. In summary:

+
    +

  • An isolate is a VM instance with its own heap.

    • +

  • A context is an execution environment that allows separate, unrelated, JavaScript applications to run in a single instance of V8.

    • +
+

In Javet, that model is simplified to 1 engine - 1 runtime - 1 isolate - 1 context. In V8Runtime, resetIsolate() and resetContext() are both exposed. It is recommended to always use resetContext() to get a brand new V8 context for the following reasons.

+
    +

  • resetContext() is a much cheaper operation with much better performance.

    • +

  • resetContext() is good enough in terms of getting a brand new V8 context.

    • +
+
+
+

Javet Engine Pool

+

Multiple Javet engines are managed by Javet Engine Pool which works almost the same way as a typical DB connection pool. Javet Engine Pool is thread-safe. However, Javet Engine is NOT thread-safe because it is designed to be single-threaded and lock free for the following reasons.

+
    +

  • V8 isolate and V8 context are single-threaded. Thread context violation results in V8 core dump immediately.

    • +

  • Javet Engine performs better without locks. Actually, Javet engine only validates current thread ID to minimize the performance overhead.

    • +
+

Please refer to Best Practices for detail.

+
+
+
+

Interception

+

Javet allows intercepting almost all V8 API so that JS code actually interacts with Java code behind the scene.

+Javet Interception +

Sample code is available at V8 Function.

+
+
+

Cross-platform

+

Javet packages all the libraries in a single jar file and automatically loads corresponding library per OS and JS runtime.

+Javet Cross-platform +
    +

  • Javet calculates the library file name from OS and JS runtime.

    • +

  • Javet unpacks the library files from resource directory to system_temporary_directory/javet/pid.

    • +

  • Javet loads the library files using either default classloader or custom classloader.

    • +
+
+

Multi-process Safety

+

Javet is multi-process safe because it deploys the library files to system_temporary_directory/javet/pid to avoid race conditions during initialization. Also, Javet purges legacy libraries (at least 1 minute old) at the beginning of the initialization.

+
+
+
+

Memory Leak Detection

+

Javet native library keeps track of every new and delete in JavetNativeMonitor. Javet every unit test case fetches the tracking data, compares the new and delete count to verify unmanaged objects are properly allocated and freed.

+

This feature is only turned on in debug version and there is zero performance overhead in release version.

+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/development/design.rst b/docs/development/design.rst index a32ec47e0..98edc382e 100644 --- a/docs/development/design.rst +++ b/docs/development/design.rst @@ -5,7 +5,7 @@ Javet Design Architecture ============ -.. image:: ../resources/images/javet_architecture.png?raw=true +.. image:: ../resources/images/javet_architecture.png :alt: Javet Architecture Primitive and Reference Types in Javet @@ -24,14 +24,14 @@ Set to Weak No Yes Reference typed objects keep memory footprint in V8 + JNI + JVM. All resource will be recycled when ``close()`` is called. That is quite an old school way of managing resource. Javet tries to hide that kind of tedious work from Java applications via try-with-resource. -Please refer to `Best Practices <../reference/best_practices.rst>`_ for detail. +Please refer to :doc:`../reference/best_practices` for detail. Node.js Mode vs. V8 Mode ======================== Javet supports both Node.js mode and V8 mode both of which can co-exist in one JVM. In other words, they can run side by side and don't interfere with each other. -.. image:: ../resources/images/javet_modes.png?raw=true +.. image:: ../resources/images/javet_modes.png :alt: Javet Modes As the diagram shows, both Node.js and V8 are lazy loaded in dedicated custom classloaders. Detailed comparisons are as following. @@ -83,13 +83,13 @@ Javet doesn't build ``require()`` in but allows applications to set an intercept Javet provides complete support to ES6 ``import()`` because certain work inside JNI has to be in place as V8 only partially supports ``import()``. So, in Javet the module is kind of virtualized, in other words, the module is represented by an arbitrary string that can be interpreted by applications during runtime. E.g. ``module.js`` may come from a file, a URL, a string in memory or whatever. Javet stores the compiled and evaluated module in a map with that string as key, and feeds V8 that module when V8 looks it up by that string. -.. image:: ../resources/images/javet_module_system.png?raw=true +.. image:: ../resources/images/javet_module_system.png :alt: Javet Module System Engine Pool =========== -.. image:: ../resources/images/javet_engine_pool.png?raw=true +.. image:: ../resources/images/javet_engine_pool.png :alt: Javet Engine Pool V8 Isolate and Context in Javet @@ -113,24 +113,24 @@ Multiple Javet engines are managed by Javet Engine Pool which works almost the s * V8 isolate and V8 context are single-threaded. Thread context violation results in V8 core dump immediately. * Javet Engine performs better without locks. Actually, Javet engine only validates current thread ID to minimize the performance overhead. -Please refer to `Best Practices <../reference/best_practices.rst>`_ for detail. +Please refer to :doc:`../reference/best_practices` for detail. Interception ============ Javet allows intercepting almost all V8 API so that JS code actually interacts with Java code behind the scene. -.. image:: ../resources/images/javet_interception.png?raw=true +.. image:: ../resources/images/javet_interception.png :alt: Javet Interception -Sample code is available at `here <../reference/v8_function.rst>`_. +Sample code is available at :doc:`../reference/v8_function`. Cross-platform ============== Javet packages all the libraries in a single jar file and automatically loads corresponding library per OS and JS runtime. -.. image:: ../resources/images/javet_cross_platform.png?raw=true +.. image:: ../resources/images/javet_cross_platform.png :alt: Javet Cross-platform * Javet calculates the library file name from OS and JS runtime. @@ -148,5 +148,3 @@ Memory Leak Detection Javet native library keeps track of every ``new`` and ``delete`` in ``JavetNativeMonitor``. Javet every unit test case fetches the tracking data, compares the ``new`` and ``delete`` count to verify unmanaged objects are properly allocated and freed. This feature is only turned on in debug version and there is zero performance overhead in release version. - -[`Home <../../README.rst>`_] [`Development `_] diff --git a/docs/development/index.html b/docs/development/index.html new file mode 100644 index 000000000..60c94a7c4 --- /dev/null +++ b/docs/development/index.html @@ -0,0 +1,367 @@ + + + + + + + + Development - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+ + +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/development/index.rst b/docs/development/index.rst index 8da39dc1c..db4ce780c 100644 --- a/docs/development/index.rst +++ b/docs/development/index.rst @@ -2,15 +2,11 @@ Development =========== -* `Development Tools `_ -* `Build `_ - - * `Build Javet with Docker `_ (Linux and Windows) - * `Build Javet with Pre-built Binaries `_ (Linux, Mac OS and Windows) - * `Build Javet from Scratch `_ (Linux, Mac OS and Windows) - -* `Test `_ -* `Design `_ -* `Debug with Chrome Developer Tools `_ - -[`Home <../../README.rst>`_] +.. toctree:: + :maxdepth: 2 + + tools + build + test + design + debug_with_chrome_developer_tools diff --git a/docs/development/test.html b/docs/development/test.html new file mode 100644 index 000000000..bf96e2aed --- /dev/null +++ b/docs/development/test.html @@ -0,0 +1,332 @@ + + + + + + + + Test Javet - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Test Javet

+

Test is designed to completely reuse test cases for either Node.js or V8 mode.

+

How do test cases know which mode to test? The base test suite compares the timestamp of the Node.js and V8 libraries and set test target to the newer one. So, if a new library is built, test cases automatically set test target to that new library.

+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/development/test.rst b/docs/development/test.rst index f9b78ade0..09adda82b 100644 --- a/docs/development/test.rst +++ b/docs/development/test.rst @@ -5,5 +5,3 @@ Test Javet Test is designed to completely reuse test cases for either Node.js or V8 mode. How do test cases know which mode to test? The base test suite compares the timestamp of the Node.js and V8 libraries and set test target to the newer one. So, if a new library is built, test cases automatically set test target to that new library. - -[`Home <../../README.rst>`_] [`Development `_] diff --git a/docs/development/tools.html b/docs/development/tools.html new file mode 100644 index 000000000..e94372640 --- /dev/null +++ b/docs/development/tools.html @@ -0,0 +1,383 @@ + + + + + + + + Development Tools - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Development Tools

+
+

JDK

+

Javet development requires JDK 8 to be installed, though Javet supports JDK 8+. JDK 6 support has been dropped because a few JDK 8 features are heavily used in Javet.

+
+
+

IntelliJ

+

I personally recommend IntelliJ IDEA.

+
+
+

Gradle

+

For now, Gradle v7.2 + Kotlin DSL constructs the build system.

+
+
+

Node.js

+

Node.js 14.17.6+ is supported.

+
+
+

Maven (Optional)

+

Maven v3.6.3+ is used for packaging bundle to maven central.

+
+
+

Visual Studio Community 2019 (Optional)

+

Visual Studio Community 2019 is used for JNI development.

+
+
+

Python 3.8+ (Optional)

+

Python 3.8+ is required if you want to upgrade the version.

+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/development/tools.rst b/docs/development/tools.rst index 0a2954781..d53ed7ba7 100644 --- a/docs/development/tools.rst +++ b/docs/development/tools.rst @@ -15,7 +15,7 @@ I personally recommend IntelliJ IDEA. Gradle ====== -For now, Gradle v6.7 + Kotlin DSL constructs the build system. +For now, Gradle v7.2 + Kotlin DSL constructs the build system. Node.js ================= @@ -36,5 +36,3 @@ Python 3.8+ (Optional) ====================== Python 3.8+ is required if you want to upgrade the version. - -[`Home <../../README.rst>`_] [`Development `_] diff --git a/docs/faq/background/history_with_j2v8.html b/docs/faq/background/history_with_j2v8.html new file mode 100644 index 000000000..cb2d5469c --- /dev/null +++ b/docs/faq/background/history_with_j2v8.html @@ -0,0 +1,431 @@ + + + + + + + + History with J2V8 - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

History with J2V8

+
+

J2V8 Issues

+

J2V8 is an excellent project on embedding V8 in Java. However, J2V8 community hasn't been active since 2017.

+

The last Windows version 4.6.0 was released in 2016 and the last Linux version 4.8.0 was released in 2017. The V8 in Windows v4.6.0 doesn't even fully support ES6.

+

The latest community activities were around Android versions. The Node.js API was dropped. The Windows build has been seriously broken for years. The Linux build is nearly broken. There are serious memory leak issues which are hard to be fixed under the current architecture.

+

Its API has stopped evolving for years. Many new features I expect just don't get any chances to be implemented. Obviously, if the build system was broken and couldn't be easily fixed, almost no one would like to contribute. That includes me. When I was trying to fix the build system for Windows and Linux, I had to admit that's so, so, so, challenging. Why is that? I think it's not merely J2V8 community's problem because in the meanwhile V8, Node.js and ECMAScript move forward rapidly causing many unexpected challenges. Someone or some team needs to look after J2V8 from time to time. Unfortunately, the reality is cruel.

+
+
+

J2V8 Latest Version

+

I managed to unofficially build the latest J2V8 v6.2.0.

+
    +

  • V8 is upgraded to v8.3.110.9 which was released in May, 2020.

    • +

  • Windows and Linux are supported.

    • +

  • Node.js is dropped temporarily.

    • +
+

I've tested the performance between j2v8_win32_x86_64-4.6.0.jar and j2v8_win32_x86_64-6.2.0.jar on a Windows machine with CPU i7 10700K. The test code is just 1+1 -> 2. Here are the comparisons.

+
+++++ + + + + + + + + + + + + + + + + + + + + +

Case

4.6.0 (TPS)

6.2.0 (TPS)

Single Session with 1 Thread

1,003,009

1,338,688

Ad-hoc Session with 1 Thread

35

299

4 Sessions with 4 threads

2,274,019

4,571,428

+

With this kind of performance improvement, what are the reasons of sticking to v4.6.0?

+
+
+

Why Windows and Linux only?

+
    +

  • I don't own a decent Mac device. To be more precisely, I have Mac Mini and MacBook Air, but they are too old (building V8 would take many hours). And I have no plan on buying a new one in the near future. Call for donation? Don't be joking. So there's no MacOS release.

    • +

  • I don't intend to support Android for now.

    • +
+
+
+

Why not Automate the J2V8 Build System?

+

TL;DR: It's too hard.

+
    +

  • V8 is evolving rapidly. v8.3.110.9 is a relatively easy one to be mastered. I didn't move forward well with v8.9.213 which placed a different set of solvable challenges to me. I plan to revisit the latest V8 in near future.

    • +

  • Node.js was removed early. I haven't got time reviving it in J2V8.

    • +

  • J2V8 build system is too old.

    +
      +

    • Gradle v2.14.1 is far from the lowest supported gradle version in my latest IntelliJ IDEA. And I don't have interest in installing a legacy Eclipse to play with that version of gradle. Hey, why not upgrade gradle to satisfy IDEA? I tried, but all was bad luck. You may take a try, then understand what I have suffered from.

      • +

    • CMake is old and seriously broken on Windows. Nowadays, V8 only supports VS 2017 or 2019, but CMakeLists.txt is still at the VS 2015 age. No surprise, it doesn't work at all.

      • +

    • Docker build is deeply broken as well. The dependent docker image was gone. There are many errors in many steps. Sitting there, watching the docker build breaks made me full of frustration because I thought it would take me a few months fixing the problems, but I don't have a few months. No one pays me to do that.

      • +

    • Python2 scripts form the outer layer of the build system, also hide the actual building logic from someone who tries to fix the build system. I don't want to spend my precious time fixing Python2 scripts, because I've been on Python3 for many years. I wish my hair could be as much as Guido van Rossum's. Obviously, I am not, so no more Python2.

      • +

    • Maven is old but the least problematic. At least it allows me to package the jar files with my hack to the pom.xml.

      • +
    +
    • +
+

With these uncertainties, to me, automating the build system is something with ROI closing to 0. Supposing I achieved it in a particular version of V8, let's say v8.3.110.9, it would for sure break in v8.9.x. Later, I managed to build v8.9.255 which has been embeded into Javet.

+
+
+

Why not Deploy J2V8 to Maven Repository?

+
    +

  • I don't have the permission to its official repository.

    • +

  • There has been no Windows / Linux releases deployed since 2016 / 2017. I really don't know who to contact with.

    • +

  • You may easily integrate the jar files in your local maven repository.

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/faq/history_with_j2v8.rst b/docs/faq/background/history_with_j2v8.rst similarity index 98% rename from docs/faq/history_with_j2v8.rst rename to docs/faq/background/history_with_j2v8.rst index 0f2675107..447a3fff7 100644 --- a/docs/faq/history_with_j2v8.rst +++ b/docs/faq/background/history_with_j2v8.rst @@ -63,5 +63,3 @@ Why not Deploy J2V8 to Maven Repository? * I don't have the permission to its official repository. * There has been no Windows / Linux releases deployed since 2016 / 2017. I really don't know who to contact with. * You may easily integrate the jar files in your local maven repository. - -[`Home <../../README.rst>`_] [`FAQ `_] diff --git a/docs/faq/background/index.html b/docs/faq/background/index.html new file mode 100644 index 000000000..344a3d3cd --- /dev/null +++ b/docs/faq/background/index.html @@ -0,0 +1,336 @@ + + + + + + + + Background - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+ +
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/faq/background/index.rst b/docs/faq/background/index.rst new file mode 100644 index 000000000..f34978f5e --- /dev/null +++ b/docs/faq/background/index.rst @@ -0,0 +1,9 @@ +========== +Background +========== + +.. toctree:: + :maxdepth: 1 + + what_is_the_motivation + history_with_j2v8 diff --git a/docs/faq/background/what_is_the_motivation.html b/docs/faq/background/what_is_the_motivation.html new file mode 100644 index 000000000..461683579 --- /dev/null +++ b/docs/faq/background/what_is_the_motivation.html @@ -0,0 +1,334 @@ + + + + + + + + What is the Motivation? - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

What is the Motivation?

+

I used to take a try of J2V8 and find it's quite compelling. However, J2V8 is slowly dying, with serious memory leak issues, V8 version issue, etc.

+

Sometimes starting from scratch implies lower cost than upgrading an existing solution. I think it might be true here in this project. I've learned quite a lot by manually fixing the Windows and Linux build system of J2V8.

+

Also, I had got many ideas on how the API will look like. At the end of 2020, I thought I would be able to write a new one from scratch and leave J2V8 behind. Indeed, I made it few months later.

+

Please refer to History with J2V8 for detail.

+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/faq/what_is_the_motivation.rst b/docs/faq/background/what_is_the_motivation.rst similarity index 83% rename from docs/faq/what_is_the_motivation.rst rename to docs/faq/background/what_is_the_motivation.rst index 57490579b..1ce83fee8 100644 --- a/docs/faq/what_is_the_motivation.rst +++ b/docs/faq/background/what_is_the_motivation.rst @@ -8,6 +8,4 @@ Sometimes starting from scratch implies lower cost than upgrading an existing so Also, I had got many ideas on how the API will look like. At the end of 2020, I thought I would be able to write a new one from scratch and leave J2V8 behind. Indeed, I made it few months later. -Please refer to `History with J2V8 `_ for detail. - -[`Home <../../README.rst>`_] [`FAQ `_] +Please refer to :doc:`history_with_j2v8` for detail. diff --git a/docs/faq/can_i_debug_javet_in_chrome_dev_tools.rst b/docs/faq/can_i_debug_javet_in_chrome_dev_tools.rst deleted file mode 100644 index 5032c9dda..000000000 --- a/docs/faq/can_i_debug_javet_in_chrome_dev_tools.rst +++ /dev/null @@ -1,10 +0,0 @@ -===================================== -Can I Debug Javet in Chrome DevTools? -===================================== - -Yes, you can do that. Please visit `Debug with Chrome Developer Tools <../development/debug_with_chrome_developer_tools.rst>`_ for detail. - -.. image:: ../resources/images/chome_developer_tools_devices_remote_target_javet.png?raw=true - :alt: Remote Target Javet - -[`Home <../../README.rst>`_] [`FAQ `_] diff --git a/docs/faq/development/how_to_think_in_javet.html b/docs/faq/development/how_to_think_in_javet.html new file mode 100644 index 000000000..5f70d0cec --- /dev/null +++ b/docs/faq/development/how_to_think_in_javet.html @@ -0,0 +1,389 @@ + + + + + + + + How to Think in Javet? - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

How to Think in Javet?

+

There are folks migrating projects from other libraries (e.g. J2V8) to Javet. Some experienced certain challenges which from Javet perspective required Thinking in Javet. So, how?

+
+

V8Runtime and V8ValueGlobalObject

+

In Javet, V8Runtime and V8ValueGlobalObject are separate concepts.

+
+

V8Runtime

+

V8Runtime is only a representative of the V8 isolate and V8 context. It has nothing to do with globalThis or window. However, in few other libraries these concepts are mixed up.

+
+
+

V8ValueGlobalObject

+

As V8Runtime no longer represents globalThis or window, V8ValueGlobalObject from V8Runtime.getGlobalObject() is the one.

+

If you want to access global objects or call top level functions, globalObject.get('...') and globalObject.invoke('...') are the Javet ways.

+
+
+
+

Executor and Execute

+

In Javet, executing a script involves 2 steps.

+
    +

  1. Get an executor.

    2. +

  2. Call certain execute method of that executor.

    3. +
+

This is quite different from the common practice of few other libraries where execute is just a 1-step thing.

+

Why? Javet intends to offer a builder pattern in the script execution. With an executor, application may do every other things before the actual execution. For instance: security check, enable / disable certain V8 features, hack the AST, set up interception, etc. The scope may be limited to that executor only. Also, the executor can be reused to avoid the duplicated resource loading overhead.

+
+
+

Declarative Function and Property Interception

+

Javet offers an easy way of registering function and property interception in a declarative way. Just decorate a function of arbitrary object with @V8Function(name = "...") or @V8Property(name = "..."), Javet is able to register it and that function will be called back from V8. Application is free from managing those tedious things like resource leakage, object lifecycle, type conversion, etc. Javet just handles that behind the scene and everything goes smoothly.

+

The coding experience is a little bit close to working with Spring Framework.

+
+
+

Learn from Unit Test

+

Most of the Javet API is unit test covered. Learning from Javet unit test is an express and effective way to Thinking in Javet.

+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/faq/how_to_think_in_javet.rst b/docs/faq/development/how_to_think_in_javet.rst similarity index 66% rename from docs/faq/how_to_think_in_javet.rst rename to docs/faq/development/how_to_think_in_javet.rst index b5618088e..de194ec67 100644 --- a/docs/faq/how_to_think_in_javet.rst +++ b/docs/faq/development/how_to_think_in_javet.rst @@ -4,18 +4,18 @@ How to Think in Javet? There are folks migrating projects from other libraries (e.g. J2V8) to Javet. Some experienced certain challenges which from Javet perspective required **Thinking in Javet**. So, how? -``V8Runtime`` and ``V8ValueGlobalObject`` -========================================= +V8Runtime and V8ValueGlobalObject +================================= In Javet, ``V8Runtime`` and ``V8ValueGlobalObject`` are separate concepts. -``V8Runtime`` -------------- +V8Runtime +--------- ``V8Runtime`` is only a representative of the V8 isolate and V8 context. It has nothing to do with ``globalThis`` or ``window``. However, in few other libraries these concepts are mixed up. -``V8ValueGlobalObject`` ------------------------ +V8ValueGlobalObject +------------------- As ``V8Runtime`` no longer represents ``globalThis`` or ``window``, ``V8ValueGlobalObject`` from ``V8Runtime.getGlobalObject()`` is the one. @@ -26,23 +26,21 @@ Executor and Execute In Javet, executing a script involves 2 steps. -1. Get the executor. +1. Get an executor. 2. Call certain execute method of that executor. This is quite different from the common practice of few other libraries where execute is just a 1-step thing. Why? Javet intends to offer a builder pattern in the script execution. With an executor, application may do every other things before the actual execution. For instance: security check, enable / disable certain V8 features, hack the AST, set up interception, etc. The scope may be limited to that executor only. Also, the executor can be reused to avoid the duplicated resource loading overhead. -Declarative Function Interception -================================= +Declarative Function and Property Interception +============================================== -Javet offers an easy way of registering function interception in a declarative way. Just decorate a function of arbitrary object with ``@V8Function(name = "...")``, Javet is able to register it and that function will be called back from V8. Application is free from managing those tedious things like resource leakage, object lifecycle, type conversion, etc. Javet just handles that behind the scene and everything goes smoothly. +Javet offers an easy way of registering function and property interception in a declarative way. Just decorate a function of arbitrary object with ``@V8Function(name = "...")`` or ``@V8Property(name = "...")``, Javet is able to register it and that function will be called back from V8. Application is free from managing those tedious things like resource leakage, object lifecycle, type conversion, etc. Javet just handles that behind the scene and everything goes smoothly. The coding experience is a little bit close to working with Spring Framework. Learn from Unit Test ==================== -Most of the Javet API is unit test coverted. Learning from Javet unit test is an express and effective way to Thinking in Javet. - -[`Home <../../README.rst>`_] [`FAQ `_] +Most of the Javet API is unit test covered. Learning from Javet unit test is an express and effective way to Thinking in Javet. diff --git a/docs/faq/development/index.html b/docs/faq/development/index.html new file mode 100644 index 000000000..6cccf8e66 --- /dev/null +++ b/docs/faq/development/index.html @@ -0,0 +1,336 @@ + + + + + + + + Development - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+ +
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/faq/development/index.rst b/docs/faq/development/index.rst new file mode 100644 index 000000000..c29b71412 --- /dev/null +++ b/docs/faq/development/index.rst @@ -0,0 +1,9 @@ +=========== +Development +=========== + +.. toctree:: + :maxdepth: 1 + + how_to_think_in_javet + where_are_es6_api_in_v8_mode diff --git a/docs/faq/development/where_are_es6_api_in_v8_mode.html b/docs/faq/development/where_are_es6_api_in_v8_mode.html new file mode 100644 index 000000000..b1df9d071 --- /dev/null +++ b/docs/faq/development/where_are_es6_api_in_v8_mode.html @@ -0,0 +1,332 @@ + + + + + + + + Where are ES6 API in V8 Mode? - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Where are ES6 API in V8 Mode?

+

V8 mode only offers the basic functionality so that some ES6 API are absent. E.g. setTimeout, setInterval, etc.

+

Project Javenode is an extension of Javet aiming at simulating Node.js with Java in Javet V8 mode.

+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/faq/where_are_es6_api_in_v8_mode.rst b/docs/faq/development/where_are_es6_api_in_v8_mode.rst similarity index 87% rename from docs/faq/where_are_es6_api_in_v8_mode.rst rename to docs/faq/development/where_are_es6_api_in_v8_mode.rst index cfb315014..9f905cd07 100644 --- a/docs/faq/where_are_es6_api_in_v8_mode.rst +++ b/docs/faq/development/where_are_es6_api_in_v8_mode.rst @@ -5,5 +5,3 @@ Where are ES6 API in V8 Mode? V8 mode only offers the basic functionality so that some ES6 API are absent. E.g. setTimeout, setInterval, etc. Project `Javenode `_ is an extension of Javet aiming at simulating Node.js with Java in Javet V8 mode. - -[`Home <../../README.rst>`_] [`FAQ `_] diff --git a/docs/faq/environment/can_javet_support_legacy_linux.html b/docs/faq/environment/can_javet_support_legacy_linux.html new file mode 100644 index 000000000..4d0fe2d79 --- /dev/null +++ b/docs/faq/environment/can_javet_support_legacy_linux.html @@ -0,0 +1,379 @@ + + + + + + + + Can Javet Support Legacy Linux? - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Can Javet Support Legacy Linux?

+

Yes, Javet can support some legacy linux distributions, eg: Ubuntu 16.04, Ubuntu 18.04, but not with the official builds which rely on more advanced tool chain.

+

Please download the private builds from this drive and prepare your runtime environment as following.

+
sudo apt update
+sudo apt upgrade -y
+sudo apt install build-essential -y
+sudo apt install software-properties-common -y
+sudo add-apt-repository ppa:ubuntu-toolchain-r/test
+sudo apt upgrade -y
+sudo apt install gcc-snapshot -y
+sudo apt upgrade -y
+sudo apt install gcc-7 g++-7 gcc-8 g++-8 gcc-9 g++-9 -y
+sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-9 90 --slave /usr/bin/g++ g++ /usr/bin/g++-9 --slave /usr/bin/gcov gcov /usr/bin/gcov-9
+sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-8 80 --slave /usr/bin/g++ g++ /usr/bin/g++-8 --slave /usr/bin/gcov gcov /usr/bin/gcov-8
+sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-7 70 --slave /usr/bin/g++ g++ /usr/bin/g++-7 --slave /usr/bin/gcov gcov /usr/bin/gcov-7
+sudo update-alternatives --config gcc
+
+There are 3 choices for the alternative gcc (providing /usr/bin/gcc).
+
+Selection    Path            Priority   Status
+------------------------------------------------------------
+* 0            /usr/bin/gcc-9   90        auto mode
+  1            /usr/bin/gcc-7   70        manual mode
+  2            /usr/bin/gcc-8   80        manual mode
+  3            /usr/bin/gcc-9   90        manual mode
+
+
+
+

Notes

+

Private builds imply considerable additional effort, so there is no commitments. Please contact the maintainer for private builds wisely.

+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/faq/can_javet_support_legacy_linux.rst b/docs/faq/environment/can_javet_support_legacy_linux.rst similarity index 97% rename from docs/faq/can_javet_support_legacy_linux.rst rename to docs/faq/environment/can_javet_support_legacy_linux.rst index ac0b5313f..fe7cb646a 100644 --- a/docs/faq/can_javet_support_legacy_linux.rst +++ b/docs/faq/environment/can_javet_support_legacy_linux.rst @@ -35,5 +35,3 @@ Notes ===== Private builds imply considerable additional effort, so there is no commitments. Please contact the maintainer for private builds wisely. - -[`Home <../../README.rst>`_] [`FAQ `_] diff --git a/docs/faq/environment/can_javet_support_mac.html b/docs/faq/environment/can_javet_support_mac.html new file mode 100644 index 000000000..e43349ea2 --- /dev/null +++ b/docs/faq/environment/can_javet_support_mac.html @@ -0,0 +1,388 @@ + + + + + + + + Can Javet Support Mac? - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Can Javet Support Mac?

+
+

Now

+

My MacBook Air mid-2012 was revived with Mac OS Catalina which is the lowest version supported by latest V8. I managed to include it in the regular release cycle.

+
+

Known Issue

+

Some of the Node.js symbols might not be exposed correctly. That might cause native node modules malfunction. Quick fix will be served per issue reported.

+
+
+

Will the Mac OS Build be LTS?

+

I doubt because when next time V8 abandons Catalina, I won't be able to create any new builds unless someone takes care of the Mac OS build or I get enough donation for a new device. Donate

+
+
+

How about arm64?

+

That is still not supported. Please Donate

+
+
+
+

Before Aug 10, 2021

+

Short answer is Yes and No.

+
+

Yes

+

There is no technical difficulties. The code is written in cross-platform manner. Someone needs to pay considerable effort creating and maintaining the Mac build.

+
+
+

No

+

I don't own a decent Mac device. To be more precisely, I have Mac Mini and MacBook Air, but they are too old (building Node.js and V8 would take many hours). Besides, there are both x86 and arm64 to be supported.

+

I have no plan on buying 2 new Mac devices for supporting Javet only in the near future. If I could be well funded, I would consider supporting Mac.

+
+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/faq/can_javet_support_mac.rst b/docs/faq/environment/can_javet_support_mac.rst similarity index 84% rename from docs/faq/can_javet_support_mac.rst rename to docs/faq/environment/can_javet_support_mac.rst index e2bb02b61..10a244dca 100644 --- a/docs/faq/can_javet_support_mac.rst +++ b/docs/faq/environment/can_javet_support_mac.rst @@ -5,7 +5,7 @@ Can Javet Support Mac? Now === -My MacBook Air mid-2012 was revived with Mac OS Catalina which is the lowest version supported by latest V8. I managed to include it in the regular release cycle. +My `MacBook Air mid-2012 `_ was revived with Mac OS Catalina which is the lowest version supported by latest V8. I managed to include it in the regular release cycle. Known Issue ----------- @@ -41,5 +41,3 @@ No I don't own a decent Mac device. To be more precisely, I have Mac Mini and MacBook Air, but they are too old (building Node.js and V8 would take many hours). Besides, there are both x86 and arm64 to be supported. I have no plan on buying 2 new Mac devices for supporting Javet only in the near future. If I could be well funded, I would consider supporting Mac. - -[`Home <../../README.rst>`_] [`FAQ `_] diff --git a/docs/faq/environment/index.html b/docs/faq/environment/index.html new file mode 100644 index 000000000..ce75d59d0 --- /dev/null +++ b/docs/faq/environment/index.html @@ -0,0 +1,336 @@ + + + + + + + + Environment - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+ +
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/faq/environment/index.rst b/docs/faq/environment/index.rst new file mode 100644 index 000000000..de6b5a214 --- /dev/null +++ b/docs/faq/environment/index.rst @@ -0,0 +1,9 @@ +=========== +Environment +=========== + +.. toctree:: + :maxdepth: 1 + + can_javet_support_mac + can_javet_support_legacy_linux diff --git a/docs/faq/index.html b/docs/faq/index.html new file mode 100644 index 000000000..f71e0427d --- /dev/null +++ b/docs/faq/index.html @@ -0,0 +1,355 @@ + + + + + + + + FAQ - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+ +
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/faq/index.rst b/docs/faq/index.rst index 331c2cb13..b6bc02345 100644 --- a/docs/faq/index.rst +++ b/docs/faq/index.rst @@ -2,28 +2,10 @@ FAQ === -Background -========== +.. toctree:: + :maxdepth: 2 -* `What is the Motivation? `_ -* `History with J2V8 `_ - -Environment -=========== - -* `Can Javet Support Mac? `_ -* `Can Javet Support Legacy Linux? `_ - -Development -=========== - -* `How to Think in Javet? `_ -* `Where are ES6 API in V8 Mode? `_ - -Troubleshooting -=============== - -* `A dynamic link library (DLL) initialization routine failed `_ -* `Can I Debug Javet in Chrome DevTools? `_ - -[`Home <../../README.rst>`_] + background/index + development/index + environment/index + troubleshooting/index diff --git a/docs/faq/troubleshooting/a_dynamic_link_library_dll_initialization_routine_failed.html b/docs/faq/troubleshooting/a_dynamic_link_library_dll_initialization_routine_failed.html new file mode 100644 index 000000000..6905a6ce1 --- /dev/null +++ b/docs/faq/troubleshooting/a_dynamic_link_library_dll_initialization_routine_failed.html @@ -0,0 +1,331 @@ + + + + + + + + A dynamic link library (DLL) initialization routine failed - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+ + +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/faq/a_dynamic_link_library_dll_initialization_routine_failed.rst b/docs/faq/troubleshooting/a_dynamic_link_library_dll_initialization_routine_failed.rst similarity index 66% rename from docs/faq/a_dynamic_link_library_dll_initialization_routine_failed.rst rename to docs/faq/troubleshooting/a_dynamic_link_library_dll_initialization_routine_failed.rst index d93988f20..e85bcab1f 100644 --- a/docs/faq/a_dynamic_link_library_dll_initialization_routine_failed.rst +++ b/docs/faq/troubleshooting/a_dynamic_link_library_dll_initialization_routine_failed.rst @@ -2,6 +2,4 @@ A dynamic link library (DLL) initialization routine failed ========================================================== -This failure happens when Javet Node.js mode tries to load a Node.js native module. The root cause is some ``NAPI`` symbols cannot be found on Windows. The fix is is available at `Modularization <../reference/modularization.rst>`_. - -[`Home <../../README.rst>`_] [`FAQ `_] +This failure happens when Javet Node.js mode tries to load a Node.js native module. The root cause is some ``NAPI`` symbols cannot be found on Windows. The fix is is available at :doc:`../../reference/modularization`. diff --git a/docs/faq/troubleshooting/can_i_debug_javet_in_chrome_dev_tools.html b/docs/faq/troubleshooting/can_i_debug_javet_in_chrome_dev_tools.html new file mode 100644 index 000000000..1b9fd54d8 --- /dev/null +++ b/docs/faq/troubleshooting/can_i_debug_javet_in_chrome_dev_tools.html @@ -0,0 +1,332 @@ + + + + + + + + Can I Debug Javet in Chrome DevTools? - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+ +
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/faq/troubleshooting/can_i_debug_javet_in_chrome_dev_tools.rst b/docs/faq/troubleshooting/can_i_debug_javet_in_chrome_dev_tools.rst new file mode 100644 index 000000000..9766a1223 --- /dev/null +++ b/docs/faq/troubleshooting/can_i_debug_javet_in_chrome_dev_tools.rst @@ -0,0 +1,8 @@ +===================================== +Can I Debug Javet in Chrome DevTools? +===================================== + +Yes, you can do that. Please visit :doc:`../../development/debug_with_chrome_developer_tools` for detail. + +.. image:: ../../resources/images/chome_developer_tools_devices_remote_target_javet.png + :alt: Remote Target Javet diff --git a/docs/faq/troubleshooting/index.html b/docs/faq/troubleshooting/index.html new file mode 100644 index 000000000..9537ce438 --- /dev/null +++ b/docs/faq/troubleshooting/index.html @@ -0,0 +1,337 @@ + + + + + + + + Troubleshooting - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+ +
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/faq/troubleshooting/index.rst b/docs/faq/troubleshooting/index.rst new file mode 100644 index 000000000..dd860e885 --- /dev/null +++ b/docs/faq/troubleshooting/index.rst @@ -0,0 +1,10 @@ +=============== +Troubleshooting +=============== + +.. toctree:: + :maxdepth: 1 + + a_dynamic_link_library_dll_initialization_routine_failed + can_i_debug_javet_in_chrome_dev_tools + why_node_js_crashes_when_being_closed diff --git a/docs/faq/troubleshooting/why_node_js_crashes_when_being_closed.html b/docs/faq/troubleshooting/why_node_js_crashes_when_being_closed.html new file mode 100644 index 000000000..6628239b6 --- /dev/null +++ b/docs/faq/troubleshooting/why_node_js_crashes_when_being_closed.html @@ -0,0 +1,395 @@ + + + + + + + + Why Node.js Crashes When being Closed? - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Why Node.js Crashes When being Closed?

+
+

Background

+

Some Javet users experience segfaults when using the Node.js mode. The segfaults occur when NodeRuntime is being closed. E.g. issue #20 and issue #82.

+
+
+

Root Cause

+

The root cause is Node.js event loop is activated when Node.js is exiting. Let's see how NodeRuntime.close() works behind the scenes.

+
    +

  1. Close all Node.js modules

    2. +

  2. Close all reference objects

    3. +

  3. Close all callback context objects

    4. +

  4. Close all V8 modules

    5. +

  5. Hand over the control to Node.js exiting process

    6. +
+

If the application registers interceptors, those interceptors will be closed at step 3. However, the corresponding JavaScript objects hasn't been recycled yet. So, at step 5, Node.js activates the event loop and async objects will get resolved or rejected. The callbacks land Javet which is not able to handle because the callback context objects are gone. That leads to memory corruption and segfaults.

+

Can Javet address that? Yes, but that implies hacking Node.js event loop. People choose Javet Node.js mode mostly because it is a genuine Node.js. So, no, Javet does not perform such hack.

+
+
+

Solution

+

Well, how to prevent that from happening? In fact, knowing how Javet works and following the Javet way, that won't happen.

+
+

Event unhandledRejection

+

Node.js provides a standard solution. Application can listen to event unhandledRejection to prevent that event from hitting Javet so that the segfaults will not take place.

+
import process from 'process';
+process.on('unhandledRejection', (reason, promise) => {
+  // Do whatever you want to do
+});
+
+
+
+
+

NodeRuntime.await()

+

Application may call NodeRuntime.await() before closing the NodeRuntime. This call explicitly tells NodeRuntime to activate the event loop.

+
+
+

NodeRuntime.lowMemoryNotification()

+

Application may call NodeRuntime.lowMemoryNotification() before closing the NodeRuntime. This call forces NodeRuntime to perform garbage collection. During the garbage collection, the callbacks can be safely handled by Javet without segfaults.

+
+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/faq/troubleshooting/why_node_js_crashes_when_being_closed.rst b/docs/faq/troubleshooting/why_node_js_crashes_when_being_closed.rst new file mode 100644 index 000000000..491927ce8 --- /dev/null +++ b/docs/faq/troubleshooting/why_node_js_crashes_when_being_closed.rst @@ -0,0 +1,50 @@ +====================================== +Why Node.js Crashes When being Closed? +====================================== + +Background +========== + +Some Javet users experience segfaults when using the Node.js mode. The segfaults occur when ``NodeRuntime`` is being closed. E.g. `issue #20 `_ and `issue #82 `_. + +Root Cause +========== + +The root cause is Node.js event loop is activated when Node.js is exiting. Let's see how ``NodeRuntime.close()`` works behind the scenes. + +1. Close all Node.js modules +2. Close all reference objects +3. Close all callback context objects +4. Close all V8 modules +5. Hand over the control to Node.js exiting process + +If the application registers interceptors, those interceptors will be closed at step 3. However, the corresponding JavaScript objects hasn't been recycled yet. So, at step 5, Node.js activates the event loop and async objects will get resolved or rejected. The callbacks land Javet which is not able to handle because the callback context objects are gone. That leads to memory corruption and segfaults. + +Can Javet address that? Yes, but that implies hacking Node.js event loop. People choose Javet Node.js mode mostly because it is a genuine Node.js. So, no, Javet does not perform such hack. + +Solution +======== + +Well, how to prevent that from happening? In fact, knowing how Javet works and following the Javet way, that won't happen. + +Event unhandledRejection +------------------------ + +Node.js provides a standard `solution `_. Application can listen to event ``unhandledRejection`` to prevent that event from hitting Javet so that the segfaults will not take place. + +.. code-block:: javascript + + import process from 'process'; + process.on('unhandledRejection', (reason, promise) => { + // Do whatever you want to do + }); + +NodeRuntime.await() +------------------- + +Application may call ``NodeRuntime.await()`` before closing the ``NodeRuntime``. This call explicitly tells ``NodeRuntime`` to activate the event loop. + +NodeRuntime.lowMemoryNotification() +----------------------------------- + +Application may call ``NodeRuntime.lowMemoryNotification()`` before closing the ``NodeRuntime``. This call forces ``NodeRuntime`` to perform garbage collection. During the garbage collection, the callbacks can be safely handled by Javet without segfaults. diff --git a/docs/genindex.html b/docs/genindex.html new file mode 100644 index 000000000..5caeb5d1c --- /dev/null +++ b/docs/genindex.html @@ -0,0 +1,309 @@ + + + + + + + Index - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+ +
+

Index

+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/index.html b/docs/index.html index 355a811c3..f4dc23331 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,98 +1,480 @@ - - - - - - + + + + + - - - - Javet - An awesome way of embedding Node.js and V8 in Java - - - + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + - .container { - height: 100%; - padding: 0; - margin: 0; - display: -webkit-box; - display: -moz-box; - display: -ms-flexbox; - display: -webkit-flex; - display: flex; - align-items: center; - justify-content: center; - } + + + + - .row { - width: auto; - } - .title, - .subtitle, - .author, - .twitter { - width: 70%; - min-width: 700px; - text-align: left; - } - .title { - font-size: 3em; - font-weight: bold; - line-height: 200%; - } +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Javet

+

Maven Central Discord Donate Linux Build

+

Javet is Java + V8 (JAVa + V + EighT). It is an awesome way of embedding Node.js and V8 in Java.

+

If you like my work, please Star this project. And, you may follow me @sjtucaocao, or visit http://caoccao.blogspot.com/. And the official support channel is at discord.

+

💖 If you use Mac OS (x86_64), please be aware that the Mac OS (x86_64) build will discontinue anytime because my MacBook Air mid-2012 will be soon deprecated by new version of V8. Please donate to support me purchasing a new Mac OS (x86_64) device. Or, if you have a retired Mac OS (x86_64) device and are fine with mailing it to me, that will also be great. Thank you for supporting Javet.

+

💖 If you use Mac OS (arm64), unfortunately there is no Mac OS (arm64) build because I don't have any Mac OS (arm64) device. Please donate to support me purchasing a new Mac OS (arm64) device.

+
+
+

Major Features

+
    +

  • Linux + Mac OS + ️Windows (x86_64)

    • +

  • Node.js v14.17.6 + V8 v9.3.345.16

    • +

  • Dynamic switch between Node.js and V8 mode

    • +

  • Polyfill V8 mode with Javenode

    • +

  • Exposure of the majority of V8 API in JVM

    • +

  • JavaScript and Java interop

    • +

  • Native BigInt and Date

    • +

  • Javet engine pool

    • +

  • Easy spring integration

    • +

  • Live debug with Chrome DevTools

    • +
+
+
+

Quick Start

+
+

Dependency

+
+

Maven

+
<!-- Linux or Windows -->
+<dependency>
+    <groupId>com.caoccao.javet</groupId>
+    <artifactId>javet</artifactId>
+    <version>0.9.12</version>
+</dependency>
 
-        .author {
-            margin-top: 10%;
-        }
+<!-- Mac OS (x86_64 Only) -->
+<dependency>
+    <groupId>com.caoccao.javet</groupId>
+    <artifactId>javet-macos</artifactId>
+    <version>0.9.12</version>
+</dependency>
+
+
+
+
+

Gradle Kotlin DSL

+
implementation("com.caoccao.javet:javet:0.9.12") // Linux or Windows
+implementation("com.caoccao.javet:javet-macos:0.9.12") // Mac OS (x86_64 Only)
+
+
+
+
+

Gradle Groovy DSL

+
implementation 'com.caoccao.javet:javet:0.9.12' // Linux or Windows
+implementation 'com.caoccao.javet:javet-macos:0.9.12' // Mac OS (x86_64 Only)
+
+
+
+
+
+

Hello Javet

+
// Node.js Mode
+try (V8Runtime v8Runtime = V8Host.getNodeInstance().createV8Runtime()) {
+    System.out.println(v8Runtime.getExecutor("'Hello Javet'").executeString());
+}
 
-        .author,
-        .twitter {
-            font-size: 1.2em;
-            line-height: 150%;
-        }
-    
-
+// V8 Mode
+try (V8Runtime v8Runtime = V8Host.getV8Instance().createV8Runtime()) {
+    System.out.println(v8Runtime.getExecutor("'Hello Javet'").executeString());
+}
+
+
+
+
+ + - - +
+
+
- + +
+
+ + + + + + \ No newline at end of file diff --git a/docs/index.rst b/docs/index.rst new file mode 100644 index 000000000..0f481303e --- /dev/null +++ b/docs/index.rst @@ -0,0 +1,10 @@ +.. include:: ../README.rst + +.. toctree:: + :maxdepth: 2 + + tutorial/index + reference/index + release_notes/index + faq/index + development/index diff --git a/docs/make.bat b/docs/make.bat new file mode 100644 index 000000000..2119f5109 --- /dev/null +++ b/docs/make.bat @@ -0,0 +1,35 @@ +@ECHO OFF + +pushd %~dp0 + +REM Command file for Sphinx documentation + +if "%SPHINXBUILD%" == "" ( + set SPHINXBUILD=sphinx-build +) +set SOURCEDIR=. +set BUILDDIR=_build + +if "%1" == "" goto help + +%SPHINXBUILD% >NUL 2>NUL +if errorlevel 9009 ( + echo. + echo.The 'sphinx-build' command was not found. Make sure you have Sphinx + echo.installed, then set the SPHINXBUILD environment variable to point + echo.to the full path of the 'sphinx-build' executable. Alternatively you + echo.may add the Sphinx directory to PATH. + echo. + echo.If you don't have Sphinx installed, grab it from + echo.http://sphinx-doc.org/ + exit /b 1 +) + +%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% +goto end + +:help +%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% + +:end +popd diff --git a/docs/publish.cmd b/docs/publish.cmd new file mode 100644 index 000000000..15857fd3d --- /dev/null +++ b/docs/publish.cmd @@ -0,0 +1,5 @@ +robocopy _build\html\_images _images /mir /nfl /ndl /njh /njs /nc /ns /np +robocopy _build\html\_sources _sources /mir /nfl /ndl /njh /njs /nc /ns /np +robocopy _build\html\_static _static /mir /nfl /ndl /njh /njs /nc /ns /np +robocopy ..\build\docs\javadoc reference\javadoc /mir /xf index.rst /nfl /ndl /njh /njs /nc /ns /np +robocopy _build\html .\ /e /xd _sources /xd _images /xd _static /xd javadoc /xf .buildinfo /xf objects.inv /nfl /ndl /njh /njs /nc /ns /np \ No newline at end of file diff --git a/docs/reference/best_practices.html b/docs/reference/best_practices.html new file mode 100644 index 000000000..891698f1f --- /dev/null +++ b/docs/reference/best_practices.html @@ -0,0 +1,405 @@ + + + + + + + + Best Practices - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Best Practices

+
+

Thread, Engine and Pool

+
    +

  • Always get 1 Javet engine from the pool in 1 thread.

    • +

  • If multiple context is required in 1 thread, there are 2 options.

    +
    +
      +

    • Call resetContext() between context switch.

      • +

    • Obtain multiple V8Runtime instances.

      • +
    +
    +
    • +

  • Do not pass Javet engine to other threads.

    • +

  • Always return Javet engine to pool in the end via try-with-resource or calling close() explicitly.

    • +

  • Subclass Javet engine pool and Javet engine to complete your customization. Indeed, they are open to full customization.

    • +
+
+
+

Resource Management

+
    +

  • Dangling V8 objects will be forced to be recycled by Javet under the following scenarios and corresponding log will reflect that. Keeping an eye on the log helps address memory leak issues in the early stage.

    +
    +
      +

    • Engine is closed.

      • +

    • Pool is closed.

      • +

    • Context is reset.

      • +

    • Isolate is reset.

      • +
    +
    +
    • +

  • Always apply try-with-resource to Javet objects regardless of primitive or reference if they are not returned to Javet.

    • +

  • Always prohibit calling close() of Javet objects if they will be returned to Javet.

    • +

  • If the lifecycle of V8 objects is uncertain, calling setWeak() is the only way so that calling close() is no longer required. Be careful, calling close() after calling setWeak() may lead to V8 core dump immediately.

    • +

  • In performance sensitive scenarios, please explicitly acquire V8Locker.

    • +
+
+
+

Security

+
    +

  • Malicious scripts are recommended to be executed in V8 mode or in vm module in Node.js mode.

    • +

  • eval can be disabled in Javet.

    • +

  • V8 0-day vulnerable issues most likely impact Node.js because the embedded V8 in Node.js is very old. It's recommended to use the V8 mode to minimize the risk.

    • +
+
+
+

Node.js

+
    +

  • Modularize the code as much as possible so that performance is maximized.

    • +

  • Always register unhandled rejection event.

    • +

  • In non-module mode (similar to V8 in web browser), always put launch script in a dedicated folder whose parent folder contains node_modules and avoid require modules in the same folder.

    • +

  • In module mode (similar to V8 in Node.js), be aware that the execution result is a promise and the behavior is different from native Node.js runtime behavior unless await() is called.

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/reference/best_practices.rst b/docs/reference/best_practices.rst index 4723c9f44..1d5377f8b 100644 --- a/docs/reference/best_practices.rst +++ b/docs/reference/best_practices.rst @@ -44,5 +44,3 @@ Node.js * Always register unhandled rejection event. * In **non-module** mode (similar to V8 in web browser), always put launch script in a dedicated folder whose parent folder contains ``node_modules`` and avoid ``require`` modules in the same folder. * In **module** mode (similar to V8 in Node.js), be aware that the execution result is a promise and the behavior is different from native Node.js runtime behavior unless ``await()`` is called. - -[`Home <../../README.rst>`_] [`Javet Reference `_] diff --git a/docs/reference/error_codes.html b/docs/reference/error_codes.html new file mode 100644 index 000000000..f2a600d9b --- /dev/null +++ b/docs/reference/error_codes.html @@ -0,0 +1,525 @@ + + + + + + + + Error Codes - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Error Codes

+
+

Why Error Codes?

+

Because Javet doesn't want to support i18n though both Node.js and V8 support i18n.

+
    +

  • The final binary size will significantly increase with i18n.

    • +

  • There is no development resource for i18n.

    • +
+
+
+

Backward Compatibility

+

Once the error codes are released, they are likely not changed any more for backward compatibility.

+

The following error codes are generated automatically from the source code.

+
++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Code

Type

Name

Format

101

System

OSNotSupported

OS ${OS} is not supported

102

System

LibraryNotFound

Javet library ${path} is not found

103

System

LibraryNotLoaded

Javet library is not loaded because ${reason}

104

System

NotSupported

${feature} is not supported

105

System

FailedToReadPath

Failed to read ${path}

201

Compilation

CompilationFailure

${message}

301

Execution

ExecutionFailure

${message}

302

Execution

ExecutionTerminated

Execution is terminated and continuable is ${continuable}

401

Callback

CallbackSignatureParameterSizeMismatch

Callback signature mismatches: method name is ${methodName}, expected parameter size is ${expectedParameterSize}, actual parameter size is ${actualParameterSize}

402

Callback

CallbackSignatureParameterTypeMismatch

Callback signature mismatches: expected parameter type is ${expectedParameterType}, actual parameter type is ${actualParameterType}

403

Callback

CallbackInjectionFailure

Failed to inject runtime with error message ${message}

404

Callback

CallbackRegistrationFailure

Callback ${methodName} registration failed with error message ${message}

405

Callback

CallbackMethodFailure

Callback ${methodName} failed with error message ${message}

406

Callback

CallbackUnknownFailure

Callback failed with unknown error message ${message}

407

Callback

CallbackUnregistrationFailure

Callback ${methodName} unregistration failed with error message ${message}

501

Converter

ConverterFailure

Failed to convert values with error message ${message}

502

Converter

ConverterCircularStructure

Circular structure is detected with max depth ${maxDepth} reached

503

Converter

ConverterSymbolNotBuiltIn

${symbol} is not a built-in symbol

601

Module

ModuleNameEmpty

Module name is empty

602

Module

ModuleNotFound

Module ${moduleName} is not found

603

Module

ModulePermissionDenied

Denied access to module ${moduleName}

701

Lock

LockAcquisitionFailure

Failed to acquire the lock

702

Lock

LockReleaseFailure

Failed to release the lock

703

Lock

LockConflictThreadIdMismatch

Runtime lock conflict is detected with locked thread ID ${lockedThreadID} and current thread ID ${currentThreadID}

801

Runtime

RuntimeAlreadyClosed

Runtime is already closed

802

Runtime

RuntimeAlreadyRegistered

Runtime is already registered

803

Runtime

RuntimeNotRegistered

Runtime is not registered

804

Runtime

RuntimeLeakageDetected

${count} runtime(s) leakage is detected

805

Runtime

RuntimeCloseFailure

Failed to close the runtime with error message ${message}

+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/reference/error_codes.rst b/docs/reference/error_codes.rst index e2ecc84ad..ef61d1798 100644 --- a/docs/reference/error_codes.rst +++ b/docs/reference/error_codes.rst @@ -15,7 +15,7 @@ Backward Compatibility Once the error codes are released, they are likely not changed any more for backward compatibility. -The following error codes are generated automatically from `source code <../../src/main/java/com/caoccao/javet/exceptions/JavetError.java>`_. +The following error codes are generated automatically from the :extsource2:`source code <../../src/main/java/com/caoccao/javet/exceptions/JavetError.java>`. .. Error Codes Begin @@ -40,6 +40,7 @@ Code Type Name Format 407 Callback CallbackUnregistrationFailure Callback ${methodName} unregistration failed with error message ${message} 501 Converter ConverterFailure Failed to convert values with error message ${message} 502 Converter ConverterCircularStructure Circular structure is detected with max depth ${maxDepth} reached +503 Converter ConverterSymbolNotBuiltIn ${symbol} is not a built-in symbol 601 Module ModuleNameEmpty Module name is empty 602 Module ModuleNotFound Module ${moduleName} is not found 603 Module ModulePermissionDenied Denied access to module ${moduleName} @@ -56,5 +57,3 @@ Code Type Name Format .. Error Codes End - -[`Home <../../README.rst>`_] [`Javet Reference `_] diff --git a/docs/reference/index.html b/docs/reference/index.html new file mode 100644 index 000000000..7d4abe617 --- /dev/null +++ b/docs/reference/index.html @@ -0,0 +1,348 @@ + + + + + + + + Reference - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+ +
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/reference/index.rst b/docs/reference/index.rst index d1661f93f..ef03781b2 100644 --- a/docs/reference/index.rst +++ b/docs/reference/index.rst @@ -1,18 +1,21 @@ -=============== -Javet Reference -=============== +========= +Reference +========= -* `V8 Collection `_ -* `V8 Function `_ -* `V8 Promise `_ -* `Modularization `_ -* `Memory Management `_ -* `Lock `_ -* `Termination `_ -* `Logging `_ -* `Load and Unload `_ -* `Best Practices `_ -* `Performance `_ -* `Error Codes `_ +.. toctree:: + :maxdepth: 1 -[`Home <../../README.rst>`_] + javadoc/index + v8_collection + v8_function + v8_promise + modularization + memory_management + lock + termination + logging + load_and_unload + best_practices + performance + error_codes + todo_list diff --git a/docs/reference/javadoc/allclasses-frame.html b/docs/reference/javadoc/allclasses-frame.html new file mode 100644 index 000000000..41e443814 --- /dev/null +++ b/docs/reference/javadoc/allclasses-frame.html @@ -0,0 +1,174 @@ + + + + + +All Classes (javet 0.9.12 API) + + + + +

All Classes

+
+ +
+ + diff --git a/docs/reference/javadoc/allclasses-noframe.html b/docs/reference/javadoc/allclasses-noframe.html new file mode 100644 index 000000000..c699d4158 --- /dev/null +++ b/docs/reference/javadoc/allclasses-noframe.html @@ -0,0 +1,174 @@ + + + + + +All Classes (javet 0.9.12 API) + + + + +

All Classes

+
+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/annotations/CheckReturnValue.html b/docs/reference/javadoc/com/caoccao/javet/annotations/CheckReturnValue.html new file mode 100644 index 000000000..279c22b88 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/annotations/CheckReturnValue.html @@ -0,0 +1,169 @@ + + + + + +CheckReturnValue (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Field | 
    • +
  • Required | 
    • +
  • Optional
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Element
    • +
+
+ + +
+ + +
+
com.caoccao.javet.annotations
+

Annotation Type CheckReturnValue

+
+
+
+
    +
  • +
    +
    +
    @Documented
+ @Target(value={METHOD,CONSTRUCTOR,TYPE,PACKAGE})
+ @Retention(value=SOURCE)
+public @interface CheckReturnValue
    +
    This annotation is for IDE to warn application developers to consume the return value. + Memory leak may occur if the return value is not consumed.
    +
    +
    Since:
    +
    0.8.10
    +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Field | 
    • +
  • Required | 
    • +
  • Optional
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Element
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/annotations/NodeModule.html b/docs/reference/javadoc/com/caoccao/javet/annotations/NodeModule.html new file mode 100644 index 000000000..21ace0ccf --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/annotations/NodeModule.html @@ -0,0 +1,229 @@ + + + + + +NodeModule (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Field | 
    • +
  • Required | 
    • +
  • Optional
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.annotations
+

Annotation Type NodeModule

+
+
+
+
    +
  • +
    +
    +
    @Documented
+ @Target(value=TYPE)
+ @Retention(value=RUNTIME)
+public @interface NodeModule
    +
    The annotation Node module.
    +
    +
    Since:
    +
    0.8.1
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Optional Element Summary

      + + + + + + + + + + +
      Optional Elements 
      Modifier and TypeOptional Element and Description
      java.lang.Stringname +
      Name string.
      +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Element Detail

      + + + +
        +
      • +

        name

        +
        public abstract java.lang.String name
        +
        Name string.
        +
        +
        Returns:
        +
        the string
        +
        Since:
        +
        0.8.1
        +
        +
        +
        Default:
        +
        ""
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Field | 
    • +
  • Required | 
    • +
  • Optional
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/annotations/V8BindEnabler.html b/docs/reference/javadoc/com/caoccao/javet/annotations/V8BindEnabler.html new file mode 100644 index 000000000..cef36fd16 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/annotations/V8BindEnabler.html @@ -0,0 +1,168 @@ + + + + + +V8BindEnabler (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Field | 
    • +
  • Required | 
    • +
  • Optional
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Element
    • +
+
+ + +
+ + +
+
com.caoccao.javet.annotations
+

Annotation Type V8BindEnabler

+
+
+
+
    +
  • +
    +
    +
    @Documented
+ @Target(value=METHOD)
+ @Retention(value=RUNTIME)
+public @interface V8BindEnabler
    +
    The interface V8 bind config is for determining whether certain injection is enabled or not.
    +
    +
    Since:
    +
    0.9.3
    +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Field | 
    • +
  • Required | 
    • +
  • Optional
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Element
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/annotations/V8Function.html b/docs/reference/javadoc/com/caoccao/javet/annotations/V8Function.html new file mode 100644 index 000000000..1b6434e29 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/annotations/V8Function.html @@ -0,0 +1,258 @@ + + + + + +V8Function (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Field | 
    • +
  • Required | 
    • +
  • Optional
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.annotations
+

Annotation Type V8Function

+
+
+
+
    +
  • +
    +
    +
    @Documented
+ @Target(value=METHOD)
+ @Retention(value=RUNTIME)
+public @interface V8Function
    +
    The annotation V8 function is for auto-registering JS function interception.
    +
    +
    Since:
    +
    0.8.1
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Optional Element Summary

      + + + + + + + + + + + + + + +
      Optional Elements 
      Modifier and TypeOptional Element and Description
      java.lang.Stringname +
      JS function name.
      +
      booleanthisObjectRequired +
      This object required.
      +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Element Detail

      + + + +
        +
      • +

        name

        +
        public abstract java.lang.String name
        +
        JS function name.
        +
        +
        Returns:
        +
        the name of the JS function to be injected
        +
        Since:
        +
        0.8.1
        +
        +
        +
        Default:
        +
        ""
        +
        +
        • +
      +
      • +
    +
      +
    • + + +
        +
      • +

        thisObjectRequired

        +
        public abstract boolean thisObjectRequired
        +
        This object required.
        +
        +
        Returns:
        +
        true: this object is required, false: this object is ignored
        +
        Since:
        +
        0.9.0
        +
        +
        +
        Default:
        +
        false
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Field | 
    • +
  • Required | 
    • +
  • Optional
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/annotations/V8Property.html b/docs/reference/javadoc/com/caoccao/javet/annotations/V8Property.html new file mode 100644 index 000000000..4719a83e9 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/annotations/V8Property.html @@ -0,0 +1,287 @@ + + + + + +V8Property (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Field | 
    • +
  • Required | 
    • +
  • Optional
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.annotations
+

Annotation Type V8Property

+
+
+
+
    +
  • +
    +
    +
    @Documented
+ @Target(value=METHOD)
+ @Retention(value=RUNTIME)
+public @interface V8Property
    +
    The interface V8 property is for auto-registering JS property interception.
    +
    +
    Since:
    +
    0.9.0
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Optional Element Summary

      + + + + + + + + + + + + + + + + + + +
      Optional Elements 
      Modifier and TypeOptional Element and Description
      java.lang.Stringname +
      JS property name.
      +
      V8ValueSymbolTypesymbolType +
      Symbol V8 value symbol type.
      +
      booleanthisObjectRequired +
      This object required.
      +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Element Detail

      + + + +
        +
      • +

        name

        +
        public abstract java.lang.String name
        +
        JS property name.
        +
        +
        Returns:
        +
        the name of the JS property to be injected
        +
        Since:
        +
        0.9.0
        +
        +
        +
        Default:
        +
        ""
        +
        +
        • +
      +
      • +
    +
      +
    • + + +
        +
      • +

        symbolType

        +
        public abstract V8ValueSymbolType symbolType
        +
        Symbol V8 value symbol type.
        +
        +
        Returns:
        +
        the V8 value symbol type
        +
        Since:
        +
        0.9.11
        +
        +
        +
        Default:
        +
        com.caoccao.javet.enums.V8ValueSymbolType.None
        +
        +
        • +
      +
      • +
    +
      +
    • + + +
        +
      • +

        thisObjectRequired

        +
        public abstract boolean thisObjectRequired
        +
        This object required.
        +
        +
        Returns:
        +
        true : this object is required, false: this object is ignored
        +
        Since:
        +
        0.9.0
        +
        +
        +
        Default:
        +
        false
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Field | 
    • +
  • Required | 
    • +
  • Optional
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/annotations/V8RuntimeSetter.html b/docs/reference/javadoc/com/caoccao/javet/annotations/V8RuntimeSetter.html new file mode 100644 index 000000000..929761e00 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/annotations/V8RuntimeSetter.html @@ -0,0 +1,168 @@ + + + + + +V8RuntimeSetter (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Field | 
    • +
  • Required | 
    • +
  • Optional
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Element
    • +
+
+ + +
+ + +
+
com.caoccao.javet.annotations
+

Annotation Type V8RuntimeSetter

+
+
+
+
    +
  • +
    +
    +
    @Documented
+ @Target(value=METHOD)
+ @Retention(value=RUNTIME)
+public @interface V8RuntimeSetter
    +
    The interface V8 runtime setter.
    +
    +
    Since:
    +
    0.8.1
    +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Field | 
    • +
  • Required | 
    • +
  • Optional
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Element
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/annotations/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/annotations/package-frame.html new file mode 100644 index 000000000..bb9269392 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/annotations/package-frame.html @@ -0,0 +1,24 @@ + + + + + +com.caoccao.javet.annotations (javet 0.9.12 API) + + + + +

com.caoccao.javet.annotations

+
+

Annotation Types

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/annotations/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/annotations/package-summary.html new file mode 100644 index 000000000..fca54d0b4 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/annotations/package-summary.html @@ -0,0 +1,184 @@ + + + + + +com.caoccao.javet.annotations (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.annotations

+
+
Annotations classes for declarative coding and IDE intellisense.
+
+

See: Description

+
+
+
    +
  • + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Annotation Types Summary 
    Annotation TypeDescription
    CheckReturnValue +
    This annotation is for IDE to warn application developers to consume the return value.
    +
    NodeModule +
    The annotation Node module.
    +
    V8BindEnabler +
    The interface V8 bind config is for determining whether certain injection is enabled or not.
    +
    V8Function +
    The annotation V8 function is for auto-registering JS function interception.
    +
    V8Property +
    The interface V8 property is for auto-registering JS property interception.
    +
    V8RuntimeSetter +
    The interface V8 runtime setter.
    +
    +
    • +
+ + + +

Package com.caoccao.javet.annotations Description

+
Annotations classes for declarative coding and IDE intellisense.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/annotations/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/annotations/package-tree.html new file mode 100644 index 000000000..3c3da7bd9 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/annotations/package-tree.html @@ -0,0 +1,135 @@ + + + + + +com.caoccao.javet.annotations Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.annotations

+Package Hierarchies: + +
+
+

Annotation Type Hierarchy

+
    +
  • com.caoccao.javet.annotations.V8Property (implements java.lang.annotation.Annotation)
    • +
  • com.caoccao.javet.annotations.V8RuntimeSetter (implements java.lang.annotation.Annotation)
    • +
  • com.caoccao.javet.annotations.CheckReturnValue (implements java.lang.annotation.Annotation)
    • +
  • com.caoccao.javet.annotations.V8BindEnabler (implements java.lang.annotation.Annotation)
    • +
  • com.caoccao.javet.annotations.NodeModule (implements java.lang.annotation.Annotation)
    • +
  • com.caoccao.javet.annotations.V8Function (implements java.lang.annotation.Annotation)
    • +
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/entities/JavetEntityFunction.html b/docs/reference/javadoc/com/caoccao/javet/entities/JavetEntityFunction.html new file mode 100644 index 000000000..eee754dfe --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/entities/JavetEntityFunction.html @@ -0,0 +1,449 @@ + + + + + +JavetEntityFunction (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.entities
+

Class JavetEntityFunction

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.entities.JavetEntityFunction
      • +
    +
    • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    IJavetEntityFunction
    +
    +
    +
    +
    public class JavetEntityFunction
+extends java.lang.Object
+implements IJavetEntityFunction
    +
    The type Javet entity function is for converting JS function + to or from Java object.
    +
    +
    Since:
    +
    0.9.4
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Summary

      + + + + + + + + + + + + + + +
      Fields 
      Modifier and TypeField and Description
      protected JSFunctionTypejsFunctionType +
      The JS function type.
      +
      protected java.lang.StringsourceCode +
      The Source code.
      +
      +
      • +
    + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + + + + +
      Constructors 
      Constructor and Description
      JavetEntityFunction() +
      Instantiates a new Javet entity function.
      +
      JavetEntityFunction(java.lang.String sourceCode) +
      Instantiates a new Javet entity function.
      +
      +
      • +
    + + +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        jsFunctionType

        +
        protected JSFunctionType jsFunctionType
        +
        The JS function type.
        +
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        sourceCode

        +
        protected java.lang.String sourceCode
        +
        The Source code.
        +
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetEntityFunction

        +
        public JavetEntityFunction()
        +
        Instantiates a new Javet entity function.
        +
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        JavetEntityFunction

        +
        public JavetEntityFunction(java.lang.String sourceCode)
        +
        Instantiates a new Javet entity function.
        +
        +
        Parameters:
        +
        sourceCode - the source code
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      +
      • +
    + + +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/entities/JavetEntityMap.html b/docs/reference/javadoc/com/caoccao/javet/entities/JavetEntityMap.html new file mode 100644 index 000000000..29e681472 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/entities/JavetEntityMap.html @@ -0,0 +1,411 @@ + + + + + +JavetEntityMap (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.entities
+

Class JavetEntityMap

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • java.util.AbstractMap<K,V>
      • +
    • +
        +
      • java.util.HashMap<java.lang.String,java.lang.Object>
        • +
      • +
          +
        • com.caoccao.javet.entities.JavetEntityMap
          • +
        +
        • +
      +
      • +
    +
    • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    IJavetEntityMap, java.io.Serializable, java.lang.Cloneable, java.util.Map<java.lang.String,java.lang.Object>
    +
    +
    +
    +
    public class JavetEntityMap
+extends java.util.HashMap<java.lang.String,java.lang.Object>
+implements IJavetEntityMap
    +
    The type Javet entity map is for converting JS map + to or from Java map.
    +
    +
    Since:
    +
    0.7.2
    +
    See Also:
    +
    Serialized Form
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Nested Class Summary

      +
        +
      • + + +

        Nested classes/interfaces inherited from class java.util.AbstractMap

        +java.util.AbstractMap.SimpleEntry<K,V>, java.util.AbstractMap.SimpleImmutableEntry<K,V>
        • +
      +
        +
      • + + +

        Nested classes/interfaces inherited from interface java.util.Map

        +java.util.Map.Entry<K,V>
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + + + + + + + + + + +
      Constructors 
      Constructor and Description
      JavetEntityMap() +
      Instantiates a new Javet entity map.
      +
      JavetEntityMap(int initialCapacity) +
      Instantiates a new Javet entity map.
      +
      JavetEntityMap(int initialCapacity, + float loadFactor) +
      Instantiates a new Javet entity map.
      +
      JavetEntityMap(java.util.Map<? extends java.lang.String,?> m) +
      Instantiates a new Javet entity map.
      +
      +
      • +
    + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + +
      All Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      java.lang.Objectclone() 
      +
        +
      • + + +

        Methods inherited from class java.util.HashMap

        +clear, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, forEach, get, getOrDefault, isEmpty, keySet, merge, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values
        • +
      +
        +
      • + + +

        Methods inherited from class java.util.AbstractMap

        +equals, hashCode, toString
        • +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +finalize, getClass, notify, notifyAll, wait, wait, wait
        • +
      +
        +
      • + + +

        Methods inherited from interface java.util.Map

        +clear, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, equals, forEach, get, getOrDefault, hashCode, isEmpty, keySet, merge, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetEntityMap

        +
        public JavetEntityMap(int initialCapacity,
+                      float loadFactor)
        +
        Instantiates a new Javet entity map.
        +
        +
        Parameters:
        +
        initialCapacity - the initial capacity
        +
        loadFactor - the load factor
        +
        Since:
        +
        0.7.2
        +
        +
        • +
      + + + +
        +
      • +

        JavetEntityMap

        +
        public JavetEntityMap(int initialCapacity)
        +
        Instantiates a new Javet entity map.
        +
        +
        Parameters:
        +
        initialCapacity - the initial capacity
        +
        Since:
        +
        0.7.2
        +
        +
        • +
      + + + +
        +
      • +

        JavetEntityMap

        +
        public JavetEntityMap()
        +
        Instantiates a new Javet entity map.
        +
        +
        Since:
        +
        0.7.2
        +
        +
        • +
      + + + +
        +
      • +

        JavetEntityMap

        +
        public JavetEntityMap(java.util.Map<? extends java.lang.String,?> m)
        +
        Instantiates a new Javet entity map.
        +
        +
        Parameters:
        +
        m - the m
        +
        Since:
        +
        0.7.2
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        clone

        +
        public java.lang.Object clone()
        +
        +
        Overrides:
        +
        clone in class java.util.HashMap<java.lang.String,java.lang.Object>
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/entities/JavetEntitySymbol.html b/docs/reference/javadoc/com/caoccao/javet/entities/JavetEntitySymbol.html new file mode 100644 index 000000000..4e8d5c08c --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/entities/JavetEntitySymbol.html @@ -0,0 +1,335 @@ + + + + + +JavetEntitySymbol (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.entities
+

Class JavetEntitySymbol

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.entities.JavetEntitySymbol
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public class JavetEntitySymbol
+extends java.lang.Object
    +
    The type Javet entity symbol is for converting JS symbol + to or from Java symbol.
    +
    +
    Since:
    +
    0.9.11
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Summary

      + + + + + + + + + + +
      Fields 
      Modifier and TypeField and Description
      protected java.lang.Stringdescription +
      The Description.
      +
      +
      • +
    + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + +
      Constructors 
      Constructor and Description
      JavetEntitySymbol(java.lang.String description) +
      Instantiates a new Javet entity symbol.
      +
      +
      • +
    + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + +
      All Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      java.lang.StringgetDescription() +
      Gets description.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        description

        +
        protected java.lang.String description
        +
        The Description.
        +
        +
        Since:
        +
        0.9.11
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetEntitySymbol

        +
        public JavetEntitySymbol(java.lang.String description)
        +
        Instantiates a new Javet entity symbol.
        +
        +
        Parameters:
        +
        description - the description
        +
        Since:
        +
        0.9.11
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getDescription

        +
        public java.lang.String getDescription()
        +
        Gets description.
        +
        +
        Returns:
        +
        the description
        +
        Since:
        +
        0.9.11
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/entities/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/entities/package-frame.html new file mode 100644 index 000000000..d8e469a1f --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/entities/package-frame.html @@ -0,0 +1,21 @@ + + + + + +com.caoccao.javet.entities (javet 0.9.12 API) + + + + +

com.caoccao.javet.entities

+
+

Classes

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/entities/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/entities/package-summary.html new file mode 100644 index 000000000..1c561f43f --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/entities/package-summary.html @@ -0,0 +1,169 @@ + + + + + +com.caoccao.javet.entities (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.entities

+
+
Built-in entities for default object conversion.
+
+

See: Description

+
+
+
    +
  • + + + + + + + + + + + + + + + + + + + + +
    Class Summary 
    ClassDescription
    JavetEntityFunction +
    The type Javet entity function is for converting JS function + to or from Java object.
    +
    JavetEntityMap +
    The type Javet entity map is for converting JS map + to or from Java map.
    +
    JavetEntitySymbol +
    The type Javet entity symbol is for converting JS symbol + to or from Java symbol.
    +
    +
    • +
+ + + +

Package com.caoccao.javet.entities Description

+
Built-in entities for default object conversion.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/entities/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/entities/package-tree.html new file mode 100644 index 000000000..be2c8e8df --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/entities/package-tree.html @@ -0,0 +1,144 @@ + + + + + +com.caoccao.javet.entities Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.entities

+Package Hierarchies: + +
+
+

Class Hierarchy

+
    +
  • java.lang.Object +
      +
    • java.util.AbstractMap<K,V> (implements java.util.Map<K,V>) +
        +
      • java.util.HashMap<K,V> (implements java.lang.Cloneable, java.util.Map<K,V>, java.io.Serializable) + +
        • +
      +
      • +
    • com.caoccao.javet.entities.JavetEntityFunction (implements com.caoccao.javet.interfaces.IJavetEntityFunction)
      • +
    • com.caoccao.javet.entities.JavetEntitySymbol
      • +
    +
    • +
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/enums/JSFunctionType.html b/docs/reference/javadoc/com/caoccao/javet/enums/JSFunctionType.html new file mode 100644 index 000000000..e2c1d8d1a --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/enums/JSFunctionType.html @@ -0,0 +1,440 @@ + + + + + +JSFunctionType (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.enums
+

Enum JSFunctionType

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • java.lang.Enum<JSFunctionType>
      • +
    • +
        +
      • com.caoccao.javet.enums.JSFunctionType
        • +
      +
      • +
    +
    • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    java.io.Serializable, java.lang.Comparable<JSFunctionType>
    +
    +
    +
    +
    public enum JSFunctionType
+extends java.lang.Enum<JSFunctionType>
    +
    • +
+
+
+
    +
  • + + + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      intgetId() 
      java.lang.StringgetName() 
      booleanisAPI() 
      booleanisNative() 
      booleanisUserDefined() 
      static JSFunctionTypeparse(int id) 
      static JSFunctionTypevalueOf(java.lang.String name) +
      Returns the enum constant of this type with the specified name.
      +
      static JSFunctionType[]values() +
      Returns an array containing the constants of this enum type, in +the order they are declared.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Enum

        +clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf
        • +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +getClass, notify, notifyAll, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + + + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        values

        +
        public static JSFunctionType[] values()
        +
        Returns an array containing the constants of this enum type, in +the order they are declared. This method may be used to iterate +over the constants as follows: +
        +for (JSFunctionType c : JSFunctionType.values())
+    System.out.println(c);
+
        +
        +
        Returns:
        +
        an array containing the constants of this enum type, in the order they are declared
        +
        +
        • +
      + + + +
        +
      • +

        valueOf

        +
        public static JSFunctionType valueOf(java.lang.String name)
        +
        Returns the enum constant of this type with the specified name. +The string must match exactly an identifier used to declare an +enum constant in this type. (Extraneous whitespace characters are +not permitted.)
        +
        +
        Parameters:
        +
        name - the name of the enum constant to be returned.
        +
        Returns:
        +
        the enum constant with the specified name
        +
        Throws:
        +
        java.lang.IllegalArgumentException - if this enum type has no constant with the specified name
        +
        java.lang.NullPointerException - if the argument is null
        +
        +
        • +
      + + + + + + + +
        +
      • +

        getId

        +
        public int getId()
        +
        • +
      + + + +
        +
      • +

        getName

        +
        public java.lang.String getName()
        +
        • +
      + + + +
        +
      • +

        isAPI

        +
        public boolean isAPI()
        +
        • +
      + + + +
        +
      • +

        isNative

        +
        public boolean isNative()
        +
        • +
      + + + +
        +
      • +

        isUserDefined

        +
        public boolean isUserDefined()
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/enums/JSRuntimeType.html b/docs/reference/javadoc/com/caoccao/javet/enums/JSRuntimeType.html new file mode 100644 index 000000000..d9e881f44 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/enums/JSRuntimeType.html @@ -0,0 +1,390 @@ + + + + + +JSRuntimeType (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.enums
+

Enum JSRuntimeType

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • java.lang.Enum<JSRuntimeType>
      • +
    • +
        +
      • com.caoccao.javet.enums.JSRuntimeType
        • +
      +
      • +
    +
    • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    java.io.Serializable, java.lang.Comparable<JSRuntimeType>
    +
    +
    +
    +
    public enum JSRuntimeType
+extends java.lang.Enum<JSRuntimeType>
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Enum Constant Summary

      + + + + + + + + + + + +
      Enum Constants 
      Enum Constant and Description
      Node 
      V8 
      +
      • +
    + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      java.lang.StringgetName() 
      java.lang.StringgetVersion() 
      booleanisNode() 
      booleanisV8() 
      static JSRuntimeTypevalueOf(java.lang.String name) +
      Returns the enum constant of this type with the specified name.
      +
      static JSRuntimeType[]values() +
      Returns an array containing the constants of this enum type, in +the order they are declared.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Enum

        +clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf
        • +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +getClass, notify, notifyAll, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + + + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        values

        +
        public static JSRuntimeType[] values()
        +
        Returns an array containing the constants of this enum type, in +the order they are declared. This method may be used to iterate +over the constants as follows: +
        +for (JSRuntimeType c : JSRuntimeType.values())
+    System.out.println(c);
+
        +
        +
        Returns:
        +
        an array containing the constants of this enum type, in the order they are declared
        +
        +
        • +
      + + + +
        +
      • +

        valueOf

        +
        public static JSRuntimeType valueOf(java.lang.String name)
        +
        Returns the enum constant of this type with the specified name. +The string must match exactly an identifier used to declare an +enum constant in this type. (Extraneous whitespace characters are +not permitted.)
        +
        +
        Parameters:
        +
        name - the name of the enum constant to be returned.
        +
        Returns:
        +
        the enum constant with the specified name
        +
        Throws:
        +
        java.lang.IllegalArgumentException - if this enum type has no constant with the specified name
        +
        java.lang.NullPointerException - if the argument is null
        +
        +
        • +
      + + + +
        +
      • +

        getName

        +
        public java.lang.String getName()
        +
        • +
      + + + +
        +
      • +

        getVersion

        +
        public java.lang.String getVersion()
        +
        • +
      + + + +
        +
      • +

        isNode

        +
        public boolean isNode()
        +
        • +
      + + + +
        +
      • +

        isV8

        +
        public boolean isV8()
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/enums/JSScopeType.html b/docs/reference/javadoc/com/caoccao/javet/enums/JSScopeType.html new file mode 100644 index 000000000..1af876953 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/enums/JSScopeType.html @@ -0,0 +1,565 @@ + + + + + +JSScopeType (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.enums
+

Enum JSScopeType

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • java.lang.Enum<JSScopeType>
      • +
    • +
        +
      • com.caoccao.javet.enums.JSScopeType
        • +
      +
      • +
    +
    • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    java.io.Serializable, java.lang.Comparable<JSScopeType>
    +
    +
    +
    +
    public enum JSScopeType
+extends java.lang.Enum<JSScopeType>
    +
    • +
+
+
+
    +
  • + + + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      intgetId() 
      java.lang.StringgetName() 
      booleanisBlock() 
      booleanisCatch() 
      booleanisClass() 
      booleanisEval() 
      booleanisFunction() 
      booleanisModule() 
      booleanisScript() 
      booleanisWith() 
      static JSScopeTypeparse(int id) 
      static JSScopeTypevalueOf(java.lang.String name) +
      Returns the enum constant of this type with the specified name.
      +
      static JSScopeType[]values() +
      Returns an array containing the constants of this enum type, in +the order they are declared.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Enum

        +clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf
        • +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +getClass, notify, notifyAll, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + + + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        values

        +
        public static JSScopeType[] values()
        +
        Returns an array containing the constants of this enum type, in +the order they are declared. This method may be used to iterate +over the constants as follows: +
        +for (JSScopeType c : JSScopeType.values())
+    System.out.println(c);
+
        +
        +
        Returns:
        +
        an array containing the constants of this enum type, in the order they are declared
        +
        +
        • +
      + + + +
        +
      • +

        valueOf

        +
        public static JSScopeType valueOf(java.lang.String name)
        +
        Returns the enum constant of this type with the specified name. +The string must match exactly an identifier used to declare an +enum constant in this type. (Extraneous whitespace characters are +not permitted.)
        +
        +
        Parameters:
        +
        name - the name of the enum constant to be returned.
        +
        Returns:
        +
        the enum constant with the specified name
        +
        Throws:
        +
        java.lang.IllegalArgumentException - if this enum type has no constant with the specified name
        +
        java.lang.NullPointerException - if the argument is null
        +
        +
        • +
      + + + +
        +
      • +

        parse

        +
        public static JSScopeType parse(int id)
        +
        • +
      + + + +
        +
      • +

        getId

        +
        public int getId()
        +
        • +
      + + + +
        +
      • +

        getName

        +
        public java.lang.String getName()
        +
        • +
      + + + +
        +
      • +

        isBlock

        +
        public boolean isBlock()
        +
        • +
      + + + +
        +
      • +

        isCatch

        +
        public boolean isCatch()
        +
        • +
      + + + +
        +
      • +

        isClass

        +
        public boolean isClass()
        +
        • +
      + + + +
        +
      • +

        isEval

        +
        public boolean isEval()
        +
        • +
      + + + +
        +
      • +

        isFunction

        +
        public boolean isFunction()
        +
        • +
      + + + +
        +
      • +

        isModule

        +
        public boolean isModule()
        +
        • +
      + + + +
        +
      • +

        isScript

        +
        public boolean isScript()
        +
        • +
      + + + +
        +
      • +

        isWith

        +
        public boolean isWith()
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/enums/JavetErrorType.html b/docs/reference/javadoc/com/caoccao/javet/enums/JavetErrorType.html new file mode 100644 index 000000000..f22b11064 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/enums/JavetErrorType.html @@ -0,0 +1,471 @@ + + + + + +JavetErrorType (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.enums
+

Enum JavetErrorType

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • java.lang.Enum<JavetErrorType>
      • +
    • +
        +
      • com.caoccao.javet.enums.JavetErrorType
        • +
      +
      • +
    +
    • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    java.io.Serializable, java.lang.Comparable<JavetErrorType>
    +
    +
    +
    +
    public enum JavetErrorType
+extends java.lang.Enum<JavetErrorType>
    +
    The enum Javet error type is for categorizing the errors.
    +
    +
    Since:
    +
    0.8.5
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Enum Constant Summary

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Enum Constants 
      Enum Constant and Description
      Callback +
      Callback javet error type.
      +
      Compilation +
      Compilation javet error type.
      +
      Converter +
      Converter javet error type.
      +
      Execution +
      Execution javet error type.
      +
      Lock +
      Lock javet error type.
      +
      Module +
      Module javet error type.
      +
      Runtime +
      Runtime javet error type.
      +
      System +
      System javet error type.
      +
      +
      • +
    + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + +
      All Methods Static Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static JavetErrorTypevalueOf(java.lang.String name) +
      Returns the enum constant of this type with the specified name.
      +
      static JavetErrorType[]values() +
      Returns an array containing the constants of this enum type, in +the order they are declared.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Enum

        +clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf
        • +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +getClass, notify, notifyAll, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Enum Constant Detail

      + + + +
        +
      • +

        System

        +
        public static final JavetErrorType System
        +
        System javet error type.
        +
        +
        Since:
        +
        0.8.5
        +
        +
        • +
      + + + +
        +
      • +

        Compilation

        +
        public static final JavetErrorType Compilation
        +
        Compilation javet error type.
        +
        +
        Since:
        +
        0.8.5
        +
        +
        • +
      + + + +
        +
      • +

        Execution

        +
        public static final JavetErrorType Execution
        +
        Execution javet error type.
        +
        +
        Since:
        +
        0.8.5
        +
        +
        • +
      + + + +
        +
      • +

        Callback

        +
        public static final JavetErrorType Callback
        +
        Callback javet error type.
        +
        +
        Since:
        +
        0.8.5
        +
        +
        • +
      + + + +
        +
      • +

        Converter

        +
        public static final JavetErrorType Converter
        +
        Converter javet error type.
        +
        +
        Since:
        +
        0.8.5
        +
        +
        • +
      + + + +
        +
      • +

        Module

        +
        public static final JavetErrorType Module
        +
        Module javet error type.
        +
        +
        Since:
        +
        0.8.5
        +
        +
        • +
      + + + +
        +
      • +

        Lock

        +
        public static final JavetErrorType Lock
        +
        Lock javet error type.
        +
        +
        Since:
        +
        0.8.5
        +
        +
        • +
      + + + +
        +
      • +

        Runtime

        +
        public static final JavetErrorType Runtime
        +
        Runtime javet error type.
        +
        +
        Since:
        +
        0.8.5
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        values

        +
        public static JavetErrorType[] values()
        +
        Returns an array containing the constants of this enum type, in +the order they are declared. This method may be used to iterate +over the constants as follows: +
        +for (JavetErrorType c : JavetErrorType.values())
+    System.out.println(c);
+
        +
        +
        Returns:
        +
        an array containing the constants of this enum type, in the order they are declared
        +
        +
        • +
      + + + +
        +
      • +

        valueOf

        +
        public static JavetErrorType valueOf(java.lang.String name)
        +
        Returns the enum constant of this type with the specified name. +The string must match exactly an identifier used to declare an +enum constant in this type. (Extraneous whitespace characters are +not permitted.)
        +
        +
        Parameters:
        +
        name - the name of the enum constant to be returned.
        +
        Returns:
        +
        the enum constant with the specified name
        +
        Throws:
        +
        java.lang.IllegalArgumentException - if this enum type has no constant with the specified name
        +
        java.lang.NullPointerException - if the argument is null
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/enums/JavetPromiseRejectEvent.html b/docs/reference/javadoc/com/caoccao/javet/enums/JavetPromiseRejectEvent.html new file mode 100644 index 000000000..e465602ce --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/enums/JavetPromiseRejectEvent.html @@ -0,0 +1,437 @@ + + + + + +JavetPromiseRejectEvent (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.enums
+

Enum JavetPromiseRejectEvent

+
+
+
    +
  • java.lang.Object
    • +
  • + +
    • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    java.io.Serializable, java.lang.Comparable<JavetPromiseRejectEvent>
    +
    +
    +
    +
    public enum JavetPromiseRejectEvent
+extends java.lang.Enum<JavetPromiseRejectEvent>
    +
    The enum Javet promise reject event represents the corresponding event in V8.
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Enum Constant Detail

      + + + +
        +
      • +

        PromiseRejectWithNoHandler

        +
        public static final JavetPromiseRejectEvent PromiseRejectWithNoHandler
        +
        PromiseRejectWithNoHandler.
        +
        • +
      + + + +
        +
      • +

        PromiseHandlerAddedAfterReject

        +
        public static final JavetPromiseRejectEvent PromiseHandlerAddedAfterReject
        +
        PromiseHandlerAddedAfterReject.
        +
        • +
      + + + +
        +
      • +

        PromiseResolveAfterResolved

        +
        public static final JavetPromiseRejectEvent PromiseResolveAfterResolved
        +
        PromiseResolveAfterResolved.
        +
        • +
      + + + +
        +
      • +

        PromiseRejectAfterResolved

        +
        public static final JavetPromiseRejectEvent PromiseRejectAfterResolved
        +
        PromiseRejectAfterResolved.
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        values

        +
        public static JavetPromiseRejectEvent[] values()
        +
        Returns an array containing the constants of this enum type, in +the order they are declared. This method may be used to iterate +over the constants as follows: +
        +for (JavetPromiseRejectEvent c : JavetPromiseRejectEvent.values())
+    System.out.println(c);
+
        +
        +
        Returns:
        +
        an array containing the constants of this enum type, in the order they are declared
        +
        +
        • +
      + + + +
        +
      • +

        valueOf

        +
        public static JavetPromiseRejectEvent valueOf(java.lang.String name)
        +
        Returns the enum constant of this type with the specified name. +The string must match exactly an identifier used to declare an +enum constant in this type. (Extraneous whitespace characters are +not permitted.)
        +
        +
        Parameters:
        +
        name - the name of the enum constant to be returned.
        +
        Returns:
        +
        the enum constant with the specified name
        +
        Throws:
        +
        java.lang.IllegalArgumentException - if this enum type has no constant with the specified name
        +
        java.lang.NullPointerException - if the argument is null
        +
        +
        • +
      + + + +
        +
      • +

        parse

        +
        public static JavetPromiseRejectEvent parse(int code)
        +
        Parse javet promise reject event by code.
        +
        +
        Parameters:
        +
        code - the event code
        +
        Returns:
        +
        the javet promise reject event
        +
        +
        • +
      + + + +
        +
      • +

        getCode

        +
        public int getCode()
        +
        Gets event code.
        +
        +
        Returns:
        +
        the event code
        +
        +
        • +
      + + + +
        +
      • +

        getName

        +
        public java.lang.String getName()
        +
        Gets event name.
        +
        +
        Returns:
        +
        the event name
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/enums/V8ValueReferenceType.html b/docs/reference/javadoc/com/caoccao/javet/enums/V8ValueReferenceType.html new file mode 100644 index 000000000..f597ea8eb --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/enums/V8ValueReferenceType.html @@ -0,0 +1,737 @@ + + + + + +V8ValueReferenceType (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.enums
+

Enum V8ValueReferenceType

+
+
+
    +
  • java.lang.Object
    • +
  • + +
    • +
+
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/enums/V8ValueSymbolType.html b/docs/reference/javadoc/com/caoccao/javet/enums/V8ValueSymbolType.html new file mode 100644 index 000000000..4c2109b73 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/enums/V8ValueSymbolType.html @@ -0,0 +1,350 @@ + + + + + +V8ValueSymbolType (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.enums
+

Enum V8ValueSymbolType

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • java.lang.Enum<V8ValueSymbolType>
      • +
    • +
        +
      • com.caoccao.javet.enums.V8ValueSymbolType
        • +
      +
      • +
    +
    • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    java.io.Serializable, java.lang.Comparable<V8ValueSymbolType>
    +
    +
    +
    +
    public enum V8ValueSymbolType
+extends java.lang.Enum<V8ValueSymbolType>
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Enum Constant Summary

      + + + + + + + + + + + + + + +
      Enum Constants 
      Enum Constant and Description
      BuiltIn 
      Custom 
      None 
      +
      • +
    + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + +
      All Methods Static Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static V8ValueSymbolTypevalueOf(java.lang.String name) +
      Returns the enum constant of this type with the specified name.
      +
      static V8ValueSymbolType[]values() +
      Returns an array containing the constants of this enum type, in +the order they are declared.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Enum

        +clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf
        • +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +getClass, notify, notifyAll, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + + + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        values

        +
        public static V8ValueSymbolType[] values()
        +
        Returns an array containing the constants of this enum type, in +the order they are declared. This method may be used to iterate +over the constants as follows: +
        +for (V8ValueSymbolType c : V8ValueSymbolType.values())
+    System.out.println(c);
+
        +
        +
        Returns:
        +
        an array containing the constants of this enum type, in the order they are declared
        +
        +
        • +
      + + + +
        +
      • +

        valueOf

        +
        public static V8ValueSymbolType valueOf(java.lang.String name)
        +
        Returns the enum constant of this type with the specified name. +The string must match exactly an identifier used to declare an +enum constant in this type. (Extraneous whitespace characters are +not permitted.)
        +
        +
        Parameters:
        +
        name - the name of the enum constant to be returned.
        +
        Returns:
        +
        the enum constant with the specified name
        +
        Throws:
        +
        java.lang.IllegalArgumentException - if this enum type has no constant with the specified name
        +
        java.lang.NullPointerException - if the argument is null
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/enums/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/enums/package-frame.html new file mode 100644 index 000000000..94ab68292 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/enums/package-frame.html @@ -0,0 +1,25 @@ + + + + + +com.caoccao.javet.enums (javet 0.9.12 API) + + + + +

com.caoccao.javet.enums

+
+

Enums

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/enums/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/enums/package-summary.html new file mode 100644 index 000000000..b7e4f9ea5 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/enums/package-summary.html @@ -0,0 +1,180 @@ + + + + + +com.caoccao.javet.enums (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.enums

+
+
Enums for various API.
+
+

See: Description

+
+
+ + + + +

Package com.caoccao.javet.enums Description

+
Enums for various API.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/enums/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/enums/package-tree.html new file mode 100644 index 000000000..ad29966d7 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/enums/package-tree.html @@ -0,0 +1,144 @@ + + + + + +com.caoccao.javet.enums Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.enums

+Package Hierarchies: + +
+
+

Enum Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/exceptions/BaseJavetScriptingException.html b/docs/reference/javadoc/com/caoccao/javet/exceptions/BaseJavetScriptingException.html new file mode 100644 index 000000000..da21bcd5b --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/exceptions/BaseJavetScriptingException.html @@ -0,0 +1,370 @@ + + + + + +BaseJavetScriptingException (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.exceptions
+

Class BaseJavetScriptingException

+
+
+ +
+ +
+
+
    +
  • + + + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + + + +
      Constructors 
      ModifierConstructor and Description
      protected BaseJavetScriptingException(JavetError error, + java.lang.String message, + java.lang.String resourceName, + java.lang.String sourceLine, + int lineNumber, + int startColumn, + int endColumn, + int startPosition, + int endPosition) 
      +
      • +
    + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + +
      All Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      JavetScriptingErrorgetScriptingError() 
      + +
        +
      • + + +

        Methods inherited from class java.lang.Throwable

        +addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
        • +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + + + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        BaseJavetScriptingException

        +
        protected BaseJavetScriptingException(JavetError error,
+                                      java.lang.String message,
+                                      java.lang.String resourceName,
+                                      java.lang.String sourceLine,
+                                      int lineNumber,
+                                      int startColumn,
+                                      int endColumn,
+                                      int startPosition,
+                                      int endPosition)
        +
        • +
      +
      • +
    + + +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetCompilationException.html b/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetCompilationException.html new file mode 100644 index 000000000..e98c99e51 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetCompilationException.html @@ -0,0 +1,319 @@ + + + + + +JavetCompilationException (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ +
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.exceptions
+

Class JavetCompilationException

+
+
+ +
+ +
+
+
    +
  • + + + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + +
      Constructors 
      Constructor and Description
      JavetCompilationException(java.lang.String message, + java.lang.String resourceName, + java.lang.String sourceLine, + int lineNumber, + int startColumn, + int endColumn, + int startPosition, + int endPosition) 
      +
      • +
    + +
      +
    • + + +

      Method Summary

      + + +
        +
      • + + +

        Methods inherited from class java.lang.Throwable

        +addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
        • +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetCompilationException

        +
        public JavetCompilationException(java.lang.String message,
+                                 java.lang.String resourceName,
+                                 java.lang.String sourceLine,
+                                 int lineNumber,
+                                 int startColumn,
+                                 int endColumn,
+                                 int startPosition,
+                                 int endPosition)
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ +
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetConverterException.html b/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetConverterException.html new file mode 100644 index 000000000..0b17665e3 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetConverterException.html @@ -0,0 +1,362 @@ + + + + + +JavetConverterException (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.exceptions
+

Class JavetConverterException

+
+
+ +
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    java.io.Serializable
    +
    +
    +
    +
    public class JavetConverterException
+extends JavetException
    +
    The type Javet converter exception is for JNI.
    +
    +
    See Also:
    +
    Serialized Form
    +
    +
    • +
+
+
+
    +
  • + + + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + + + + + + + +
      Constructors 
      ModifierConstructor and Description
      protected JavetConverterException(JavetError error, + java.util.Map<java.lang.String,java.lang.Object> parameters) +
      Instantiates a new Javet converter exception.
      +
       JavetConverterException(java.lang.String message) +
      Instantiates a new Javet converter exception.
      +
      +
      • +
    + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + +
      All Methods Static Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static JavetConverterExceptioncircularStructure(int maxDepth) +
      Circular structure.
      +
      + +
        +
      • + + +

        Methods inherited from class java.lang.Throwable

        +addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
        • +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetConverterException

        +
        protected JavetConverterException(JavetError error,
+                                  java.util.Map<java.lang.String,java.lang.Object> parameters)
        +
        Instantiates a new Javet converter exception.
        +
        +
        Parameters:
        +
        error - the error
        +
        parameters - the parameters
        +
        +
        • +
      + + + +
        +
      • +

        JavetConverterException

        +
        public JavetConverterException(java.lang.String message)
        +
        Instantiates a new Javet converter exception.
        +
        +
        Parameters:
        +
        message - the message
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        circularStructure

        +
        public static JavetConverterException circularStructure(int maxDepth)
        +
        Circular structure.
        +
        +
        Parameters:
        +
        maxDepth - the max depth
        +
        Returns:
        +
        the javet converter exception
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetError.html b/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetError.html new file mode 100644 index 000000000..16d3851f7 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetError.html @@ -0,0 +1,1103 @@ + + + + + +JavetError (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.exceptions
+

Class JavetError

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.exceptions.JavetError
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public class JavetError
+extends java.lang.Object
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        PARAMETER_EXPECTED_PARAMETER_TYPE

        +
        public static final java.lang.String PARAMETER_EXPECTED_PARAMETER_TYPE
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_ACTUAL_PARAMETER_TYPE

        +
        public static final java.lang.String PARAMETER_ACTUAL_PARAMETER_TYPE
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_METHOD_NAME

        +
        public static final java.lang.String PARAMETER_METHOD_NAME
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_EXPECTED_PARAMETER_SIZE

        +
        public static final java.lang.String PARAMETER_EXPECTED_PARAMETER_SIZE
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_ACTUAL_PARAMETER_SIZE

        +
        public static final java.lang.String PARAMETER_ACTUAL_PARAMETER_SIZE
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_RESOURCE_NAME

        +
        public static final java.lang.String PARAMETER_RESOURCE_NAME
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_SOURCE_LINE

        +
        public static final java.lang.String PARAMETER_SOURCE_LINE
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_LINE_NUMBER

        +
        public static final java.lang.String PARAMETER_LINE_NUMBER
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_START_COLUMN

        +
        public static final java.lang.String PARAMETER_START_COLUMN
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_END_COLUMN

        +
        public static final java.lang.String PARAMETER_END_COLUMN
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_START_POSITION

        +
        public static final java.lang.String PARAMETER_START_POSITION
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_END_POSITION

        +
        public static final java.lang.String PARAMETER_END_POSITION
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_MESSAGE

        +
        public static final java.lang.String PARAMETER_MESSAGE
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_CURRENT_THREAD_ID

        +
        public static final java.lang.String PARAMETER_CURRENT_THREAD_ID
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_LOCKED_THREAD_ID

        +
        public static final java.lang.String PARAMETER_LOCKED_THREAD_ID
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_OS

        +
        public static final java.lang.String PARAMETER_OS
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_FEATURE

        +
        public static final java.lang.String PARAMETER_FEATURE
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_SYMBOL

        +
        public static final java.lang.String PARAMETER_SYMBOL
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_COUNT

        +
        public static final java.lang.String PARAMETER_COUNT
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_CONTINUABLE

        +
        public static final java.lang.String PARAMETER_CONTINUABLE
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_PATH

        +
        public static final java.lang.String PARAMETER_PATH
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_REASON

        +
        public static final java.lang.String PARAMETER_REASON
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PARAMETER_MAX_DEPTH

        +
        public static final java.lang.String PARAMETER_MAX_DEPTH
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        OSNotSupported

        +
        public static final JavetError OSNotSupported
        +
        • +
      + + + +
        +
      • +

        LibraryNotFound

        +
        public static final JavetError LibraryNotFound
        +
        • +
      + + + +
        +
      • +

        LibraryNotLoaded

        +
        public static final JavetError LibraryNotLoaded
        +
        • +
      + + + +
        +
      • +

        NotSupported

        +
        public static final JavetError NotSupported
        +
        • +
      + + + +
        +
      • +

        FailedToReadPath

        +
        public static final JavetError FailedToReadPath
        +
        • +
      + + + +
        +
      • +

        CompilationFailure

        +
        public static final JavetError CompilationFailure
        +
        • +
      + + + +
        +
      • +

        ExecutionFailure

        +
        public static final JavetError ExecutionFailure
        +
        • +
      + + + +
        +
      • +

        ExecutionTerminated

        +
        public static final JavetError ExecutionTerminated
        +
        • +
      + + + +
        +
      • +

        CallbackSignatureParameterSizeMismatch

        +
        public static final JavetError CallbackSignatureParameterSizeMismatch
        +
        • +
      + + + +
        +
      • +

        CallbackSignatureParameterTypeMismatch

        +
        public static final JavetError CallbackSignatureParameterTypeMismatch
        +
        • +
      + + + +
        +
      • +

        CallbackInjectionFailure

        +
        public static final JavetError CallbackInjectionFailure
        +
        • +
      + + + +
        +
      • +

        CallbackRegistrationFailure

        +
        public static final JavetError CallbackRegistrationFailure
        +
        • +
      + + + +
        +
      • +

        CallbackMethodFailure

        +
        public static final JavetError CallbackMethodFailure
        +
        • +
      + + + +
        +
      • +

        CallbackUnknownFailure

        +
        public static final JavetError CallbackUnknownFailure
        +
        • +
      + + + +
        +
      • +

        CallbackUnregistrationFailure

        +
        public static final JavetError CallbackUnregistrationFailure
        +
        • +
      + + + +
        +
      • +

        ConverterFailure

        +
        public static final JavetError ConverterFailure
        +
        • +
      + + + +
        +
      • +

        ConverterCircularStructure

        +
        public static final JavetError ConverterCircularStructure
        +
        • +
      + + + +
        +
      • +

        ConverterSymbolNotBuiltIn

        +
        public static final JavetError ConverterSymbolNotBuiltIn
        +
        • +
      + + + +
        +
      • +

        ModuleNameEmpty

        +
        public static final JavetError ModuleNameEmpty
        +
        • +
      + + + +
        +
      • +

        ModuleNotFound

        +
        public static final JavetError ModuleNotFound
        +
        • +
      + + + +
        +
      • +

        ModulePermissionDenied

        +
        public static final JavetError ModulePermissionDenied
        +
        • +
      + + + +
        +
      • +

        LockAcquisitionFailure

        +
        public static final JavetError LockAcquisitionFailure
        +
        • +
      + + + +
        +
      • +

        LockReleaseFailure

        +
        public static final JavetError LockReleaseFailure
        +
        • +
      + + + +
        +
      • +

        LockConflictThreadIdMismatch

        +
        public static final JavetError LockConflictThreadIdMismatch
        +
        • +
      + + + +
        +
      • +

        RuntimeAlreadyClosed

        +
        public static final JavetError RuntimeAlreadyClosed
        +
        • +
      + + + +
        +
      • +

        RuntimeAlreadyRegistered

        +
        public static final JavetError RuntimeAlreadyRegistered
        +
        • +
      + + + +
        +
      • +

        RuntimeNotRegistered

        +
        public static final JavetError RuntimeNotRegistered
        +
        • +
      + + + +
        +
      • +

        RuntimeLeakageDetected

        +
        public static final JavetError RuntimeLeakageDetected
        +
        • +
      + + + +
        +
      • +

        RuntimeCloseFailure

        +
        public static final JavetError RuntimeCloseFailure
        +
        • +
      + + + +
        +
      • +

        code

        +
        protected int code
        +
        • +
      + + + +
        +
      • +

        format

        +
        protected java.lang.String format
        +
        • +
      + + + + +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getCode

        +
        public int getCode()
        +
        • +
      + + + +
        +
      • +

        getFormat

        +
        public java.lang.String getFormat()
        +
        • +
      + + + +
        +
      • +

        getMessage

        +
        public java.lang.String getMessage(java.util.Map<java.lang.String,java.lang.Object> parameters)
        +
        • +
      + + + + +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetException.html b/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetException.html new file mode 100644 index 000000000..48a6185ed --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetException.html @@ -0,0 +1,403 @@ + + + + + +JavetException (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.exceptions
+

Class JavetException

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • java.lang.Throwable
      • +
    • +
        +
      • java.lang.Exception
        • +
      • +
          +
        • com.caoccao.javet.exceptions.JavetException
          • +
        +
        • +
      +
      • +
    +
    • +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Summary

      + + + + + + + + + + + + + + +
      Fields 
      Modifier and TypeField and Description
      protected JavetErrorerror 
      protected java.util.Map<java.lang.String,java.lang.Object>parameters 
      +
      • +
    + + + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + +
      All Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      JavetErrorgetError() 
      java.util.Map<java.lang.String,java.lang.Object>getParameters() 
      +
        +
      • + + +

        Methods inherited from class java.lang.Throwable

        +addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
        • +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + + + + + +
        +
      • +

        parameters

        +
        protected java.util.Map<java.lang.String,java.lang.Object> parameters
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetException

        +
        public JavetException(JavetError error)
        +
        • +
      + + + +
        +
      • +

        JavetException

        +
        public JavetException(JavetError error,
+                      java.util.Map<java.lang.String,java.lang.Object> parameters)
        +
        • +
      + + + +
        +
      • +

        JavetException

        +
        public JavetException(JavetError error,
+                      java.lang.Throwable cause)
        +
        • +
      + + + +
        +
      • +

        JavetException

        +
        public JavetException(JavetError error,
+                      java.util.Map<java.lang.String,java.lang.Object> parameters,
+                      java.lang.Throwable cause)
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + + + + + +
        +
      • +

        getParameters

        +
        public java.util.Map<java.lang.String,java.lang.Object> getParameters()
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetExecutionException.html b/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetExecutionException.html new file mode 100644 index 000000000..8b6cfc41e --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetExecutionException.html @@ -0,0 +1,319 @@ + + + + + +JavetExecutionException (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ +
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.exceptions
+

Class JavetExecutionException

+
+
+ +
+ +
+
+
    +
  • + + + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + +
      Constructors 
      Constructor and Description
      JavetExecutionException(java.lang.String message, + java.lang.String resourceName, + java.lang.String sourceLine, + int lineNumber, + int startColumn, + int endColumn, + int startPosition, + int endPosition) 
      +
      • +
    + +
      +
    • + + +

      Method Summary

      + + +
        +
      • + + +

        Methods inherited from class java.lang.Throwable

        +addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
        • +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetExecutionException

        +
        public JavetExecutionException(java.lang.String message,
+                               java.lang.String resourceName,
+                               java.lang.String sourceLine,
+                               int lineNumber,
+                               int startColumn,
+                               int endColumn,
+                               int startPosition,
+                               int endPosition)
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ +
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetScriptingError.html b/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetScriptingError.html new file mode 100644 index 000000000..835554f12 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetScriptingError.html @@ -0,0 +1,494 @@ + + + + + +JavetScriptingError (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.exceptions
+

Class JavetScriptingError

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.exceptions.JavetScriptingError
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public final class JavetScriptingError
+extends java.lang.Object
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetScriptingError

        +
        public JavetScriptingError(java.lang.String message,
+                           java.lang.String resourceName,
+                           java.lang.String sourceLine,
+                           int lineNumber,
+                           int startColumn,
+                           int endColumn,
+                           int startPosition,
+                           int endPosition)
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getEndColumn

        +
        public int getEndColumn()
        +
        • +
      + + + +
        +
      • +

        getEndPosition

        +
        public int getEndPosition()
        +
        • +
      + + + +
        +
      • +

        getLineNumber

        +
        public int getLineNumber()
        +
        • +
      + + + +
        +
      • +

        getMessage

        +
        public java.lang.String getMessage()
        +
        • +
      + + + +
        +
      • +

        getResourceName

        +
        public java.lang.String getResourceName()
        +
        • +
      + + + +
        +
      • +

        getSourceLine

        +
        public java.lang.String getSourceLine()
        +
        • +
      + + + +
        +
      • +

        getStartColumn

        +
        public int getStartColumn()
        +
        • +
      + + + +
        +
      • +

        getStartPosition

        +
        public int getStartPosition()
        +
        • +
      + + + +
        +
      • +

        setEndColumn

        +
        public void setEndColumn(int endColumn)
        +
        • +
      + + + +
        +
      • +

        setEndPosition

        +
        public void setEndPosition(int endPosition)
        +
        • +
      + + + +
        +
      • +

        setLineNumber

        +
        public void setLineNumber(int lineNumber)
        +
        • +
      + + + +
        +
      • +

        setMessage

        +
        public void setMessage(java.lang.String message)
        +
        • +
      + + + +
        +
      • +

        setResourceName

        +
        public void setResourceName(java.lang.String resourceName)
        +
        • +
      + + + +
        +
      • +

        setSourceLine

        +
        public void setSourceLine(java.lang.String sourceLine)
        +
        • +
      + + + +
        +
      • +

        setStartColumn

        +
        public void setStartColumn(int startColumn)
        +
        • +
      + + + +
        +
      • +

        setStartPosition

        +
        public void setStartPosition(int startPosition)
        +
        • +
      + + + +
        +
      • +

        toString

        +
        public java.lang.String toString()
        +
        +
        Overrides:
        +
        toString in class java.lang.Object
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetTerminatedException.html b/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetTerminatedException.html new file mode 100644 index 000000000..f8d1158f3 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/exceptions/JavetTerminatedException.html @@ -0,0 +1,348 @@ + + + + + +JavetTerminatedException (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.exceptions
+

Class JavetTerminatedException

+
+
+ +
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    java.io.Serializable
    +
    +
    +
    +
    public class JavetTerminatedException
+extends JavetException
    +
    +
    See Also:
    +
    Serialized Form
    +
    +
    • +
+
+
+
    +
  • + + + + + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + +
      All Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      booleanisContinuable() 
      + +
        +
      • + + +

        Methods inherited from class java.lang.Throwable

        +addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
        • +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        continuable

        +
        protected boolean continuable
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetTerminatedException

        +
        public JavetTerminatedException(boolean continuable)
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        isContinuable

        +
        public boolean isContinuable()
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/exceptions/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/exceptions/package-frame.html new file mode 100644 index 000000000..a2e1843af --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/exceptions/package-frame.html @@ -0,0 +1,29 @@ + + + + + +com.caoccao.javet.exceptions (javet 0.9.12 API) + + + + +

com.caoccao.javet.exceptions

+
+

Classes

+ +

Exceptions

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/exceptions/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/exceptions/package-summary.html new file mode 100644 index 000000000..70bf0d713 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/exceptions/package-summary.html @@ -0,0 +1,193 @@ + + + + + +com.caoccao.javet.exceptions (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.exceptions

+
+
Exceptions and errors for error handling.
+
+

See: Description

+
+
+ + + + +

Package com.caoccao.javet.exceptions Description

+
Exceptions and errors for error handling.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/exceptions/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/exceptions/package-tree.html new file mode 100644 index 000000000..4aacbf715 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/exceptions/package-tree.html @@ -0,0 +1,155 @@ + + + + + +com.caoccao.javet.exceptions Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.exceptions

+Package Hierarchies: + +
+
+

Class Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interception/BaseJavetInterceptor.html b/docs/reference/javadoc/com/caoccao/javet/interception/BaseJavetInterceptor.html new file mode 100644 index 000000000..fd03d0a1c --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interception/BaseJavetInterceptor.html @@ -0,0 +1,369 @@ + + + + + +BaseJavetInterceptor (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+
    +
  • Prev Class
    • +
  • Next Class
    • +
+ + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interception
+

Class BaseJavetInterceptor

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interception.BaseJavetInterceptor
      • +
    +
    • +
+
+ +
+
+ +
+
+
    +
  • + + + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        BaseJavetInterceptor

        +
        public BaseJavetInterceptor(V8Runtime v8Runtime)
        +
        • +
      +
      • +
    + + +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+
    +
  • Prev Class
    • +
  • Next Class
    • +
+ + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interception/logging/BaseJavetConsoleInterceptor.html b/docs/reference/javadoc/com/caoccao/javet/interception/logging/BaseJavetConsoleInterceptor.html new file mode 100644 index 000000000..28678af54 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interception/logging/BaseJavetConsoleInterceptor.html @@ -0,0 +1,874 @@ + + + + + +BaseJavetConsoleInterceptor (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interception.logging
+

Class BaseJavetConsoleInterceptor

+
+
+ +
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Summary

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Fields 
      Modifier and TypeField and Description
      protected static java.lang.StringJAVA_CONSOLE_DEBUG +
      The constant JAVA_CONSOLE_DEBUG.
      +
      protected static java.lang.StringJAVA_CONSOLE_ERROR +
      The constant JAVA_CONSOLE_ERROR.
      +
      protected static java.lang.StringJAVA_CONSOLE_INFO +
      The constant JAVA_CONSOLE_INFO.
      +
      protected static java.lang.StringJAVA_CONSOLE_LOG +
      The constant JAVA_CONSOLE_LOG.
      +
      protected static java.lang.StringJAVA_CONSOLE_TRACE +
      The constant JAVA_CONSOLE_TRACE.
      +
      protected static java.lang.StringJAVA_CONSOLE_WARN +
      The constant JAVA_CONSOLE_WARN.
      +
      protected static java.lang.StringJS_FUNCTION_DEBUG +
      The constant JS_FUNCTION_DEBUG.
      +
      protected static java.lang.StringJS_FUNCTION_ERROR +
      The constant JS_FUNCTION_ERROR.
      +
      protected static java.lang.StringJS_FUNCTION_INFO +
      The constant JS_FUNCTION_INFO.
      +
      protected static java.lang.StringJS_FUNCTION_LOG +
      The constant JS_FUNCTION_LOG.
      +
      protected static java.lang.StringJS_FUNCTION_TRACE +
      The constant JS_FUNCTION_TRACE.
      +
      protected static java.lang.StringJS_FUNCTION_WARN +
      The constant JS_FUNCTION_WARN.
      +
      protected static java.lang.StringPROPERTY_CONSOLE +
      The constant PROPERTY_CONSOLE.
      +
      protected static java.lang.StringSPACE +
      The constant SPACE.
      +
      + +
      • +
    + + + + +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        JAVA_CONSOLE_DEBUG

        +
        protected static final java.lang.String JAVA_CONSOLE_DEBUG
        +
        The constant JAVA_CONSOLE_DEBUG.
        +
        +
        Since:
        +
        0.7.0
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        JAVA_CONSOLE_ERROR

        +
        protected static final java.lang.String JAVA_CONSOLE_ERROR
        +
        The constant JAVA_CONSOLE_ERROR.
        +
        +
        Since:
        +
        0.7.0
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        JAVA_CONSOLE_INFO

        +
        protected static final java.lang.String JAVA_CONSOLE_INFO
        +
        The constant JAVA_CONSOLE_INFO.
        +
        +
        Since:
        +
        0.7.0
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        JAVA_CONSOLE_LOG

        +
        protected static final java.lang.String JAVA_CONSOLE_LOG
        +
        The constant JAVA_CONSOLE_LOG.
        +
        +
        Since:
        +
        0.7.0
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        JAVA_CONSOLE_TRACE

        +
        protected static final java.lang.String JAVA_CONSOLE_TRACE
        +
        The constant JAVA_CONSOLE_TRACE.
        +
        +
        Since:
        +
        0.7.0
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        JAVA_CONSOLE_WARN

        +
        protected static final java.lang.String JAVA_CONSOLE_WARN
        +
        The constant JAVA_CONSOLE_WARN.
        +
        +
        Since:
        +
        0.7.0
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        JS_FUNCTION_DEBUG

        +
        protected static final java.lang.String JS_FUNCTION_DEBUG
        +
        The constant JS_FUNCTION_DEBUG.
        +
        +
        Since:
        +
        0.7.0
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        JS_FUNCTION_ERROR

        +
        protected static final java.lang.String JS_FUNCTION_ERROR
        +
        The constant JS_FUNCTION_ERROR.
        +
        +
        Since:
        +
        0.7.0
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        JS_FUNCTION_INFO

        +
        protected static final java.lang.String JS_FUNCTION_INFO
        +
        The constant JS_FUNCTION_INFO.
        +
        +
        Since:
        +
        0.7.0
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        JS_FUNCTION_LOG

        +
        protected static final java.lang.String JS_FUNCTION_LOG
        +
        The constant JS_FUNCTION_LOG.
        +
        +
        Since:
        +
        0.7.0
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        JS_FUNCTION_TRACE

        +
        protected static final java.lang.String JS_FUNCTION_TRACE
        +
        The constant JS_FUNCTION_TRACE.
        +
        +
        Since:
        +
        0.7.0
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        JS_FUNCTION_WARN

        +
        protected static final java.lang.String JS_FUNCTION_WARN
        +
        The constant JS_FUNCTION_WARN.
        +
        +
        Since:
        +
        0.7.0
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PROPERTY_CONSOLE

        +
        protected static final java.lang.String PROPERTY_CONSOLE
        +
        The constant PROPERTY_CONSOLE.
        +
        +
        Since:
        +
        0.7.0
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        SPACE

        +
        protected static final java.lang.String SPACE
        +
        The constant SPACE.
        +
        +
        Since:
        +
        0.7.1
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        BaseJavetConsoleInterceptor

        +
        public BaseJavetConsoleInterceptor(V8Runtime v8Runtime)
        +
        Instantiates a new Base javet console interceptor.
        +
        +
        Parameters:
        +
        v8Runtime - the V8 runtime
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        concat

        +
        public java.lang.String concat(V8Value... v8Values)
        +
        Concat string.
        +
        +
        Parameters:
        +
        v8Values - the V8 values
        +
        Returns:
        +
        the string
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        consoleDebug

        +
        public abstract void consoleDebug(V8Value... v8Values)
        +
        Console debug.
        +
        +
        Parameters:
        +
        v8Values - the V8 values
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        consoleError

        +
        public abstract void consoleError(V8Value... v8Values)
        +
        Console error.
        +
        +
        Parameters:
        +
        v8Values - the V8 values
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        consoleInfo

        +
        public abstract void consoleInfo(V8Value... v8Values)
        +
        Console info.
        +
        +
        Parameters:
        +
        v8Values - the V8 values
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        consoleLog

        +
        public abstract void consoleLog(V8Value... v8Values)
        +
        Console log.
        +
        +
        Parameters:
        +
        v8Values - the V8 values
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        consoleTrace

        +
        public abstract void consoleTrace(V8Value... v8Values)
        +
        Console trace.
        +
        +
        Parameters:
        +
        v8Values - the V8 values
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        consoleWarn

        +
        public abstract void consoleWarn(V8Value... v8Values)
        +
        Console warn.
        +
        +
        Parameters:
        +
        v8Values - the V8 values
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + + + + + +
        +
      • +

        register

        +
        protected void register(IV8ValueObject iV8ValueObject,
+                        java.lang.String jsFunctionName,
+                        java.lang.String javaFunctionName)
+                 throws JavetException
        +
        Register a JS function by name.
        +
        +
        Parameters:
        +
        iV8ValueObject - the V8 value object
        +
        jsFunctionName - the JS function name
        +
        javaFunctionName - the Java function name
        +
        Throws:
        +
        JavetException - the Javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + + +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interception/logging/JavetStandardConsoleInterceptor.html b/docs/reference/javadoc/com/caoccao/javet/interception/logging/JavetStandardConsoleInterceptor.html new file mode 100644 index 000000000..d89ad1941 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interception/logging/JavetStandardConsoleInterceptor.html @@ -0,0 +1,856 @@ + + + + + +JavetStandardConsoleInterceptor (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interception.logging
+

Class JavetStandardConsoleInterceptor

+
+
+ +
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        debug

        +
        protected java.io.PrintStream debug
        +
        The Debug.
        +
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        error

        +
        protected java.io.PrintStream error
        +
        The Error.
        +
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        info

        +
        protected java.io.PrintStream info
        +
        The Info.
        +
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        log

        +
        protected java.io.PrintStream log
        +
        The Log.
        +
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        trace

        +
        protected java.io.PrintStream trace
        +
        The Trace.
        +
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        warn

        +
        protected java.io.PrintStream warn
        +
        The Warn.
        +
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetStandardConsoleInterceptor

        +
        public JavetStandardConsoleInterceptor(V8Runtime v8Runtime)
        +
        Instantiates a new Javet standard console interceptor.
        +
        +
        Parameters:
        +
        v8Runtime - the V8 runtime
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + + + + + + + + + + + + + + + + + + + + + + + + + +
        +
      • +

        getDebug

        +
        public java.io.PrintStream getDebug()
        +
        Gets debug.
        +
        +
        Returns:
        +
        the debug
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getError

        +
        public java.io.PrintStream getError()
        +
        Gets error.
        +
        +
        Returns:
        +
        the error
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getInfo

        +
        public java.io.PrintStream getInfo()
        +
        Gets info.
        +
        +
        Returns:
        +
        the info
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getLog

        +
        public java.io.PrintStream getLog()
        +
        Gets log.
        +
        +
        Returns:
        +
        the log
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getTrace

        +
        public java.io.PrintStream getTrace()
        +
        Gets trace.
        +
        +
        Returns:
        +
        the trace
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getWarn

        +
        public java.io.PrintStream getWarn()
        +
        Gets warn.
        +
        +
        Returns:
        +
        the warn
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        setDebug

        +
        public void setDebug(java.io.PrintStream debug)
        +
        Sets debug.
        +
        +
        Parameters:
        +
        debug - the debug
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        setError

        +
        public void setError(java.io.PrintStream error)
        +
        Sets error.
        +
        +
        Parameters:
        +
        error - the error
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        setInfo

        +
        public void setInfo(java.io.PrintStream info)
        +
        Sets info.
        +
        +
        Parameters:
        +
        info - the info
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        setLog

        +
        public void setLog(java.io.PrintStream log)
        +
        Sets log.
        +
        +
        Parameters:
        +
        log - the log
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        setTrace

        +
        public void setTrace(java.io.PrintStream trace)
        +
        Sets trace.
        +
        +
        Parameters:
        +
        trace - the trace
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        setWarn

        +
        public void setWarn(java.io.PrintStream warn)
        +
        Sets warn.
        +
        +
        Parameters:
        +
        warn - the warn
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interception/logging/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/interception/logging/package-frame.html new file mode 100644 index 000000000..31ffa0413 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interception/logging/package-frame.html @@ -0,0 +1,20 @@ + + + + + +com.caoccao.javet.interception.logging (javet 0.9.12 API) + + + + +

com.caoccao.javet.interception.logging

+
+

Classes

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/interception/logging/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/interception/logging/package-summary.html new file mode 100644 index 000000000..82205d32e --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interception/logging/package-summary.html @@ -0,0 +1,160 @@ + + + + + +com.caoccao.javet.interception.logging (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.interception.logging

+
+
Built-in interceptors for JS logging function console.log(), etc...
+
+

See: Description

+
+
+ + + + +

Package com.caoccao.javet.interception.logging Description

+
Built-in interceptors for JS logging function console.log(), etc...
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interception/logging/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/interception/logging/package-tree.html new file mode 100644 index 000000000..28a736b7a --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interception/logging/package-tree.html @@ -0,0 +1,142 @@ + + + + + +com.caoccao.javet.interception.logging Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.interception.logging

+Package Hierarchies: + +
+
+

Class Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interception/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/interception/package-frame.html new file mode 100644 index 000000000..5862592eb --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interception/package-frame.html @@ -0,0 +1,19 @@ + + + + + +com.caoccao.javet.interception (javet 0.9.12 API) + + + + +

com.caoccao.javet.interception

+
+

Classes

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/interception/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/interception/package-summary.html new file mode 100644 index 000000000..c9f68593b --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interception/package-summary.html @@ -0,0 +1,152 @@ + + + + + +com.caoccao.javet.interception (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.interception

+
+
Built-in interceptors.
+
+

See: Description

+
+
+ + + + +

Package com.caoccao.javet.interception Description

+
Built-in interceptors.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interception/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/interception/package-tree.html new file mode 100644 index 000000000..67c0cd294 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interception/package-tree.html @@ -0,0 +1,134 @@ + + + + + +com.caoccao.javet.interception Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.interception

+Package Hierarchies: + +
+
+

Class Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetBiConsumer.html b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetBiConsumer.html new file mode 100644 index 000000000..2d8d6bddb --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetBiConsumer.html @@ -0,0 +1,249 @@ + + + + + +IJavetBiConsumer (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interfaces
+

Interface IJavetBiConsumer<T1 extends V8Value,T2 extends V8Value,E extends java.lang.Throwable>

+
+
+
+
    +
  • +
    +
    Type Parameters:
    +
    T1 - the type parameter for key
    +
    T2 - the type parameter for value
    +
    E - the type parameter for custom exception
    +
    +
    +
    +
    public interface IJavetBiConsumer<T1 extends V8Value,T2 extends V8Value,E extends java.lang.Throwable>
    +
    The interface Javet bi-consumer.
    +
    +
    Since:
    +
    0.8.9
    +
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + + + +
        +
      • +

        accept

        +
        void accept(T1 key,
+            T2 value)
+     throws JavetException,
+            E extends java.lang.Throwable
        +
        Accept.
        +
        +
        Parameters:
        +
        key - the key
        +
        value - the value
        +
        Throws:
        +
        JavetException - the javet exception
        +
        E - the custom exception
        +
        E extends java.lang.Throwable
        +
        Since:
        +
        0.8.9
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetBiIndexedConsumer.html b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetBiIndexedConsumer.html new file mode 100644 index 000000000..afdfee48d --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetBiIndexedConsumer.html @@ -0,0 +1,252 @@ + + + + + +IJavetBiIndexedConsumer (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interfaces
+

Interface IJavetBiIndexedConsumer<T1 extends V8Value,T2 extends V8Value,E extends java.lang.Throwable>

+
+
+
+
    +
  • +
    +
    Type Parameters:
    +
    T1 - the type parameter for key
    +
    T2 - the type parameter for value
    +
    E - the type parameter for custom exception
    +
    +
    +
    +
    public interface IJavetBiIndexedConsumer<T1 extends V8Value,T2 extends V8Value,E extends java.lang.Throwable>
    +
    The interface Javet bi-indexed consumer.
    +
    +
    Since:
    +
    0.8.10
    +
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + + + +
        +
      • +

        accept

        +
        void accept(int index,
+            T1 key,
+            T2 value)
+     throws JavetException,
+            E extends java.lang.Throwable
        +
        Accept.
        +
        +
        Parameters:
        +
        index - the index
        +
        key - the key
        +
        value - the value
        +
        Throws:
        +
        JavetException - the javet exception
        +
        E - the custom exception
        +
        E extends java.lang.Throwable
        +
        Since:
        +
        0.8.10
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetClosable.html b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetClosable.html new file mode 100644 index 000000000..a2f0af287 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetClosable.html @@ -0,0 +1,265 @@ + + + + + +IJavetClosable (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interfaces
+

Interface IJavetClosable

+
+
+
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        close

        +
        void close()
+    throws JavetException
        +
        +
        Specified by:
        +
        close in interface java.lang.AutoCloseable
        +
        Throws:
        +
        JavetException
        +
        +
        • +
      + + + +
        +
      • +

        isClosed

        +
        boolean isClosed()
        +
        Is closed.
        +
        +
        Returns:
        +
        the boolean
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetEntityFunction.html b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetEntityFunction.html new file mode 100644 index 000000000..447f2975f --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetEntityFunction.html @@ -0,0 +1,302 @@ + + + + + +IJavetEntityFunction (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interfaces
+

Interface IJavetEntityFunction

+
+
+
+
    +
  • +
    +
    All Known Implementing Classes:
    +
    JavetEntityFunction
    +
    +
    +
    +
    public interface IJavetEntityFunction
    +
    The interface Javet entity function.
    +
    +
    Since:
    +
    0.9.4
    +
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getJSFunctionType

        +
        JSFunctionType getJSFunctionType()
        +
        Gets JS function type.
        +
        +
        Returns:
        +
        the JS function type
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        getSourceCode

        +
        java.lang.String getSourceCode()
        +
        Gets source code.
        +
        +
        Returns:
        +
        the source code
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        setJSFunctionType

        +
        void setJSFunctionType(JSFunctionType jsFunctionType)
        +
        Sets JS function type.
        +
        +
        Parameters:
        +
        jsFunctionType - the JS function type
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        setSourceCode

        +
        void setSourceCode(java.lang.String sourceCode)
        +
        Sets source code.
        +
        +
        Parameters:
        +
        sourceCode - the source code
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetEntityMap.html b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetEntityMap.html new file mode 100644 index 000000000..75f530773 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetEntityMap.html @@ -0,0 +1,214 @@ + + + + + +IJavetEntityMap (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interfaces
+

Interface IJavetEntityMap

+
+
+
+
    +
  • +
    +
    All Superinterfaces:
    +
    java.util.Map<java.lang.String,java.lang.Object>
    +
    +
    +
    All Known Implementing Classes:
    +
    JavetEntityMap
    +
    +
    +
    +
    public interface IJavetEntityMap
+extends java.util.Map<java.lang.String,java.lang.Object>
    +
    The interface Javet entity map.
    +
    +
    Since:
    +
    0.9.4
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Nested Class Summary

      +
        +
      • + + +

        Nested classes/interfaces inherited from interface java.util.Map

        +java.util.Map.Entry<K,V>
        • +
      +
      • +
    + +
      +
    • + + +

      Method Summary

      +
        +
      • + + +

        Methods inherited from interface java.util.Map

        +clear, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, equals, forEach, get, getOrDefault, hashCode, isEmpty, keySet, merge, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetInterceptor.html b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetInterceptor.html new file mode 100644 index 000000000..4d1e40959 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetInterceptor.html @@ -0,0 +1,268 @@ + + + + + +IJavetInterceptor (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interfaces
+

Interface IJavetInterceptor

+
+
+
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        register

        +
        boolean register(IV8ValueObject... iV8ValueObjects)
+          throws JavetException
        +
        Register the interceptor to the given V8 value object.
        +
        +
        Parameters:
        +
        iV8ValueObjects - the V8 value objects
        +
        Returns:
        +
        true: success, false: failure
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        unregister

        +
        boolean unregister(IV8ValueObject... iV8ValueObjects)
+            throws JavetException
        +
        Unregister the interceptor from the given V8 value object.
        +
        +
        Parameters:
        +
        iV8ValueObjects - the V8 value objects
        +
        Returns:
        +
        true: success, false: failure
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetLogger.html b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetLogger.html new file mode 100644 index 000000000..1018f1323 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetLogger.html @@ -0,0 +1,455 @@ + + + + + +IJavetLogger (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interfaces
+

Interface IJavetLogger

+
+
+
+
    +
  • +
    +
    All Known Implementing Classes:
    +
    JavetDefaultLogger
    +
    +
    +
    +
    public interface IJavetLogger
    +
    The interface Javet logger.
    +
    +
    Since:
    +
    0.7.0
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      All Methods Instance Methods Abstract Methods Default Methods 
      Modifier and TypeMethod and Description
      voiddebug(java.lang.String message) +
      Debug.
      +
      voiderror(java.lang.String message) +
      Error.
      +
      voiderror(java.lang.String message, + java.lang.Throwable cause) +
      Error.
      +
      voidinfo(java.lang.String message) +
      Info.
      +
      default voidlogDebug(java.lang.String format, + java.lang.Object... objects) +
      Log debug.
      +
      default voidlogError(java.lang.String format, + java.lang.Object... objects) +
      Log error.
      +
      default voidlogError(java.lang.Throwable cause, + java.lang.String format, + java.lang.Object... objects) +
      Log error.
      +
      default voidlogInfo(java.lang.String format, + java.lang.Object... objects) +
      Log info.
      +
      default voidlogWarn(java.lang.String format, + java.lang.Object... objects) +
      Log warn.
      +
      voidwarn(java.lang.String message) +
      Warn.
      +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        debug

        +
        void debug(java.lang.String message)
        +
        Debug.
        +
        +
        Parameters:
        +
        message - the message
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        error

        +
        void error(java.lang.String message)
        +
        Error.
        +
        +
        Parameters:
        +
        message - the message
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        error

        +
        void error(java.lang.String message,
+           java.lang.Throwable cause)
        +
        Error.
        +
        +
        Parameters:
        +
        message - the message
        +
        cause - the cause
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        info

        +
        void info(java.lang.String message)
        +
        Info.
        +
        +
        Parameters:
        +
        message - the message
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        logDebug

        +
        default void logDebug(java.lang.String format,
+                      java.lang.Object... objects)
        +
        Log debug.
        +
        +
        Parameters:
        +
        format - the format
        +
        objects - the objects
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        logError

        +
        default void logError(java.lang.Throwable cause,
+                      java.lang.String format,
+                      java.lang.Object... objects)
        +
        Log error.
        +
        +
        Parameters:
        +
        cause - the cause
        +
        format - the format
        +
        objects - the objects
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        logError

        +
        default void logError(java.lang.String format,
+                      java.lang.Object... objects)
        +
        Log error.
        +
        +
        Parameters:
        +
        format - the format
        +
        objects - the objects
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        logInfo

        +
        default void logInfo(java.lang.String format,
+                     java.lang.Object... objects)
        +
        Log info.
        +
        +
        Parameters:
        +
        format - the format
        +
        objects - the objects
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        logWarn

        +
        default void logWarn(java.lang.String format,
+                     java.lang.Object... objects)
        +
        Log warn.
        +
        +
        Parameters:
        +
        format - the format
        +
        objects - the objects
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        warn

        +
        void warn(java.lang.String message)
        +
        Warn.
        +
        +
        Parameters:
        +
        message - the message
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetPromiseRejectCallback.html b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetPromiseRejectCallback.html new file mode 100644 index 000000000..a3a683a38 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetPromiseRejectCallback.html @@ -0,0 +1,242 @@ + + + + + +IJavetPromiseRejectCallback (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interfaces
+

Interface IJavetPromiseRejectCallback

+
+
+
+
    +
  • +
    +
    All Known Implementing Classes:
    +
    JavetPromiseRejectCallback
    +
    +
    +
    +
    public interface IJavetPromiseRejectCallback
    +
    The interface Javet promise reject callback.
    +
    +
    Since:
    +
    0.8.3
    +
    +
    • +
+
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetResettable.html b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetResettable.html new file mode 100644 index 000000000..1dcd31960 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetResettable.html @@ -0,0 +1,233 @@ + + + + + +IJavetResettable (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interfaces
+

Interface IJavetResettable

+
+
+
+
    +
  • +
    +
    +
    public interface IJavetResettable
    +
    The interface Javet resettable.
    +
    +
    Since:
    +
    0.7.0
    +
    +
    • +
+
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetSupplier.html b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetSupplier.html new file mode 100644 index 000000000..5041e2c7c --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetSupplier.html @@ -0,0 +1,230 @@ + + + + + +IJavetSupplier (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interfaces
+

Interface IJavetSupplier<T,E extends java.lang.Throwable>

+
+
+
+
    +
  • +
    +
    Functional Interface:
    +
    This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
    +
    +
    +
    +
    @FunctionalInterface
+public interface IJavetSupplier<T,E extends java.lang.Throwable>
    +
    • +
+
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetUniConsumer.html b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetUniConsumer.html new file mode 100644 index 000000000..38f73da44 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetUniConsumer.html @@ -0,0 +1,245 @@ + + + + + +IJavetUniConsumer (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interfaces
+

Interface IJavetUniConsumer<T extends V8Value,E extends java.lang.Throwable>

+
+
+
+
    +
  • +
    +
    Type Parameters:
    +
    T - the type parameter for value
    +
    E - the type parameter for custom exception
    +
    +
    +
    +
    public interface IJavetUniConsumer<T extends V8Value,E extends java.lang.Throwable>
    +
    The interface Javet uni consumer.
    +
    +
    Since:
    +
    0.8.10
    +
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + + + +
        +
      • +

        accept

        +
        void accept(T value)
+     throws JavetException,
+            E extends java.lang.Throwable
        +
        Accept.
        +
        +
        Parameters:
        +
        value - the value
        +
        Throws:
        +
        JavetException - the javet exception
        +
        E - the custom exception
        +
        E extends java.lang.Throwable
        +
        Since:
        +
        0.8.10
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetUniIndexedConsumer.html b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetUniIndexedConsumer.html new file mode 100644 index 000000000..d77900395 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interfaces/IJavetUniIndexedConsumer.html @@ -0,0 +1,248 @@ + + + + + +IJavetUniIndexedConsumer (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interfaces
+

Interface IJavetUniIndexedConsumer<T extends V8Value,E extends java.lang.Throwable>

+
+
+
+
    +
  • +
    +
    Type Parameters:
    +
    T - the type parameter for value
    +
    E - the type parameter for custom exception
    +
    +
    +
    +
    public interface IJavetUniIndexedConsumer<T extends V8Value,E extends java.lang.Throwable>
    +
    The interface Javet uni indexed consumer.
    +
    +
    Since:
    +
    0.8.10
    +
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + + + +
        +
      • +

        accept

        +
        void accept(int index,
+            T value)
+     throws JavetException,
+            E extends java.lang.Throwable
        +
        Accept.
        +
        +
        Parameters:
        +
        index - the index
        +
        value - the value
        +
        Throws:
        +
        JavetException - the javet exception
        +
        E - the custom exception
        +
        E extends java.lang.Throwable
        +
        Since:
        +
        0.8.10
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interfaces/IV8ModuleResolver.html b/docs/reference/javadoc/com/caoccao/javet/interfaces/IV8ModuleResolver.html new file mode 100644 index 000000000..f8a3dd948 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interfaces/IV8ModuleResolver.html @@ -0,0 +1,243 @@ + + + + + +IV8ModuleResolver (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interfaces
+

Interface IV8ModuleResolver

+
+
+
+
    +
  • +
    +
    +
    public interface IV8ModuleResolver
    +
    The interface V8 module resolver is for resolving V8 module look-up in dynamic import.
    +
    +
    Since:
    +
    0.9.3
    +
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        resolve

        +
        IV8Module resolve(V8Runtime v8Runtime,
+                  java.lang.String resourceName,
+                  IV8Module v8ModuleReferrer)
+           throws JavetException
        +
        Resolve V8 module.
        +
        +
        Parameters:
        +
        v8Runtime - the V8 runtime
        +
        resourceName - the resource name
        +
        v8ModuleReferrer - the V8 module referrer
        +
        Returns:
        +
        the V8 module
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.3
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interfaces/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/interfaces/package-frame.html new file mode 100644 index 000000000..2817771d9 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interfaces/package-frame.html @@ -0,0 +1,31 @@ + + + + + +com.caoccao.javet.interfaces (javet 0.9.12 API) + + + + +

com.caoccao.javet.interfaces

+
+

Interfaces

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/interfaces/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/interfaces/package-summary.html new file mode 100644 index 000000000..25165b55d --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interfaces/package-summary.html @@ -0,0 +1,224 @@ + + + + + +com.caoccao.javet.interfaces (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.interfaces

+
+
Interfaces required by various internal and external API.
+
+

See: Description

+
+
+ + + + +

Package com.caoccao.javet.interfaces Description

+
Interfaces required by various internal and external API.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interfaces/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/interfaces/package-tree.html new file mode 100644 index 000000000..edbf9e1d3 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interfaces/package-tree.html @@ -0,0 +1,150 @@ + + + + + +com.caoccao.javet.interfaces Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.interfaces

+Package Hierarchies: + +
+
+

Interface Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/INodeNative.html b/docs/reference/javadoc/com/caoccao/javet/interop/INodeNative.html new file mode 100644 index 000000000..e52e9509e --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/INodeNative.html @@ -0,0 +1,190 @@ + + + + + +INodeNative (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interop
+

Interface INodeNative

+
+
+
+
    +
  • +
    +
    All Superinterfaces:
    +
    IV8Native
    +
    +
    +
    +
    public interface INodeNative
+extends IV8Native
    +
    • +
+
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/IV8Cloneable.html b/docs/reference/javadoc/com/caoccao/javet/interop/IV8Cloneable.html new file mode 100644 index 000000000..1111d99ec --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/IV8Cloneable.html @@ -0,0 +1,232 @@ + + + + + +IV8Cloneable (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interop
+

Interface IV8Cloneable

+
+
+
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/IV8Convertible.html b/docs/reference/javadoc/com/caoccao/javet/interop/IV8Convertible.html new file mode 100644 index 000000000..1fff54de4 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/IV8Convertible.html @@ -0,0 +1,310 @@ + + + + + +IV8Convertible (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interop
+

Interface IV8Convertible

+
+
+
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + + + +
        +
      • +

        toObject

        +
        <T,V extends V8Value> T toObject(V v8Value)
+                          throws JavetException
        +
        Convert from V8 value to object. + The caller is responsible for closing the V8 value.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        V - the type parameter
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the object
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + + + +
        +
      • +

        toObject

        +
        default <T,V extends V8Value> T toObject(V v8Value,
+                                         boolean autoClose)
+                                  throws JavetException
        +
        Convert from V8 value to object. + The V8 value is closed automatically if autoClose is set to true.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        V - the type parameter
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        autoClose - the auto close
        +
        Returns:
        +
        the t
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + + + +
        +
      • +

        toV8Value

        +
        @CheckReturnValue
+<T,V extends V8Value> V toV8Value(T object)
+                                              throws JavetException
        +
        Convert object to V8 value.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        V - the type parameter
        +
        Parameters:
        +
        object - the object
        +
        Returns:
        +
        the V8 value
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/IV8Creatable.html b/docs/reference/javadoc/com/caoccao/javet/interop/IV8Creatable.html new file mode 100644 index 000000000..050c4bb1f --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/IV8Creatable.html @@ -0,0 +1,631 @@ + + + + + +IV8Creatable (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interop
+

Interface IV8Creatable

+
+
+
+
    +
  • +
    +
    All Known Implementing Classes:
    +
    NodeRuntime, V8Runtime
    +
    +
    +
    +
    public interface IV8Creatable
    +
    • +
+
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/IV8Executable.html b/docs/reference/javadoc/com/caoccao/javet/interop/IV8Executable.html new file mode 100644 index 000000000..97bf241e1 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/IV8Executable.html @@ -0,0 +1,490 @@ + + + + + +IV8Executable (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interop
+

Interface IV8Executable

+
+
+
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + + + + + +
        +
      • +

        execute

        +
        @CheckReturnValue
+<T extends V8Value> T execute(boolean resultRequired)
+                                          throws JavetException
        +
        Execute t.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        resultRequired - the result required
        +
        Returns:
        +
        the t
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        executeBoolean

        +
        default java.lang.Boolean executeBoolean()
+                                  throws JavetException
        +
        Execute boolean boolean.
        +
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        executeDouble

        +
        default java.lang.Double executeDouble()
+                                throws JavetException
        +
        Execute double double.
        +
        +
        Returns:
        +
        the double
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        executeInteger

        +
        default java.lang.Integer executeInteger()
+                                  throws JavetException
        +
        Execute integer integer.
        +
        +
        Returns:
        +
        the integer
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        executeLong

        +
        default java.lang.Long executeLong()
+                            throws JavetException
        +
        Execute long long.
        +
        +
        Returns:
        +
        the long
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        executeObject

        +
        default <T> T executeObject()
+                     throws JavetException
        +
        Execute object t.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Returns:
        +
        the t
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        executePrimitive

        +
        default <R,T extends V8ValuePrimitive<R>> R executePrimitive()
+                                                      throws JavetException
        +
        Execute primitive r.
        +
        +
        Type Parameters:
        +
        R - the type parameter
        +
        T - the type parameter
        +
        Returns:
        +
        the r
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        executeString

        +
        default java.lang.String executeString()
+                                throws JavetException
        +
        Execute string string.
        +
        +
        Returns:
        +
        the string
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + + + + + +
        +
      • +

        executeZonedDateTime

        +
        default java.time.ZonedDateTime executeZonedDateTime()
+                                              throws JavetException
        +
        Execute zoned date time zoned date time.
        +
        +
        Returns:
        +
        the zoned date time
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/IV8InspectorListener.html b/docs/reference/javadoc/com/caoccao/javet/interop/IV8InspectorListener.html new file mode 100644 index 000000000..031fb4df4 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/IV8InspectorListener.html @@ -0,0 +1,270 @@ + + + + + +IV8InspectorListener (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interop
+

Interface IV8InspectorListener

+
+
+
+
    +
  • +
    +
    +
    public interface IV8InspectorListener
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        flushProtocolNotifications

        +
        void flushProtocolNotifications()
        +
        • +
      + + + +
        +
      • +

        receiveNotification

        +
        void receiveNotification(java.lang.String message)
        +
        • +
      + + + +
        +
      • +

        receiveResponse

        +
        void receiveResponse(java.lang.String message)
        +
        • +
      + + + +
        +
      • +

        runIfWaitingForDebugger

        +
        void runIfWaitingForDebugger(int contextGroupId)
        +
        • +
      + + + +
        +
      • +

        sendRequest

        +
        void sendRequest(java.lang.String message)
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/IV8Native.html b/docs/reference/javadoc/com/caoccao/javet/interop/IV8Native.html new file mode 100644 index 000000000..578e2bb87 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/IV8Native.html @@ -0,0 +1,1663 @@ + + + + + +IV8Native (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interop
+

Interface IV8Native

+
+
+
+
    +
  • +
    +
    All Known Subinterfaces:
    +
    INodeNative
    +
    +
    +
    +
    public interface IV8Native
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      All Methods Instance Methods Abstract Methods 
      Modifier and TypeMethod and Description
      voidadd(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + java.lang.Object value) 
      voidallowCodeGenerationFromStrings(long v8RuntimeHandle, + boolean allow) 
      voidawait(long v8RuntimeHandle) 
      java.lang.Objectcall(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + java.lang.Object receiver, + boolean returnResult, + java.lang.Object[] values) 
      java.lang.ObjectcallAsConstructor(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + java.lang.Object[] values) 
      voidclearInternalStatistic() 
      voidclearWeak(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      java.lang.ObjectcloneV8Value(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      voidcloseV8Runtime(long v8RuntimeHandle) 
      java.lang.Objectcompile(long v8RuntimeHandle, + java.lang.String script, + boolean returnResult, + java.lang.String resourceName, + int resourceLineOffset, + int resourceColumnOffset, + int scriptId, + boolean isWASM, + boolean isModule) 
      voidcreateV8Inspector(long v8RuntimeHandle, + java.lang.Object v8Inspector) 
      longcreateV8Runtime(java.lang.String globalName) 
      java.lang.ObjectcreateV8Value(long v8RuntimeHandle, + int v8ValueType, + java.lang.Object context) 
      booleandelete(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + java.lang.Object key) 
      booleandeletePrivateProperty(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + java.lang.String key) 
      booleanequals(long v8RuntimeHandle, + long v8ValueHandle1, + long v8ValueHandle2) 
      java.lang.Objectexecute(long v8RuntimeHandle, + java.lang.String script, + boolean returnResult, + java.lang.String resourceName, + int resourceLineOffset, + int resourceColumnOffset, + int scriptId, + boolean isWASM, + boolean isModule) 
      java.lang.Objectget(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + java.lang.Object key) 
      java.lang.ObjectgetGlobalObject(long v8RuntimeHandle) 
      intgetIdentityHash(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      java.lang.ObjectgetInternalProperties(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      long[]getInternalStatistic() 
      intgetJSFunctionType(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      intgetJSScopeType(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      intgetLength(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      java.lang.ObjectgetOwnPropertyNames(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      java.lang.ObjectgetPrivateProperty(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + java.lang.String propertyName) 
      java.lang.ObjectgetProperty(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + java.lang.Object key) 
      java.lang.ObjectgetPropertyNames(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      java.lang.ObjectgetPrototype(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      intgetSize(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      java.lang.StringgetSourceCode(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      java.lang.StringgetVersion() 
      booleanhas(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + java.lang.Object value) 
      booleanhasOwnProperty(long v8RuntimeHandle, + long v8ValueHandle, + int type, + java.lang.Object key) 
      booleanhasPrivateProperty(long v8RuntimeHandle, + long v8ValueHandle, + int type, + java.lang.String propertyName) 
      voididleNotificationDeadline(long v8RuntimeHandle, + long deadlineInMillis) 
      java.lang.Objectinvoke(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + java.lang.String functionName, + boolean returnResult, + java.lang.Object[] values) 
      booleanisDead(long v8RuntimeHandle) 
      booleanisInUse(long v8RuntimeHandle) 
      booleanisWeak(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      booleanlockV8Runtime(long v8RuntimeHandle) 
      voidlowMemoryNotification(long v8RuntimeHandle) 
      java.lang.ObjectmoduleEvaluate(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + boolean resultRequired) 
      java.lang.ObjectmoduleGetException(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      java.lang.ObjectmoduleGetNamespace(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      intmoduleGetScriptId(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      intmoduleGetStatus(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      booleanmoduleInstantiate(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      java.lang.ObjectpromiseCatch(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + long v8ValueFunctionHandle) 
      java.lang.ObjectpromiseGetPromise(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      java.lang.ObjectpromiseGetResult(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      intpromiseGetState(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      booleanpromiseHasHandler(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      voidpromiseMarkAsHandled(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      booleanpromiseReject(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + java.lang.Object value) 
      booleanpromiseResolve(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + java.lang.Object value) 
      java.lang.ObjectpromiseThen(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + long v8ValueFunctionFulfilledHandle, + long v8ValueFunctionRejectedHandle) 
      java.lang.ObjectproxyGetHandler(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      java.lang.ObjectproxyGetTarget(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      booleanproxyIsRevoked(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      voidproxyRevoke(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      voidregisterV8Runtime(long v8RuntimeHandle, + java.lang.Object v8Runtime) 
      voidremoveJNIGlobalRef(long handle) 
      voidremoveReferenceHandle(long referenceHandle, + int referenceType) 
      voidrequestGarbageCollectionForTesting(long v8RuntimeHandle, + boolean fullGC) 
      voidresetV8Context(long v8RuntimeHandle, + java.lang.String globalName) 
      voidresetV8Isolate(long v8RuntimeHandle, + java.lang.String globalName) 
      booleansameValue(long v8RuntimeHandle, + long v8ValueHandle1, + long v8ValueHandle2) 
      java.lang.ObjectscriptRun(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + boolean resultRequired) 
      booleanset(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + java.lang.Object key, + java.lang.Object value) 
      booleansetAccessor(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + java.lang.Object propertyName, + java.lang.Object getter, + java.lang.Object setter) 
      voidsetFlags(java.lang.String flags) +
      Sets flags.
      +
      booleansetPrivateProperty(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + java.lang.String key, + java.lang.Object value) 
      booleansetProperty(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + java.lang.Object key, + java.lang.Object value) 
      booleansetPrototype(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + long v8ValueHandlePrototype) 
      booleansetSourceCode(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + java.lang.String sourceCode) 
      voidsetWeak(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType, + java.lang.Object objectReference) 
      booleanstrictEquals(long v8RuntimeHandle, + long v8ValueHandle1, + long v8ValueHandle2) 
      voidterminateExecution(long v8RuntimeHandle) 
      java.lang.StringtoProtoString(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      java.lang.StringtoString(long v8RuntimeHandle, + long v8ValueHandle, + int v8ValueType) 
      booleanunlockV8Runtime(long v8RuntimeHandle) 
      voidv8InspectorSend(long v8RuntimeHandle, + java.lang.String message) 
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        add

        +
        void add(long v8RuntimeHandle,
+         long v8ValueHandle,
+         int v8ValueType,
+         java.lang.Object value)
        +
        • +
      + + + +
        +
      • +

        allowCodeGenerationFromStrings

        +
        void allowCodeGenerationFromStrings(long v8RuntimeHandle,
+                                    boolean allow)
        +
        • +
      + + + +
        +
      • +

        await

        +
        void await(long v8RuntimeHandle)
        +
        • +
      + + + +
        +
      • +

        call

        +
        java.lang.Object call(long v8RuntimeHandle,
+                      long v8ValueHandle,
+                      int v8ValueType,
+                      java.lang.Object receiver,
+                      boolean returnResult,
+                      java.lang.Object[] values)
        +
        • +
      + + + +
        +
      • +

        callAsConstructor

        +
        java.lang.Object callAsConstructor(long v8RuntimeHandle,
+                                   long v8ValueHandle,
+                                   int v8ValueType,
+                                   java.lang.Object[] values)
        +
        • +
      + + + +
        +
      • +

        clearInternalStatistic

        +
        void clearInternalStatistic()
        +
        • +
      + + + +
        +
      • +

        clearWeak

        +
        void clearWeak(long v8RuntimeHandle,
+               long v8ValueHandle,
+               int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        cloneV8Value

        +
        java.lang.Object cloneV8Value(long v8RuntimeHandle,
+                              long v8ValueHandle,
+                              int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        closeV8Runtime

        +
        void closeV8Runtime(long v8RuntimeHandle)
        +
        • +
      + + + +
        +
      • +

        compile

        +
        java.lang.Object compile(long v8RuntimeHandle,
+                         java.lang.String script,
+                         boolean returnResult,
+                         java.lang.String resourceName,
+                         int resourceLineOffset,
+                         int resourceColumnOffset,
+                         int scriptId,
+                         boolean isWASM,
+                         boolean isModule)
        +
        • +
      + + + +
        +
      • +

        createV8Inspector

        +
        void createV8Inspector(long v8RuntimeHandle,
+                       java.lang.Object v8Inspector)
        +
        • +
      + + + +
        +
      • +

        createV8Runtime

        +
        long createV8Runtime(java.lang.String globalName)
        +
        • +
      + + + +
        +
      • +

        createV8Value

        +
        java.lang.Object createV8Value(long v8RuntimeHandle,
+                               int v8ValueType,
+                               java.lang.Object context)
        +
        • +
      + + + +
        +
      • +

        delete

        +
        boolean delete(long v8RuntimeHandle,
+               long v8ValueHandle,
+               int v8ValueType,
+               java.lang.Object key)
        +
        • +
      + + + +
        +
      • +

        deletePrivateProperty

        +
        boolean deletePrivateProperty(long v8RuntimeHandle,
+                              long v8ValueHandle,
+                              int v8ValueType,
+                              java.lang.String key)
        +
        • +
      + + + +
        +
      • +

        equals

        +
        boolean equals(long v8RuntimeHandle,
+               long v8ValueHandle1,
+               long v8ValueHandle2)
        +
        • +
      + + + +
        +
      • +

        execute

        +
        java.lang.Object execute(long v8RuntimeHandle,
+                         java.lang.String script,
+                         boolean returnResult,
+                         java.lang.String resourceName,
+                         int resourceLineOffset,
+                         int resourceColumnOffset,
+                         int scriptId,
+                         boolean isWASM,
+                         boolean isModule)
        +
        • +
      + + + +
        +
      • +

        get

        +
        java.lang.Object get(long v8RuntimeHandle,
+                     long v8ValueHandle,
+                     int v8ValueType,
+                     java.lang.Object key)
        +
        • +
      + + + +
        +
      • +

        getGlobalObject

        +
        java.lang.Object getGlobalObject(long v8RuntimeHandle)
        +
        • +
      + + + +
        +
      • +

        getIdentityHash

        +
        int getIdentityHash(long v8RuntimeHandle,
+                    long v8ValueHandle,
+                    int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        getInternalProperties

        +
        java.lang.Object getInternalProperties(long v8RuntimeHandle,
+                                       long v8ValueHandle,
+                                       int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        getInternalStatistic

        +
        long[] getInternalStatistic()
        +
        • +
      + + + +
        +
      • +

        getJSFunctionType

        +
        int getJSFunctionType(long v8RuntimeHandle,
+                      long v8ValueHandle,
+                      int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        getJSScopeType

        +
        int getJSScopeType(long v8RuntimeHandle,
+                   long v8ValueHandle,
+                   int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        getLength

        +
        int getLength(long v8RuntimeHandle,
+              long v8ValueHandle,
+              int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        getOwnPropertyNames

        +
        java.lang.Object getOwnPropertyNames(long v8RuntimeHandle,
+                                     long v8ValueHandle,
+                                     int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        getPrivateProperty

        +
        java.lang.Object getPrivateProperty(long v8RuntimeHandle,
+                                    long v8ValueHandle,
+                                    int v8ValueType,
+                                    java.lang.String propertyName)
        +
        • +
      + + + +
        +
      • +

        getProperty

        +
        java.lang.Object getProperty(long v8RuntimeHandle,
+                             long v8ValueHandle,
+                             int v8ValueType,
+                             java.lang.Object key)
        +
        • +
      + + + +
        +
      • +

        getPropertyNames

        +
        java.lang.Object getPropertyNames(long v8RuntimeHandle,
+                                  long v8ValueHandle,
+                                  int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        getPrototype

        +
        java.lang.Object getPrototype(long v8RuntimeHandle,
+                              long v8ValueHandle,
+                              int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        getSize

        +
        int getSize(long v8RuntimeHandle,
+            long v8ValueHandle,
+            int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        getSourceCode

        +
        java.lang.String getSourceCode(long v8RuntimeHandle,
+                               long v8ValueHandle,
+                               int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        getVersion

        +
        java.lang.String getVersion()
        +
        • +
      + + + +
        +
      • +

        has

        +
        boolean has(long v8RuntimeHandle,
+            long v8ValueHandle,
+            int v8ValueType,
+            java.lang.Object value)
        +
        • +
      + + + +
        +
      • +

        hasOwnProperty

        +
        boolean hasOwnProperty(long v8RuntimeHandle,
+                       long v8ValueHandle,
+                       int type,
+                       java.lang.Object key)
        +
        • +
      + + + +
        +
      • +

        hasPrivateProperty

        +
        boolean hasPrivateProperty(long v8RuntimeHandle,
+                           long v8ValueHandle,
+                           int type,
+                           java.lang.String propertyName)
        +
        • +
      + + + +
        +
      • +

        idleNotificationDeadline

        +
        void idleNotificationDeadline(long v8RuntimeHandle,
+                              long deadlineInMillis)
        +
        • +
      + + + +
        +
      • +

        invoke

        +
        java.lang.Object invoke(long v8RuntimeHandle,
+                        long v8ValueHandle,
+                        int v8ValueType,
+                        java.lang.String functionName,
+                        boolean returnResult,
+                        java.lang.Object[] values)
        +
        • +
      + + + +
        +
      • +

        isDead

        +
        boolean isDead(long v8RuntimeHandle)
        +
        • +
      + + + +
        +
      • +

        isInUse

        +
        boolean isInUse(long v8RuntimeHandle)
        +
        • +
      + + + +
        +
      • +

        isWeak

        +
        boolean isWeak(long v8RuntimeHandle,
+               long v8ValueHandle,
+               int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        lockV8Runtime

        +
        boolean lockV8Runtime(long v8RuntimeHandle)
        +
        • +
      + + + +
        +
      • +

        lowMemoryNotification

        +
        void lowMemoryNotification(long v8RuntimeHandle)
        +
        • +
      + + + +
        +
      • +

        moduleEvaluate

        +
        java.lang.Object moduleEvaluate(long v8RuntimeHandle,
+                                long v8ValueHandle,
+                                int v8ValueType,
+                                boolean resultRequired)
        +
        • +
      + + + +
        +
      • +

        moduleGetException

        +
        java.lang.Object moduleGetException(long v8RuntimeHandle,
+                                    long v8ValueHandle,
+                                    int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        moduleGetNamespace

        +
        java.lang.Object moduleGetNamespace(long v8RuntimeHandle,
+                                    long v8ValueHandle,
+                                    int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        moduleGetScriptId

        +
        int moduleGetScriptId(long v8RuntimeHandle,
+                      long v8ValueHandle,
+                      int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        moduleGetStatus

        +
        int moduleGetStatus(long v8RuntimeHandle,
+                    long v8ValueHandle,
+                    int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        moduleInstantiate

        +
        boolean moduleInstantiate(long v8RuntimeHandle,
+                          long v8ValueHandle,
+                          int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        promiseCatch

        +
        java.lang.Object promiseCatch(long v8RuntimeHandle,
+                              long v8ValueHandle,
+                              int v8ValueType,
+                              long v8ValueFunctionHandle)
        +
        • +
      + + + +
        +
      • +

        promiseGetPromise

        +
        java.lang.Object promiseGetPromise(long v8RuntimeHandle,
+                                   long v8ValueHandle,
+                                   int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        promiseGetResult

        +
        java.lang.Object promiseGetResult(long v8RuntimeHandle,
+                                  long v8ValueHandle,
+                                  int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        promiseGetState

        +
        int promiseGetState(long v8RuntimeHandle,
+                    long v8ValueHandle,
+                    int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        promiseHasHandler

        +
        boolean promiseHasHandler(long v8RuntimeHandle,
+                          long v8ValueHandle,
+                          int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        promiseMarkAsHandled

        +
        void promiseMarkAsHandled(long v8RuntimeHandle,
+                          long v8ValueHandle,
+                          int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        promiseReject

        +
        boolean promiseReject(long v8RuntimeHandle,
+                      long v8ValueHandle,
+                      int v8ValueType,
+                      java.lang.Object value)
        +
        • +
      + + + +
        +
      • +

        promiseResolve

        +
        boolean promiseResolve(long v8RuntimeHandle,
+                       long v8ValueHandle,
+                       int v8ValueType,
+                       java.lang.Object value)
        +
        • +
      + + + +
        +
      • +

        promiseThen

        +
        java.lang.Object promiseThen(long v8RuntimeHandle,
+                             long v8ValueHandle,
+                             int v8ValueType,
+                             long v8ValueFunctionFulfilledHandle,
+                             long v8ValueFunctionRejectedHandle)
        +
        • +
      + + + +
        +
      • +

        proxyGetHandler

        +
        java.lang.Object proxyGetHandler(long v8RuntimeHandle,
+                                 long v8ValueHandle,
+                                 int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        proxyGetTarget

        +
        java.lang.Object proxyGetTarget(long v8RuntimeHandle,
+                                long v8ValueHandle,
+                                int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        proxyIsRevoked

        +
        boolean proxyIsRevoked(long v8RuntimeHandle,
+                       long v8ValueHandle,
+                       int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        proxyRevoke

        +
        void proxyRevoke(long v8RuntimeHandle,
+                 long v8ValueHandle,
+                 int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        registerV8Runtime

        +
        void registerV8Runtime(long v8RuntimeHandle,
+                       java.lang.Object v8Runtime)
        +
        • +
      + + + +
        +
      • +

        removeJNIGlobalRef

        +
        void removeJNIGlobalRef(long handle)
        +
        • +
      + + + +
        +
      • +

        removeReferenceHandle

        +
        void removeReferenceHandle(long referenceHandle,
+                           int referenceType)
        +
        • +
      + + + +
        +
      • +

        requestGarbageCollectionForTesting

        +
        void requestGarbageCollectionForTesting(long v8RuntimeHandle,
+                                        boolean fullGC)
        +
        • +
      + + + +
        +
      • +

        resetV8Context

        +
        void resetV8Context(long v8RuntimeHandle,
+                    java.lang.String globalName)
        +
        • +
      + + + +
        +
      • +

        resetV8Isolate

        +
        void resetV8Isolate(long v8RuntimeHandle,
+                    java.lang.String globalName)
        +
        • +
      + + + +
        +
      • +

        sameValue

        +
        boolean sameValue(long v8RuntimeHandle,
+                  long v8ValueHandle1,
+                  long v8ValueHandle2)
        +
        • +
      + + + +
        +
      • +

        scriptRun

        +
        java.lang.Object scriptRun(long v8RuntimeHandle,
+                           long v8ValueHandle,
+                           int v8ValueType,
+                           boolean resultRequired)
        +
        • +
      + + + +
        +
      • +

        set

        +
        boolean set(long v8RuntimeHandle,
+            long v8ValueHandle,
+            int v8ValueType,
+            java.lang.Object key,
+            java.lang.Object value)
        +
        • +
      + + + +
        +
      • +

        setAccessor

        +
        boolean setAccessor(long v8RuntimeHandle,
+                    long v8ValueHandle,
+                    int v8ValueType,
+                    java.lang.Object propertyName,
+                    java.lang.Object getter,
+                    java.lang.Object setter)
        +
        • +
      + + + +
        +
      • +

        setFlags

        +
        void setFlags(java.lang.String flags)
        +
        Sets flags. +

        + Famous flags: + --use_strict type: bool default: false

        +
        +
        Parameters:
        +
        flags - the flags
        +
        +
        • +
      + + + +
        +
      • +

        setPrivateProperty

        +
        boolean setPrivateProperty(long v8RuntimeHandle,
+                           long v8ValueHandle,
+                           int v8ValueType,
+                           java.lang.String key,
+                           java.lang.Object value)
        +
        • +
      + + + +
        +
      • +

        setProperty

        +
        boolean setProperty(long v8RuntimeHandle,
+                    long v8ValueHandle,
+                    int v8ValueType,
+                    java.lang.Object key,
+                    java.lang.Object value)
        +
        • +
      + + + +
        +
      • +

        setPrototype

        +
        boolean setPrototype(long v8RuntimeHandle,
+                     long v8ValueHandle,
+                     int v8ValueType,
+                     long v8ValueHandlePrototype)
        +
        • +
      + + + +
        +
      • +

        setSourceCode

        +
        boolean setSourceCode(long v8RuntimeHandle,
+                      long v8ValueHandle,
+                      int v8ValueType,
+                      java.lang.String sourceCode)
        +
        • +
      + + + +
        +
      • +

        setWeak

        +
        void setWeak(long v8RuntimeHandle,
+             long v8ValueHandle,
+             int v8ValueType,
+             java.lang.Object objectReference)
        +
        • +
      + + + +
        +
      • +

        strictEquals

        +
        boolean strictEquals(long v8RuntimeHandle,
+                     long v8ValueHandle1,
+                     long v8ValueHandle2)
        +
        • +
      + + + +
        +
      • +

        terminateExecution

        +
        void terminateExecution(long v8RuntimeHandle)
        +
        • +
      + + + +
        +
      • +

        toProtoString

        +
        java.lang.String toProtoString(long v8RuntimeHandle,
+                               long v8ValueHandle,
+                               int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        toString

        +
        java.lang.String toString(long v8RuntimeHandle,
+                          long v8ValueHandle,
+                          int v8ValueType)
        +
        • +
      + + + +
        +
      • +

        unlockV8Runtime

        +
        boolean unlockV8Runtime(long v8RuntimeHandle)
        +
        • +
      + + + +
        +
      • +

        v8InspectorSend

        +
        void v8InspectorSend(long v8RuntimeHandle,
+                     java.lang.String message)
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/JavetLibLoader.html b/docs/reference/javadoc/com/caoccao/javet/interop/JavetLibLoader.html new file mode 100644 index 000000000..a881aed0b --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/JavetLibLoader.html @@ -0,0 +1,319 @@ + + + + + +JavetLibLoader (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.interop
+

Class JavetLibLoader

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.JavetLibLoader
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public final class JavetLibLoader
+extends java.lang.Object
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetLibLoader

        +
        public JavetLibLoader(JSRuntimeType jsRuntimeType)
        +
        • +
      +
      • +
    + + +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/NodeRuntime.html b/docs/reference/javadoc/com/caoccao/javet/interop/NodeRuntime.html new file mode 100644 index 000000000..fa264148a --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/NodeRuntime.html @@ -0,0 +1,467 @@ + + + + + +NodeRuntime (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.interop
+

Class NodeRuntime

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/V8Flags.html b/docs/reference/javadoc/com/caoccao/javet/interop/V8Flags.html new file mode 100644 index 000000000..fb5f6d8e1 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/V8Flags.html @@ -0,0 +1,377 @@ + + + + + +V8Flags (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interop
+

Class V8Flags

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.V8Flags
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public final class V8Flags
+extends java.lang.Object
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        isAllowNativesSyntax

        +
        public boolean isAllowNativesSyntax()
        +
        • +
      + + + +
        +
      • +

        isExposeGC

        +
        public boolean isExposeGC()
        +
        • +
      + + + +
        +
      • +

        isExposeInspectorScripts

        +
        public boolean isExposeInspectorScripts()
        +
        • +
      + + + +
        +
      • +

        isSealed

        +
        public boolean isSealed()
        +
        • +
      + + + +
        +
      • +

        isTrackRetainingPath

        +
        public boolean isTrackRetainingPath()
        +
        • +
      + + + +
        +
      • +

        isUseStrict

        +
        public boolean isUseStrict()
        +
        • +
      + + + +
        +
      • +

        seal

        +
        public void seal()
        +
        • +
      + + + +
        +
      • +

        setAllowNativesSyntax

        +
        public void setAllowNativesSyntax(boolean allowNativesSyntax)
        +
        • +
      + + + +
        +
      • +

        setExposeGC

        +
        public void setExposeGC(boolean exposeGC)
        +
        • +
      + + + +
        +
      • +

        setExposeInspectorScripts

        +
        public void setExposeInspectorScripts(boolean exposeInspectorScripts)
        +
        • +
      + + + +
        +
      • +

        setTrackRetainingPath

        +
        public void setTrackRetainingPath(boolean trackRetainingPath)
        +
        • +
      + + + +
        +
      • +

        setUseStrict

        +
        public void setUseStrict(boolean useStrict)
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/V8Host.html b/docs/reference/javadoc/com/caoccao/javet/interop/V8Host.html new file mode 100644 index 000000000..22d3881cb --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/V8Host.html @@ -0,0 +1,891 @@ + + + + + +V8Host (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.interop
+

Class V8Host

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.V8Host
      • +
    +
    • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    java.lang.AutoCloseable
    +
    +
    +
    +
    public final class V8Host
+extends java.lang.Object
+implements java.lang.AutoCloseable
    +
    The type V8 host.
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        GLOBAL_THIS

        +
        public static final java.lang.String GLOBAL_THIS
        +
        The constant GLOBAL_THIS.
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getInstance

        +
        public static V8Host getInstance(JSRuntimeType jsRuntimeType)
        +
        Gets instance by JS runtime type.
        +
        +
        Parameters:
        +
        jsRuntimeType - the JS runtime type
        +
        Returns:
        +
        the instance
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getMemoryUsageThresholdRatio

        +
        public static double getMemoryUsageThresholdRatio()
        +
        Gets memory usage threshold ratio.
        +
        +
        Returns:
        +
        the memory usage threshold ratio
        +
        Since:
        +
        0.8.3
        +
        +
        • +
      + + + +
        +
      • +

        getNodeInstance

        +
        public static V8Host getNodeInstance()
        +
        Gets Node instance. +

        + Note: Node runtime library is loaded by a custom class loader.

        +
        +
        Returns:
        +
        the Node instance
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        getV8Instance

        +
        public static V8Host getV8Instance()
        +
        Gets V8 instance. +

        + Note: V8 runtime library is loaded by a custom class loader.

        +
        +
        Returns:
        +
        the V8 instance
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        isLibraryReloadable

        +
        public static boolean isLibraryReloadable()
        +
        Determines whether the JNI library is reloadable or not.
        +
        +
        Returns:
        +
        true: reloadable, false: not reloadable, default: false
        +
        Since:
        +
        0.9.1
        +
        +
        • +
      + + + +
        +
      • +

        setLibraryReloadable

        +
        public static void setLibraryReloadable(boolean libraryReloadable)
        +
        Sets whether the JNI library is reloadable or not.
        +
        +
        Parameters:
        +
        libraryReloadable - true: reloadable, false: not reloadable
        +
        Since:
        +
        0.9.1
        +
        +
        • +
      + + + +
        +
      • +

        setMemoryUsageThresholdRatio

        +
        public static void setMemoryUsageThresholdRatio(double memoryUsageThresholdRatio)
        +
        Sets memory usage threshold ratio. +

        + This manageable usage threshold attribute is designed for monitoring + the increasing trend of memory usage with low overhead.

        +
        +
        Parameters:
        +
        memoryUsageThresholdRatio - the memory usage threshold ratio
        +
        Since:
        +
        0.8.3
        +
        +
        • +
      + + + +
        +
      • +

        clearInternalStatistic

        +
        public void clearInternalStatistic()
        +
        Clear internal statistic for internal test purpose.
        +
        • +
      + + + +
        +
      • +

        close

        +
        public void close()
+           throws JavetException
        +
        +
        Specified by:
        +
        close in interface java.lang.AutoCloseable
        +
        Throws:
        +
        JavetException
        +
        +
        • +
      + + + +
        +
      • +

        closeV8Runtime

        +
        public void closeV8Runtime(V8Runtime v8Runtime)
        +
        Close V8 runtime.
        +
        +
        Parameters:
        +
        v8Runtime - the V8 runtime
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        createV8Runtime

        +
        public <R extends V8Runtime> R createV8Runtime()
+                                        throws JavetException
        +
        Create V8 runtime.
        +
        +
        Type Parameters:
        +
        R - the type parameter
        +
        Returns:
        +
        the V8 runtime
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        createV8Runtime

        +
        public <R extends V8Runtime> R createV8Runtime(java.lang.String globalName)
+                                        throws JavetException
        +
        Create V8 runtime.
        +
        +
        Type Parameters:
        +
        R - the type parameter
        +
        Parameters:
        +
        globalName - the global name
        +
        Returns:
        +
        the V8 runtime
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        createV8Runtime

        +
        public <R extends V8Runtime> R createV8Runtime(boolean pooled,
+                                               java.lang.String globalName)
+                                        throws JavetException
        +
        Create V8 runtime.
        +
        +
        Type Parameters:
        +
        R - the type parameter
        +
        Parameters:
        +
        pooled - the pooled
        +
        globalName - the global name
        +
        Returns:
        +
        the V8 runtime
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        disableGCNotification

        +
        public V8Host disableGCNotification()
        +
        Disable GC notification.
        +
        +
        Returns:
        +
        the self
        +
        Since:
        +
        0.8.3
        +
        +
        • +
      + + + +
        +
      • +

        enableGCNotification

        +
        public V8Host enableGCNotification()
        +
        Enable GC notification.
        +
        +
        Returns:
        +
        the self
        +
        Since:
        +
        0.8.3
        +
        +
        • +
      + + + +
        +
      • +

        getFlags

        +
        public V8Flags getFlags()
        +
        Gets flags.
        +
        +
        Returns:
        +
        the flags
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getInternalStatistic

        +
        public long[] getInternalStatistic()
        +
        Get internal statistic internal for test purpose.
        +
        +
        Returns:
        +
        the long [ ]
        +
        Since:
        +
        0.8.3
        +
        +
        • +
      + + + +
        +
      • +

        getJSRuntimeType

        +
        public JSRuntimeType getJSRuntimeType()
        +
        Gets JS runtime type.
        +
        +
        Returns:
        +
        the JS runtime type
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        getJavetVersion

        +
        public java.lang.String getJavetVersion()
        +
        Gets javet version.
        +
        +
        Returns:
        +
        the javet version
        +
        Since:
        +
        0.7.1
        +
        +
        • +
      + + + +
        +
      • +

        getLastException

        +
        public JavetException getLastException()
        +
        Gets last exception.
        +
        +
        Returns:
        +
        the last exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getLogger

        +
        public IJavetLogger getLogger()
        +
        Gets logger.
        +
        +
        Returns:
        +
        the logger
        +
        Since:
        +
        0.7.3
        +
        +
        • +
      + + + +
        +
      • +

        getV8RuntimeCount

        +
        public int getV8RuntimeCount()
        +
        Gets V8 runtime count.
        +
        +
        Returns:
        +
        the V8 runtime count
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        isIsolateCreated

        +
        public boolean isIsolateCreated()
        +
        Is isolate created.
        +
        +
        Returns:
        +
        true: created, false: not created
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        isLibraryLoaded

        +
        public boolean isLibraryLoaded()
        +
        Is library loaded.
        +
        +
        Returns:
        +
        true: loaded, false: not loaded
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        loadLibrary

        +
        public boolean loadLibrary()
        +
        Load library. +

        + Note: setLibraryReloadable(true) must be called, otherwise, JVM will crash.

        +
        +
        Returns:
        +
        true: library is loaded, false: library is not loaded
        +
        Since:
        +
        0.9.1
        +
        +
        • +
      + + + +
        +
      • +

        setFlags

        +
        public boolean setFlags()
        +
        Sets flags.
        +
        +
        Returns:
        +
        true: flags are set, false: flags are not set
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        unloadLibrary

        +
        public boolean unloadLibrary()
        +
        Unload library. +

        + Note: setLibraryReloadable(true) must be called, otherwise, JVM will crash.

        +
        +
        Returns:
        +
        true: library is unloaded, false: library is loaded
        +
        Since:
        +
        0.9.1
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/V8Inspector.html b/docs/reference/javadoc/com/caoccao/javet/interop/V8Inspector.html new file mode 100644 index 000000000..7befcb18e --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/V8Inspector.html @@ -0,0 +1,356 @@ + + + + + +V8Inspector (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interop
+

Class V8Inspector

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.V8Inspector
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public final class V8Inspector
+extends java.lang.Object
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + + + + + +
        +
      • +

        flushProtocolNotifications

        +
        public void flushProtocolNotifications()
        +
        • +
      + + + + + + + +
        +
      • +

        getName

        +
        public java.lang.String getName()
        +
        • +
      + + + +
        +
      • +

        receiveNotification

        +
        public void receiveNotification(java.lang.String message)
        +
        • +
      + + + +
        +
      • +

        receiveResponse

        +
        public void receiveResponse(java.lang.String message)
        +
        • +
      + + + + + + + +
        +
      • +

        runIfWaitingForDebugger

        +
        public void runIfWaitingForDebugger(int contextGroupId)
        +
        • +
      + + + + + + + +
        +
      • +

        setLogger

        +
        public void setLogger(IJavetLogger logger)
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/V8Locker.html b/docs/reference/javadoc/com/caoccao/javet/interop/V8Locker.html new file mode 100644 index 000000000..bb47e0b3c --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/V8Locker.html @@ -0,0 +1,299 @@ + + + + + +V8Locker (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interop
+

Class V8Locker

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.V8Locker
      • +
    +
    • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    IJavetClosable, java.lang.AutoCloseable
    +
    +
    +
    +
    public final class V8Locker
+extends java.lang.Object
+implements IJavetClosable
    +
    The type V8 locker. + It's designed for performance sensitive scenarios.
    +
    +
    Since:
    +
    0.7.3
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + +
      All Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      voidclose() 
      booleanisClosed() +
      Is closed.
      +
      booleanisLocked() +
      Is locked.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + + + + + +
        +
      • +

        isClosed

        +
        public boolean isClosed()
        +
        Description copied from interface: IJavetClosable
        +
        Is closed.
        +
        +
        Specified by:
        +
        isClosed in interface IJavetClosable
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      + + + +
        +
      • +

        isLocked

        +
        public boolean isLocked()
        +
        Is locked.
        +
        +
        Returns:
        +
        the boolean
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/V8Notifier.html b/docs/reference/javadoc/com/caoccao/javet/interop/V8Notifier.html new file mode 100644 index 000000000..97744252d --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/V8Notifier.html @@ -0,0 +1,305 @@ + + + + + +V8Notifier (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.interop
+

Class V8Notifier

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.V8Notifier
      • +
    +
    • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    java.util.EventListener, javax.management.NotificationListener
    +
    +
    +
    +
    public final class V8Notifier
+extends java.lang.Object
+implements javax.management.NotificationListener
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + +
      Constructors 
      Constructor and Description
      V8Notifier(java.util.concurrent.ConcurrentHashMap<java.lang.Long,V8Runtime> v8RuntimeMap) 
      +
      • +
    + + +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        V8Notifier

        +
        public V8Notifier(java.util.concurrent.ConcurrentHashMap<java.lang.Long,V8Runtime> v8RuntimeMap)
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        handleNotification

        +
        public void handleNotification(javax.management.Notification notification,
+                               java.lang.Object handback)
        +
        +
        Specified by:
        +
        handleNotification in interface javax.management.NotificationListener
        +
        +
        • +
      + + + +
        +
      • +

        registerListeners

        +
        public void registerListeners()
        +
        • +
      + + + +
        +
      • +

        unregisterListener

        +
        public void unregisterListener()
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/V8Runtime.html b/docs/reference/javadoc/com/caoccao/javet/interop/V8Runtime.html new file mode 100644 index 000000000..b5a13361e --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/V8Runtime.html @@ -0,0 +1,3330 @@ + + + + + +V8Runtime (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.interop
+

Class V8Runtime

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.V8Runtime
      • +
    +
    • +
+
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/V8ScriptOrigin.html b/docs/reference/javadoc/com/caoccao/javet/interop/V8ScriptOrigin.html new file mode 100644 index 000000000..365b34b78 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/V8ScriptOrigin.html @@ -0,0 +1,475 @@ + + + + + +V8ScriptOrigin (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.interop
+

Class V8ScriptOrigin

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.V8ScriptOrigin
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public final class V8ScriptOrigin
+extends java.lang.Object
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        V8ScriptOrigin

        +
        public V8ScriptOrigin(java.lang.String resourceName,
+                      int resourceLineOffset,
+                      int resourceColumnOffset,
+                      int scriptId,
+                      boolean wasm,
+                      boolean module)
        +
        • +
      + + + +
        +
      • +

        V8ScriptOrigin

        +
        public V8ScriptOrigin()
        +
        • +
      + + + +
        +
      • +

        V8ScriptOrigin

        +
        public V8ScriptOrigin(java.lang.String resourceName)
        +
        • +
      + + + +
        +
      • +

        V8ScriptOrigin

        +
        public V8ScriptOrigin(java.lang.String resourceName,
+                      int resourceLineOffset,
+                      int resourceColumnOffset)
        +
        • +
      + + + +
        +
      • +

        V8ScriptOrigin

        +
        public V8ScriptOrigin(java.lang.String resourceName,
+                      int scriptId)
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getResourceColumnOffset

        +
        public int getResourceColumnOffset()
        +
        • +
      + + + +
        +
      • +

        getResourceLineOffset

        +
        public int getResourceLineOffset()
        +
        • +
      + + + +
        +
      • +

        getResourceName

        +
        public java.lang.String getResourceName()
        +
        • +
      + + + +
        +
      • +

        getScriptId

        +
        public int getScriptId()
        +
        • +
      + + + +
        +
      • +

        isModule

        +
        public boolean isModule()
        +
        • +
      + + + +
        +
      • +

        isWasm

        +
        public boolean isWasm()
        +
        • +
      + + + + + + + +
        +
      • +

        setResourceColumnOffset

        +
        public V8ScriptOrigin setResourceColumnOffset(int resourceColumnOffset)
        +
        • +
      + + + +
        +
      • +

        setResourceLineOffset

        +
        public V8ScriptOrigin setResourceLineOffset(int resourceLineOffset)
        +
        • +
      + + + +
        +
      • +

        setResourceName

        +
        public V8ScriptOrigin setResourceName(java.lang.String resourceName)
        +
        • +
      + + + +
        +
      • +

        setScriptId

        +
        public V8ScriptOrigin setScriptId(int scriptId)
        +
        • +
      + + + + +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/binding/BindingContext.html b/docs/reference/javadoc/com/caoccao/javet/interop/binding/BindingContext.html new file mode 100644 index 000000000..26350ee82 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/binding/BindingContext.html @@ -0,0 +1,544 @@ + + + + + +BindingContext (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interop.binding
+

Class BindingContext

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.binding.BindingContext
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public class BindingContext
+extends java.lang.Object
    +
    The type Binding context.
    +
    +
    Since:
    +
    0.9.2
    +
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        functionMap

        +
        protected java.util.Map<java.lang.String,MethodDescriptor> functionMap
        +
        The Function map.
        +
        +
        Since:
        +
        0.9.2
        +
        +
        • +
      + + + +
        +
      • +

        propertyGetterMap

        +
        protected java.util.Map<java.lang.String,MethodDescriptor> propertyGetterMap
        +
        The Property getter map.
        +
        +
        Since:
        +
        0.9.2
        +
        +
        • +
      + + + +
        +
      • +

        propertySetterMap

        +
        protected java.util.Map<java.lang.String,MethodDescriptor> propertySetterMap
        +
        The Property setter map.
        +
        +
        Since:
        +
        0.9.2
        +
        +
        • +
      + + + +
        +
      • +

        v8BindEnabler

        +
        protected java.lang.reflect.Method v8BindEnabler
        +
        The V8 bind enabler.
        +
        +
        Since:
        +
        0.9.3
        +
        +
        • +
      + + + +
        +
      • +

        v8RuntimeSetter

        +
        protected java.lang.reflect.Method v8RuntimeSetter
        +
        The V8 runtime setter.
        +
        +
        Since:
        +
        0.9.2
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        BindingContext

        +
        public BindingContext()
        +
        Instantiates a new Binding context.
        +
        +
        Since:
        +
        0.9.2
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getFunctionMap

        +
        public java.util.Map<java.lang.String,MethodDescriptor> getFunctionMap()
        +
        Gets function map.
        +
        +
        Returns:
        +
        the function map
        +
        Since:
        +
        0.9.2
        +
        +
        • +
      + + + +
        +
      • +

        getPropertyGetterMap

        +
        public java.util.Map<java.lang.String,MethodDescriptor> getPropertyGetterMap()
        +
        Gets property getter map.
        +
        +
        Returns:
        +
        the property getter map
        +
        Since:
        +
        0.9.2
        +
        +
        • +
      + + + +
        +
      • +

        getPropertySetterMap

        +
        public java.util.Map<java.lang.String,MethodDescriptor> getPropertySetterMap()
        +
        Gets property setter map.
        +
        +
        Returns:
        +
        the property setter map
        +
        Since:
        +
        0.9.2
        +
        +
        • +
      + + + +
        +
      • +

        getV8BindEnabler

        +
        public java.lang.reflect.Method getV8BindEnabler()
        +
        Gets V8 bind enabler.
        +
        +
        Returns:
        +
        the V8 bind enabler
        +
        Since:
        +
        0.9.3
        +
        +
        • +
      + + + +
        +
      • +

        getV8RuntimeSetter

        +
        public java.lang.reflect.Method getV8RuntimeSetter()
        +
        Gets V8 runtime setter.
        +
        +
        Returns:
        +
        the V8 runtime setter
        +
        Since:
        +
        0.9.2
        +
        +
        • +
      + + + +
        +
      • +

        setV8BindEnabler

        +
        public void setV8BindEnabler(java.lang.reflect.Method v8BindEnabler)
        +
        Sets V8 bind enabler.
        +
        +
        Parameters:
        +
        v8BindEnabler - the V8 bind enabler
        +
        Since:
        +
        0.9.3
        +
        +
        • +
      + + + +
        +
      • +

        setV8RuntimeSetter

        +
        public void setV8RuntimeSetter(java.lang.reflect.Method v8RuntimeSetter)
        +
        Sets V8 runtime setter.
        +
        +
        Parameters:
        +
        v8RuntimeSetter - the V8 runtime setter
        +
        Since:
        +
        0.9.2
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/binding/MethodDescriptor.html b/docs/reference/javadoc/com/caoccao/javet/interop/binding/MethodDescriptor.html new file mode 100644 index 000000000..48b1ccf56 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/binding/MethodDescriptor.html @@ -0,0 +1,448 @@ + + + + + +MethodDescriptor (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interop.binding
+

Class MethodDescriptor

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.binding.MethodDescriptor
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public class MethodDescriptor
+extends java.lang.Object
    +
    The type Method descriptor.
    +
    +
    Since:
    +
    0.9.2
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Summary

      + + + + + + + + + + + + + + + + + + +
      Fields 
      Modifier and TypeField and Description
      protected java.lang.reflect.Methodmethod +
      The Method.
      +
      protected V8ValueSymbolTypesymbolType +
      The Symbol type.
      +
      protected booleanthisObjectRequired +
      The This object required.
      +
      +
      • +
    + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + + + + +
      Constructors 
      Constructor and Description
      MethodDescriptor(java.lang.reflect.Method method, + boolean thisObjectRequired) +
      Instantiates a new Method descriptor.
      +
      MethodDescriptor(java.lang.reflect.Method method, + boolean thisObjectRequired, + V8ValueSymbolType symbolType) +
      Instantiates a new Method descriptor.
      +
      +
      • +
    + + +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        method

        +
        protected java.lang.reflect.Method method
        +
        The Method.
        +
        +
        Since:
        +
        0.9.2
        +
        +
        • +
      + + + +
        +
      • +

        symbolType

        +
        protected V8ValueSymbolType symbolType
        +
        The Symbol type.
        +
        +
        Since:
        +
        0.9.11
        +
        +
        • +
      + + + +
        +
      • +

        thisObjectRequired

        +
        protected boolean thisObjectRequired
        +
        The This object required.
        +
        +
        Since:
        +
        0.9.2
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        MethodDescriptor

        +
        public MethodDescriptor(java.lang.reflect.Method method,
+                        boolean thisObjectRequired)
        +
        Instantiates a new Method descriptor.
        +
        +
        Parameters:
        +
        method - the method
        +
        thisObjectRequired - the this object required
        +
        Since:
        +
        0.9.2
        +
        +
        • +
      + + + +
        +
      • +

        MethodDescriptor

        +
        public MethodDescriptor(java.lang.reflect.Method method,
+                        boolean thisObjectRequired,
+                        V8ValueSymbolType symbolType)
        +
        Instantiates a new Method descriptor.
        +
        +
        Parameters:
        +
        method - the method
        +
        thisObjectRequired - the this object required
        +
        symbolType - the symbol type
        +
        Since:
        +
        0.9.11
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getMethod

        +
        public java.lang.reflect.Method getMethod()
        +
        Gets method.
        +
        +
        Returns:
        +
        the method
        +
        Since:
        +
        0.9.2
        +
        +
        • +
      + + + +
        +
      • +

        getSymbolType

        +
        public V8ValueSymbolType getSymbolType()
        +
        Gets symbol type.
        +
        +
        Returns:
        +
        the symbol type
        +
        Since:
        +
        0.9.11
        +
        +
        • +
      + + + +
        +
      • +

        isThisObjectRequired

        +
        public boolean isThisObjectRequired()
        +
        Is this object required boolean.
        +
        +
        Returns:
        +
        the boolean
        +
        Since:
        +
        0.9.2
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/binding/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/interop/binding/package-frame.html new file mode 100644 index 000000000..6165aacb8 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/binding/package-frame.html @@ -0,0 +1,20 @@ + + + + + +com.caoccao.javet.interop.binding (javet 0.9.12 API) + + + + +

com.caoccao.javet.interop.binding

+
+

Classes

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/binding/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/interop/binding/package-summary.html new file mode 100644 index 000000000..7643b4059 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/binding/package-summary.html @@ -0,0 +1,160 @@ + + + + + +com.caoccao.javet.interop.binding (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.interop.binding

+
+
Callback data structure for binding context and method descriptor.
+
+

See: Description

+
+
+
    +
  • + + + + + + + + + + + + + + + + +
    Class Summary 
    ClassDescription
    BindingContext +
    The type Binding context.
    +
    MethodDescriptor +
    The type Method descriptor.
    +
    +
    • +
+ + + +

Package com.caoccao.javet.interop.binding Description

+
Callback data structure for binding context and method descriptor.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/binding/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/interop/binding/package-tree.html new file mode 100644 index 000000000..11ce23ca1 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/binding/package-tree.html @@ -0,0 +1,135 @@ + + + + + +com.caoccao.javet.interop.binding Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.interop.binding

+Package Hierarchies: + +
+
+

Class Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/callback/JavetCallbackContext.html b/docs/reference/javadoc/com/caoccao/javet/interop/callback/JavetCallbackContext.html new file mode 100644 index 000000000..62a663f91 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/callback/JavetCallbackContext.html @@ -0,0 +1,496 @@ + + + + + +JavetCallbackContext (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interop.callback
+

Class JavetCallbackContext

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.callback.JavetCallbackContext
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public final class JavetCallbackContext
+extends java.lang.Object
    +
    The type Javet callback context.
    +
    +
    Since:
    +
    0.7.1
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Summary

      + + + + + + + + + + +
      Fields 
      Modifier and TypeField and Description
      static longINVALID_HANDLE +
      The constant INVALID_HANDLE.
      +
      +
      • +
    + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + + + + +
      Constructors 
      Constructor and Description
      JavetCallbackContext(java.lang.Object callbackReceiver, + java.lang.reflect.Method callbackMethod) +
      Instantiates a new Javet callback context.
      +
      JavetCallbackContext(java.lang.Object callbackReceiver, + java.lang.reflect.Method callbackMethod, + boolean thisObjectRequired) +
      Instantiates a new Javet callback context.
      +
      +
      • +
    + + +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        INVALID_HANDLE

        +
        public static final long INVALID_HANDLE
        +
        The constant INVALID_HANDLE.
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetCallbackContext

        +
        public JavetCallbackContext(java.lang.Object callbackReceiver,
+                            java.lang.reflect.Method callbackMethod)
        +
        Instantiates a new Javet callback context.
        +
        +
        Parameters:
        +
        callbackReceiver - the callback receiver
        +
        callbackMethod - the callback method
        +
        Since:
        +
        0.7.1
        +
        +
        • +
      + + + +
        +
      • +

        JavetCallbackContext

        +
        public JavetCallbackContext(java.lang.Object callbackReceiver,
+                            java.lang.reflect.Method callbackMethod,
+                            boolean thisObjectRequired)
        +
        Instantiates a new Javet callback context.
        +
        +
        Parameters:
        +
        callbackReceiver - the callback receiver
        +
        callbackMethod - the callback method
        +
        thisObjectRequired - the this object required
        +
        Since:
        +
        0.7.1
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getCallbackMethod

        +
        public java.lang.reflect.Method getCallbackMethod()
        +
        Gets callback method.
        +
        +
        Returns:
        +
        the callback method
        +
        Since:
        +
        0.9.1
        +
        +
        • +
      + + + +
        +
      • +

        getCallbackReceiver

        +
        public java.lang.Object getCallbackReceiver()
        +
        Gets callback receiver.
        +
        +
        Returns:
        +
        the callback receiver
        +
        Since:
        +
        0.7.1
        +
        +
        • +
      + + + +
        +
      • +

        getHandle

        +
        public long getHandle()
        +
        Gets handle.
        +
        +
        Returns:
        +
        the handle
        +
        Since:
        +
        0.7.1
        +
        +
        • +
      + + + +
        +
      • +

        isReturnResult

        +
        public boolean isReturnResult()
        +
        Is return result.
        +
        +
        Returns:
        +
        the boolean
        +
        Since:
        +
        0.9.1
        +
        +
        • +
      + + + +
        +
      • +

        isThisObjectRequired

        +
        public boolean isThisObjectRequired()
        +
        Is this object required.
        +
        +
        Returns:
        +
        the boolean
        +
        Since:
        +
        0.9.1
        +
        +
        • +
      + + + +
        +
      • +

        isValid

        +
        public boolean isValid()
        +
        Is valid.
        +
        +
        Returns:
        +
        the boolean
        +
        Since:
        +
        0.9.11
        +
        +
        • +
      + + + +
        +
      • +

        setHandle

        +
        public void setHandle(long handle)
        +
        Sets handle.
        +
        +
        Parameters:
        +
        handle - the handle
        +
        Since:
        +
        0.7.1
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/callback/V8FunctionCallback.html b/docs/reference/javadoc/com/caoccao/javet/interop/callback/V8FunctionCallback.html new file mode 100644 index 000000000..7ce32a0ee --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/callback/V8FunctionCallback.html @@ -0,0 +1,296 @@ + + + + + +V8FunctionCallback (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.interop.callback
+

Class V8FunctionCallback

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.callback.V8FunctionCallback
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public final class V8FunctionCallback
+extends java.lang.Object
    +
    The type V8 function callback.
    +
    +
    Since:
    +
    0.8.3
    +
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        V8FunctionCallback

        +
        public V8FunctionCallback()
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        receiveCallback

        +
        public static V8Value receiveCallback(V8Runtime v8Runtime,
+                                      JavetCallbackContext javetCallbackContext,
+                                      V8Value thisObject,
+                                      V8ValueArray args)
+                               throws java.lang.Throwable
        +
        Receive callback V8 value.
        +
        +
        Parameters:
        +
        v8Runtime - the V8 runtime
        +
        javetCallbackContext - the javet callback context
        +
        thisObject - the this object
        +
        args - the args
        +
        Returns:
        +
        the V8 value
        +
        Throws:
        +
        java.lang.Throwable - the throwable
        +
        Since:
        +
        0.8.3
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/callback/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/interop/callback/package-frame.html new file mode 100644 index 000000000..def309fc2 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/callback/package-frame.html @@ -0,0 +1,20 @@ + + + + + +com.caoccao.javet.interop.callback (javet 0.9.12 API) + + + + +

com.caoccao.javet.interop.callback

+
+

Classes

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/callback/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/interop/callback/package-summary.html new file mode 100644 index 000000000..ae5b0f7ad --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/callback/package-summary.html @@ -0,0 +1,160 @@ + + + + + +com.caoccao.javet.interop.callback (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.interop.callback

+
+
Callback bridge between JVM and C++ via JNI.
+
+

See: Description

+
+
+ + + + +

Package com.caoccao.javet.interop.callback Description

+
Callback bridge between JVM and C++ via JNI.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/callback/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/interop/callback/package-tree.html new file mode 100644 index 000000000..7fde79f28 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/callback/package-tree.html @@ -0,0 +1,135 @@ + + + + + +com.caoccao.javet.interop.callback Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.interop.callback

+Package Hierarchies: + +
+
+

Class Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/converters/IJavetConverter.html b/docs/reference/javadoc/com/caoccao/javet/interop/converters/IJavetConverter.html new file mode 100644 index 000000000..2cf6074b7 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/converters/IJavetConverter.html @@ -0,0 +1,332 @@ + + + + + +IJavetConverter (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interop.converters
+

Interface IJavetConverter

+
+
+
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getConfig

        +
        JavetConverterConfig getConfig()
        +
        Gets config.
        +
        +
        Returns:
        +
        the config
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        toObject

        +
        java.lang.Object toObject(V8Value v8Value)
+                   throws JavetException
        +
        To object from V8 value. +

        + Don't override this function, instead, override the one with depth as argument + for circular structure detection.

        +
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the object
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.1
        +
        +
        • +
      + + + +
        +
      • +

        toObject

        +
        default java.lang.Object toObject(V8Value v8Value,
+                                  boolean autoClose)
+                           throws JavetException
        +
        To object from V8 value and auto close the V8 value.
        +
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        autoClose - the auto close
        +
        Returns:
        +
        the object
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.5
        +
        +
        • +
      + + + +
        +
      • +

        toV8Value

        +
        @CheckReturnValue
+<T extends V8Value> T toV8Value(V8Runtime v8Runtime,
+                                                   java.lang.Object object)
+                                            throws JavetException
        +
        To V8 value from object. +

        + Don't override this function, instead, override the one with depth as argument + for circular structure detection.

        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        v8Runtime - the V8 runtime
        +
        object - the object
        +
        Returns:
        +
        the V8 value
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.2
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/converters/JavetConverterConfig.html b/docs/reference/javadoc/com/caoccao/javet/interop/converters/JavetConverterConfig.html new file mode 100644 index 000000000..7eb40e4ba --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/converters/JavetConverterConfig.html @@ -0,0 +1,1174 @@ + + + + + +JavetConverterConfig (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interop.converters
+

Class JavetConverterConfig<T extends JavetConverterConfig>

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.converters.JavetConverterConfig<T>
      • +
    +
    • +
+
+
    +
  • +
    +
    Type Parameters:
    +
    T - the type parameter
    +
    +
    +
    +
    public class JavetConverterConfig<T extends JavetConverterConfig>
+extends java.lang.Object
    +
    The type Javet converter config.
    +
    +
    Since:
    +
    0.9.4
    +
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        DEFAULT_MAX_DEPTH

        +
        public static final int DEFAULT_MAX_DEPTH
        +
        The constant DEFAULT_MAX_DEPTH.
        +
        +
        Since:
        +
        0.9.4
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        defaultBoolean

        +
        protected boolean defaultBoolean
        +
        The Default boolean.
        +
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        defaultByte

        +
        protected byte defaultByte
        +
        The Default byte.
        +
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        defaultChar

        +
        protected char defaultChar
        +
        The Default char.
        +
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        defaultDouble

        +
        protected double defaultDouble
        +
        The Default double.
        +
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        defaultFloat

        +
        protected float defaultFloat
        +
        The Default float.
        +
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        defaultInt

        +
        protected int defaultInt
        +
        The Default int.
        +
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        defaultLong

        +
        protected long defaultLong
        +
        The Default long.
        +
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        defaultShort

        +
        protected short defaultShort
        +
        The Default short.
        +
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        extractFunctionSourceCode

        +
        protected boolean extractFunctionSourceCode
        +
        The Extract function source code.
        +
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        maxDepth

        +
        protected int maxDepth
        +
        The Max depth.
        +
        +
        Since:
        +
        0.9.3
        +
        +
        • +
      + + + +
        +
      • +

        proxyMapEnabled

        +
        protected boolean proxyMapEnabled
        +
        The Proxy map enabled.
        +
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        proxySetEnabled

        +
        protected boolean proxySetEnabled
        +
        The Proxy set enabled.
        +
        +
        Since:
        +
        0.9.8
        +
        +
        • +
      + + + +
        +
      • +

        skipFunctionInObject

        +
        protected boolean skipFunctionInObject
        +
        This flag determines whether function should be skipped in object or not.
        +
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetConverterConfig

        +
        public JavetConverterConfig()
        +
        Instantiates a new Javet converter config.
        +
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getDefaultBoolean

        +
        public boolean getDefaultBoolean()
        +
        Gets default boolean boolean.
        +
        +
        Returns:
        +
        the boolean
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        getDefaultByte

        +
        public byte getDefaultByte()
        +
        Gets default byte.
        +
        +
        Returns:
        +
        the default byte
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        getDefaultChar

        +
        public char getDefaultChar()
        +
        Gets default char.
        +
        +
        Returns:
        +
        the default char
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        getDefaultDouble

        +
        public double getDefaultDouble()
        +
        Gets default double.
        +
        +
        Returns:
        +
        the default double
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        getDefaultFloat

        +
        public float getDefaultFloat()
        +
        Gets default float.
        +
        +
        Returns:
        +
        the default float
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        getDefaultInt

        +
        public int getDefaultInt()
        +
        Gets default int.
        +
        +
        Returns:
        +
        the default int
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        getDefaultLong

        +
        public long getDefaultLong()
        +
        Gets default long.
        +
        +
        Returns:
        +
        the default long
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        getDefaultShort

        +
        public short getDefaultShort()
        +
        Gets default short.
        +
        +
        Returns:
        +
        the default short
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        getMaxDepth

        +
        public int getMaxDepth()
        +
        Gets max depth.
        +
        +
        Returns:
        +
        the max depth
        +
        Since:
        +
        0.9.3
        +
        +
        • +
      + + + +
        +
      • +

        isExtractFunctionSourceCode

        +
        public boolean isExtractFunctionSourceCode()
        +
        Is extract function source code boolean.
        +
        +
        Returns:
        +
        the boolean
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        isProxyMapEnabled

        +
        public boolean isProxyMapEnabled()
        +
        Is proxy map enabled.
        +
        +
        Returns:
        +
        the boolean
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        isProxySetEnabled

        +
        public boolean isProxySetEnabled()
        +
        Is proxy set enabled.
        +
        +
        Returns:
        +
        the boolean
        +
        Since:
        +
        0.9.8
        +
        +
        • +
      + + + +
        +
      • +

        isSkipFunctionInObject

        +
        public boolean isSkipFunctionInObject()
        +
        Is skip functions boolean.
        +
        +
        Returns:
        +
        the boolean
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        setDefaultBoolean

        +
        public T setDefaultBoolean(boolean defaultBoolean)
        +
        Sets default boolean.
        +
        +
        Parameters:
        +
        defaultBoolean - the default boolean
        +
        Returns:
        +
        the self
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        setDefaultByte

        +
        public T setDefaultByte(byte defaultByte)
        +
        Sets default byte.
        +
        +
        Parameters:
        +
        defaultByte - the default byte
        +
        Returns:
        +
        the self
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        setDefaultChar

        +
        public T setDefaultChar(char defaultChar)
        +
        Sets default char.
        +
        +
        Parameters:
        +
        defaultChar - the default char
        +
        Returns:
        +
        the self
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        setDefaultDouble

        +
        public T setDefaultDouble(double defaultDouble)
        +
        Sets default double.
        +
        +
        Parameters:
        +
        defaultDouble - the default double
        +
        Returns:
        +
        the self
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        setDefaultFloat

        +
        public T setDefaultFloat(float defaultFloat)
        +
        Sets default float.
        +
        +
        Parameters:
        +
        defaultFloat - the default float
        +
        Returns:
        +
        the self
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        setDefaultInt

        +
        public T setDefaultInt(int defaultInt)
        +
        Sets default int.
        +
        +
        Parameters:
        +
        defaultInt - the default int
        +
        Returns:
        +
        the self
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        setDefaultLong

        +
        public T setDefaultLong(long defaultLong)
        +
        Sets default long.
        +
        +
        Parameters:
        +
        defaultLong - the default long
        +
        Returns:
        +
        the self
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        setDefaultShort

        +
        public T setDefaultShort(short defaultShort)
        +
        Sets default short.
        +
        +
        Parameters:
        +
        defaultShort - the default short
        +
        Returns:
        +
        the self
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        setExtractFunctionSourceCode

        +
        public T setExtractFunctionSourceCode(boolean extractFunctionSourceCode)
        +
        Sets extract function source code.
        +
        +
        Parameters:
        +
        extractFunctionSourceCode - the extract function source code
        +
        Returns:
        +
        the self
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        setMaxDepth

        +
        public T setMaxDepth(int maxDepth)
        +
        Sets max depth.
        +
        +
        Parameters:
        +
        maxDepth - the max depth
        +
        Returns:
        +
        the self
        +
        Since:
        +
        0.9.3
        +
        +
        • +
      + + + +
        +
      • +

        setProxyMapEnabled

        +
        public T setProxyMapEnabled(boolean proxyMapEnabled)
        +
        Sets proxy map enabled.
        +
        +
        Parameters:
        +
        proxyMapEnabled - the proxy map enabled
        +
        Returns:
        +
        the self
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        setProxySetEnabled

        +
        public T setProxySetEnabled(boolean proxySetEnabled)
        +
        Sets proxy set enabled.
        +
        +
        Parameters:
        +
        proxySetEnabled - the proxy set enabled
        +
        Returns:
        +
        the self
        +
        Since:
        +
        0.9.8
        +
        +
        • +
      + + + +
        +
      • +

        setSkipFunctionInObject

        +
        public T setSkipFunctionInObject(boolean skipFunctionInObject)
        +
        Sets skip functions.
        +
        +
        Parameters:
        +
        skipFunctionInObject - the skip functions
        +
        Returns:
        +
        the self
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/converters/JavetObjectConverter.html b/docs/reference/javadoc/com/caoccao/javet/interop/converters/JavetObjectConverter.html new file mode 100644 index 000000000..952c55187 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/converters/JavetObjectConverter.html @@ -0,0 +1,752 @@ + + + + + +JavetObjectConverter (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interop.converters
+

Class JavetObjectConverter

+
+
+ +
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        EXECUTABLE_INDEX_DEFAULT_CONSTRUCTOR

        +
        protected static final int EXECUTABLE_INDEX_DEFAULT_CONSTRUCTOR
        +
        The constant EXECUTABLE_INDEX_DEFAULT_CONSTRUCTOR.
        +
        +
        Since:
        +
        0.9.12
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        EXECUTABLE_INDEX_FROM_MAP

        +
        protected static final int EXECUTABLE_INDEX_FROM_MAP
        +
        The constant EXECUTABLE_INDEX_FROM_MAP.
        +
        +
        Since:
        +
        0.9.12
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        EXECUTABLE_INDEX_TO_MAP

        +
        protected static final int EXECUTABLE_INDEX_TO_MAP
        +
        The constant EXECUTABLE_INDEX_TO_MAP.
        +
        +
        Since:
        +
        0.9.12
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        METHOD_NAME_FROM_MAP

        +
        protected static final java.lang.String METHOD_NAME_FROM_MAP
        +
        The constant METHOD_NAME_FROM_MAP.
        +
        +
        Since:
        +
        0.9.12
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        METHOD_NAME_TO_MAP

        +
        protected static final java.lang.String METHOD_NAME_TO_MAP
        +
        The constant METHOD_NAME_TO_MAP.
        +
        +
        Since:
        +
        0.9.12
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PRIVATE_PROPERTY_CUSTOM_OBJECT_CLASS_NAME

        +
        protected static final java.lang.String PRIVATE_PROPERTY_CUSTOM_OBJECT_CLASS_NAME
        +
        The constant PRIVATE_PROPERTY_CUSTOM_OBJECT_CLASS_NAME.
        +
        +
        Since:
        +
        0.9.6
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PRIVATE_PROPERTY_PROXY_TARGET

        +
        protected static final java.lang.String PRIVATE_PROPERTY_PROXY_TARGET
        +
        The constant PRIVATE_PROPERTY_PROXY_TARGET.
        +
        +
        Since:
        +
        0.9.6
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PROPERTY_NAME

        +
        protected static final java.lang.String PROPERTY_NAME
        +
        The constant PROPERTY_NAME.
        +
        +
        Since:
        +
        0.7.2
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PUBLIC_PROPERTY_CONSTRUCTOR

        +
        protected static final java.lang.String PUBLIC_PROPERTY_CONSTRUCTOR
        +
        The constant PUBLIC_PROPERTY_CONSTRUCTOR.
        +
        +
        Since:
        +
        0.7.2
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        customObjectLock

        +
        protected java.util.concurrent.locks.ReentrantReadWriteLock customObjectLock
        +
        The Custom object lock.
        +
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + +
        +
      • +

        customObjectMap

        +
        protected java.util.Map<java.lang.String,java.lang.reflect.Executable[]> customObjectMap
        +
        The Custom object map.
        +
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetObjectConverter

        +
        public JavetObjectConverter()
        +
        Instantiates a new Javet object converter.
        +
        +
        Since:
        +
        0.7.1
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        createEntityFunction

        +
        protected IJavetEntityFunction createEntityFunction()
        +
        Create entity function javet entity function.
        +
        +
        Returns:
        +
        the javet entity function
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        createEntityMap

        +
        protected java.util.Map<java.lang.String,java.lang.Object> createEntityMap()
        +
        Create entity map map.
        +
        +
        Returns:
        +
        the map
        +
        Since:
        +
        0.7.2
        +
        +
        • +
      + + + +
        +
      • +

        registerCustomObject

        +
        public boolean registerCustomObject(java.lang.Class<?> customObjectClass)
        +
        Register custom object.
        +
        +
        Parameters:
        +
        customObjectClass - the custom object class
        +
        Returns:
        +
        true : success, false: failure
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + +
        +
      • +

        registerCustomObject

        +
        public boolean registerCustomObject(java.lang.Class<?> customObjectClass,
+                                    java.lang.String methodNameFromMap,
+                                    java.lang.String methodNameToMap)
        +
        Register custom object.
        +
        +
        Parameters:
        +
        customObjectClass - the custom object class
        +
        methodNameFromMap - the method name from map
        +
        methodNameToMap - the method name to map
        +
        Returns:
        +
        true : success, false: failure
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + + + + + + + + + +
        +
      • +

        unregisterCustomObject

        +
        public boolean unregisterCustomObject(java.lang.Class<?> customObjectClass)
        +
        Unregister custom object.
        +
        +
        Parameters:
        +
        customObjectClass - the custom object class
        +
        Returns:
        +
        true : success, false: failure
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/converters/JavetPrimitiveConverter.html b/docs/reference/javadoc/com/caoccao/javet/interop/converters/JavetPrimitiveConverter.html new file mode 100644 index 000000000..de8805f89 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/converters/JavetPrimitiveConverter.html @@ -0,0 +1,530 @@ + + + + + +JavetPrimitiveConverter (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interop.converters
+

Class JavetPrimitiveConverter

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.converters.JavetPrimitiveConverter
      • +
    +
    • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    IJavetConverter
    +
    +
    +
    Direct Known Subclasses:
    +
    JavetObjectConverter
    +
    +
    +
    +
    public class JavetPrimitiveConverter
+extends java.lang.Object
+implements IJavetConverter
    +
    The type Javet primitive converter.
    +
    +
    Since:
    +
    0.7.1
    +
    +
    • +
+
+
+ +
+
+
    +
  • + + + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetPrimitiveConverter

        +
        public JavetPrimitiveConverter()
        +
        Instantiates a new Javet primitive converter.
        +
        +
        Since:
        +
        0.7.1
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + + + + + +
        +
      • +

        setConfig

        +
        public void setConfig(JavetConverterConfig config)
        +
        Sets config.
        +
        +
        Parameters:
        +
        config - the config
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        toObject

        +
        public final java.lang.Object toObject(V8Value v8Value)
+                                throws JavetException
        +
        Description copied from interface: IJavetConverter
        +
        To object from V8 value. +

        + Don't override this function, instead, override the one with depth as argument + for circular structure detection.

        +
        +
        Specified by:
        +
        toObject in interface IJavetConverter
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the object
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        toObject

        +
        protected java.lang.Object toObject(V8Value v8Value,
+                                    int depth)
+                             throws JavetException
        +
        To object with stack depth.
        +
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        depth - the stack depth
        +
        Returns:
        +
        the object
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.3
        +
        +
        • +
      + + + +
        +
      • +

        toV8Value

        +
        @CheckReturnValue
+public final <T extends V8Value> T toV8Value(V8Runtime v8Runtime,
+                                                                java.lang.Object object)
+                                                         throws JavetException
        +
        Description copied from interface: IJavetConverter
        +
        To V8 value from object. +

        + Don't override this function, instead, override the one with depth as argument + for circular structure detection.

        +
        +
        Specified by:
        +
        toV8Value in interface IJavetConverter
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        v8Runtime - the V8 runtime
        +
        object - the object
        +
        Returns:
        +
        the V8 value
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        toV8Value

        +
        @CheckReturnValue
+protected <T extends V8Value> T toV8Value(V8Runtime v8Runtime,
+                                                             java.lang.Object object,
+                                                             int depth)
+                                                      throws JavetException
        +
        To V8 value with stack depth.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        v8Runtime - the V8 runtime
        +
        object - the object
        +
        depth - the stack depth
        +
        Returns:
        +
        the V8 value
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.3
        +
        +
        • +
      + + + +
        +
      • +

        validateDepth

        +
        protected void validateDepth(int depth)
+                      throws JavetException
        +
        Validate the stack depth.
        +
        +
        Parameters:
        +
        depth - the stack depth
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.3
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/converters/JavetProxyConverter.html b/docs/reference/javadoc/com/caoccao/javet/interop/converters/JavetProxyConverter.html new file mode 100644 index 000000000..982d870d4 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/converters/JavetProxyConverter.html @@ -0,0 +1,398 @@ + + + + + +JavetProxyConverter (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interop.converters
+

Class JavetProxyConverter

+
+
+ +
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    IJavetConverter
    +
    +
    +
    +
    public class JavetProxyConverter
+extends JavetObjectConverter
    +
    The type Javet proxy converter.
    +
    +
    Since:
    +
    0.9.6
    +
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        DUMMY_FUNCTION_STRING

        +
        protected static final java.lang.String DUMMY_FUNCTION_STRING
        +
        The constant DUMMY_FUNCTION_STRING.
        +
        +
        Since:
        +
        0.9.8
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetProxyConverter

        +
        public JavetProxyConverter()
        +
        Instantiates a new Javet proxy converter.
        +
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      +
      • +
    + + +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/converters/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/interop/converters/package-frame.html new file mode 100644 index 000000000..bcf02acb7 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/converters/package-frame.html @@ -0,0 +1,26 @@ + + + + + +com.caoccao.javet.interop.converters (javet 0.9.12 API) + + + + +

com.caoccao.javet.interop.converters

+
+

Interfaces

+ +

Classes

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/converters/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/interop/converters/package-summary.html new file mode 100644 index 000000000..ceeefc0da --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/converters/package-summary.html @@ -0,0 +1,189 @@ + + + + + +com.caoccao.javet.interop.converters (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.interop.converters

+
+
Built-in converters, interface and config.
+
+

See: Description

+
+
+ + + + +

Package com.caoccao.javet.interop.converters Description

+
Built-in converters, interface and config.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/converters/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/interop/converters/package-tree.html new file mode 100644 index 000000000..e8f62d821 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/converters/package-tree.html @@ -0,0 +1,147 @@ + + + + + +com.caoccao.javet.interop.converters Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.interop.converters

+Package Hierarchies: + +
+
+

Class Hierarchy

+ +

Interface Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/engine/IJavetEngine.html b/docs/reference/javadoc/com/caoccao/javet/interop/engine/IJavetEngine.html new file mode 100644 index 000000000..4bf47ec5c --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/engine/IJavetEngine.html @@ -0,0 +1,342 @@ + + + + + +IJavetEngine (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interop.engine
+

Interface IJavetEngine<R extends V8Runtime>

+
+
+
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/engine/IJavetEngineGuard.html b/docs/reference/javadoc/com/caoccao/javet/interop/engine/IJavetEngineGuard.html new file mode 100644 index 000000000..f9005a82c --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/engine/IJavetEngineGuard.html @@ -0,0 +1,326 @@ + + + + + +IJavetEngineGuard (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interop.engine
+

Interface IJavetEngineGuard

+
+
+
+
    +
  • +
    +
    All Superinterfaces:
    +
    java.lang.AutoCloseable, IJavetClosable, java.lang.Runnable
    +
    +
    +
    All Known Implementing Classes:
    +
    JavetEngineGuard
    +
    +
    +
    +
    public interface IJavetEngineGuard
+extends IJavetClosable, java.lang.Runnable
    +
    The interface Javet engine guard is the one guarding the script execution with a timeout. +

    + Usage: + + + try (IJavetEngineGuard iJavetEngineGuard = iJavetEngine.getGuard(5000)) { + v8Runtime.getExecutor("while (true) {}").executeVoid(); + // That infinite loop will be terminated in 5 seconds by the guard. + } +

    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        cancel

        +
        void cancel()
        +
        Cancel.
        +
        • +
      + + + +
        +
      • +

        disableInDebugMode

        +
        void disableInDebugMode()
        +
        Disable in debug mode.
        +
        • +
      + + + +
        +
      • +

        enableInDebugMode

        +
        void enableInDebugMode()
        +
        Enable in debug mode.
        +
        • +
      + + + +
        +
      • +

        getTimeoutMillis

        +
        long getTimeoutMillis()
        +
        Gets timeout millis.
        +
        +
        Returns:
        +
        the timeout millis
        +
        +
        • +
      + + + +
        +
      • +

        setTimeoutMillis

        +
        void setTimeoutMillis(long timeoutMillis)
        +
        Sets timeout millis.
        +
        +
        Parameters:
        +
        timeoutMillis - the timeout millis
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/engine/IJavetEnginePool.html b/docs/reference/javadoc/com/caoccao/javet/interop/engine/IJavetEnginePool.html new file mode 100644 index 000000000..d866abca9 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/engine/IJavetEnginePool.html @@ -0,0 +1,318 @@ + + + + + +IJavetEnginePool (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interop.engine
+

Interface IJavetEnginePool<R extends V8Runtime>

+
+
+
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/engine/JavetEngine.html b/docs/reference/javadoc/com/caoccao/javet/interop/engine/JavetEngine.html new file mode 100644 index 000000000..a2337fb80 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/engine/JavetEngine.html @@ -0,0 +1,608 @@ + + + + + +JavetEngine (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interop.engine
+

Class JavetEngine<R extends V8Runtime>

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.engine.JavetEngine<R>
      • +
    +
    • +
+
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/engine/JavetEngineConfig.html b/docs/reference/javadoc/com/caoccao/javet/interop/engine/JavetEngineConfig.html new file mode 100644 index 000000000..923676d9f --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/engine/JavetEngineConfig.html @@ -0,0 +1,830 @@ + + + + + +JavetEngineConfig (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interop.engine
+

Class JavetEngineConfig

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.engine.JavetEngineConfig
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public final class JavetEngineConfig
+extends java.lang.Object
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        DEFAULT_ENGINE_GUARD_TIMEOUT_MILLIS

        +
        public static final int DEFAULT_ENGINE_GUARD_TIMEOUT_MILLIS
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        DEFAULT_ENGINE_GUARD_CHECK_INTERVAL_MILLIS

        +
        public static final int DEFAULT_ENGINE_GUARD_CHECK_INTERVAL_MILLIS
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        DEFAULT_JS_RUNTIME_TYPE

        +
        public static final JSRuntimeType DEFAULT_JS_RUNTIME_TYPE
        +
        • +
      + + + +
        +
      • +

        DEFAULT_POOL_MIN_SIZE

        +
        public static final int DEFAULT_POOL_MIN_SIZE
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        DEFAULT_POOL_IDLE_TIMEOUT_SECONDS

        +
        public static final int DEFAULT_POOL_IDLE_TIMEOUT_SECONDS
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        DEFAULT_POOL_DAEMON_CHECK_INTERVAL_MILLIS

        +
        public static final int DEFAULT_POOL_DAEMON_CHECK_INTERVAL_MILLIS
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        DEFAULT_RESET_ENGINE_TIMEOUT_SECONDS

        +
        public static final int DEFAULT_RESET_ENGINE_TIMEOUT_SECONDS
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        DEFAULT_GLOBAL_NAME

        +
        public static final java.lang.String DEFAULT_GLOBAL_NAME
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        DEFAULT_POOL_SHUTDOWN_TIMEOUT_SECONDS

        +
        public static final int DEFAULT_POOL_SHUTDOWN_TIMEOUT_SECONDS
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        DEFAULT_JAVET_LOGGER

        +
        public static IJavetLogger DEFAULT_JAVET_LOGGER
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetEngineConfig

        +
        public JavetEngineConfig()
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getDefaultEngineGuardTimeoutMillis

        +
        public int getDefaultEngineGuardTimeoutMillis()
        +
        • +
      + + + +
        +
      • +

        getEngineGuardCheckIntervalMillis

        +
        public int getEngineGuardCheckIntervalMillis()
        +
        • +
      + + + +
        +
      • +

        getExecutorService

        +
        public java.util.concurrent.ExecutorService getExecutorService()
        +
        • +
      + + + +
        +
      • +

        getGlobalName

        +
        public java.lang.String getGlobalName()
        +
        • +
      + + + +
        +
      • +

        getJSRuntimeType

        +
        public JSRuntimeType getJSRuntimeType()
        +
        • +
      + + + +
        +
      • +

        getJavetLogger

        +
        public IJavetLogger getJavetLogger()
        +
        • +
      + + + +
        +
      • +

        getPoolDaemonCheckIntervalMillis

        +
        public int getPoolDaemonCheckIntervalMillis()
        +
        • +
      + + + +
        +
      • +

        getPoolIdleTimeoutSeconds

        +
        public int getPoolIdleTimeoutSeconds()
        +
        • +
      + + + +
        +
      • +

        getPoolMaxSize

        +
        public int getPoolMaxSize()
        +
        • +
      + + + +
        +
      • +

        getPoolMinSize

        +
        public int getPoolMinSize()
        +
        • +
      + + + +
        +
      • +

        getPoolShutdownTimeoutSeconds

        +
        public int getPoolShutdownTimeoutSeconds()
        +
        • +
      + + + +
        +
      • +

        getResetEngineTimeoutSeconds

        +
        public int getResetEngineTimeoutSeconds()
        +
        • +
      + + + +
        +
      • +

        isAllowEval

        +
        public boolean isAllowEval()
        +
        • +
      + + + +
        +
      • +

        isAutoSendGCNotification

        +
        public boolean isAutoSendGCNotification()
        +
        • +
      + + + +
        +
      • +

        isGcBeforeEngineClose

        +
        public boolean isGcBeforeEngineClose()
        +
        • +
      + + + + + + + + + + + +
        +
      • +

        setAutoSendGCNotification

        +
        public JavetEngineConfig setAutoSendGCNotification(boolean autoSendGCNotification)
        +
        • +
      + + + +
        +
      • +

        setDefaultEngineGuardTimeoutMillis

        +
        public JavetEngineConfig setDefaultEngineGuardTimeoutMillis(int defaultEngineGuardTimeoutMillis)
        +
        • +
      + + + +
        +
      • +

        setEngineGuardCheckIntervalMillis

        +
        public JavetEngineConfig setEngineGuardCheckIntervalMillis(int engineGuardCheckIntervalMillis)
        +
        • +
      + + + +
        +
      • +

        setGcBeforeEngineClose

        +
        public JavetEngineConfig setGcBeforeEngineClose(boolean gcBeforeEngineClose)
        +
        • +
      + + + +
        +
      • +

        setGlobalName

        +
        public JavetEngineConfig setGlobalName(java.lang.String globalName)
        +
        • +
      + + + + + + + + + + + +
        +
      • +

        setPoolDaemonCheckIntervalMillis

        +
        public JavetEngineConfig setPoolDaemonCheckIntervalMillis(int poolDaemonCheckIntervalMillis)
        +
        • +
      + + + +
        +
      • +

        setPoolIdleTimeoutSeconds

        +
        public JavetEngineConfig setPoolIdleTimeoutSeconds(int poolIdleTimeoutSeconds)
        +
        • +
      + + + + + + + + + + + +
        +
      • +

        setPoolShutdownTimeoutSeconds

        +
        public JavetEngineConfig setPoolShutdownTimeoutSeconds(int poolShutdownTimeoutSeconds)
        +
        • +
      + + + +
        +
      • +

        setResetEngineTimeoutSeconds

        +
        public JavetEngineConfig setResetEngineTimeoutSeconds(int resetEngineTimeoutSeconds)
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/engine/JavetEngineGuard.html b/docs/reference/javadoc/com/caoccao/javet/interop/engine/JavetEngineGuard.html new file mode 100644 index 000000000..cb68faa2b --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/engine/JavetEngineGuard.html @@ -0,0 +1,678 @@ + + + + + +JavetEngineGuard (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interop.engine
+

Class JavetEngineGuard

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.engine.JavetEngineGuard
      • +
    +
    • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    IJavetClosable, IJavetEngineGuard, java.lang.AutoCloseable, java.lang.Runnable
    +
    +
    +
    +
    public class JavetEngineGuard
+extends java.lang.Object
+implements IJavetEngineGuard
    +
    The type Javet engine guard.
    +
    +
    Since:
    +
    0.7.2
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Summary

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Fields 
      Modifier and TypeField and Description
      protected booleanclosed +
      The Closed.
      +
      protected java.util.concurrent.Future<?>future +
      The Future.
      +
      protected IJavetEngine<?>iJavetEngine +
      The Javet engine.
      +
      protected static booleanIS_IN_DEBUG_MODE +
      The constant IS_IN_DEBUG_MODE.
      +
      protected booleanquitting +
      The Quitting.
      +
      protected booleanskipInDebugMode +
      The Skip in debug mode.
      +
      protected longtimeoutMillis +
      The Timeout millis.
      +
      protected V8Runtimev8Runtime +
      The V8 runtime.
      +
      +
      • +
    + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + +
      Constructors 
      Constructor and Description
      JavetEngineGuard(IJavetEngine<?> iJavetEngine, + V8Runtime v8Runtime, + long timeoutMills) +
      Instantiates a new Javet engine guard.
      +
      +
      • +
    + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      All Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      voidcancel() +
      Cancel.
      +
      voidclose() 
      voiddisableInDebugMode() +
      Disable in debug mode.
      +
      voidenableInDebugMode() +
      Enable in debug mode.
      +
      longgetTimeoutMillis() +
      Gets timeout millis.
      +
      protected java.time.ZonedDateTimegetUTCNow() +
      Gets utc now.
      +
      booleanisClosed() +
      Is closed.
      +
      booleanisQuitting() +
      Is quitting boolean.
      +
      voidrun() 
      voidsetTimeoutMillis(long timeoutSeconds) +
      Sets timeout millis.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        IS_IN_DEBUG_MODE

        +
        protected static final boolean IS_IN_DEBUG_MODE
        +
        The constant IS_IN_DEBUG_MODE.
        +
        +
        Since:
        +
        0.8.9
        +
        +
        • +
      + + + +
        +
      • +

        closed

        +
        protected boolean closed
        +
        The Closed.
        +
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      + + + +
        +
      • +

        future

        +
        protected java.util.concurrent.Future<?> future
        +
        The Future.
        +
        +
        Since:
        +
        0.8.10
        +
        +
        • +
      + + + +
        +
      • +

        iJavetEngine

        +
        protected IJavetEngine<?> iJavetEngine
        +
        The Javet engine.
        +
        +
        Since:
        +
        0.8.10
        +
        +
        • +
      + + + +
        +
      • +

        quitting

        +
        protected volatile boolean quitting
        +
        The Quitting.
        +
        +
        Since:
        +
        0.8.10
        +
        +
        • +
      + + + +
        +
      • +

        skipInDebugMode

        +
        protected boolean skipInDebugMode
        +
        The Skip in debug mode.
        +
        +
        Since:
        +
        0.8.9
        +
        +
        • +
      + + + +
        +
      • +

        timeoutMillis

        +
        protected long timeoutMillis
        +
        The Timeout millis.
        +
        +
        Since:
        +
        0.8.9
        +
        +
        • +
      + + + +
        +
      • +

        v8Runtime

        +
        protected V8Runtime v8Runtime
        +
        The V8 runtime.
        +
        +
        Since:
        +
        0.7.2
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetEngineGuard

        +
        public JavetEngineGuard(IJavetEngine<?> iJavetEngine,
+                        V8Runtime v8Runtime,
+                        long timeoutMills)
        +
        Instantiates a new Javet engine guard.
        +
        +
        Parameters:
        +
        iJavetEngine - the javet engine
        +
        v8Runtime - the V8 runtime
        +
        timeoutMills - the timeout mills
        +
        Since:
        +
        0.7.2
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + + + + + + + + + + + + + + + + + + + + + +
        +
      • +

        getUTCNow

        +
        protected java.time.ZonedDateTime getUTCNow()
        +
        Gets utc now.
        +
        +
        Returns:
        +
        the utc now
        +
        Since:
        +
        0.9.1
        +
        +
        • +
      + + + +
        +
      • +

        isClosed

        +
        public boolean isClosed()
        +
        Description copied from interface: IJavetClosable
        +
        Is closed.
        +
        +
        Specified by:
        +
        isClosed in interface IJavetClosable
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      + + + +
        +
      • +

        isQuitting

        +
        public boolean isQuitting()
        +
        Is quitting boolean.
        +
        +
        Returns:
        +
        the boolean
        +
        Since:
        +
        0.7.2
        +
        +
        • +
      + + + +
        +
      • +

        run

        +
        public void run()
        +
        +
        Specified by:
        +
        run in interface java.lang.Runnable
        +
        +
        • +
      + + + +
        +
      • +

        setTimeoutMillis

        +
        public void setTimeoutMillis(long timeoutSeconds)
        +
        Description copied from interface: IJavetEngineGuard
        +
        Sets timeout millis.
        +
        +
        Specified by:
        +
        setTimeoutMillis in interface IJavetEngineGuard
        +
        Parameters:
        +
        timeoutSeconds - the timeout millis
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/engine/JavetEnginePool.html b/docs/reference/javadoc/com/caoccao/javet/interop/engine/JavetEnginePool.html new file mode 100644 index 000000000..d7c69914e --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/engine/JavetEnginePool.html @@ -0,0 +1,753 @@ + + + + + +JavetEnginePool (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interop.engine
+

Class JavetEnginePool<R extends V8Runtime>

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.engine.JavetEnginePool<R>
      • +
    +
    • +
+
+
    +
  • +
    +
    Type Parameters:
    +
    R - the type parameter
    +
    +
    +
    All Implemented Interfaces:
    +
    IJavetClosable, IJavetEnginePool<R>, java.lang.AutoCloseable, java.lang.Runnable
    +
    +
    +
    +
    public class JavetEnginePool<R extends V8Runtime>
+extends java.lang.Object
+implements IJavetEnginePool<R>, java.lang.Runnable
    +
    The type Javet engine pool.
    +
    +
    Since:
    +
    0.8.0
    +
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        JAVET_DAEMON_THREAD_NAME

        +
        protected static final java.lang.String JAVET_DAEMON_THREAD_NAME
        +
        The constant JAVET_DAEMON_THREAD_NAME.
        +
        +
        Since:
        +
        0.8.10
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        activeEngineList

        +
        protected final java.util.concurrent.ConcurrentLinkedQueue<JavetEngine<R extends V8Runtime>> activeEngineList
        +
        The Active engine list.
        +
        +
        Since:
        +
        0.9.1
        +
        +
        • +
      + + + +
        +
      • +

        externalLock

        +
        protected final java.lang.Object externalLock
        +
        The External lock.
        +
        +
        Since:
        +
        0.8.10
        +
        +
        • +
      + + + +
        +
      • +

        idleEngineList

        +
        protected final java.util.concurrent.ConcurrentLinkedQueue<JavetEngine<R extends V8Runtime>> idleEngineList
        +
        The Idle engine list.
        +
        +
        Since:
        +
        0.9.1
        +
        +
        • +
      + + + +
        +
      • +

        active

        +
        protected volatile boolean active
        +
        The Active.
        +
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + + + + + +
        +
      • +

        daemonThread

        +
        protected java.lang.Thread daemonThread
        +
        The Daemon thread.
        +
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        quitting

        +
        protected volatile boolean quitting
        +
        The Quitting.
        +
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetEnginePool

        +
        public JavetEnginePool()
        +
        Instantiates a new Javet engine pool.
        +
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        JavetEnginePool

        +
        public JavetEnginePool(JavetEngineConfig config)
        +
        Instantiates a new Javet engine pool.
        +
        +
        Parameters:
        +
        config - the config
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      +
      • +
    + + +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/engine/JavetEngineUsage.html b/docs/reference/javadoc/com/caoccao/javet/interop/engine/JavetEngineUsage.html new file mode 100644 index 000000000..5b5166c2e --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/engine/JavetEngineUsage.html @@ -0,0 +1,369 @@ + + + + + +JavetEngineUsage (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interop.engine
+

Class JavetEngineUsage

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.engine.JavetEngineUsage
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public class JavetEngineUsage
+extends java.lang.Object
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        engineUsedCount

        +
        protected int engineUsedCount
        +
        • +
      + + + +
        +
      • +

        lastActiveZonedDatetime

        +
        protected java.time.ZonedDateTime lastActiveZonedDatetime
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetEngineUsage

        +
        public JavetEngineUsage()
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getEngineUsedCount

        +
        public int getEngineUsedCount()
        +
        • +
      + + + +
        +
      • +

        getLastActiveZonedDatetime

        +
        public java.time.ZonedDateTime getLastActiveZonedDatetime()
        +
        • +
      + + + +
        +
      • +

        increaseUsedCount

        +
        public void increaseUsedCount()
        +
        • +
      + + + +
        +
      • +

        reset

        +
        protected void reset()
        +
        • +
      + + + +
        +
      • +

        setLastActiveZonedDatetime

        +
        public void setLastActiveZonedDatetime(java.time.ZonedDateTime lastActiveZonedDatetime)
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/engine/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/interop/engine/package-frame.html new file mode 100644 index 000000000..06dd9bc2c --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/engine/package-frame.html @@ -0,0 +1,29 @@ + + + + + +com.caoccao.javet.interop.engine (javet 0.9.12 API) + + + + +

com.caoccao.javet.interop.engine

+
+

Interfaces

+ +

Classes

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/engine/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/interop/engine/package-summary.html new file mode 100644 index 000000000..bb1899330 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/engine/package-summary.html @@ -0,0 +1,197 @@ + + + + + +com.caoccao.javet.interop.engine (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.interop.engine

+
+
Engine pool, config and guard.
+
+

See: Description

+
+
+ + + + +

Package com.caoccao.javet.interop.engine Description

+
Engine pool, config and guard.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/engine/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/interop/engine/package-tree.html new file mode 100644 index 000000000..21a4128c5 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/engine/package-tree.html @@ -0,0 +1,157 @@ + + + + + +com.caoccao.javet.interop.engine Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.interop.engine

+Package Hierarchies: + +
+
+

Class Hierarchy

+ +

Interface Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/executors/BaseV8Executor.html b/docs/reference/javadoc/com/caoccao/javet/interop/executors/BaseV8Executor.html new file mode 100644 index 000000000..889db7436 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/executors/BaseV8Executor.html @@ -0,0 +1,461 @@ + + + + + +BaseV8Executor (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interop.executors
+

Class BaseV8Executor

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.executors.BaseV8Executor
      • +
    +
    • +
+
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/executors/IV8Executor.html b/docs/reference/javadoc/com/caoccao/javet/interop/executors/IV8Executor.html new file mode 100644 index 000000000..3b58c4699 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/executors/IV8Executor.html @@ -0,0 +1,509 @@ + + + + + +IV8Executor (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interop.executors
+

Interface IV8Executor

+
+
+
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/executors/V8PathExecutor.html b/docs/reference/javadoc/com/caoccao/javet/interop/executors/V8PathExecutor.html new file mode 100644 index 000000000..68beb6250 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/executors/V8PathExecutor.html @@ -0,0 +1,396 @@ + + + + + +V8PathExecutor (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interop.executors
+

Class V8PathExecutor

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/executors/V8StringExecutor.html b/docs/reference/javadoc/com/caoccao/javet/interop/executors/V8StringExecutor.html new file mode 100644 index 000000000..7f6117cbf --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/executors/V8StringExecutor.html @@ -0,0 +1,454 @@ + + + + + +V8StringExecutor (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interop.executors
+

Class V8StringExecutor

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/executors/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/interop/executors/package-frame.html new file mode 100644 index 000000000..2cd468a28 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/executors/package-frame.html @@ -0,0 +1,25 @@ + + + + + +com.caoccao.javet.interop.executors (javet 0.9.12 API) + + + + +

com.caoccao.javet.interop.executors

+
+

Interfaces

+ +

Classes

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/executors/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/interop/executors/package-summary.html new file mode 100644 index 000000000..8c85a0f60 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/executors/package-summary.html @@ -0,0 +1,175 @@ + + + + + +com.caoccao.javet.interop.executors (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.interop.executors

+
+
Executors and interface.
+
+

See: Description

+
+
+ + + + +

Package com.caoccao.javet.interop.executors Description

+
Executors and interface.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/executors/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/interop/executors/package-tree.html new file mode 100644 index 000000000..0c16dc845 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/executors/package-tree.html @@ -0,0 +1,154 @@ + + + + + +com.caoccao.javet.interop.executors Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.interop.executors

+Package Hierarchies: + +
+
+

Class Hierarchy

+ +

Interface Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/interop/package-frame.html new file mode 100644 index 000000000..50edcc733 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/package-frame.html @@ -0,0 +1,37 @@ + + + + + +com.caoccao.javet.interop (javet 0.9.12 API) + + + + +

com.caoccao.javet.interop

+
+

Interfaces

+ +

Classes

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/interop/package-summary.html new file mode 100644 index 000000000..0321f87b7 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/package-summary.html @@ -0,0 +1,233 @@ + + + + + +com.caoccao.javet.interop (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.interop

+
+
Interoperation between JVM and C++ via JNI.
+
+

See: Description

+
+
+ + + + +

Package com.caoccao.javet.interop Description

+
Interoperation between JVM and C++ via JNI.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/interop/package-tree.html new file mode 100644 index 000000000..bade1f773 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/package-tree.html @@ -0,0 +1,161 @@ + + + + + +com.caoccao.javet.interop Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.interop

+Package Hierarchies: + +
+
+

Class Hierarchy

+ +

Interface Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/proxy/BaseJavetProxyHandler.html b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/BaseJavetProxyHandler.html new file mode 100644 index 000000000..20739b112 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/BaseJavetProxyHandler.html @@ -0,0 +1,402 @@ + + + + + +BaseJavetProxyHandler (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interop.proxy
+

Class BaseJavetProxyHandler<T>

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.proxy.BaseJavetProxyHandler<T>
      • +
    +
    • +
+
+
    +
  • +
    +
    Type Parameters:
    +
    T - the type parameter
    +
    +
    +
    All Implemented Interfaces:
    +
    IJavetProxyHandler<T>
    +
    +
    +
    Direct Known Subclasses:
    +
    JavetUniversalProxyHandler
    +
    +
    +
    +
    public abstract class BaseJavetProxyHandler<T>
+extends java.lang.Object
+implements IJavetProxyHandler<T>
    +
    The type Base javet proxy handler.
    +
    +
    Since:
    +
    0.9.6
    +
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        targetObject

        +
        protected T targetObject
        +
        The Target object.
        +
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        v8Runtime

        +
        protected V8Runtime v8Runtime
        +
        The V8 runtime.
        +
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + + + +
        +
      • +

        BaseJavetProxyHandler

        +
        public BaseJavetProxyHandler(V8Runtime v8Runtime,
+                             T targetObject)
        +
        Instantiates a new Base javet proxy handler.
        +
        +
        Parameters:
        +
        v8Runtime - the V8 runtime
        +
        targetObject - the target object
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + + + + + +
        +
      • +

        getV8Runtime

        +
        public V8Runtime getV8Runtime()
        +
        Gets V8 runtime.
        +
        +
        Returns:
        +
        the V8 runtime
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/proxy/DynamicProxyV8ValueFunctionInvocationHandler.html b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/DynamicProxyV8ValueFunctionInvocationHandler.html new file mode 100644 index 000000000..9ee13439c --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/DynamicProxyV8ValueFunctionInvocationHandler.html @@ -0,0 +1,339 @@ + + + + + +DynamicProxyV8ValueFunctionInvocationHandler (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.interop.proxy
+

Class DynamicProxyV8ValueFunctionInvocationHandler

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.proxy.DynamicProxyV8ValueFunctionInvocationHandler
      • +
    +
    • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    IJavetClosable, java.lang.AutoCloseable, java.lang.reflect.InvocationHandler
    +
    +
    +
    +
    public class DynamicProxyV8ValueFunctionInvocationHandler
+extends java.lang.Object
+implements java.lang.reflect.InvocationHandler, IJavetClosable
    +
    The type Dynamic proxy V8 value function invocation handler.
    +
    • +
+
+
+
    +
  • + + + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + +
      All Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      voidclose() 
      java.lang.Objectinvoke(java.lang.Object proxy, + java.lang.reflect.Method method, + java.lang.Object[] args) 
      booleanisClosed() +
      Is closed.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        DynamicProxyV8ValueFunctionInvocationHandler

        +
        public DynamicProxyV8ValueFunctionInvocationHandler(V8ValueFunction v8ValueFunction)
        +
        Instantiates a new Dynamic proxy V8 value function invocation handler.
        +
        +
        Parameters:
        +
        v8ValueFunction - the V8 value function
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + + + + + +
        +
      • +

        invoke

        +
        public java.lang.Object invoke(java.lang.Object proxy,
+                               java.lang.reflect.Method method,
+                               java.lang.Object[] args)
+                        throws java.lang.Throwable
        +
        +
        Specified by:
        +
        invoke in interface java.lang.reflect.InvocationHandler
        +
        Throws:
        +
        java.lang.Throwable
        +
        +
        • +
      + + + +
        +
      • +

        isClosed

        +
        public boolean isClosed()
        +
        Description copied from interface: IJavetClosable
        +
        Is closed.
        +
        +
        Specified by:
        +
        isClosed in interface IJavetClosable
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/proxy/DynamicProxyV8ValueObjectInvocationHandler.html b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/DynamicProxyV8ValueObjectInvocationHandler.html new file mode 100644 index 000000000..4b5069b2f --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/DynamicProxyV8ValueObjectInvocationHandler.html @@ -0,0 +1,339 @@ + + + + + +DynamicProxyV8ValueObjectInvocationHandler (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.interop.proxy
+

Class DynamicProxyV8ValueObjectInvocationHandler

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.proxy.DynamicProxyV8ValueObjectInvocationHandler
      • +
    +
    • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    IJavetClosable, java.lang.AutoCloseable, java.lang.reflect.InvocationHandler
    +
    +
    +
    +
    public class DynamicProxyV8ValueObjectInvocationHandler
+extends java.lang.Object
+implements java.lang.reflect.InvocationHandler, IJavetClosable
    +
    The type Dynamic proxy V8 value object invocation handler.
    +
    • +
+
+
+
    +
  • + + + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + +
      All Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      voidclose() 
      java.lang.Objectinvoke(java.lang.Object proxy, + java.lang.reflect.Method method, + java.lang.Object[] args) 
      booleanisClosed() +
      Is closed.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        DynamicProxyV8ValueObjectInvocationHandler

        +
        public DynamicProxyV8ValueObjectInvocationHandler(V8ValueObject v8ValueObject)
        +
        Instantiates a new Dynamic proxy V8 value object invocation handler.
        +
        +
        Parameters:
        +
        v8ValueObject - the V8 value object
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + + + + + +
        +
      • +

        invoke

        +
        public java.lang.Object invoke(java.lang.Object proxy,
+                               java.lang.reflect.Method method,
+                               java.lang.Object[] args)
+                        throws java.lang.Throwable
        +
        +
        Specified by:
        +
        invoke in interface java.lang.reflect.InvocationHandler
        +
        Throws:
        +
        java.lang.Throwable
        +
        +
        • +
      + + + +
        +
      • +

        isClosed

        +
        public boolean isClosed()
        +
        Description copied from interface: IJavetClosable
        +
        Is closed.
        +
        +
        Specified by:
        +
        isClosed in interface IJavetClosable
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/proxy/IJavetProxyHandler.html b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/IJavetProxyHandler.html new file mode 100644 index 000000000..f6f964c7e --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/IJavetProxyHandler.html @@ -0,0 +1,545 @@ + + + + + +IJavetProxyHandler (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.interop.proxy
+

Interface IJavetProxyHandler<T>

+
+
+
+
    +
  • +
    +
    Type Parameters:
    +
    T - the type parameter
    +
    +
    +
    All Known Implementing Classes:
    +
    BaseJavetProxyHandler, JavetUniversalProxyHandler
    +
    +
    +
    +
    public interface IJavetProxyHandler<T>
    +
    The interface Javet proxy handler. +

    + https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy

    +
    +
    Since:
    +
    0.9.6
    +
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        apply

        +
        default V8Value apply(V8Value target,
+                      V8Value thisObject,
+                      V8ValueArray arguments)
+               throws JavetException
        +
        Apply to object
        +
        +
        Parameters:
        +
        target - the target
        +
        thisObject - the this object
        +
        arguments - the arguments
        +
        Returns:
        +
        the V8 value
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        construct

        +
        default V8Value construct(V8Value target,
+                          V8ValueArray arguments,
+                          V8Value newTarget)
+                   throws JavetException
        +
        Construct.
        +
        +
        Parameters:
        +
        target - the target
        +
        arguments - the arguments
        +
        newTarget - the new target
        +
        Returns:
        +
        the V8 value
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        get

        +
        default V8Value get(V8Value target,
+                    V8Value property,
+                    V8Value receiver)
+             throws JavetException
        +
        Get by property.
        +
        +
        Parameters:
        +
        target - the target
        +
        property - the property
        +
        receiver - the receiver
        +
        Returns:
        +
        the V8 value
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        getPrototypeOf

        +
        default V8Value getPrototypeOf(V8Value target)
+                        throws JavetException
        +
        Gets prototype of.
        +
        +
        Parameters:
        +
        target - the target
        +
        Returns:
        +
        the prototype of
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        getTargetObject

        +
        T getTargetObject()
        +
        Gets target object.
        +
        +
        Returns:
        +
        the target object
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + + + + + +
        +
      • +

        isExtensible

        +
        default V8ValueBoolean isExtensible(V8Value target)
+                             throws JavetException
        +
        Is extensible.
        +
        +
        Parameters:
        +
        target - the target
        +
        Returns:
        +
        the V8 value boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        ownKeys

        +
        default V8Value ownKeys(V8Value target)
+                 throws JavetException
        +
        Own keys V8 value.
        +
        +
        Parameters:
        +
        target - the target
        +
        Returns:
        +
        the V8 value
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        preventExtensions

        +
        default V8ValueBoolean preventExtensions(V8Value target)
+                                  throws JavetException
        +
        Prevent extensions.
        +
        +
        Parameters:
        +
        target - the target
        +
        Returns:
        +
        the V8 value boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        set

        +
        default V8ValueBoolean set(V8Value target,
+                           V8Value propertyKey,
+                           V8Value propertyValue,
+                           V8Value receiver)
+                    throws JavetException
        +
        Set value by property.
        +
        +
        Parameters:
        +
        target - the target
        +
        propertyKey - the property key
        +
        propertyValue - the property value
        +
        receiver - the receiver
        +
        Returns:
        +
        the V8 value boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        setPrototypeOf

        +
        default V8ValueBoolean setPrototypeOf(V8Value target,
+                                      V8Value prototype)
+                               throws JavetException
        +
        Sets prototype of.
        +
        +
        Parameters:
        +
        target - the target
        +
        prototype - the prototype
        +
        Returns:
        +
        the V8 value boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/proxy/JavetUniversalProxyHandler.JavetUniversalInterceptor.html b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/JavetUniversalProxyHandler.JavetUniversalInterceptor.html new file mode 100644 index 000000000..bfc52eeae --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/JavetUniversalProxyHandler.JavetUniversalInterceptor.html @@ -0,0 +1,397 @@ + + + + + +JavetUniversalProxyHandler.JavetUniversalInterceptor (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.interop.proxy
+

Class JavetUniversalProxyHandler.JavetUniversalInterceptor

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler.JavetUniversalInterceptor
      • +
    +
    • +
+
+
    +
  • +
    +
    Enclosing class:
    +
    JavetUniversalProxyHandler<T>
    +
    +
    +
    +
    public static class JavetUniversalProxyHandler.JavetUniversalInterceptor
+extends java.lang.Object
    +
    The type Javet universal interceptor.
    +
    +
    Since:
    +
    0.9.6
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + +
      Constructors 
      Constructor and Description
      JavetUniversalInterceptor(V8Runtime v8Runtime, + java.lang.Object targetObject, + java.lang.String jsMethodName, + java.util.List<java.lang.reflect.Method> methods) +
      Instantiates a new Javet universal interceptor.
      +
      +
      • +
    + + +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetUniversalInterceptor

        +
        public JavetUniversalInterceptor(V8Runtime v8Runtime,
+                                 java.lang.Object targetObject,
+                                 java.lang.String jsMethodName,
+                                 java.util.List<java.lang.reflect.Method> methods)
        +
        Instantiates a new Javet universal interceptor.
        +
        +
        Parameters:
        +
        v8Runtime - the V8 runtime
        +
        targetObject - the target object
        +
        jsMethodName - the JS method name
        +
        methods - the methods
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getCallbackContext

        +
        public JavetCallbackContext getCallbackContext()
        +
        Gets callback context.
        +
        +
        Returns:
        +
        the callback context
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        getJSMethodName

        +
        public java.lang.String getJSMethodName()
        +
        Gets JS method name.
        +
        +
        Returns:
        +
        the JS method name
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        getMethods

        +
        public java.util.List<java.lang.reflect.Method> getMethods()
        +
        Gets methods.
        +
        +
        Returns:
        +
        the methods
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        getTargetObject

        +
        public java.lang.Object getTargetObject()
        +
        Gets target object.
        +
        +
        Returns:
        +
        the target object
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        invoke

        +
        public java.lang.Object invoke(V8Value... v8Values)
+                        throws JavetException
        +
        Invoke.
        +
        +
        Parameters:
        +
        v8Values - the V8 values
        +
        Returns:
        +
        the object
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/proxy/JavetUniversalProxyHandler.ScoredExecutable.html b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/JavetUniversalProxyHandler.ScoredExecutable.html new file mode 100644 index 000000000..3669dab9c --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/JavetUniversalProxyHandler.ScoredExecutable.html @@ -0,0 +1,358 @@ + + + + + +JavetUniversalProxyHandler.ScoredExecutable (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.interop.proxy
+

Class JavetUniversalProxyHandler.ScoredExecutable<E extends java.lang.reflect.Executable>

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler.ScoredExecutable<E>
      • +
    +
    • +
+
+
    +
  • +
    +
    Type Parameters:
    +
    E - the type parameter
    +
    +
    +
    Enclosing class:
    +
    JavetUniversalProxyHandler<T>
    +
    +
    +
    +
    public static class JavetUniversalProxyHandler.ScoredExecutable<E extends java.lang.reflect.Executable>
+extends java.lang.Object
    +
    The type Scored executable.
    +
    +
    Since:
    +
    0.9.6
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + +
      Constructors 
      Constructor and Description
      ScoredExecutable(V8Runtime v8Runtime, + java.lang.Object targetObject, + E executable, + JavetVirtualObject[] javetVirtualObjects) +
      Instantiates a new Scored executable.
      +
      +
      • +
    + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + +
      All Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      voidcalculateScore() +
      Calculate score double.
      +
      java.lang.Objectexecute() +
      Execute.
      +
      doublegetScore() +
      Gets score.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + + + +
        +
      • +

        ScoredExecutable

        +
        public ScoredExecutable(V8Runtime v8Runtime,
+                        java.lang.Object targetObject,
+                        E executable,
+                        JavetVirtualObject[] javetVirtualObjects)
        +
        Instantiates a new Scored executable.
        +
        +
        Parameters:
        +
        v8Runtime - the V8 runtime
        +
        targetObject - the target object
        +
        executable - the executable
        +
        javetVirtualObjects - the javet virtual objects
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        calculateScore

        +
        public void calculateScore()
+                    throws JavetException
        +
        Calculate score double.
        +
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      + + + +
        +
      • +

        execute

        +
        public java.lang.Object execute()
+                         throws java.lang.Throwable
        +
        Execute.
        +
        +
        Returns:
        +
        the object
        +
        Throws:
        +
        java.lang.Throwable - the throwable
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      + + + +
        +
      • +

        getScore

        +
        public double getScore()
        +
        Gets score.
        +
        +
        Returns:
        +
        the score
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/proxy/JavetUniversalProxyHandler.html b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/JavetUniversalProxyHandler.html new file mode 100644 index 000000000..c526be03a --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/JavetUniversalProxyHandler.html @@ -0,0 +1,1237 @@ + + + + + +JavetUniversalProxyHandler (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.interop.proxy
+

Class JavetUniversalProxyHandler<T>

+
+
+ +
+
    +
  • +
    +
    Type Parameters:
    +
    T - the type parameter
    +
    +
    +
    All Implemented Interfaces:
    +
    IJavetProxyHandler<T>
    +
    +
    +
    +
    public class JavetUniversalProxyHandler<T>
+extends BaseJavetProxyHandler<T>
    +
    The type Javet universal proxy handler.
    +
    +
    Since:
    +
    0.9.6
    +
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        GETTER_PREFIX_ARRAY

        +
        protected static final java.lang.String[] GETTER_PREFIX_ARRAY
        +
        The constant GETTER_PREFIX_ARRAY.
        +
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        METHOD_NAME_CONSTRUCT

        +
        protected static final java.lang.String METHOD_NAME_CONSTRUCT
        +
        The constant METHOD_NAME_CONSTRUCT.
        +
        +
        Since:
        +
        0.9.9
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        METHOD_NAME_CONSTRUCTOR

        +
        protected static final java.lang.String METHOD_NAME_CONSTRUCTOR
        +
        The constant METHOD_NAME_CONSTRUCTOR.
        +
        +
        Since:
        +
        0.9.8
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PATTERN_CAPITALIZED_PREFIX

        +
        protected static final java.util.regex.Pattern PATTERN_CAPITALIZED_PREFIX
        +
        The constant PATTERN_CAPITALIZED_PREFIX.
        +
        +
        Since:
        +
        0.9.7
        +
        +
        • +
      + + + +
        +
      • +

        SETTER_PREFIX_ARRAY

        +
        protected static final java.lang.String[] SETTER_PREFIX_ARRAY
        +
        The constant SETTER_PREFIX_ARRAY.
        +
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        V8_VALUE_CLASS

        +
        protected static final java.lang.Class<?> V8_VALUE_CLASS
        +
        The constant V8_VALUE_CLASS.
        +
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      + + + +
        +
      • +

        V8_VALUE_FUNCTION_CLASS

        +
        protected static final java.lang.Class<?> V8_VALUE_FUNCTION_CLASS
        +
        The constant V8_VALUE_FUNCTION_CLASS.
        +
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      + + + +
        +
      • +

        V8_VALUE_OBJECT_CLASS

        +
        protected static final java.lang.Class<?> V8_VALUE_OBJECT_CLASS
        +
        The constant V8_VALUE_OBJECT_CLASS.
        +
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      + + + +
        +
      • +

        V8_VALUE_PROXY_CLASS

        +
        protected static final java.lang.Class<?> V8_VALUE_PROXY_CLASS
        +
        The constant V8_VALUE_PROXY_CLASS.
        +
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      + + + +
        +
      • +

        classMode

        +
        protected boolean classMode
        +
        The Class mode.
        +
        +
        Since:
        +
        0.9.9
        +
        +
        • +
      + + + +
        +
      • +

        constructors

        +
        protected java.util.List<java.lang.reflect.Constructor> constructors
        +
        The Constructors.
        +
        +
        Since:
        +
        0.9.8
        +
        +
        • +
      + + + +
        +
      • +

        fieldMap

        +
        protected java.util.Map<java.lang.String,java.lang.reflect.Field> fieldMap
        +
        The Field map.
        +
        +
        Since:
        +
        0.9.7
        +
        +
        • +
      + + + +
        +
      • +

        genericGetters

        +
        protected java.util.List<java.lang.reflect.Method> genericGetters
        +
        The Generic getters.
        +
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        genericSetters

        +
        protected java.util.List<java.lang.reflect.Method> genericSetters
        +
        The Generic setters.
        +
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        gettersMap

        +
        protected java.util.Map<java.lang.String,java.util.List<java.lang.reflect.Method>> gettersMap
        +
        The Getters map.
        +
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        isTargetTypeMap

        +
        protected boolean isTargetTypeMap
        +
        The Is target type map.
        +
        +
        Since:
        +
        0.9.7
        +
        +
        • +
      + + + +
        +
      • +

        isTargetTypeSet

        +
        protected boolean isTargetTypeSet
        +
        The Is target type set.
        +
        +
        Since:
        +
        0.9.7
        +
        +
        • +
      + + + +
        +
      • +

        methodsMap

        +
        protected java.util.Map<java.lang.String,java.util.List<java.lang.reflect.Method>> methodsMap
        +
        The Methods map.
        +
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        settersMap

        +
        protected java.util.Map<java.lang.String,java.util.List<java.lang.reflect.Method>> settersMap
        +
        The Setters map.
        +
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        targetClass

        +
        protected java.lang.Class<T> targetClass
        +
        The Target class.
        +
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        uniqueKeySet

        +
        protected java.util.Set<java.lang.String> uniqueKeySet
        +
        The Unique key set.
        +
        +
        Since:
        +
        0.9.7
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + + + +
        +
      • +

        JavetUniversalProxyHandler

        +
        public JavetUniversalProxyHandler(V8Runtime v8Runtime,
+                                  T targetObject)
        +
        Instantiates a new Javet universal proxy handler.
        +
        +
        Parameters:
        +
        v8Runtime - the V8 runtime
        +
        targetObject - the target object
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        execute

        +
        protected static <E extends java.lang.reflect.Executable> java.lang.Object execute(V8Runtime v8Runtime,
+                                                                                   java.lang.Object targetObject,
+                                                                                   java.util.List<E> executables,
+                                                                                   JavetVirtualObject[] javetVirtualObjects)
+                                                                            throws java.lang.Throwable
        +
        Execute.
        +
        +
        Type Parameters:
        +
        E - the type parameter
        +
        Parameters:
        +
        v8Runtime - the V8 runtime
        +
        targetObject - the target object
        +
        executables - the executables
        +
        javetVirtualObjects - the javet virtual objects
        +
        Returns:
        +
        the object
        +
        Throws:
        +
        java.lang.Throwable - the throwable
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      + + + +
        +
      • +

        isClassMode

        +
        public static boolean isClassMode(java.lang.Class objectClass)
        +
        Is class mode.
        +
        +
        Parameters:
        +
        objectClass - the object class
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      + + + +
        +
      • +

        addMethod

        +
        protected void addMethod(java.lang.reflect.Method method,
+                         int startIndex,
+                         java.util.Map<java.lang.String,java.util.List<java.lang.reflect.Method>> map)
        +
        Add method.
        +
        +
        Parameters:
        +
        method - the method
        +
        startIndex - the start index
        +
        map - the map
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + + + + + + + + + +
        +
      • +

        getGetterPrefixLength

        +
        protected int getGetterPrefixLength(java.lang.reflect.Method method)
        +
        Gets getter prefix length.
        +
        +
        Parameters:
        +
        method - the method
        +
        Returns:
        +
        the getter prefix length
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        getSetterPrefixLength

        +
        protected int getSetterPrefixLength(java.lang.reflect.Method method)
        +
        Gets setter prefix length.
        +
        +
        Parameters:
        +
        method - the method
        +
        Returns:
        +
        the setter prefix length
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + + + + + +
        +
      • +

        hasConstructors

        +
        public boolean hasConstructors()
        +
        Has constructors.
        +
        +
        Returns:
        +
        the boolean
        +
        Since:
        +
        0.9.9
        +
        +
        • +
      + + + +
        +
      • +

        initialize

        +
        protected void initialize()
        +
        Initialize.
        +
        +
        Since:
        +
        0.9.7
        +
        +
        • +
      + + + +
        +
      • +

        initializeFieldsAndMethods

        +
        protected void initializeFieldsAndMethods(java.lang.Class currentClass,
+                                          boolean staticMode)
        +
        Initialize fields and methods.
        +
        +
        Parameters:
        +
        currentClass - the current class
        +
        staticMode - the static mode
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        isClassMode

        +
        public boolean isClassMode()
        +
        Is class mode.
        +
        +
        Returns:
        +
        the boolean
        +
        Since:
        +
        0.9.9
        +
        +
        • +
      + + + +
        +
      • +

        isGenericGetter

        +
        protected boolean isGenericGetter(java.lang.reflect.Method method)
        +
        Is generic getter boolean.
        +
        +
        Parameters:
        +
        method - the method
        +
        Returns:
        +
        the boolean
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        isGenericSetter

        +
        protected boolean isGenericSetter(java.lang.reflect.Method method)
        +
        Is generic setter boolean.
        +
        +
        Parameters:
        +
        method - the method
        +
        Returns:
        +
        the boolean
        +
        Since:
        +
        0.9.6
        +
        +
        • +
      + + + +
        +
      • +

        isV8BindEnabled

        +
        @V8BindEnabler
+public boolean isV8BindEnabled(java.lang.String methodName)
        +
        Is V8 bind enabled.
        +
        +
        Parameters:
        +
        methodName - the method name
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      + + + + + + + + +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/proxy/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/package-frame.html new file mode 100644 index 000000000..26347dbde --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/package-frame.html @@ -0,0 +1,28 @@ + + + + + +com.caoccao.javet.interop.proxy (javet 0.9.12 API) + + + + +

com.caoccao.javet.interop.proxy

+
+

Interfaces

+ +

Classes

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/proxy/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/package-summary.html new file mode 100644 index 000000000..295eb9cbd --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/package-summary.html @@ -0,0 +1,201 @@ + + + + + +com.caoccao.javet.interop.proxy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.interop.proxy

+
+
Dynamic proxy handlers for polyfilling Java interfaces with JS functions or objects.
+
+

See: Description

+
+
+ + + + +

Package com.caoccao.javet.interop.proxy Description

+
Dynamic proxy handlers for polyfilling Java interfaces with JS functions or objects.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/interop/proxy/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/package-tree.html new file mode 100644 index 000000000..86529c835 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/interop/proxy/package-tree.html @@ -0,0 +1,146 @@ + + + + + +com.caoccao.javet.interop.proxy Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.interop.proxy

+Package Hierarchies: + +
+
+

Class Hierarchy

+ +

Interface Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/node/modules/BaseNodeModule.html b/docs/reference/javadoc/com/caoccao/javet/node/modules/BaseNodeModule.html new file mode 100644 index 000000000..689349f43 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/node/modules/BaseNodeModule.html @@ -0,0 +1,394 @@ + + + + + +BaseNodeModule (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.node.modules
+

Class BaseNodeModule

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.node.modules.BaseNodeModule
      • +
    +
    • +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Summary

      + + + + + + + + + + + + + + +
      Fields 
      Modifier and TypeField and Description
      protected V8ValueObjectmoduleObject 
      protected java.lang.Stringname 
      +
      • +
    + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + +
      Constructors 
      Constructor and Description
      BaseNodeModule(V8ValueObject moduleObject, + java.lang.String name) 
      +
      • +
    + + +
    • +
+
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/node/modules/INodeModule.html b/docs/reference/javadoc/com/caoccao/javet/node/modules/INodeModule.html new file mode 100644 index 000000000..e96eec4cb --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/node/modules/INodeModule.html @@ -0,0 +1,247 @@ + + + + + +INodeModule (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.node.modules
+

Interface INodeModule

+
+
+
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + + + + + +
        +
      • +

        getName

        +
        java.lang.String getName()
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/node/modules/NodeModuleAny.html b/docs/reference/javadoc/com/caoccao/javet/node/modules/NodeModuleAny.html new file mode 100644 index 000000000..993bdd2f0 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/node/modules/NodeModuleAny.html @@ -0,0 +1,267 @@ + + + + + +NodeModuleAny (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ +
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.node.modules
+

Class NodeModuleAny

+
+
+ +
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        NodeModuleAny

        +
        public NodeModuleAny(V8ValueObject moduleObject,
+                     java.lang.String name)
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ +
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/node/modules/NodeModuleModule.html b/docs/reference/javadoc/com/caoccao/javet/node/modules/NodeModuleModule.html new file mode 100644 index 000000000..8d80934fe --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/node/modules/NodeModuleModule.html @@ -0,0 +1,356 @@ + + + + + +NodeModuleModule (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.node.modules
+

Class NodeModuleModule

+
+
+ +
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        FUNCTION_CREATE_REQUIRE

        +
        public static final java.lang.String FUNCTION_CREATE_REQUIRE
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PROPERTY_REQUIRE

        +
        public static final java.lang.String PROPERTY_REQUIRE
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        NodeModuleModule

        +
        public NodeModuleModule(V8ValueObject moduleObject,
+                        java.lang.String name)
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        setRequireRootDirectory

        +
        public void setRequireRootDirectory(java.nio.file.Path path)
+                             throws JavetException
        +
        +
        Throws:
        +
        JavetException
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/node/modules/NodeModuleProcess.html b/docs/reference/javadoc/com/caoccao/javet/node/modules/NodeModuleProcess.html new file mode 100644 index 000000000..408af7d60 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/node/modules/NodeModuleProcess.html @@ -0,0 +1,446 @@ + + + + + +NodeModuleProcess (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.node.modules
+

Class NodeModuleProcess

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/node/modules/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/node/modules/package-frame.html new file mode 100644 index 000000000..4f61b27ef --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/node/modules/package-frame.html @@ -0,0 +1,26 @@ + + + + + +com.caoccao.javet.node.modules (javet 0.9.12 API) + + + + +

com.caoccao.javet.node.modules

+
+

Interfaces

+ +

Classes

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/node/modules/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/node/modules/package-summary.html new file mode 100644 index 000000000..bff021634 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/node/modules/package-summary.html @@ -0,0 +1,179 @@ + + + + + +com.caoccao.javet.node.modules (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.node.modules

+
+
Reference classes for Node.js built-in modules.
+
+

See: Description

+
+
+ + + + +

Package com.caoccao.javet.node.modules Description

+
Reference classes for Node.js built-in modules.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/node/modules/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/node/modules/package-tree.html new file mode 100644 index 000000000..01e2a2096 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/node/modules/package-tree.html @@ -0,0 +1,152 @@ + + + + + +com.caoccao.javet.node.modules Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.node.modules

+Package Hierarchies: + +
+
+

Class Hierarchy

+ +

Interface Hierarchy

+
    +
  • java.lang.AutoCloseable + +
    • +
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/utils/JavetDateTimeUtils.html b/docs/reference/javadoc/com/caoccao/javet/utils/JavetDateTimeUtils.html new file mode 100644 index 000000000..cd0b329f8 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/utils/JavetDateTimeUtils.html @@ -0,0 +1,330 @@ + + + + + +JavetDateTimeUtils (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.utils
+

Class JavetDateTimeUtils

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.utils.JavetDateTimeUtils
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public final class JavetDateTimeUtils
+extends java.lang.Object
    +
    The type Date time utils.
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Summary

      + + + + + + + + + + +
      Fields 
      Modifier and TypeField and Description
      static java.time.ZoneIdZONE_ID_UTC +
      The constant ZONE_ID_UTC.
      +
      +
      • +
    + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + +
      All Methods Static Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static java.time.ZonedDateTimegetUTCNow() +
      Gets utc now.
      +
      static java.time.ZonedDateTimetoZonedDateTime(long jsTimestamp) +
      From JS timestamp to zoned date time.
      +
      static java.time.ZonedDateTimetoZonedDateTime(long jsTimestamp, + java.time.ZoneId zoneId) +
      From JS timestamp to zoned date time.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        ZONE_ID_UTC

        +
        public static final java.time.ZoneId ZONE_ID_UTC
        +
        The constant ZONE_ID_UTC.
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getUTCNow

        +
        public static java.time.ZonedDateTime getUTCNow()
        +
        Gets utc now.
        +
        +
        Returns:
        +
        the utc now
        +
        +
        • +
      + + + +
        +
      • +

        toZonedDateTime

        +
        public static java.time.ZonedDateTime toZonedDateTime(long jsTimestamp,
+                                                      java.time.ZoneId zoneId)
        +
        From JS timestamp to zoned date time.
        +
        +
        Parameters:
        +
        jsTimestamp - the JS timestamp
        +
        zoneId - the zone id
        +
        Returns:
        +
        the zoned date time
        +
        +
        • +
      + + + +
        +
      • +

        toZonedDateTime

        +
        public static java.time.ZonedDateTime toZonedDateTime(long jsTimestamp)
        +
        From JS timestamp to zoned date time. +

        + Note: the ZoneId needs to be system default because that's what V8 sees.

        +
        +
        Parameters:
        +
        jsTimestamp - the JS timestamp
        +
        Returns:
        +
        the zoned date time
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/utils/JavetDefaultLogger.html b/docs/reference/javadoc/com/caoccao/javet/utils/JavetDefaultLogger.html new file mode 100644 index 000000000..eac95c4cd --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/utils/JavetDefaultLogger.html @@ -0,0 +1,460 @@ + + + + + +JavetDefaultLogger (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.utils
+

Class JavetDefaultLogger

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.utils.JavetDefaultLogger
      • +
    +
    • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    IJavetLogger
    +
    +
    +
    +
    public class JavetDefaultLogger
+extends java.lang.Object
+implements IJavetLogger
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Summary

      + + + + + + + + + + + + + + +
      Fields 
      Modifier and TypeField and Description
      protected java.util.logging.Loggerlogger 
      protected java.lang.Stringname 
      +
      • +
    + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + +
      Constructors 
      Constructor and Description
      JavetDefaultLogger(java.lang.String name) 
      +
      • +
    + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      All Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      voiddebug(java.lang.String message) +
      Debug.
      +
      voiderror(java.lang.String message) +
      Error.
      +
      voiderror(java.lang.String message, + java.lang.Throwable cause) +
      Error.
      +
      java.util.logging.LoggergetLogger() 
      java.lang.StringgetName() 
      voidinfo(java.lang.String message) +
      Info.
      +
      voidwarn(java.lang.String message) +
      Warn.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      + +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        logger

        +
        protected java.util.logging.Logger logger
        +
        • +
      + + + +
        +
      • +

        name

        +
        protected java.lang.String name
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetDefaultLogger

        +
        public JavetDefaultLogger(java.lang.String name)
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        debug

        +
        public void debug(java.lang.String message)
        +
        Description copied from interface: IJavetLogger
        +
        Debug.
        +
        +
        Specified by:
        +
        debug in interface IJavetLogger
        +
        Parameters:
        +
        message - the message
        +
        +
        • +
      + + + +
        +
      • +

        error

        +
        public void error(java.lang.String message)
        +
        Description copied from interface: IJavetLogger
        +
        Error.
        +
        +
        Specified by:
        +
        error in interface IJavetLogger
        +
        Parameters:
        +
        message - the message
        +
        +
        • +
      + + + +
        +
      • +

        error

        +
        public void error(java.lang.String message,
+                  java.lang.Throwable cause)
        +
        Description copied from interface: IJavetLogger
        +
        Error.
        +
        +
        Specified by:
        +
        error in interface IJavetLogger
        +
        Parameters:
        +
        message - the message
        +
        cause - the cause
        +
        +
        • +
      + + + +
        +
      • +

        getLogger

        +
        public java.util.logging.Logger getLogger()
        +
        • +
      + + + +
        +
      • +

        getName

        +
        public java.lang.String getName()
        +
        • +
      + + + +
        +
      • +

        info

        +
        public void info(java.lang.String message)
        +
        Description copied from interface: IJavetLogger
        +
        Info.
        +
        +
        Specified by:
        +
        info in interface IJavetLogger
        +
        Parameters:
        +
        message - the message
        +
        +
        • +
      + + + +
        +
      • +

        warn

        +
        public void warn(java.lang.String message)
        +
        Description copied from interface: IJavetLogger
        +
        Warn.
        +
        +
        Specified by:
        +
        warn in interface IJavetLogger
        +
        Parameters:
        +
        message - the message
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/utils/JavetOSUtils.html b/docs/reference/javadoc/com/caoccao/javet/utils/JavetOSUtils.html new file mode 100644 index 000000000..c07571799 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/utils/JavetOSUtils.html @@ -0,0 +1,361 @@ + + + + + +JavetOSUtils (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.utils
+

Class JavetOSUtils

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.utils.JavetOSUtils
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public final class JavetOSUtils
+extends java.lang.Object
    +
    • +
+
+
+
    +
  • + + + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + +
      All Methods Static Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static intgetCPUCount() 
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        OS_NAME

        +
        public static final java.lang.String OS_NAME
        +
        • +
      + + + +
        +
      • +

        IS_LINUX

        +
        public static final boolean IS_LINUX
        +
        • +
      + + + +
        +
      • +

        IS_MACOS

        +
        public static final boolean IS_MACOS
        +
        • +
      + + + +
        +
      • +

        IS_WINDOWS

        +
        public static final boolean IS_WINDOWS
        +
        • +
      + + + +
        +
      • +

        PROCESS_ID

        +
        public static final long PROCESS_ID
        +
        • +
      + + + +
        +
      • +

        LINE_SEPARATOR

        +
        public static final java.lang.String LINE_SEPARATOR
        +
        • +
      + + + +
        +
      • +

        TEMP_DIRECTORY

        +
        public static final java.lang.String TEMP_DIRECTORY
        +
        • +
      + + + +
        +
      • +

        WORKING_DIRECTORY

        +
        public static final java.lang.String WORKING_DIRECTORY
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getCPUCount

        +
        public static int getCPUCount()
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/utils/JavetPrimitiveUtils.html b/docs/reference/javadoc/com/caoccao/javet/utils/JavetPrimitiveUtils.html new file mode 100644 index 000000000..344f3f6e8 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/utils/JavetPrimitiveUtils.html @@ -0,0 +1,270 @@ + + + + + +JavetPrimitiveUtils (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.utils
+

Class JavetPrimitiveUtils

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.utils.JavetPrimitiveUtils
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public final class JavetPrimitiveUtils
+extends java.lang.Object
    +
    • +
+
+
+
    +
  • + + + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + +
      All Methods Static Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static java.lang.ObjecttoExactPrimitive(java.lang.Class<?> expectedClass, + java.lang.Object object) 
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetPrimitiveUtils

        +
        public JavetPrimitiveUtils()
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        toExactPrimitive

        +
        public static java.lang.Object toExactPrimitive(java.lang.Class<?> expectedClass,
+                                                java.lang.Object object)
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/utils/JavetPromiseRejectCallback.html b/docs/reference/javadoc/com/caoccao/javet/utils/JavetPromiseRejectCallback.html new file mode 100644 index 000000000..74376c0f0 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/utils/JavetPromiseRejectCallback.html @@ -0,0 +1,325 @@ + + + + + +JavetPromiseRejectCallback (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.utils
+

Class JavetPromiseRejectCallback

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.utils.JavetPromiseRejectCallback
      • +
    +
    • +
+
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/utils/JavetReflectionUtils.html b/docs/reference/javadoc/com/caoccao/javet/utils/JavetReflectionUtils.html new file mode 100644 index 000000000..23751a92e --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/utils/JavetReflectionUtils.html @@ -0,0 +1,248 @@ + + + + + +JavetReflectionUtils (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.utils
+

Class JavetReflectionUtils

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.utils.JavetReflectionUtils
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public final class JavetReflectionUtils
+extends java.lang.Object
    +
    The type Javet reflection utils.
    +
    +
    Since:
    +
    0.9.7
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + +
      All Methods Static Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static voidsafeSetAccessible(java.lang.reflect.AccessibleObject accessibleObject) +
      Safe set accessible.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        safeSetAccessible

        +
        public static void safeSetAccessible(java.lang.reflect.AccessibleObject accessibleObject)
        +
        Safe set accessible.
        +
        +
        Parameters:
        +
        accessibleObject - the accessible object
        +
        Since:
        +
        0.9.7
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/utils/JavetResourceUtils.html b/docs/reference/javadoc/com/caoccao/javet/utils/JavetResourceUtils.html new file mode 100644 index 000000000..9d25b704c --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/utils/JavetResourceUtils.html @@ -0,0 +1,321 @@ + + + + + +JavetResourceUtils (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.utils
+

Class JavetResourceUtils

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.utils.JavetResourceUtils
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public final class JavetResourceUtils
+extends java.lang.Object
    +
    The type Javet resource utils.
    +
    +
    Since:
    +
    0.7.0
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + + + + + +
      All Methods Static Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static booleanisClosed(java.lang.Object object) +
      Is closed.
      +
      static voidsafeClose(java.lang.Object... objects) +
      Safe close.
      +
      static voidsafeClose(java.lang.Object object) +
      Safe close.
      +
      static V8Value[]toClone(V8Value[] v8Values) +
      To clone V8 value array.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        isClosed

        +
        public static boolean isClosed(java.lang.Object object)
        +
        Is closed.
        +
        +
        Parameters:
        +
        object - the object
        +
        Returns:
        +
        the boolean
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      + + + +
        +
      • +

        safeClose

        +
        public static void safeClose(java.lang.Object... objects)
        +
        Safe close.
        +
        +
        Parameters:
        +
        objects - the objects
        +
        Since:
        +
        0.7.1
        +
        +
        • +
      + + + +
        +
      • +

        safeClose

        +
        public static void safeClose(java.lang.Object object)
        +
        Safe close.
        +
        +
        Parameters:
        +
        object - the object
        +
        Since:
        +
        0.7.1
        +
        +
        • +
      + + + +
        +
      • +

        toClone

        +
        public static V8Value[] toClone(V8Value[] v8Values)
+                         throws JavetException
        +
        To clone V8 value array.
        +
        +
        Parameters:
        +
        v8Values - the V8 values
        +
        Returns:
        +
        the V8 value array
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.11
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/utils/JavetVirtualObject.html b/docs/reference/javadoc/com/caoccao/javet/utils/JavetVirtualObject.html new file mode 100644 index 000000000..0cacf4121 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/utils/JavetVirtualObject.html @@ -0,0 +1,421 @@ + + + + + +JavetVirtualObject (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.utils
+

Class JavetVirtualObject

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.utils.JavetVirtualObject
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public class JavetVirtualObject
+extends java.lang.Object
    +
    The type Javet virtual object.
    +
    +
    Since:
    +
    0.9.10
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Summary

      + + + + + + + + + + + + + + + + + + +
      Fields 
      Modifier and TypeField and Description
      protected booleanconverted +
      The Converted.
      +
      protected java.lang.Objectobject +
      The Object.
      +
      protected V8Valuev8Value +
      The V8 value.
      +
      +
      • +
    + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + +
      Constructors 
      Constructor and Description
      JavetVirtualObject(V8Value v8Value) +
      Instantiates a new Javet virtual object.
      +
      +
      • +
    + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + +
      All Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      java.lang.ObjectgetObject() +
      Gets object.
      +
      V8ValuegetV8Value() +
      Gets V8 value.
      +
      booleanisConverted() +
      Is converted.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        converted

        +
        protected boolean converted
        +
        The Converted.
        +
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      + + + +
        +
      • +

        object

        +
        protected java.lang.Object object
        +
        The Object.
        +
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      + + + +
        +
      • +

        v8Value

        +
        protected V8Value v8Value
        +
        The V8 value.
        +
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetVirtualObject

        +
        public JavetVirtualObject(V8Value v8Value)
        +
        Instantiates a new Javet virtual object.
        +
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getObject

        +
        public java.lang.Object getObject()
+                           throws JavetException
        +
        Gets object.
        +
        +
        Returns:
        +
        the object
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      + + + +
        +
      • +

        getV8Value

        +
        public V8Value getV8Value()
        +
        Gets V8 value.
        +
        +
        Returns:
        +
        the V8 value
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      + + + +
        +
      • +

        isConverted

        +
        public boolean isConverted()
        +
        Is converted.
        +
        +
        Returns:
        +
        the boolean
        +
        Since:
        +
        0.9.10
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/utils/SimpleFreeMarkerFormat.html b/docs/reference/javadoc/com/caoccao/javet/utils/SimpleFreeMarkerFormat.html new file mode 100644 index 000000000..40699be58 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/utils/SimpleFreeMarkerFormat.html @@ -0,0 +1,310 @@ + + + + + +SimpleFreeMarkerFormat (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.utils
+

Class SimpleFreeMarkerFormat

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.utils.SimpleFreeMarkerFormat
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public final class SimpleFreeMarkerFormat
+extends java.lang.Object
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Summary

      + + + + + + + + + + +
      Fields 
      Modifier and TypeField and Description
      static java.lang.StringSTRING_NULL 
      +
      • +
    + + + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + +
      All Methods Static Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static java.lang.Stringformat(java.lang.String format, + java.util.Map<java.lang.String,java.lang.Object> parameters) 
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + + + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        SimpleFreeMarkerFormat

        +
        public SimpleFreeMarkerFormat()
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        format

        +
        public static java.lang.String format(java.lang.String format,
+                                      java.util.Map<java.lang.String,java.lang.Object> parameters)
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/utils/SimpleMap.html b/docs/reference/javadoc/com/caoccao/javet/utils/SimpleMap.html new file mode 100644 index 000000000..f2d50716c --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/utils/SimpleMap.html @@ -0,0 +1,504 @@ + + + + + +SimpleMap (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.utils
+

Class SimpleMap

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.utils.SimpleMap
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public final class SimpleMap
+extends java.lang.Object
    +
    The type Simple map is a polyfill because Map.of is not available at JDK 8 .
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + +
      Constructors 
      Constructor and Description
      SimpleMap() 
      +
      • +
    + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      All Methods Static Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static <K,V> java.util.Map<K,V>of(K k1, + V v1) 
      static <K,V> java.util.Map<K,V>of(K k1, + V v1, + K k2, + V v2) 
      static <K,V> java.util.Map<K,V>of(K k1, + V v1, + K k2, + V v2, + K k3, + V v3) 
      static <K,V> java.util.Map<K,V>of(K k1, + V v1, + K k2, + V v2, + K k3, + V v3, + K k4, + V v4) 
      static <K,V> java.util.Map<K,V>of(K k1, + V v1, + K k2, + V v2, + K k3, + V v3, + K k4, + V v4, + K k5, + V v5) 
      static <K,V> java.util.Map<K,V>of(K k1, + V v1, + K k2, + V v2, + K k3, + V v3, + K k4, + V v4, + K k5, + V v5, + K k6, + V v6) 
      static <K,V> java.util.Map<K,V>of(K k1, + V v1, + K k2, + V v2, + K k3, + V v3, + K k4, + V v4, + K k5, + V v5, + K k6, + V v6, + K k7, + V v7) 
      static <K,V> java.util.Map<K,V>of(K k1, + V v1, + K k2, + V v2, + K k3, + V v3, + K k4, + V v4, + K k5, + V v5, + K k6, + V v6, + K k7, + V v7, + K k8, + V v8) 
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        SimpleMap

        +
        public SimpleMap()
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + + + +
        +
      • +

        of

        +
        public static <K,V> java.util.Map<K,V> of(K k1,
+                                          V v1)
        +
        • +
      + + + + + +
        +
      • +

        of

        +
        public static <K,V> java.util.Map<K,V> of(K k1,
+                                          V v1,
+                                          K k2,
+                                          V v2)
        +
        • +
      + + + + + +
        +
      • +

        of

        +
        public static <K,V> java.util.Map<K,V> of(K k1,
+                                          V v1,
+                                          K k2,
+                                          V v2,
+                                          K k3,
+                                          V v3)
        +
        • +
      + + + + + +
        +
      • +

        of

        +
        public static <K,V> java.util.Map<K,V> of(K k1,
+                                          V v1,
+                                          K k2,
+                                          V v2,
+                                          K k3,
+                                          V v3,
+                                          K k4,
+                                          V v4)
        +
        • +
      + + + + + +
        +
      • +

        of

        +
        public static <K,V> java.util.Map<K,V> of(K k1,
+                                          V v1,
+                                          K k2,
+                                          V v2,
+                                          K k3,
+                                          V v3,
+                                          K k4,
+                                          V v4,
+                                          K k5,
+                                          V v5)
        +
        • +
      + + + + + +
        +
      • +

        of

        +
        public static <K,V> java.util.Map<K,V> of(K k1,
+                                          V v1,
+                                          K k2,
+                                          V v2,
+                                          K k3,
+                                          V v3,
+                                          K k4,
+                                          V v4,
+                                          K k5,
+                                          V v5,
+                                          K k6,
+                                          V v6)
        +
        • +
      + + + + + +
        +
      • +

        of

        +
        public static <K,V> java.util.Map<K,V> of(K k1,
+                                          V v1,
+                                          K k2,
+                                          V v2,
+                                          K k3,
+                                          V v3,
+                                          K k4,
+                                          V v4,
+                                          K k5,
+                                          V v5,
+                                          K k6,
+                                          V v6,
+                                          K k7,
+                                          V v7)
        +
        • +
      + + + + + +
        +
      • +

        of

        +
        public static <K,V> java.util.Map<K,V> of(K k1,
+                                          V v1,
+                                          K k2,
+                                          V v2,
+                                          K k3,
+                                          V v3,
+                                          K k4,
+                                          V v4,
+                                          K k5,
+                                          V v5,
+                                          K k6,
+                                          V v6,
+                                          K k7,
+                                          V v7,
+                                          K k8,
+                                          V v8)
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/utils/V8ValueUtils.html b/docs/reference/javadoc/com/caoccao/javet/utils/V8ValueUtils.html new file mode 100644 index 000000000..4ba52178c --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/utils/V8ValueUtils.html @@ -0,0 +1,312 @@ + + + + + +V8ValueUtils (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.utils
+

Class V8ValueUtils

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.utils.V8ValueUtils
      • +
    +
    • +
+
+
    +
  • +
    +
    +
    public final class V8ValueUtils
+extends java.lang.Object
    +
    The type V8 value utils.
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Summary

      + + + + + + + + + + +
      Fields 
      Modifier and TypeField and Description
      static java.lang.StringEMPTY +
      The constant EMPTY.
      +
      +
      • +
    + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + +
      All Methods Static Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static java.lang.Stringconcat(java.lang.String delimiter, + V8Value... v8Values) +
      Concat string.
      +
      static JavetVirtualObject[]convertToVirtualObjects(V8Value... v8Values) +
      Convert to virtual objects.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        EMPTY

        +
        public static final java.lang.String EMPTY
        +
        The constant EMPTY.
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        concat

        +
        public static java.lang.String concat(java.lang.String delimiter,
+                                      V8Value... v8Values)
        +
        Concat string.
        +
        +
        Parameters:
        +
        delimiter - the delimiter
        +
        v8Values - the V8 values
        +
        Returns:
        +
        the string
        +
        +
        • +
      + + + +
        +
      • +

        convertToVirtualObjects

        +
        public static JavetVirtualObject[] convertToVirtualObjects(V8Value... v8Values)
        +
        Convert to virtual objects.
        +
        +
        Parameters:
        +
        v8Values - the V8 values
        +
        Returns:
        +
        the javet virtual objects
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/utils/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/utils/package-frame.html new file mode 100644 index 000000000..99071e9ad --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/utils/package-frame.html @@ -0,0 +1,29 @@ + + + + + +com.caoccao.javet.utils (javet 0.9.12 API) + + + + +

com.caoccao.javet.utils

+
+

Classes

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/utils/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/utils/package-summary.html new file mode 100644 index 000000000..e1b80d28d --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/utils/package-summary.html @@ -0,0 +1,204 @@ + + + + + +com.caoccao.javet.utils (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.utils

+
+
Built-in utilities.
+
+

See: Description

+
+
+ + + + +

Package com.caoccao.javet.utils Description

+
Built-in utilities.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/utils/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/utils/package-tree.html new file mode 100644 index 000000000..2737931d1 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/utils/package-tree.html @@ -0,0 +1,144 @@ + + + + + +com.caoccao.javet.utils Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.utils

+Package Hierarchies: + +
+
+

Class Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/utils/receivers/IJavetCallbackReceiver.html b/docs/reference/javadoc/com/caoccao/javet/utils/receivers/IJavetCallbackReceiver.html new file mode 100644 index 000000000..164b9ac57 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/utils/receivers/IJavetCallbackReceiver.html @@ -0,0 +1,416 @@ + + + + + +IJavetCallbackReceiver (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.utils.receivers
+

Interface IJavetCallbackReceiver

+
+
+
+
    +
  • +
    +
    All Known Implementing Classes:
    +
    JavetCallbackReceiver
    +
    +
    +
    +
    public interface IJavetCallbackReceiver
    +
    The interface Javet callback receiver.
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      All Methods Instance Methods Abstract Methods Default Methods 
      Modifier and TypeMethod and Description
      default java.lang.reflect.MethodgetMethod(java.lang.String methodName) +
      Gets method that does not take any arguments by method name.
      +
      default java.lang.reflect.MethodgetMethod(java.lang.String methodName, + boolean thisObjectRequired) +
      Gets method.
      +
      default java.lang.reflect.MethodgetMethod(java.lang.String methodName, + boolean thisObjectRequired, + int argCount) +
      Gets method that takes given number of arguments by method name.
      +
      default java.lang.reflect.MethodgetMethod(java.lang.String methodName, + java.lang.Class<?>... parameterTypes) +
      Gets method that is customized to given argument types by method name.
      +
      default java.lang.reflect.MethodgetMethod(java.lang.String methodName, + int argCount) +
      Gets method.
      +
      default java.lang.reflect.MethodgetMethodVarargs(java.lang.String methodName) +
      Gets method that takes an arbitrary number of arguments by method name.
      +
      default java.lang.reflect.MethodgetMethodVarargs(java.lang.String methodName, + boolean thisObjectRequired) +
      Gets method that takes an arbitrary number of arguments by method name.
      +
      V8RuntimegetV8Runtime() 
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getMethod

        +
        default java.lang.reflect.Method getMethod(java.lang.String methodName)
+                                    throws java.lang.NoSuchMethodException
        +
        Gets method that does not take any arguments by method name.
        +
        +
        Parameters:
        +
        methodName - the method name
        +
        Returns:
        +
        the method
        +
        Throws:
        +
        java.lang.NoSuchMethodException - the no such method exception
        +
        +
        • +
      + + + +
        +
      • +

        getMethod

        +
        default java.lang.reflect.Method getMethod(java.lang.String methodName,
+                                           int argCount)
+                                    throws java.lang.NoSuchMethodException
        +
        Gets method.
        +
        +
        Parameters:
        +
        methodName - the method name
        +
        argCount - the arg count
        +
        Returns:
        +
        the method
        +
        Throws:
        +
        java.lang.NoSuchMethodException - the no such method exception
        +
        +
        • +
      + + + +
        +
      • +

        getMethod

        +
        default java.lang.reflect.Method getMethod(java.lang.String methodName,
+                                           boolean thisObjectRequired)
+                                    throws java.lang.NoSuchMethodException
        +
        Gets method.
        +
        +
        Parameters:
        +
        methodName - the method name
        +
        thisObjectRequired - the this object required
        +
        Returns:
        +
        the method
        +
        Throws:
        +
        java.lang.NoSuchMethodException - the no such method exception
        +
        +
        • +
      + + + +
        +
      • +

        getMethod

        +
        default java.lang.reflect.Method getMethod(java.lang.String methodName,
+                                           boolean thisObjectRequired,
+                                           int argCount)
+                                    throws java.lang.NoSuchMethodException
        +
        Gets method that takes given number of arguments by method name.
        +
        +
        Parameters:
        +
        methodName - the method name
        +
        thisObjectRequired - the this object required
        +
        argCount - the arg count
        +
        Returns:
        +
        the method
        +
        Throws:
        +
        java.lang.NoSuchMethodException - the no such method exception
        +
        +
        • +
      + + + +
        +
      • +

        getMethod

        +
        default java.lang.reflect.Method getMethod(java.lang.String methodName,
+                                           java.lang.Class<?>... parameterTypes)
+                                    throws java.lang.NoSuchMethodException
        +
        Gets method that is customized to given argument types by method name.
        +
        +
        Parameters:
        +
        methodName - the method name
        +
        parameterTypes - the parameter types
        +
        Returns:
        +
        the method
        +
        Throws:
        +
        java.lang.NoSuchMethodException - the no such method exception
        +
        +
        • +
      + + + +
        +
      • +

        getMethodVarargs

        +
        default java.lang.reflect.Method getMethodVarargs(java.lang.String methodName)
+                                           throws java.lang.NoSuchMethodException
        +
        Gets method that takes an arbitrary number of arguments by method name.
        +
        +
        Parameters:
        +
        methodName - the method name
        +
        Returns:
        +
        the method varargs
        +
        Throws:
        +
        java.lang.NoSuchMethodException - the no such method exception
        +
        +
        • +
      + + + +
        +
      • +

        getMethodVarargs

        +
        default java.lang.reflect.Method getMethodVarargs(java.lang.String methodName,
+                                                  boolean thisObjectRequired)
+                                           throws java.lang.NoSuchMethodException
        +
        Gets method that takes an arbitrary number of arguments by method name.
        +
        +
        Parameters:
        +
        methodName - the method name
        +
        thisObjectRequired - the this object required
        +
        Returns:
        +
        the method varargs
        +
        Throws:
        +
        java.lang.NoSuchMethodException - the no such method exception
        +
        +
        • +
      + + + +
        +
      • +

        getV8Runtime

        +
        V8Runtime getV8Runtime()
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/utils/receivers/JavetCallbackReceiver.html b/docs/reference/javadoc/com/caoccao/javet/utils/receivers/JavetCallbackReceiver.html new file mode 100644 index 000000000..fd83b89d8 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/utils/receivers/JavetCallbackReceiver.html @@ -0,0 +1,472 @@ + + + + + +JavetCallbackReceiver (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.utils.receivers
+

Class JavetCallbackReceiver

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.utils.receivers.JavetCallbackReceiver
      • +
    +
    • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    IJavetCallbackReceiver
    +
    +
    +
    +
    public class JavetCallbackReceiver
+extends java.lang.Object
+implements IJavetCallbackReceiver
    +
    The type Javet explicit callback receiver. +

    + It is supposed to provide a common ground for customized V8 callback receiver.

    +
    • +
+
+
+ +
+
+
    +
  • + + + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        JavetCallbackReceiver

        +
        public JavetCallbackReceiver(V8Runtime v8Runtime)
        +
        Instantiates a new V8 callback receiver.
        +
        +
        Parameters:
        +
        v8Runtime - the V8 runtime
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + + + + + +
        +
      • +

        echo

        +
        @CheckReturnValue
+public V8ValueArray echo(V8Value... args)
+                                     throws JavetException
        +
        Echo the given V8 value array. +

        + Note: Lifecycle of the input and return arrays is managed by the caller.

        +
        +
        Parameters:
        +
        args - the args
        +
        Returns:
        +
        the V8 value array
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        echoString

        +
        public java.lang.String echoString(java.lang.String str)
        +
        Echo string from input string.
        +
        +
        Parameters:
        +
        str - the str
        +
        Returns:
        +
        the string
        +
        +
        • +
      + + + +
        +
      • +

        echoString

        +
        public java.lang.String echoString(V8Value arg)
        +
        Echo string from input V8 value.
        +
        +
        Parameters:
        +
        arg - the arg
        +
        Returns:
        +
        the string
        +
        +
        • +
      + + + +
        +
      • +

        echoString

        +
        public java.lang.String echoString(V8Value... args)
        +
        Echo string from the given V8 value array. +

        + Note: Lifecycle of the input and return arrays is managed by the caller.

        +
        +
        Parameters:
        +
        args - the args
        +
        Returns:
        +
        the string
        +
        +
        • +
      + + + + +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/utils/receivers/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/utils/receivers/package-frame.html new file mode 100644 index 000000000..a026fc9a1 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/utils/receivers/package-frame.html @@ -0,0 +1,23 @@ + + + + + +com.caoccao.javet.utils.receivers (javet 0.9.12 API) + + + + +

com.caoccao.javet.utils.receivers

+
+

Interfaces

+ +

Classes

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/utils/receivers/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/utils/receivers/package-summary.html new file mode 100644 index 000000000..fe6233d68 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/utils/receivers/package-summary.html @@ -0,0 +1,171 @@ + + + + + +com.caoccao.javet.utils.receivers (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.utils.receivers

+
+
Built-in callback receivers.
+
+

See: Description

+
+
+
    +
  • + + + + + + + + + + + + +
    Interface Summary 
    InterfaceDescription
    IJavetCallbackReceiver +
    The interface Javet callback receiver.
    +
    +
    • +
  • + + + + + + + + + + + + +
    Class Summary 
    ClassDescription
    JavetCallbackReceiver +
    The type Javet explicit callback receiver.
    +
    +
    • +
+ + + +

Package com.caoccao.javet.utils.receivers Description

+
Built-in callback receivers.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/utils/receivers/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/utils/receivers/package-tree.html new file mode 100644 index 000000000..edeb46a5a --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/utils/receivers/package-tree.html @@ -0,0 +1,138 @@ + + + + + +com.caoccao.javet.utils.receivers Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.utils.receivers

+Package Hierarchies: + +
+
+

Class Hierarchy

+ +

Interface Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/IV8Value.html b/docs/reference/javadoc/com/caoccao/javet/values/IV8Value.html new file mode 100644 index 000000000..e0ff3077a --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/IV8Value.html @@ -0,0 +1,417 @@ + + + + + +IV8Value (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values
+

Interface IV8Value

+
+
+
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        equals

        +
        boolean equals(V8Value v8Value)
+        throws JavetException
        +
        Equals. +

        + The behavior is different from JS behavior but is the same as Java behavior.

        +
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        getV8Runtime

        +
        V8Runtime getV8Runtime()
        +
        Gets V8 runtime.
        +
        +
        Returns:
        +
        the V8 runtime
        +
        +
        • +
      + + + +
        +
      • +

        isNull

        +
        default boolean isNull()
        +
        Is null.
        +
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      + + + +
        +
      • +

        isNullOrUndefined

        +
        default boolean isNullOrUndefined()
        +
        Is null or undefined.
        +
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      + + + +
        +
      • +

        isUndefined

        +
        default boolean isUndefined()
        +
        Is undefined.
        +
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      + + + +
        +
      • +

        sameValue

        +
        boolean sameValue(V8Value v8Value)
+           throws JavetException
        +
        Same value. +

        + The behavior is different from JS behavior but is the same as Java behavior.

        +
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        setV8Runtime

        +
        void setV8Runtime(V8Runtime v8Runtime)
+           throws JavetException
        +
        Sets V8 runtime.
        +
        +
        Parameters:
        +
        v8Runtime - the V8 runtime
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        strictEquals

        +
        boolean strictEquals(V8Value v8Value)
+              throws JavetException
        +
        Strict equals boolean. +

        + The behavior is different from JS behavior but is the same as Java behavior.

        +
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/V8Data.html b/docs/reference/javadoc/com/caoccao/javet/values/V8Data.html new file mode 100644 index 000000000..baedb1930 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/V8Data.html @@ -0,0 +1,238 @@ + + + + + +V8Data (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values
+

Class V8Data

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.values.V8Data
      • +
    +
    • +
+
+
    +
  • +
    +
    Direct Known Subclasses:
    +
    V8Value
    +
    +
    +
    +
    public abstract class V8Data
+extends java.lang.Object
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + +
      Constructors 
      Constructor and Description
      V8Data() 
      +
      • +
    + +
      +
    • + + +

      Method Summary

      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        V8Data

        +
        public V8Data()
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/V8Value.html b/docs/reference/javadoc/com/caoccao/javet/values/V8Value.html new file mode 100644 index 000000000..deafe6eb3 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/V8Value.html @@ -0,0 +1,537 @@ + + + + + +V8Value (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values
+

Class V8Value

+
+
+ +
+ +
+
+ +
+
+
    +
  • + + + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        V8Value

        +
        protected V8Value()
        +
        • +
      +
      • +
    + + +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/values/package-frame.html new file mode 100644 index 000000000..bc58807f3 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/package-frame.html @@ -0,0 +1,24 @@ + + + + + +com.caoccao.javet.values (javet 0.9.12 API) + + + + +

com.caoccao.javet.values

+
+

Interfaces

+ +

Classes

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/values/package-summary.html new file mode 100644 index 000000000..bc589535f --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/package-summary.html @@ -0,0 +1,173 @@ + + + + + +com.caoccao.javet.values (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.values

+
+
Classes for V8 values.
+
+

See: Description

+
+
+
    +
  • + + + + + + + + + + + + +
    Interface Summary 
    InterfaceDescription
    IV8Value +
    The interface V8 value.
    +
    +
    • +
  • + + + + + + + + + + + + + + + + +
    Class Summary 
    ClassDescription
    V8Data 
    V8Value 
    +
    • +
+ + + +

Package com.caoccao.javet.values Description

+
Classes for V8 values.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/values/package-tree.html new file mode 100644 index 000000000..874284c00 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/package-tree.html @@ -0,0 +1,155 @@ + + + + + +com.caoccao.javet.values Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.values

+Package Hierarchies: + +
+
+

Class Hierarchy

+
    +
  • java.lang.Object +
      +
    • com.caoccao.javet.values.V8Data +
        +
      • com.caoccao.javet.values.V8Value (implements com.caoccao.javet.values.IV8Value)
        • +
      +
      • +
    +
    • +
+

Interface Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueBoolean.html b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueBoolean.html new file mode 100644 index 000000000..f2961590a --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueBoolean.html @@ -0,0 +1,364 @@ + + + + + +V8ValueBoolean (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.primitive
+

Class V8ValueBoolean

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueDouble.html b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueDouble.html new file mode 100644 index 000000000..0fe204c02 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueDouble.html @@ -0,0 +1,403 @@ + + + + + +V8ValueDouble (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.primitive
+

Class V8ValueDouble

+
+
+ +
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        V8ValueDouble

        +
        public V8ValueDouble()
        +
        • +
      + + + +
        +
      • +

        V8ValueDouble

        +
        public V8ValueDouble(double value)
        +
        • +
      +
      • +
    + + +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueInteger.html b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueInteger.html new file mode 100644 index 000000000..714b0a121 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueInteger.html @@ -0,0 +1,364 @@ + + + + + +V8ValueInteger (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.primitive
+

Class V8ValueInteger

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueLong.html b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueLong.html new file mode 100644 index 000000000..4c7003d4b --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueLong.html @@ -0,0 +1,376 @@ + + + + + +V8ValueLong (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.primitive
+

Class V8ValueLong

+
+
+ +
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        V8ValueLong

        +
        public V8ValueLong()
        +
        • +
      + + + +
        +
      • +

        V8ValueLong

        +
        public V8ValueLong(long value)
        +
        • +
      + + + +
        +
      • +

        V8ValueLong

        +
        public V8ValueLong(java.lang.String value)
        +
        • +
      +
      • +
    + + +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueNull.html b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueNull.html new file mode 100644 index 000000000..3dbc22107 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueNull.html @@ -0,0 +1,477 @@ + + + + + +V8ValueNull (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.primitive
+

Class V8ValueNull

+
+
+ +
+ +
+
+ +
+
+
    +
  • + + + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        V8ValueNull

        +
        public V8ValueNull()
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + + + + + +
        +
      • +

        equals

        +
        public boolean equals(V8Value v8Value)
        +
        Description copied from interface: IV8Value
        +
        Equals. +

        + The behavior is different from JS behavior but is the same as Java behavior.

        +
        +
        Specified by:
        +
        equals in interface IV8Value
        +
        Specified by:
        +
        equals in class V8Value
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      + + + +
        +
      • +

        sameValue

        +
        public boolean sameValue(V8Value v8Value)
        +
        Description copied from interface: IV8Value
        +
        Same value. +

        + The behavior is different from JS behavior but is the same as Java behavior.

        +
        +
        Specified by:
        +
        sameValue in interface IV8Value
        +
        Specified by:
        +
        sameValue in class V8Value
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      + + + +
        +
      • +

        strictEquals

        +
        public boolean strictEquals(V8Value v8Value)
        +
        Description copied from interface: IV8Value
        +
        Strict equals boolean. +

        + The behavior is different from JS behavior but is the same as Java behavior.

        +
        +
        Specified by:
        +
        strictEquals in interface IV8Value
        +
        Specified by:
        +
        strictEquals in class V8Value
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      + + + + + + + +
        +
      • +

        toString

        +
        public java.lang.String toString()
        +
        +
        Overrides:
        +
        toString in class java.lang.Object
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValuePrimitive.html b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValuePrimitive.html new file mode 100644 index 000000000..057fb2bc9 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValuePrimitive.html @@ -0,0 +1,511 @@ + + + + + +V8ValuePrimitive (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.primitive
+

Class V8ValuePrimitive<T>

+
+
+ +
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        value

        +
        protected T value
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        V8ValuePrimitive

        +
        public V8ValuePrimitive()
        +
        • +
      + + + + + +
        +
      • +

        V8ValuePrimitive

        +
        public V8ValuePrimitive(T value)
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + + + + + +
        +
      • +

        equals

        +
        public boolean equals(V8Value v8Value)
        +
        Description copied from interface: IV8Value
        +
        Equals. +

        + The behavior is different from JS behavior but is the same as Java behavior.

        +
        +
        Specified by:
        +
        equals in interface IV8Value
        +
        Specified by:
        +
        equals in class V8Value
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      + + + +
        +
      • +

        getValue

        +
        public T getValue()
        +
        • +
      + + + +
        +
      • +

        isEmpty

        +
        public boolean isEmpty()
        +
        • +
      + + + +
        +
      • +

        isPresent

        +
        public boolean isPresent()
        +
        • +
      + + + +
        +
      • +

        sameValue

        +
        public boolean sameValue(V8Value v8Value)
        +
        Description copied from interface: IV8Value
        +
        Same value. +

        + The behavior is different from JS behavior but is the same as Java behavior.

        +
        +
        Specified by:
        +
        sameValue in interface IV8Value
        +
        Specified by:
        +
        sameValue in class V8Value
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      + + + +
        +
      • +

        strictEquals

        +
        public boolean strictEquals(V8Value v8Value)
        +
        Description copied from interface: IV8Value
        +
        Strict equals boolean. +

        + The behavior is different from JS behavior but is the same as Java behavior.

        +
        +
        Specified by:
        +
        strictEquals in interface IV8Value
        +
        Specified by:
        +
        strictEquals in class V8Value
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      + + + +
        +
      • +

        toString

        +
        public java.lang.String toString()
        +
        +
        Overrides:
        +
        toString in class java.lang.Object
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueString.html b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueString.html new file mode 100644 index 000000000..0b30c73bc --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueString.html @@ -0,0 +1,364 @@ + + + + + +V8ValueString (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.primitive
+

Class V8ValueString

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueUndefined.html b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueUndefined.html new file mode 100644 index 000000000..be1074295 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueUndefined.html @@ -0,0 +1,480 @@ + + + + + +V8ValueUndefined (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.primitive
+

Class V8ValueUndefined

+
+
+ +
+ +
+
+ +
+
+
    +
  • + + + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        V8ValueUndefined

        +
        public V8ValueUndefined()
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + + + + + +
        +
      • +

        equals

        +
        public boolean equals(V8Value v8Value)
        +
        Description copied from interface: IV8Value
        +
        Equals. +

        + The behavior is different from JS behavior but is the same as Java behavior.

        +
        +
        Specified by:
        +
        equals in interface IV8Value
        +
        Specified by:
        +
        equals in class V8Value
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      + + + +
        +
      • +

        sameValue

        +
        public boolean sameValue(V8Value v8Value)
        +
        Description copied from interface: IV8Value
        +
        Same value. +

        + The behavior is different from JS behavior but is the same as Java behavior.

        +
        +
        Specified by:
        +
        sameValue in interface IV8Value
        +
        Specified by:
        +
        sameValue in class V8Value
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      + + + +
        +
      • +

        strictEquals

        +
        public boolean strictEquals(V8Value v8Value)
        +
        Description copied from interface: IV8Value
        +
        Strict equals boolean. +

        + The behavior is different from JS behavior but is the same as Java behavior.

        +
        +
        Specified by:
        +
        strictEquals in interface IV8Value
        +
        Specified by:
        +
        strictEquals in class V8Value
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      + + + + + + + +
        +
      • +

        toString

        +
        public java.lang.String toString()
        +
        +
        Overrides:
        +
        toString in class java.lang.Object
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueUnknown.html b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueUnknown.html new file mode 100644 index 000000000..eb8067ca8 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueUnknown.html @@ -0,0 +1,351 @@ + + + + + +V8ValueUnknown (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.primitive
+

Class V8ValueUnknown

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueZonedDateTime.html b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueZonedDateTime.html new file mode 100644 index 000000000..0d82bcd24 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/primitive/V8ValueZonedDateTime.html @@ -0,0 +1,376 @@ + + + + + +V8ValueZonedDateTime (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.primitive
+

Class V8ValueZonedDateTime

+
+
+ +
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        V8ValueZonedDateTime

        +
        public V8ValueZonedDateTime()
        +
        • +
      + + + +
        +
      • +

        V8ValueZonedDateTime

        +
        public V8ValueZonedDateTime(long jsTimestamp)
        +
        • +
      + + + +
        +
      • +

        V8ValueZonedDateTime

        +
        public V8ValueZonedDateTime(java.time.ZonedDateTime value)
        +
        • +
      +
      • +
    + + +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/primitive/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/values/primitive/package-frame.html new file mode 100644 index 000000000..b0252d3df --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/primitive/package-frame.html @@ -0,0 +1,28 @@ + + + + + +com.caoccao.javet.values.primitive (javet 0.9.12 API) + + + + +

com.caoccao.javet.values.primitive

+
+

Classes

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/primitive/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/values/primitive/package-summary.html new file mode 100644 index 000000000..b5d3f8a15 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/primitive/package-summary.html @@ -0,0 +1,188 @@ + + + + + +com.caoccao.javet.values.primitive (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.values.primitive

+
+
Classes for V8 primitive values.
+
+

See: Description

+
+
+ + + + +

Package com.caoccao.javet.values.primitive Description

+
Classes for V8 primitive values.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/primitive/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/values/primitive/package-tree.html new file mode 100644 index 000000000..2b77f96d6 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/primitive/package-tree.html @@ -0,0 +1,154 @@ + + + + + +com.caoccao.javet.values.primitive Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.values.primitive

+Package Hierarchies: + +
+
+

Class Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8Module.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8Module.html new file mode 100644 index 000000000..4437270be --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8Module.html @@ -0,0 +1,624 @@ + + + + + +IV8Module (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Interface IV8Module

+
+
+
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8Script.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8Script.html new file mode 100644 index 000000000..b230e0a53 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8Script.html @@ -0,0 +1,350 @@ + + + + + +IV8Script (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Interface IV8Script

+
+
+
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getResourceName

        +
        java.lang.String getResourceName()
        +
        • +
      + + + +
        +
      • +

        setResourceName

        +
        void setResourceName(java.lang.String resourceName)
        +
        • +
      + + + + + +
        +
      • +

        toObject

        +
        default <T,V extends V8Value> T toObject(V v8Value)
+                                  throws JavetException
        +
        Description copied from interface: IV8Convertible
        +
        Convert from V8 value to object. + The caller is responsible for closing the V8 value.
        +
        +
        Specified by:
        +
        toObject in interface IV8Convertible
        +
        Type Parameters:
        +
        T - the type parameter
        +
        V - the type parameter
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the object
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + + + + +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueArray.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueArray.html new file mode 100644 index 000000000..8bc2cb5a9 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueArray.html @@ -0,0 +1,558 @@ + + + + + +IV8ValueArray (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Interface IV8ValueArray

+
+
+
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueFunction.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueFunction.html new file mode 100644 index 000000000..57816ab5d --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueFunction.html @@ -0,0 +1,840 @@ + + + + + +IV8ValueFunction (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Interface IV8ValueFunction

+
+
+
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        call

        +
        @CheckReturnValue
+default <T extends V8Value> T call(IV8ValueObject receiver,
+                                                      java.lang.Object... objects)
+                                               throws JavetException
        +
        Call function by objects and return V8 value.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        receiver - the receiver
        +
        objects - the objects
        +
        Returns:
        +
        the V8 value
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        call

        +
        @CheckReturnValue
+default <T extends V8Value> T call(IV8ValueObject receiver,
+                                                      V8Value... v8Values)
+                                               throws JavetException
        +
        Call function by V8 values and return V8 value.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        receiver - the receiver
        +
        v8Values - the V8 values
        +
        Returns:
        +
        the V8 value
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        callAsConstructor

        +
        @CheckReturnValue
+<T extends V8Value> T callAsConstructor(java.lang.Object... objects)
+                                                    throws JavetException
        +
        Call function as constructor by objects.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        objects - the objects
        +
        Returns:
        +
        the V8 value
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        callAsConstructor

        +
        @CheckReturnValue
+<T extends V8Value> T callAsConstructor(V8Value... v8Values)
+                                                    throws JavetException
        +
        Call function as constructor by V8 values.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        v8Values - the V8 values
        +
        Returns:
        +
        the V8 value
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        callBoolean

        +
        default java.lang.Boolean callBoolean(IV8ValueObject receiver,
+                                      java.lang.Object... objects)
+                               throws JavetException
        +
        Call function by objects and return boolean.
        +
        +
        Parameters:
        +
        receiver - the receiver
        +
        objects - the objects
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        callDouble

        +
        default java.lang.Double callDouble(IV8ValueObject receiver,
+                                    java.lang.Object... objects)
+                             throws JavetException
        +
        Call function by objects and return double.
        +
        +
        Parameters:
        +
        receiver - the receiver
        +
        objects - the objects
        +
        Returns:
        +
        the double
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        callExtended

        +
        @CheckReturnValue
+<T extends V8Value> T callExtended(IV8ValueObject receiver,
+                                                      boolean returnResult,
+                                                      java.lang.Object... objects)
+                                               throws JavetException
        +
        Call function by objects and return V8 value.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        receiver - the receiver
        +
        returnResult - the return result
        +
        objects - the objects
        +
        Returns:
        +
        the t
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        callExtended

        +
        @CheckReturnValue
+<T extends V8Value> T callExtended(IV8ValueObject receiver,
+                                                      boolean returnResult,
+                                                      V8Value... v8Values)
+                                               throws JavetException
        +
        Call function by V8 values and return V8 value.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        receiver - the receiver
        +
        returnResult - the return result
        +
        v8Values - the v 8 values
        +
        Returns:
        +
        the t
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        callFloat

        +
        default java.lang.Float callFloat(IV8ValueObject receiver,
+                                  java.lang.Object... objects)
+                           throws JavetException
        +
        Call function by objects and return float.
        +
        +
        Parameters:
        +
        receiver - the receiver
        +
        objects - the objects
        +
        Returns:
        +
        the float
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        callInteger

        +
        default java.lang.Integer callInteger(IV8ValueObject receiver,
+                                      java.lang.Object... objects)
+                               throws JavetException
        +
        Call function by objects and return integer.
        +
        +
        Parameters:
        +
        receiver - the receiver
        +
        objects - the objects
        +
        Returns:
        +
        the integer
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        callLong

        +
        default java.lang.Long callLong(IV8ValueObject receiver,
+                                java.lang.Object... objects)
+                         throws JavetException
        +
        Call function by objects and return long.
        +
        +
        Parameters:
        +
        receiver - the receiver
        +
        objects - the objects
        +
        Returns:
        +
        the long
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        callObject

        +
        default <T> T callObject(IV8ValueObject receiver,
+                         java.lang.Object... objects)
+                  throws JavetException
        +
        Call function by objects and return object.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        receiver - the receiver
        +
        objects - the objects
        +
        Returns:
        +
        the object
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        callPrimitive

        +
        default <R,T extends V8ValuePrimitive<R>> R callPrimitive(IV8ValueObject receiver,
+                                                          java.lang.Object... objects)
+                                                   throws JavetException
        +
        Call function by objects and return primitive object.
        +
        +
        Type Parameters:
        +
        R - the type parameter
        +
        T - the type parameter
        +
        Parameters:
        +
        receiver - the receiver
        +
        objects - the objects
        +
        Returns:
        +
        the primitive object
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        callString

        +
        default java.lang.String callString(IV8ValueObject receiver,
+                                    java.lang.Object... objects)
+                             throws JavetException
        +
        Call function by objects and return string.
        +
        +
        Parameters:
        +
        receiver - the receiver
        +
        objects - the objects
        +
        Returns:
        +
        the string
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        callVoid

        +
        default void callVoid(IV8ValueObject receiver,
+                      java.lang.Object... objects)
+               throws JavetException
        +
        Call function by objects without return.
        +
        +
        Parameters:
        +
        receiver - the receiver
        +
        objects - the objects
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        callVoid

        +
        default void callVoid(IV8ValueObject receiver,
+                      V8Value... v8Values)
+               throws JavetException
        +
        Call function by V8 values without return.
        +
        +
        Parameters:
        +
        receiver - the receiver
        +
        v8Values - the V8 values
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + + + + + + + + + + + + + +
        +
      • +

        getSourceCode

        +
        java.lang.String getSourceCode()
+                        throws JavetException
        +
        Gets source code.
        +
        +
        Returns:
        +
        the source code
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        setSourceCode

        +
        boolean setSourceCode(java.lang.String sourceCode)
+               throws JavetException
        +
        Sets source code. +

        + Note: The source is shared among all function objects. + So the caller is responsible for restoring the original source code, + otherwise the next function call will likely fail because the source code + of the next function call is incorrect.

        +
        +
        Parameters:
        +
        sourceCode - the source code
        +
        Returns:
        +
        the source code
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueIterator.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueIterator.html new file mode 100644 index 000000000..9188432c9 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueIterator.html @@ -0,0 +1,246 @@ + + + + + +IV8ValueIterator (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Interface IV8ValueIterator<T extends V8Value>

+
+
+
+
    +
  • +
    +
    Type Parameters:
    +
    T - the type parameter
    +
    +
    +
    All Superinterfaces:
    +
    java.lang.AutoCloseable, IJavetClosable
    +
    +
    +
    All Known Implementing Classes:
    +
    V8ValueIterator
    +
    +
    +
    +
    public interface IV8ValueIterator<T extends V8Value>
+extends IJavetClosable
    +
    The interface V8 value iterator.
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getNext

        +
        T getNext()
        +
        Gets next.
        +
        +
        Returns:
        +
        the next
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueKeyContainer.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueKeyContainer.html new file mode 100644 index 000000000..65e428ae9 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueKeyContainer.html @@ -0,0 +1,290 @@ + + + + + +IV8ValueKeyContainer (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Interface IV8ValueKeyContainer

+
+
+
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueMap.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueMap.html new file mode 100644 index 000000000..c2a6a4a15 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueMap.html @@ -0,0 +1,294 @@ + + + + + +IV8ValueMap (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Interface IV8ValueMap

+
+
+
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueObject.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueObject.html new file mode 100644 index 000000000..3b9700b83 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueObject.html @@ -0,0 +1,2855 @@ + + + + + +IV8ValueObject (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Interface IV8ValueObject

+
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      All Methods Instance Methods Abstract Methods Default Methods 
      Modifier and TypeMethod and Description
      java.util.List<JavetCallbackContext>bind(java.lang.Object callbackReceiver) +
      Bind both functions via @V8Function and properties via @V8Property.
      +
      booleanbindFunction(java.lang.String functionName, + JavetCallbackContext javetCallbackContext) +
      Binds function by name and callback context.
      +
      default booleanbindFunction(java.lang.String functionName, + java.lang.String codeString) +
      Binds function by name and string.
      +
      default booleanbindProperty(java.lang.String propertyName, + JavetCallbackContext javetCallbackContextGetter) +
      Bind property.
      +
      default booleanbindProperty(java.lang.String propertyName, + JavetCallbackContext javetCallbackContextGetter, + JavetCallbackContext javetCallbackContextSetter) +
      Bind property.
      +
      default booleanbindProperty(V8ValueString propertyName, + JavetCallbackContext javetCallbackContextGetter) +
      Bind property.
      +
      booleanbindProperty(V8ValueString propertyName, + JavetCallbackContext javetCallbackContextGetter, + JavetCallbackContext javetCallbackContextSetter) +
      Bind property.
      +
      default booleanbindProperty(V8ValueSymbol propertyName, + JavetCallbackContext javetCallbackContextGetter) +
      Bind property.
      +
      booleanbindProperty(V8ValueSymbol propertyName, + JavetCallbackContext javetCallbackContextGetter, + JavetCallbackContext javetCallbackContextSetter) +
      Bind property.
      +
      booleandelete(java.lang.Object key) +
      Delete boolean.
      +
      default booleandeleteNull() +
      Delete null boolean.
      +
      booleandeletePrivateProperty(java.lang.String propertyName) +
      Delete private property boolean.
      +
      default booleandeleteUndefined() +
      Delete undefined boolean.
      +
      <Key extends V8Value,Value extends V8Value,E extends java.lang.Throwable>
      int      		forEach(IJavetBiConsumer<Key,Value,E> consumer) +
      For each.
      +
      <Key extends V8Value,Value extends V8Value,E extends java.lang.Throwable>
      int      		forEach(IJavetBiIndexedConsumer<Key,Value,E> consumer) +
      For each.
      +
      <Key extends V8Value,E extends java.lang.Throwable>
      int      		forEach(IJavetUniConsumer<Key,E> consumer) +
      For each.
      +
      <Key extends V8Value,E extends java.lang.Throwable>
      int      		forEach(IJavetUniIndexedConsumer<Key,E> consumer) +
      For each.
      +
      <T extends V8Value>
      T      		get(java.lang.Object key) +
      Get t.
      +
      default java.lang.BooleangetBoolean(java.lang.Object key) +
      Gets boolean.
      +
      default java.lang.DoublegetDouble(java.lang.Object key) +
      Gets double.
      +
      default java.lang.FloatgetFloat(java.lang.Object key) +
      Gets float.
      +
      intgetIdentityHash() +
      Returns the identity hash for this object.
      +
      default java.lang.IntegergetInteger(java.lang.Object key) +
      Gets integer.
      +
      default java.lang.LonggetLong(java.lang.Object key) +
      Gets long.
      +
      default V8ValueNullgetNull(java.lang.Object key) +
      Gets null.
      +
      default <T> TgetObject(java.lang.Object key) +
      Gets object.
      +
      IV8ValueArraygetOwnPropertyNames() +
      Gets own property names.
      +
      default <R,T extends V8ValuePrimitive<R>>
      R      		getPrimitive(java.lang.Object key) +
      Gets primitive.
      +
      <T extends V8Value>
      T      		getPrivateProperty(java.lang.String propertyName) +
      Gets private property.
      +
      default java.lang.BooleangetPrivatePropertyBoolean(java.lang.String propertyName) +
      Gets private property boolean.
      +
      default java.lang.DoublegetPrivatePropertyDouble(java.lang.String propertyName) +
      Gets private property double.
      +
      default java.lang.FloatgetPrivatePropertyFloat(java.lang.String propertyName) +
      Gets private property float.
      +
      default java.lang.IntegergetPrivatePropertyInteger(java.lang.String propertyName) +
      Gets private property integer.
      +
      default java.lang.LonggetPrivatePropertyLong(java.lang.String propertyName) +
      Gets private property long.
      +
      default V8ValueNullgetPrivatePropertyNull(java.lang.String propertyName) +
      Gets private property null.
      +
      default <T> TgetPrivatePropertyObject(java.lang.String propertyName) +
      Gets private property object.
      +
      default <R,T extends V8ValuePrimitive<R>>
      R      		getPrivatePropertyPrimitive(java.lang.String propertyName) +
      Gets private property primitive.
      +
      default java.lang.StringgetPrivatePropertyString(java.lang.String propertyName) +
      Gets private property string.
      +
      default V8ValueUndefinedgetPrivatePropertyUndefined(java.lang.String propertyName) +
      Gets private property undefined.
      +
      default java.time.ZonedDateTimegetPrivatePropertyZonedDateTime(java.lang.String propertyName) +
      Gets private property zoned date time.
      +
      <T extends V8Value>
      T      		getProperty(java.lang.Object key) +
      Gets property.
      +
      default java.lang.BooleangetPropertyBoolean(java.lang.Object key) +
      Gets property boolean.
      +
      default java.lang.DoublegetPropertyDouble(java.lang.Object key) +
      Gets property double.
      +
      default java.lang.FloatgetPropertyFloat(java.lang.Object key) +
      Gets property float.
      +
      default java.lang.IntegergetPropertyInteger(java.lang.Object key) +
      Gets property integer.
      +
      default java.lang.LonggetPropertyLong(java.lang.Object key) +
      Gets property long.
      +
      IV8ValueArraygetPropertyNames() +
      Gets property names.
      +
      default <T> TgetPropertyObject(java.lang.Object key) +
      Gets property object.
      +
      default <R,T extends V8ValuePrimitive<R>>
      R      		getPropertyPrimitive(java.lang.Object key) +
      Gets property primitive.
      +
      default java.lang.StringgetPropertyString(java.lang.Object key) +
      Gets property string.
      +
      default java.time.ZonedDateTimegetPropertyZonedDateTime(java.lang.Object key) +
      Gets property zoned date time.
      +
      <T extends IV8ValueObject>
      T      		getPrototype() +
      Gets prototype.
      +
      default java.lang.StringgetString(java.lang.Object key) +
      Gets string.
      +
      default V8ValueUndefinedgetUndefined(java.lang.Object key) +
      Gets undefined.
      +
      default java.time.ZonedDateTimegetZonedDateTime(java.lang.Object key) +
      Gets zoned date time.
      +
      booleanhas(java.lang.Object value) +
      Has object property key.
      +
      default booleanhasNull() +
      Has null property key.
      +
      booleanhasOwnProperty(java.lang.Object key) +
      Has own property key.
      +
      booleanhasPrivateProperty(java.lang.String propertyName) +
      Has private property boolean.
      +
      default booleanhasUndefined() +
      Has undefined property key.
      +
      default <T extends V8Value>
      T      		invoke(java.lang.String functionName, + java.lang.Object... objects) +
      Invoke function with return V8 value by name and objects as arguments.
      +
      default <T extends V8Value>
      T      		invoke(java.lang.String functionName, + V8Value... v8Values) +
      Invoke function with return V8 value by name and V8 values as arguments.
      +
      default java.lang.BooleaninvokeBoolean(java.lang.String functionName, + java.lang.Object... objects) +
      Invoke function with return value boolean by name and objects as arguments.
      +
      default java.lang.DoubleinvokeDouble(java.lang.String functionName, + java.lang.Object... objects) +
      Invoke function with return value double by name and objects as arguments.
      +
      <T extends V8Value>
      T      		invokeExtended(java.lang.String functionName, + boolean returnResult, + java.lang.Object... objects) +
      Invoke extended and return V8 value which must be consumed, + otherwise memory leak may occur.
      +
      <T extends V8Value>
      T      		invokeExtended(java.lang.String functionName, + boolean returnResult, + V8Value... v8Values) +
      Invoke extended and return V8 value which must be consumed, + otherwise memory leak may occur.
      +
      default java.lang.FloatinvokeFloat(java.lang.String functionName, + java.lang.Object... objects) +
      Invoke function with return value float by name and objects as arguments.
      +
      default java.lang.IntegerinvokeInteger(java.lang.String functionName, + java.lang.Object... objects) +
      Invoke function with return value integer by name and objects as arguments.
      +
      default java.lang.LonginvokeLong(java.lang.String functionName, + java.lang.Object... objects) +
      Invoke function with return value long by name and objects as arguments.
      +
      default <T> TinvokeObject(java.lang.String functionName, + java.lang.Object... objects) +
      Invoke function with return value object by name and objects as arguments.
      +
      default <R,T extends V8ValuePrimitive<R>>
      R      		invokePrimitive(java.lang.String functionName, + java.lang.Object... objects) +
      Invoke function with return value primitive by name and objects as arguments.
      +
      default java.lang.StringinvokeString(java.lang.String functionName, + java.lang.Object... objects) +
      Invoke function with return value string by name and objects as arguments.
      +
      default voidinvokeVoid(java.lang.String functionName, + java.lang.Object... objects) +
      Invoke function without return value by name and objects as arguments.
      +
      default voidinvokeVoid(java.lang.String functionName, + V8Value... v8Values) +
      Invoke function without return value by name and V8 values as arguments.
      +
      booleanset(java.lang.Object key, + java.lang.Object value) +
      Set boolean.
      +
      default booleansetNull(java.lang.Object key) +
      Sets null.
      +
      booleansetPrivateProperty(java.lang.String propertyName, + java.lang.Object propertyValue) +
      Sets private property.
      +
      default booleansetPrivatePropertyNull(java.lang.String propertyKey) +
      Sets private property null.
      +
      default booleansetPrivatePropertyUndefined(java.lang.String propertyKey) +
      Sets private property undefined.
      +
      booleansetProperty(java.lang.Object key, + java.lang.Object value) +
      Sets property.
      +
      default booleansetPropertyNull(java.lang.Object key) +
      Sets property null.
      +
      default booleansetPropertyUndefined(java.lang.Object key) +
      Sets property undefined.
      +
      booleansetPrototype(IV8ValueObject v8ValueObject) +
      Sets prototype.
      +
      default booleansetUndefined(java.lang.Object key) +
      Sets undefined.
      +
      java.lang.StringtoJsonString() +
      To json string.
      +
      java.lang.StringtoProtoString() +
      To proto string.
      +
      intunbind(java.lang.Object callbackReceiver) +
      Unbind the interception.
      +
      booleanunbindFunction(java.lang.String functionName) +
      Unbind function.
      +
      default booleanunbindProperty(java.lang.String propertyName) +
      Unbind property.
      +
      booleanunbindProperty(V8ValueString propertyName) +
      Unbind property boolean.
      +
      booleanunbindProperty(V8ValueSymbol propertyName) +
      Unbind property boolean.
      +
      + + + + +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        bind

        +
        java.util.List<JavetCallbackContext> bind(java.lang.Object callbackReceiver)
+                                   throws JavetException
        +
        Bind both functions via @V8Function and properties via @V8Property.
        +
        +
        Parameters:
        +
        callbackReceiver - the callback receiver
        +
        Returns:
        +
        the list of callback context
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.9
        +
        +
        • +
      + + + +
        +
      • +

        bindFunction

        +
        boolean bindFunction(java.lang.String functionName,
+                     JavetCallbackContext javetCallbackContext)
+              throws JavetException
        +
        Binds function by name and callback context. +

        + It is for creating a Java code based function in V8.

        +
        +
        Parameters:
        +
        functionName - the function name
        +
        javetCallbackContext - the javet callback context
        +
        Returns:
        +
        true : function is bind, false: function is not bind
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.9
        +
        +
        • +
      + + + +
        +
      • +

        bindFunction

        +
        default boolean bindFunction(java.lang.String functionName,
+                             java.lang.String codeString)
+                      throws JavetException
        +
        Binds function by name and string. +

        + It is for creating a string based function in V8. +

        + JS equivalent: + + obj.func = function(arg1, arg2) { ... }; +

        +
        +
        Parameters:
        +
        functionName - the function name
        +
        codeString - the code string
        +
        Returns:
        +
        true : function is bind, false: function is not bind
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.9
        +
        +
        • +
      + + + +
        +
      • +

        bindProperty

        +
        default boolean bindProperty(java.lang.String propertyName,
+                             JavetCallbackContext javetCallbackContextGetter)
+                      throws JavetException
        +
        Bind property.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        javetCallbackContextGetter - the javet callback context getter
        +
        Returns:
        +
        true if the property is bind, false if the property is not bind
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.9
        +
        +
        • +
      + + + +
        +
      • +

        bindProperty

        +
        default boolean bindProperty(java.lang.String propertyName,
+                             JavetCallbackContext javetCallbackContextGetter,
+                             JavetCallbackContext javetCallbackContextSetter)
+                      throws JavetException
        +
        Bind property.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        javetCallbackContextGetter - the javet callback context getter
        +
        javetCallbackContextSetter - the javet callback context setter
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.11
        +
        +
        • +
      + + + +
        +
      • +

        bindProperty

        +
        default boolean bindProperty(V8ValueString propertyName,
+                             JavetCallbackContext javetCallbackContextGetter)
+                      throws JavetException
        +
        Bind property.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        javetCallbackContextGetter - the javet callback context getter
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.11
        +
        +
        • +
      + + + +
        +
      • +

        bindProperty

        +
        default boolean bindProperty(V8ValueSymbol propertyName,
+                             JavetCallbackContext javetCallbackContextGetter)
+                      throws JavetException
        +
        Bind property.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        javetCallbackContextGetter - the javet callback context getter
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.11
        +
        +
        • +
      + + + +
        +
      • +

        bindProperty

        +
        boolean bindProperty(V8ValueString propertyName,
+                     JavetCallbackContext javetCallbackContextGetter,
+                     JavetCallbackContext javetCallbackContextSetter)
+              throws JavetException
        +
        Bind property.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        javetCallbackContextGetter - the javet callback context getter
        +
        javetCallbackContextSetter - the javet callback context setter
        +
        Returns:
        +
        true if the property is bind, false if the property is not bind
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.9
        +
        +
        • +
      + + + +
        +
      • +

        bindProperty

        +
        boolean bindProperty(V8ValueSymbol propertyName,
+                     JavetCallbackContext javetCallbackContextGetter,
+                     JavetCallbackContext javetCallbackContextSetter)
+              throws JavetException
        +
        Bind property.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        javetCallbackContextGetter - the javet callback context getter
        +
        javetCallbackContextSetter - the javet callback context setter
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.11
        +
        +
        • +
      + + + +
        +
      • +

        delete

        +
        boolean delete(java.lang.Object key)
+        throws JavetException
        +
        Delete boolean.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        deleteNull

        +
        default boolean deleteNull()
+                    throws JavetException
        +
        Delete null boolean.
        +
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        deletePrivateProperty

        +
        boolean deletePrivateProperty(java.lang.String propertyName)
+                       throws JavetException
        +
        Delete private property boolean.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + +
        +
      • +

        deleteUndefined

        +
        default boolean deleteUndefined()
+                         throws JavetException
        +
        Delete undefined boolean.
        +
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        forEach

        +
        <Key extends V8Value,E extends java.lang.Throwable> int forEach(IJavetUniConsumer<Key,E> consumer)
+                                                         throws JavetException,
+                                                                E extends java.lang.Throwable
        +
        For each.
        +
        +
        Type Parameters:
        +
        Key - the type of key
        +
        E - the type of exception
        +
        Parameters:
        +
        consumer - the consumer
        +
        Returns:
        +
        the item count
        +
        Throws:
        +
        JavetException - the javet exception
        +
        E - the exception
        +
        E extends java.lang.Throwable
        +
        Since:
        +
        0.8.10
        +
        +
        • +
      + + + +
        +
      • +

        forEach

        +
        <Key extends V8Value,E extends java.lang.Throwable> int forEach(IJavetUniIndexedConsumer<Key,E> consumer)
+                                                         throws JavetException,
+                                                                E extends java.lang.Throwable
        +
        For each.
        +
        +
        Type Parameters:
        +
        Key - the type of key
        +
        E - the type of exception
        +
        Parameters:
        +
        consumer - the consumer
        +
        Returns:
        +
        the item count
        +
        Throws:
        +
        JavetException - the javet exception
        +
        E - the exception
        +
        E extends java.lang.Throwable
        +
        Since:
        +
        0.8.10
        +
        +
        • +
      + + + +
        +
      • +

        forEach

        +
        <Key extends V8Value,Value extends V8Value,E extends java.lang.Throwable> int forEach(IJavetBiConsumer<Key,Value,E> consumer)
+                                                                               throws JavetException,
+                                                                                      E extends java.lang.Throwable
        +
        For each.
        +
        +
        Type Parameters:
        +
        Key - the type of key
        +
        Value - the type of value
        +
        E - the type of exception
        +
        Parameters:
        +
        consumer - the consumer
        +
        Returns:
        +
        the item count
        +
        Throws:
        +
        JavetException - the javet exception
        +
        E - the exception
        +
        E extends java.lang.Throwable
        +
        Since:
        +
        0.8.9
        +
        +
        • +
      + + + +
        +
      • +

        forEach

        +
        <Key extends V8Value,Value extends V8Value,E extends java.lang.Throwable> int forEach(IJavetBiIndexedConsumer<Key,Value,E> consumer)
+                                                                               throws JavetException,
+                                                                                      E extends java.lang.Throwable
        +
        For each.
        +
        +
        Type Parameters:
        +
        Key - the type of key
        +
        Value - the type of value
        +
        E - the type of exception
        +
        Parameters:
        +
        consumer - the consumer
        +
        Returns:
        +
        the item count
        +
        Throws:
        +
        JavetException - the javet exception
        +
        E - the exception
        +
        E extends java.lang.Throwable
        +
        Since:
        +
        0.8.10
        +
        +
        • +
      + + + +
        +
      • +

        get

        +
        @CheckReturnValue
+<T extends V8Value> T get(java.lang.Object key)
+                                      throws JavetException
        +
        Get t.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the t
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getBoolean

        +
        default java.lang.Boolean getBoolean(java.lang.Object key)
+                              throws JavetException
        +
        Gets boolean.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getDouble

        +
        default java.lang.Double getDouble(java.lang.Object key)
+                            throws JavetException
        +
        Gets double.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the double
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getFloat

        +
        default java.lang.Float getFloat(java.lang.Object key)
+                          throws JavetException
        +
        Gets float.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the float
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getIdentityHash

        +
        int getIdentityHash()
+             throws JavetException
        +
        Returns the identity hash for this object. The current implementation + uses an inline property on the object to store the identity hash. +

        + The return value will never be 0. Also, it is not guaranteed to be + unique.

        +
        +
        Returns:
        +
        the identity hash
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        getInteger

        +
        default java.lang.Integer getInteger(java.lang.Object key)
+                              throws JavetException
        +
        Gets integer.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the integer
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getLong

        +
        default java.lang.Long getLong(java.lang.Object key)
+                        throws JavetException
        +
        Gets long.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the long
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getNull

        +
        default V8ValueNull getNull(java.lang.Object key)
+                     throws JavetException
        +
        Gets null.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the null
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getObject

        +
        default <T> T getObject(java.lang.Object key)
+                 throws JavetException
        +
        Gets object.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the object
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + + + + + +
        +
      • +

        getPrimitive

        +
        default <R,T extends V8ValuePrimitive<R>> R getPrimitive(java.lang.Object key)
+                                                  throws JavetException
        +
        Gets primitive.
        +
        +
        Type Parameters:
        +
        R - the type parameter
        +
        T - the type parameter
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the primitive
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getPrivateProperty

        +
        @CheckReturnValue
+<T extends V8Value> T getPrivateProperty(java.lang.String propertyName)
+                                                     throws JavetException
        +
        Gets private property.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the private property
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + +
        +
      • +

        getPrivatePropertyBoolean

        +
        default java.lang.Boolean getPrivatePropertyBoolean(java.lang.String propertyName)
+                                             throws JavetException
        +
        Gets private property boolean.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the private property boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + +
        +
      • +

        getPrivatePropertyDouble

        +
        default java.lang.Double getPrivatePropertyDouble(java.lang.String propertyName)
+                                           throws JavetException
        +
        Gets private property double.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the private property double
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + +
        +
      • +

        getPrivatePropertyFloat

        +
        default java.lang.Float getPrivatePropertyFloat(java.lang.String propertyName)
+                                         throws JavetException
        +
        Gets private property float.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the private property float
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + +
        +
      • +

        getPrivatePropertyInteger

        +
        default java.lang.Integer getPrivatePropertyInteger(java.lang.String propertyName)
+                                             throws JavetException
        +
        Gets private property integer.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the private property integer
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + +
        +
      • +

        getPrivatePropertyLong

        +
        default java.lang.Long getPrivatePropertyLong(java.lang.String propertyName)
+                                       throws JavetException
        +
        Gets private property long.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the private property long
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + +
        +
      • +

        getPrivatePropertyNull

        +
        default V8ValueNull getPrivatePropertyNull(java.lang.String propertyName)
+                                    throws JavetException
        +
        Gets private property null.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the private property null
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + +
        +
      • +

        getPrivatePropertyObject

        +
        default <T> T getPrivatePropertyObject(java.lang.String propertyName)
+                                throws JavetException
        +
        Gets private property object.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the private property object
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + +
        +
      • +

        getPrivatePropertyPrimitive

        +
        default <R,T extends V8ValuePrimitive<R>> R getPrivatePropertyPrimitive(java.lang.String propertyName)
+                                                                 throws JavetException
        +
        Gets private property primitive.
        +
        +
        Type Parameters:
        +
        R - the type parameter
        +
        T - the type parameter
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the private property primitive
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + +
        +
      • +

        getPrivatePropertyString

        +
        default java.lang.String getPrivatePropertyString(java.lang.String propertyName)
+                                           throws JavetException
        +
        Gets private property string.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the private property string
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + +
        +
      • +

        getPrivatePropertyUndefined

        +
        default V8ValueUndefined getPrivatePropertyUndefined(java.lang.String propertyName)
+                                              throws JavetException
        +
        Gets private property undefined.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the private property undefined
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + +
        +
      • +

        getPrivatePropertyZonedDateTime

        +
        default java.time.ZonedDateTime getPrivatePropertyZonedDateTime(java.lang.String propertyName)
+                                                         throws JavetException
        +
        Gets private property zoned date time.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the private property zoned date time
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + +
        +
      • +

        getProperty

        +
        @CheckReturnValue
+<T extends V8Value> T getProperty(java.lang.Object key)
+                                              throws JavetException
        +
        Gets property.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the property
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getPropertyBoolean

        +
        default java.lang.Boolean getPropertyBoolean(java.lang.Object key)
+                                      throws JavetException
        +
        Gets property boolean.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the property boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getPropertyDouble

        +
        default java.lang.Double getPropertyDouble(java.lang.Object key)
+                                    throws JavetException
        +
        Gets property double.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the property double
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getPropertyFloat

        +
        default java.lang.Float getPropertyFloat(java.lang.Object key)
+                                  throws JavetException
        +
        Gets property float.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the property float
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getPropertyInteger

        +
        default java.lang.Integer getPropertyInteger(java.lang.Object key)
+                                      throws JavetException
        +
        Gets property integer.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the property integer
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getPropertyLong

        +
        default java.lang.Long getPropertyLong(java.lang.Object key)
+                                throws JavetException
        +
        Gets property long.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the property long
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + + + + + +
        +
      • +

        getPropertyObject

        +
        default <T> T getPropertyObject(java.lang.Object key)
+                         throws JavetException
        +
        Gets property object.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the property object
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getPropertyPrimitive

        +
        default <R,T extends V8ValuePrimitive<R>> R getPropertyPrimitive(java.lang.Object key)
+                                                          throws JavetException
        +
        Gets property primitive.
        +
        +
        Type Parameters:
        +
        R - the type parameter
        +
        T - the type parameter
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the property primitive
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getPropertyString

        +
        default java.lang.String getPropertyString(java.lang.Object key)
+                                    throws JavetException
        +
        Gets property string.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the property string
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getPropertyZonedDateTime

        +
        default java.time.ZonedDateTime getPropertyZonedDateTime(java.lang.Object key)
+                                                  throws JavetException
        +
        Gets property zoned date time.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the property zoned date time
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + + + + + +
        +
      • +

        getString

        +
        default java.lang.String getString(java.lang.Object key)
+                            throws JavetException
        +
        Gets string.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the string
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getUndefined

        +
        default V8ValueUndefined getUndefined(java.lang.Object key)
+                               throws JavetException
        +
        Gets undefined.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the undefined
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        getZonedDateTime

        +
        default java.time.ZonedDateTime getZonedDateTime(java.lang.Object key)
+                                          throws JavetException
        +
        Gets zoned date time.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the zoned date time
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        has

        +
        boolean has(java.lang.Object value)
+     throws JavetException
        +
        Has object property key.
        +
        +
        Parameters:
        +
        value - the value
        +
        Returns:
        +
        true : yes, false: no
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        hasNull

        +
        default boolean hasNull()
+                 throws JavetException
        +
        Has null property key.
        +
        +
        Returns:
        +
        true : yes, false: no
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.3
        +
        +
        • +
      + + + +
        +
      • +

        hasOwnProperty

        +
        boolean hasOwnProperty(java.lang.Object key)
+                throws JavetException
        +
        Has own property key.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        true : yes, false: no
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        hasPrivateProperty

        +
        boolean hasPrivateProperty(java.lang.String propertyName)
+                    throws JavetException
        +
        Has private property boolean.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + +
        +
      • +

        hasUndefined

        +
        default boolean hasUndefined()
+                      throws JavetException
        +
        Has undefined property key.
        +
        +
        Returns:
        +
        true : yes, false: no
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.3
        +
        +
        • +
      + + + +
        +
      • +

        invoke

        +
        @CheckReturnValue
+default <T extends V8Value> T invoke(java.lang.String functionName,
+                                                        java.lang.Object... objects)
+                                                 throws JavetException
        +
        Invoke function with return V8 value by name and objects as arguments.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        functionName - the function name
        +
        objects - the objects
        +
        Returns:
        +
        the result
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        invoke

        +
        @CheckReturnValue
+default <T extends V8Value> T invoke(java.lang.String functionName,
+                                                        V8Value... v8Values)
+                                                 throws JavetException
        +
        Invoke function with return V8 value by name and V8 values as arguments.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        functionName - the function name
        +
        v8Values - the V8 values
        +
        Returns:
        +
        the result
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        invokeBoolean

        +
        default java.lang.Boolean invokeBoolean(java.lang.String functionName,
+                                        java.lang.Object... objects)
+                                 throws JavetException
        +
        Invoke function with return value boolean by name and objects as arguments.
        +
        +
        Parameters:
        +
        functionName - the function name
        +
        objects - the objects
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        invokeDouble

        +
        default java.lang.Double invokeDouble(java.lang.String functionName,
+                                      java.lang.Object... objects)
+                               throws JavetException
        +
        Invoke function with return value double by name and objects as arguments.
        +
        +
        Parameters:
        +
        functionName - the function name
        +
        objects - the objects
        +
        Returns:
        +
        the double
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        invokeExtended

        +
        @CheckReturnValue
+<T extends V8Value> T invokeExtended(java.lang.String functionName,
+                                                        boolean returnResult,
+                                                        java.lang.Object... objects)
+                                                 throws JavetException
        +
        Invoke extended and return V8 value which must be consumed, + otherwise memory leak may occur.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        functionName - the function name
        +
        returnResult - the return result
        +
        objects - the objects
        +
        Returns:
        +
        the result
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.5
        +
        +
        • +
      + + + +
        +
      • +

        invokeExtended

        +
        @CheckReturnValue
+<T extends V8Value> T invokeExtended(java.lang.String functionName,
+                                                        boolean returnResult,
+                                                        V8Value... v8Values)
+                                                 throws JavetException
        +
        Invoke extended and return V8 value which must be consumed, + otherwise memory leak may occur.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        functionName - the function name
        +
        returnResult - the return result
        +
        v8Values - the v 8 values
        +
        Returns:
        +
        the result
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.5
        +
        +
        • +
      + + + +
        +
      • +

        invokeFloat

        +
        default java.lang.Float invokeFloat(java.lang.String functionName,
+                                    java.lang.Object... objects)
+                             throws JavetException
        +
        Invoke function with return value float by name and objects as arguments.
        +
        +
        Parameters:
        +
        functionName - the function name
        +
        objects - the objects
        +
        Returns:
        +
        the float
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        invokeInteger

        +
        default java.lang.Integer invokeInteger(java.lang.String functionName,
+                                        java.lang.Object... objects)
+                                 throws JavetException
        +
        Invoke function with return value integer by name and objects as arguments.
        +
        +
        Parameters:
        +
        functionName - the function name
        +
        objects - the objects
        +
        Returns:
        +
        the integer
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        invokeLong

        +
        default java.lang.Long invokeLong(java.lang.String functionName,
+                                  java.lang.Object... objects)
+                           throws JavetException
        +
        Invoke function with return value long by name and objects as arguments.
        +
        +
        Parameters:
        +
        functionName - the function name
        +
        objects - the objects
        +
        Returns:
        +
        the long
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        invokeObject

        +
        default <T> T invokeObject(java.lang.String functionName,
+                           java.lang.Object... objects)
+                    throws JavetException
        +
        Invoke function with return value object by name and objects as arguments.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        functionName - the function name
        +
        objects - the objects
        +
        Returns:
        +
        the t
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        invokePrimitive

        +
        default <R,T extends V8ValuePrimitive<R>> R invokePrimitive(java.lang.String functionName,
+                                                            java.lang.Object... objects)
+                                                     throws JavetException
        +
        Invoke function with return value primitive by name and objects as arguments.
        +
        +
        Type Parameters:
        +
        R - the type parameter
        +
        T - the type parameter
        +
        Parameters:
        +
        functionName - the function name
        +
        objects - the objects
        +
        Returns:
        +
        the primitive value
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        invokeString

        +
        default java.lang.String invokeString(java.lang.String functionName,
+                                      java.lang.Object... objects)
+                               throws JavetException
        +
        Invoke function with return value string by name and objects as arguments.
        +
        +
        Parameters:
        +
        functionName - the function name
        +
        objects - the objects
        +
        Returns:
        +
        the string
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        invokeVoid

        +
        default void invokeVoid(java.lang.String functionName,
+                        java.lang.Object... objects)
+                 throws JavetException
        +
        Invoke function without return value by name and objects as arguments.
        +
        +
        Parameters:
        +
        functionName - the function name
        +
        objects - the objects
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        invokeVoid

        +
        default void invokeVoid(java.lang.String functionName,
+                        V8Value... v8Values)
+                 throws JavetException
        +
        Invoke function without return value by name and V8 values as arguments.
        +
        +
        Parameters:
        +
        functionName - the function name
        +
        v8Values - the V8 values
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        set

        +
        boolean set(java.lang.Object key,
+            java.lang.Object value)
+     throws JavetException
        +
        Set boolean.
        +
        +
        Parameters:
        +
        key - the key
        +
        value - the value
        +
        Returns:
        +
        true : set, false: not set
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        setNull

        +
        default boolean setNull(java.lang.Object key)
+                 throws JavetException
        +
        Sets null.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        true : set, false: not set
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        setPrivateProperty

        +
        boolean setPrivateProperty(java.lang.String propertyName,
+                           java.lang.Object propertyValue)
+                    throws JavetException
        +
        Sets private property.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        propertyValue - the property value
        +
        Returns:
        +
        true : set, false: not set
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + +
        +
      • +

        setPrivatePropertyNull

        +
        default boolean setPrivatePropertyNull(java.lang.String propertyKey)
+                                throws JavetException
        +
        Sets private property null.
        +
        +
        Parameters:
        +
        propertyKey - the property key
        +
        Returns:
        +
        true : set, false: not set
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + +
        +
      • +

        setPrivatePropertyUndefined

        +
        default boolean setPrivatePropertyUndefined(java.lang.String propertyKey)
+                                     throws JavetException
        +
        Sets private property undefined.
        +
        +
        Parameters:
        +
        propertyKey - the property key
        +
        Returns:
        +
        true : set, false: not set
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.12
        +
        +
        • +
      + + + +
        +
      • +

        setProperty

        +
        boolean setProperty(java.lang.Object key,
+                    java.lang.Object value)
+             throws JavetException
        +
        Sets property.
        +
        +
        Parameters:
        +
        key - the key
        +
        value - the value
        +
        Returns:
        +
        true : set, false: not set
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        setPropertyNull

        +
        default boolean setPropertyNull(java.lang.Object key)
+                         throws JavetException
        +
        Sets property null.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        true : set, false: not set
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        setPropertyUndefined

        +
        default boolean setPropertyUndefined(java.lang.Object key)
+                              throws JavetException
        +
        Sets property undefined.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        true : set, false: not set
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        setPrototype

        +
        boolean setPrototype(IV8ValueObject v8ValueObject)
+              throws JavetException
        +
        Sets prototype.
        +
        +
        Parameters:
        +
        v8ValueObject - the V8 value object
        +
        Returns:
        +
        true : set, false: not set
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.4
        +
        +
        • +
      + + + +
        +
      • +

        setUndefined

        +
        default boolean setUndefined(java.lang.Object key)
+                      throws JavetException
        +
        Sets undefined.
        +
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        true : set, false: not set
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        toJsonString

        +
        java.lang.String toJsonString()
        +
        To json string. +

        + JS equivalent: + JSON.stringify(obj);

        +
        +
        Returns:
        +
        the string
        +
        Since:
        +
        0.7.0
        +
        +
        • +
      + + + +
        +
      • +

        toProtoString

        +
        java.lang.String toProtoString()
        +
        To proto string.
        +
        +
        Returns:
        +
        the string
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        unbind

        +
        int unbind(java.lang.Object callbackReceiver)
+    throws JavetException
        +
        Unbind the interception.
        +
        +
        Parameters:
        +
        callbackReceiver - the callback receiver
        +
        Returns:
        +
        the count
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.11
        +
        +
        • +
      + + + +
        +
      • +

        unbindFunction

        +
        boolean unbindFunction(java.lang.String functionName)
+                throws JavetException
        +
        Unbind function.
        +
        +
        Parameters:
        +
        functionName - the function name
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.11
        +
        +
        • +
      + + + +
        +
      • +

        unbindProperty

        +
        default boolean unbindProperty(java.lang.String propertyName)
+                        throws JavetException
        +
        Unbind property.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.11
        +
        +
        • +
      + + + +
        +
      • +

        unbindProperty

        +
        boolean unbindProperty(V8ValueString propertyName)
+                throws JavetException
        +
        Unbind property boolean.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        unbindProperty

        +
        boolean unbindProperty(V8ValueSymbol propertyName)
+                throws JavetException
        +
        Unbind property boolean.
        +
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValuePromise.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValuePromise.html new file mode 100644 index 000000000..79fcf4dbb --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValuePromise.html @@ -0,0 +1,1036 @@ + + + + + +IV8ValuePromise (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Interface IV8ValuePromise

+
+
+
+
    +
  • +
    +
    All Superinterfaces:
    +
    java.lang.AutoCloseable, IJavetClosable, IV8Cloneable, IV8Value, IV8ValueObject, IV8ValueReference
    +
    +
    +
    All Known Implementing Classes:
    +
    V8ValuePromise
    +
    +
    +
    +
    public interface IV8ValuePromise
+extends IV8ValueObject
    +
    The interface V8 value promise is 2-sided. + 1. As a promise resolver, its API includes getPromise(), resolve(), reject(). + 2. As a promise, its API includes _catch(), then(), hasHandler(), markAsHandled(), getState(), getResult().
    +
    +
    Since:
    +
    0.8.0
    +
    +
    • +
+
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        STATE_PENDING

        +
        static final int STATE_PENDING
        +
        The constant STATE_PENDING.
        +
        +
        Since:
        +
        0.8.0
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        STATE_FULFILLED

        +
        static final int STATE_FULFILLED
        +
        The constant STATE_FULFILLED.
        +
        +
        Since:
        +
        0.8.0
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        STATE_REJECTED

        +
        static final int STATE_REJECTED
        +
        The constant STATE_REJECTED.
        +
        +
        Since:
        +
        0.8.0
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + + + + + + + + + + + + + + + + + +
        +
      • +

        getResultBoolean

        +
        default boolean getResultBoolean()
+                          throws JavetException
        +
        Gets result boolean.
        +
        +
        Returns:
        +
        the result boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        getResultDouble

        +
        default double getResultDouble()
+                        throws JavetException
        +
        Gets result double.
        +
        +
        Returns:
        +
        the result double
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        getResultInteger

        +
        default int getResultInteger()
+                      throws JavetException
        +
        Gets result integer.
        +
        +
        Returns:
        +
        the result integer
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        getResultLong

        +
        default long getResultLong()
+                    throws JavetException
        +
        Gets result long.
        +
        +
        Returns:
        +
        the result long
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        getResultObject

        +
        default <T> T getResultObject(java.lang.Object key)
+                       throws JavetException
        +
        Gets result object.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the result object
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        getResultPrimitive

        +
        default <R,T extends V8ValuePrimitive<R>> R getResultPrimitive()
+                                                        throws JavetException
        +
        Gets result primitive.
        +
        +
        Type Parameters:
        +
        R - the type parameter
        +
        T - the type parameter
        +
        Returns:
        +
        the result primitive
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        getResultString

        +
        default java.lang.String getResultString()
+                                  throws JavetException
        +
        Gets result string.
        +
        +
        Returns:
        +
        the result string
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        getResultZonedDateTime

        +
        default java.time.ZonedDateTime getResultZonedDateTime()
+                                                throws JavetException
        +
        Gets result zoned date time.
        +
        +
        Returns:
        +
        the result zoned date time
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        getState

        +
        int getState()
+      throws JavetException
        +
        Gets state.
        +
        +
        Returns:
        +
        the state
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        hasHandler

        +
        boolean hasHandler()
+            throws JavetException
        +
        Has handler.
        +
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        isFulfilled

        +
        default boolean isFulfilled()
+                     throws JavetException
        +
        Is fulfilled.
        +
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        isPending

        +
        default boolean isPending()
+                   throws JavetException
        +
        Is pending.
        +
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        isRejected

        +
        default boolean isRejected()
+                    throws JavetException
        +
        Is rejected.
        +
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        markAsHandled

        +
        void markAsHandled()
+            throws JavetException
        +
        Mark as handled.
        +
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      + + + +
        +
      • +

        reject

        +
        boolean reject(V8Value v8Value)
+        throws JavetException
        +
        Reject.
        +
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.8
        +
        +
        • +
      + + + +
        +
      • +

        reject

        +
        default boolean reject(java.lang.Object object)
+                throws JavetException
        +
        Reject.
        +
        +
        Parameters:
        +
        object - the object
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.8
        +
        +
        • +
      + + + +
        +
      • +

        resolve

        +
        boolean resolve(V8Value v8Value)
+         throws JavetException
        +
        Resolve.
        +
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.8
        +
        +
        • +
      + + + +
        +
      • +

        resolve

        +
        default boolean resolve(java.lang.Object object)
+                 throws JavetException
        +
        Resolve.
        +
        +
        Parameters:
        +
        object - the object
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.9.8
        +
        +
        • +
      + + + + + + + + + + + + + + + +
        +
      • +

        then

        +
        @CheckReturnValue
+default V8ValuePromise then(java.lang.String codeStringFulfilled,
+                                               java.lang.String codeStringRejected)
+                                        throws JavetException
        +
        Then.
        +
        +
        Parameters:
        +
        codeStringFulfilled - the code string fulfilled
        +
        codeStringRejected - the code string rejected
        +
        Returns:
        +
        the V8 value promise
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.0
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueProxy.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueProxy.html new file mode 100644 index 000000000..92ca7008b --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueProxy.html @@ -0,0 +1,354 @@ + + + + + +IV8ValueProxy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Interface IV8ValueProxy

+
+
+
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueReference.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueReference.html new file mode 100644 index 000000000..e8e97160f --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueReference.html @@ -0,0 +1,378 @@ + + + + + +IV8ValueReference (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Interface IV8ValueReference

+
+
+
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueSet.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueSet.html new file mode 100644 index 000000000..6a7f16ff0 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueSet.html @@ -0,0 +1,329 @@ + + + + + +IV8ValueSet (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Interface IV8ValueSet

+
+
+
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueTypedArray.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueTypedArray.html new file mode 100644 index 000000000..31f065708 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/IV8ValueTypedArray.html @@ -0,0 +1,348 @@ + + + + + +IV8ValueTypedArray (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Interface IV8ValueTypedArray

+
+
+
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8Module.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8Module.html new file mode 100644 index 000000000..59ed3b168 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8Module.html @@ -0,0 +1,618 @@ + + + + + +V8Module (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8Module

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8Script.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8Script.html new file mode 100644 index 000000000..472bdfde3 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8Script.html @@ -0,0 +1,487 @@ + + + + + +V8Script (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8Script

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueArguments.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueArguments.html new file mode 100644 index 000000000..57cec58c9 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueArguments.html @@ -0,0 +1,375 @@ + + + + + +V8ValueArguments (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueArguments

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueArray.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueArray.html new file mode 100644 index 000000000..76ae7c9c2 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueArray.html @@ -0,0 +1,652 @@ + + + + + +V8ValueArray (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueArray

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueArrayBuffer.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueArrayBuffer.html new file mode 100644 index 000000000..3555596b1 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueArrayBuffer.html @@ -0,0 +1,675 @@ + + + + + +V8ValueArrayBuffer (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueArrayBuffer

+
+
+ +
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + + + + + + + + + + + + + +
        +
      • +

        PROPERTY_BYTE_LENGTH

        +
        protected static final java.lang.String PROPERTY_BYTE_LENGTH
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        byteBuffer

        +
        protected java.nio.ByteBuffer byteBuffer
        +
        • +
      + + + +
        +
      • +

        byteOrder

        +
        protected java.nio.ByteOrder byteOrder
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        fromBytes

        +
        public boolean fromBytes(byte[] bytes)
        +
        • +
      + + + +
        +
      • +

        fromDoubles

        +
        public boolean fromDoubles(double[] doubles)
        +
        • +
      + + + +
        +
      • +

        fromFloats

        +
        public boolean fromFloats(float[] floats)
        +
        • +
      + + + +
        +
      • +

        fromIntegers

        +
        public boolean fromIntegers(int[] integers)
        +
        • +
      + + + +
        +
      • +

        fromLongs

        +
        public boolean fromLongs(long[] longs)
        +
        • +
      + + + +
        +
      • +

        fromShorts

        +
        public boolean fromShorts(short[] shorts)
        +
        • +
      + + + +
        +
      • +

        getByteBuffer

        +
        public java.nio.ByteBuffer getByteBuffer()
        +
        • +
      + + + + + + + +
        +
      • +

        getByteOrder

        +
        public java.nio.ByteOrder getByteOrder()
        +
        • +
      + + + + + + + +
        +
      • +

        setByteOrder

        +
        public void setByteOrder(java.nio.ByteOrder byteOrder)
        +
        • +
      + + + +
        +
      • +

        toBytes

        +
        public byte[] toBytes()
        +
        • +
      + + + +
        +
      • +

        toDoubles

        +
        public double[] toDoubles()
        +
        • +
      + + + +
        +
      • +

        toFloats

        +
        public float[] toFloats()
        +
        • +
      + + + +
        +
      • +

        toIntegers

        +
        public int[] toIntegers()
        +
        • +
      + + + +
        +
      • +

        toLongs

        +
        public long[] toLongs()
        +
        • +
      + + + +
        +
      • +

        toShorts

        +
        public short[] toShorts()
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueDataView.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueDataView.html new file mode 100644 index 000000000..576f19d91 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueDataView.html @@ -0,0 +1,1120 @@ + + + + + +V8ValueDataView (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueDataView

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueError.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueError.html new file mode 100644 index 000000000..9b656dc75 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueError.html @@ -0,0 +1,434 @@ + + + + + +V8ValueError (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueError

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueFunction.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueFunction.html new file mode 100644 index 000000000..31caf5e82 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueFunction.html @@ -0,0 +1,699 @@ + + + + + +V8ValueFunction (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueFunction

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueGlobalObject.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueGlobalObject.html new file mode 100644 index 000000000..66d028a60 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueGlobalObject.html @@ -0,0 +1,619 @@ + + + + + +V8ValueGlobalObject (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueGlobalObject

+
+
+ +
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    IJavetClosable, IV8Cloneable, IV8Value, IV8ValueObject, IV8ValueReference, java.lang.AutoCloseable
    +
    +
    +
    +
    public final class V8ValueGlobalObject
+extends V8ValueObject
    +
    The type V8 value global object is a special object. + 1. It lives as long as V8 runtime lives. + 2. It does not have reference count. + 3. It cannot be set to weak. + 4. Its clone is itself.
    +
    • +
+
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueIterator.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueIterator.html new file mode 100644 index 000000000..6ba9004aa --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueIterator.html @@ -0,0 +1,440 @@ + + + + + +V8ValueIterator (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueIterator<T extends V8Value>

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueMap.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueMap.html new file mode 100644 index 000000000..9fff5af75 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueMap.html @@ -0,0 +1,645 @@ + + + + + +V8ValueMap (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueMap

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueObject.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueObject.html new file mode 100644 index 000000000..a9d00fe21 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueObject.html @@ -0,0 +1,1592 @@ + + + + + +V8ValueObject (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueObject

+
+
+ +
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        FUNCTION_ADD

        +
        protected static final java.lang.String FUNCTION_ADD
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        FUNCTION_DELETE

        +
        protected static final java.lang.String FUNCTION_DELETE
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        FUNCTION_GET

        +
        protected static final java.lang.String FUNCTION_GET
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        FUNCTION_HAS

        +
        protected static final java.lang.String FUNCTION_HAS
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        FUNCTION_SET

        +
        protected static final java.lang.String FUNCTION_SET
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        METHOD_PREFIX_GET

        +
        protected static final java.lang.String METHOD_PREFIX_GET
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        METHOD_PREFIX_IS

        +
        protected static final java.lang.String METHOD_PREFIX_IS
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        METHOD_PREFIX_SET

        +
        protected static final java.lang.String METHOD_PREFIX_SET
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PROPERTY_PROTOTYPE

        +
        protected static final java.lang.String PROPERTY_PROTOTYPE
        +
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        V8ValueObject

        +
        protected V8ValueObject(long handle)
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        bind

        +
        public java.util.List<JavetCallbackContext> bind(java.lang.Object callbackReceiver)
+                                          throws JavetException
        +
        Description copied from interface: IV8ValueObject
        +
        Bind both functions via @V8Function and properties via @V8Property.
        +
        +
        Specified by:
        +
        bind in interface IV8ValueObject
        +
        Parameters:
        +
        callbackReceiver - the callback receiver
        +
        Returns:
        +
        the list of callback context
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        bindFunction

        +
        public boolean bindFunction(java.lang.String functionName,
+                            JavetCallbackContext javetCallbackContext)
+                     throws JavetException
        +
        Description copied from interface: IV8ValueObject
        +
        Binds function by name and callback context. +

        + It is for creating a Java code based function in V8.

        +
        +
        Specified by:
        +
        bindFunction in interface IV8ValueObject
        +
        Parameters:
        +
        functionName - the function name
        +
        javetCallbackContext - the javet callback context
        +
        Returns:
        +
        true : function is bind, false: function is not bind
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        bindProperty

        +
        public boolean bindProperty(V8ValueString propertyName,
+                            JavetCallbackContext javetCallbackContextGetter,
+                            JavetCallbackContext javetCallbackContextSetter)
+                     throws JavetException
        +
        Description copied from interface: IV8ValueObject
        +
        Bind property.
        +
        +
        Specified by:
        +
        bindProperty in interface IV8ValueObject
        +
        Parameters:
        +
        propertyName - the property name
        +
        javetCallbackContextGetter - the javet callback context getter
        +
        javetCallbackContextSetter - the javet callback context setter
        +
        Returns:
        +
        true if the property is bind, false if the property is not bind
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + + + + + +
        +
      • +

        delete

        +
        public boolean delete(java.lang.Object key)
+               throws JavetException
        +
        Description copied from interface: IV8ValueObject
        +
        Delete boolean.
        +
        +
        Specified by:
        +
        delete in interface IV8ValueObject
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        deletePrivateProperty

        +
        public boolean deletePrivateProperty(java.lang.String propertyName)
+                              throws JavetException
        +
        Description copied from interface: IV8ValueObject
        +
        Delete private property boolean.
        +
        +
        Specified by:
        +
        deletePrivateProperty in interface IV8ValueObject
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        forEach

        +
        public <Key extends V8Value,E extends java.lang.Throwable> int forEach(IJavetUniConsumer<Key,E> consumer)
+                                                                throws JavetException,
+                                                                       E extends java.lang.Throwable
        +
        Description copied from interface: IV8ValueObject
        +
        For each.
        +
        +
        Specified by:
        +
        forEach in interface IV8ValueObject
        +
        Type Parameters:
        +
        Key - the type of key
        +
        E - the type of exception
        +
        Parameters:
        +
        consumer - the consumer
        +
        Returns:
        +
        the item count
        +
        Throws:
        +
        JavetException - the javet exception
        +
        E - the exception
        +
        E extends java.lang.Throwable
        +
        +
        • +
      + + + +
        +
      • +

        forEach

        +
        public <Key extends V8Value,E extends java.lang.Throwable> int forEach(IJavetUniIndexedConsumer<Key,E> consumer)
+                                                                throws JavetException,
+                                                                       E extends java.lang.Throwable
        +
        Description copied from interface: IV8ValueObject
        +
        For each.
        +
        +
        Specified by:
        +
        forEach in interface IV8ValueObject
        +
        Type Parameters:
        +
        Key - the type of key
        +
        E - the type of exception
        +
        Parameters:
        +
        consumer - the consumer
        +
        Returns:
        +
        the item count
        +
        Throws:
        +
        JavetException - the javet exception
        +
        E - the exception
        +
        E extends java.lang.Throwable
        +
        +
        • +
      + + + +
        +
      • +

        forEach

        +
        public <Key extends V8Value,Value extends V8Value,E extends java.lang.Throwable> int forEach(IJavetBiConsumer<Key,Value,E> consumer)
+                                                                                      throws JavetException,
+                                                                                             E extends java.lang.Throwable
        +
        Description copied from interface: IV8ValueObject
        +
        For each.
        +
        +
        Specified by:
        +
        forEach in interface IV8ValueObject
        +
        Type Parameters:
        +
        Key - the type of key
        +
        Value - the type of value
        +
        E - the type of exception
        +
        Parameters:
        +
        consumer - the consumer
        +
        Returns:
        +
        the item count
        +
        Throws:
        +
        JavetException - the javet exception
        +
        E - the exception
        +
        E extends java.lang.Throwable
        +
        +
        • +
      + + + +
        +
      • +

        forEach

        +
        public <Key extends V8Value,Value extends V8Value,E extends java.lang.Throwable> int forEach(IJavetBiIndexedConsumer<Key,Value,E> consumer)
+                                                                                      throws JavetException,
+                                                                                             E extends java.lang.Throwable
        +
        Description copied from interface: IV8ValueObject
        +
        For each.
        +
        +
        Specified by:
        +
        forEach in interface IV8ValueObject
        +
        Type Parameters:
        +
        Key - the type of key
        +
        Value - the type of value
        +
        E - the type of exception
        +
        Parameters:
        +
        consumer - the consumer
        +
        Returns:
        +
        the item count
        +
        Throws:
        +
        JavetException - the javet exception
        +
        E - the exception
        +
        E extends java.lang.Throwable
        +
        +
        • +
      + + + + + + + + + + + +
        +
      • +

        getIdentityHash

        +
        public int getIdentityHash()
+                    throws JavetException
        +
        Description copied from interface: IV8ValueObject
        +
        Returns the identity hash for this object. The current implementation + uses an inline property on the object to store the identity hash. +

        + The return value will never be 0. Also, it is not guaranteed to be + unique.

        +
        +
        Specified by:
        +
        getIdentityHash in interface IV8ValueObject
        +
        Returns:
        +
        the identity hash
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + + + + + +
        +
      • +

        getPrivateProperty

        +
        public <T extends V8Value> T getPrivateProperty(java.lang.String propertyName)
+                                         throws JavetException
        +
        Description copied from interface: IV8ValueObject
        +
        Gets private property.
        +
        +
        Specified by:
        +
        getPrivateProperty in interface IV8ValueObject
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the private property
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + + + + + + + + + + + + + + + + + +
        +
      • +

        has

        +
        public boolean has(java.lang.Object value)
+            throws JavetException
        +
        Description copied from interface: IV8ValueObject
        +
        Has object property key.
        +
        +
        Specified by:
        +
        has in interface IV8ValueObject
        +
        Parameters:
        +
        value - the value
        +
        Returns:
        +
        true : yes, false: no
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        hasOwnProperty

        +
        public boolean hasOwnProperty(java.lang.Object key)
+                       throws JavetException
        +
        Description copied from interface: IV8ValueObject
        +
        Has own property key.
        +
        +
        Specified by:
        +
        hasOwnProperty in interface IV8ValueObject
        +
        Parameters:
        +
        key - the key
        +
        Returns:
        +
        true : yes, false: no
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        hasPrivateProperty

        +
        public boolean hasPrivateProperty(java.lang.String propertyName)
+                           throws JavetException
        +
        Description copied from interface: IV8ValueObject
        +
        Has private property boolean.
        +
        +
        Specified by:
        +
        hasPrivateProperty in interface IV8ValueObject
        +
        Parameters:
        +
        propertyName - the property name
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        invokeExtended

        +
        @CheckReturnValue
+public <T extends V8Value> T invokeExtended(java.lang.String functionName,
+                                                               boolean returnResult,
+                                                               java.lang.Object... objects)
+                                                        throws JavetException
        +
        Description copied from interface: IV8ValueObject
        +
        Invoke extended and return V8 value which must be consumed, + otherwise memory leak may occur.
        +
        +
        Specified by:
        +
        invokeExtended in interface IV8ValueObject
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        functionName - the function name
        +
        returnResult - the return result
        +
        objects - the objects
        +
        Returns:
        +
        the result
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        invokeExtended

        +
        @CheckReturnValue
+public <T extends V8Value> T invokeExtended(java.lang.String functionName,
+                                                               boolean returnResult,
+                                                               V8Value... v8Values)
+                                                        throws JavetException
        +
        Description copied from interface: IV8ValueObject
        +
        Invoke extended and return V8 value which must be consumed, + otherwise memory leak may occur.
        +
        +
        Specified by:
        +
        invokeExtended in interface IV8ValueObject
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Parameters:
        +
        functionName - the function name
        +
        returnResult - the return result
        +
        v8Values - the v 8 values
        +
        Returns:
        +
        the result
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        sameValue

        +
        public boolean sameValue(V8Value v8Value)
+                  throws JavetException
        +
        Description copied from interface: IV8Value
        +
        Same value. +

        + The behavior is different from JS behavior but is the same as Java behavior.

        +
        +
        Specified by:
        +
        sameValue in interface IV8Value
        +
        Overrides:
        +
        sameValue in class V8ValueReference
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        set

        +
        public boolean set(java.lang.Object key,
+                   java.lang.Object value)
+            throws JavetException
        +
        Description copied from interface: IV8ValueObject
        +
        Set boolean.
        +
        +
        Specified by:
        +
        set in interface IV8ValueObject
        +
        Parameters:
        +
        key - the key
        +
        value - the value
        +
        Returns:
        +
        true : set, false: not set
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        setPrivateProperty

        +
        public boolean setPrivateProperty(java.lang.String propertyName,
+                                  java.lang.Object propertyValue)
+                           throws JavetException
        +
        Description copied from interface: IV8ValueObject
        +
        Sets private property.
        +
        +
        Specified by:
        +
        setPrivateProperty in interface IV8ValueObject
        +
        Parameters:
        +
        propertyName - the property name
        +
        propertyValue - the property value
        +
        Returns:
        +
        true : set, false: not set
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        setProperty

        +
        public boolean setProperty(java.lang.Object key,
+                           java.lang.Object value)
+                    throws JavetException
        +
        Description copied from interface: IV8ValueObject
        +
        Sets property.
        +
        +
        Specified by:
        +
        setProperty in interface IV8ValueObject
        +
        Parameters:
        +
        key - the key
        +
        value - the value
        +
        Returns:
        +
        true : set, false: not set
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + + + + + +
        +
      • +

        strictEquals

        +
        public boolean strictEquals(V8Value v8Value)
+                     throws JavetException
        +
        Description copied from interface: IV8Value
        +
        Strict equals boolean. +

        + The behavior is different from JS behavior but is the same as Java behavior.

        +
        +
        Specified by:
        +
        strictEquals in interface IV8Value
        +
        Overrides:
        +
        strictEquals in class V8ValueReference
        +
        Parameters:
        +
        v8Value - the V8 value
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        toJsonString

        +
        public java.lang.String toJsonString()
        +
        Description copied from interface: IV8ValueObject
        +
        To json string. +

        + JS equivalent: + JSON.stringify(obj);

        +
        +
        Specified by:
        +
        toJsonString in interface IV8ValueObject
        +
        Returns:
        +
        the string
        +
        +
        • +
      + + + +
        +
      • +

        toProtoString

        +
        public java.lang.String toProtoString()
        +
        Description copied from interface: IV8ValueObject
        +
        To proto string.
        +
        +
        Specified by:
        +
        toProtoString in interface IV8ValueObject
        +
        Returns:
        +
        the string
        +
        +
        • +
      + + + +
        +
      • +

        unbind

        +
        public int unbind(java.lang.Object callbackReceiver)
+           throws JavetException
        +
        Description copied from interface: IV8ValueObject
        +
        Unbind the interception.
        +
        +
        Specified by:
        +
        unbind in interface IV8ValueObject
        +
        Parameters:
        +
        callbackReceiver - the callback receiver
        +
        Returns:
        +
        the count
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + +
        +
      • +

        unbindFunction

        +
        public boolean unbindFunction(java.lang.String functionName)
+                       throws JavetException
        +
        Description copied from interface: IV8ValueObject
        +
        Unbind function.
        +
        +
        Specified by:
        +
        unbindFunction in interface IV8ValueObject
        +
        Parameters:
        +
        functionName - the function name
        +
        Returns:
        +
        the boolean
        +
        Throws:
        +
        JavetException - the javet exception
        +
        +
        • +
      + + + + + + + + +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValuePromise.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValuePromise.html new file mode 100644 index 000000000..360a14a50 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValuePromise.html @@ -0,0 +1,617 @@ + + + + + +V8ValuePromise (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValuePromise

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueProxy.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueProxy.html new file mode 100644 index 000000000..28f321148 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueProxy.html @@ -0,0 +1,457 @@ + + + + + +V8ValueProxy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueProxy

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueReference.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueReference.html new file mode 100644 index 000000000..239471a24 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueReference.html @@ -0,0 +1,729 @@ + + + + + +V8ValueReference (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueReference

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueRegExp.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueRegExp.html new file mode 100644 index 000000000..3a1a34a47 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueRegExp.html @@ -0,0 +1,349 @@ + + + + + +V8ValueRegExp (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueRegExp

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueSet.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueSet.html new file mode 100644 index 000000000..5715b37d0 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueSet.html @@ -0,0 +1,560 @@ + + + + + +V8ValueSet (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueSet

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueSharedArrayBuffer.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueSharedArrayBuffer.html new file mode 100644 index 000000000..6ef2fefe7 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueSharedArrayBuffer.html @@ -0,0 +1,368 @@ + + + + + +V8ValueSharedArrayBuffer (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueSharedArrayBuffer

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueSymbol.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueSymbol.html new file mode 100644 index 000000000..c01a779ee --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueSymbol.html @@ -0,0 +1,459 @@ + + + + + +V8ValueSymbol (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueSymbol

+
+
+ +
+ +
+
+ +
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        FUNCTION_TO_STRING

        +
        protected static final java.lang.String FUNCTION_TO_STRING
        +
        The constant FUNCTION_TO_STRING.
        +
        +
        Since:
        +
        0.9.11
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      + + + +
        +
      • +

        PROPERTY_DESCRIPTION

        +
        protected static final java.lang.String PROPERTY_DESCRIPTION
        +
        The constant PROPERTY_DESCRIPTION.
        +
        +
        Since:
        +
        0.9.11
        +
        See Also:
        +
        Constant Field Values
        +
        +
        • +
      +
      • +
    + + +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueSymbolObject.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueSymbolObject.html new file mode 100644 index 000000000..723b02b57 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueSymbolObject.html @@ -0,0 +1,437 @@ + + + + + +V8ValueSymbolObject (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueSymbolObject

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueTypedArray.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueTypedArray.html new file mode 100644 index 000000000..896f65882 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueTypedArray.html @@ -0,0 +1,1026 @@ + + + + + +V8ValueTypedArray (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueTypedArray

+
+
+ +
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    IJavetClosable, IV8Cloneable, IV8Value, IV8ValueObject, IV8ValueReference, IV8ValueTypedArray, java.lang.AutoCloseable
    +
    +
    +
    +
    public class V8ValueTypedArray
+extends V8ValueObject
+implements IV8ValueTypedArray
    +
    The type V8 value typed array. + The typical way of manipulating the typed array is as following. + 1. Get array buffer and apply try-with-resource. + 2. Create the value array by length. + 3. Fill the value array. + E.g.: + + try (V8ValueArrayBuffer v8ValueArrayBuffer = v8ValueTypedArray.getArrayBuffer()) { + long[] longs = new long[v8ValueArrayBuffer.getLength()]; + v8ValueArrayBuffer.toLongs(longs); + // ... + } + + Or, play with ByteBuffer directly. + 1. Get array buffer and apply try-with-resource. + 2. Get native ByteBuffer. + 3. Set order of the native ByteBuffer to native order. + 4. Get typed buffer by type. + 5. Read from or write to the typed buffer. + E.g: + + try (V8ValueArrayBuffer v8ValueArrayBuffer = v8ValueTypedArray.getArrayBuffer()) { + LongBuffer longBuffer = v8ValueArrayBuffer.getByteBuffer().order(ByteOrder.nativeOrder()).asLongBuffer(); + // ... + } +
    +
    • +
+
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueWeakMap.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueWeakMap.html new file mode 100644 index 000000000..0dcd72990 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueWeakMap.html @@ -0,0 +1,510 @@ + + + + + +V8ValueWeakMap (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueWeakMap

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueWeakSet.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueWeakSet.html new file mode 100644 index 000000000..524173e2e --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/V8ValueWeakSet.html @@ -0,0 +1,443 @@ + + + + + +V8ValueWeakSet (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + +
+
com.caoccao.javet.values.reference
+

Class V8ValueWeakSet

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+
    +
  • Summary: 
    • +
  • Nested | 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
    +
  • Detail: 
    • +
  • Field | 
    • +
  • Constr | 
    • +
  • Method
    • +
+
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/V8ValueBuiltInJson.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/V8ValueBuiltInJson.html new file mode 100644 index 000000000..cfd1c0887 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/V8ValueBuiltInJson.html @@ -0,0 +1,429 @@ + + + + + +V8ValueBuiltInJson (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.reference.builtin
+

Class V8ValueBuiltInJson

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/V8ValueBuiltInObject.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/V8ValueBuiltInObject.html new file mode 100644 index 000000000..0d7ca6adf --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/V8ValueBuiltInObject.html @@ -0,0 +1,511 @@ + + + + + +V8ValueBuiltInObject (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.reference.builtin
+

Class V8ValueBuiltInObject

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/V8ValueBuiltInPromise.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/V8ValueBuiltInPromise.html new file mode 100644 index 000000000..b13368e17 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/V8ValueBuiltInPromise.html @@ -0,0 +1,744 @@ + + + + + +V8ValueBuiltInPromise (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.reference.builtin
+

Class V8ValueBuiltInPromise

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/V8ValueBuiltInSymbol.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/V8ValueBuiltInSymbol.html new file mode 100644 index 000000000..311c61077 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/V8ValueBuiltInSymbol.html @@ -0,0 +1,1009 @@ + + + + + +V8ValueBuiltInSymbol (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.reference.builtin
+

Class V8ValueBuiltInSymbol

+
+
+ +
+ +
+
+ +
+
+ +
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/package-frame.html new file mode 100644 index 000000000..6842d9cb9 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/package-frame.html @@ -0,0 +1,22 @@ + + + + + +com.caoccao.javet.values.reference.builtin (javet 0.9.12 API) + + + + +

com.caoccao.javet.values.reference.builtin

+
+

Classes

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/package-summary.html new file mode 100644 index 000000000..9078d8426 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/package-summary.html @@ -0,0 +1,166 @@ + + + + + +com.caoccao.javet.values.reference.builtin (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.values.reference.builtin

+
+
Classes for V8 built-in reference values.
+
+

See: Description

+
+
+ + + + +

Package com.caoccao.javet.values.reference.builtin Description

+
Classes for V8 built-in reference values.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/package-tree.html new file mode 100644 index 000000000..5fc125f05 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/builtin/package-tree.html @@ -0,0 +1,157 @@ + + + + + +com.caoccao.javet.values.reference.builtin Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.values.reference.builtin

+Package Hierarchies: + +
+
+

Class Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/package-frame.html new file mode 100644 index 000000000..40c541e80 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/package-frame.html @@ -0,0 +1,57 @@ + + + + + +com.caoccao.javet.values.reference (javet 0.9.12 API) + + + + +

com.caoccao.javet.values.reference

+
+

Interfaces

+ +

Classes

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/package-summary.html new file mode 100644 index 000000000..9ea7a6d84 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/package-summary.html @@ -0,0 +1,325 @@ + + + + + +com.caoccao.javet.values.reference (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.values.reference

+
+
Classes for V8 reference values.
+
+

See: Description

+
+
+ + + + +

Package com.caoccao.javet.values.reference Description

+
Classes for V8 reference values.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/reference/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/values/reference/package-tree.html new file mode 100644 index 000000000..77d1e12f9 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/reference/package-tree.html @@ -0,0 +1,255 @@ + + + + + +com.caoccao.javet.values.reference Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.values.reference

+Package Hierarchies: + +
+
+

Class Hierarchy

+ +

Interface Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/virtual/V8VirtualValue.html b/docs/reference/javadoc/com/caoccao/javet/values/virtual/V8VirtualValue.html new file mode 100644 index 000000000..e53f02625 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/virtual/V8VirtualValue.html @@ -0,0 +1,414 @@ + + + + + +V8VirtualValue (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.virtual
+

Class V8VirtualValue

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.values.virtual.V8VirtualValue
      • +
    +
    • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    IJavetClosable, java.lang.AutoCloseable
    +
    +
    +
    +
    public class V8VirtualValue
+extends java.lang.Object
+implements IJavetClosable
    +
    The type V8 virtual value.
    +
    +
    Since:
    +
    0.8.5
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Summary

      + + + + + + + + + + + + + + +
      Fields 
      Modifier and TypeField and Description
      protected booleanconverted +
      It indicates whether the value is converted or not.
      +
      protected V8Valuevalue +
      The Value.
      +
      +
      • +
    + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + +
      Constructors 
      Constructor and Description
      V8VirtualValue(V8Runtime v8Runtime, + java.lang.Object object) +
      Instantiates a new V8 virtual value.
      +
      +
      • +
    + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + +
      All Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      voidclose() 
      <T extends V8Value>
      T      		get() +
      Get the value.
      +
      booleanisClosed() +
      Is closed.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        converted

        +
        protected boolean converted
        +
        It indicates whether the value is converted or not. + true: converted + false: not converted
        +
        +
        Since:
        +
        0.8.5
        +
        +
        • +
      + + + +
        +
      • +

        value

        +
        protected V8Value value
        +
        The Value.
        +
        +
        Since:
        +
        0.8.5
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        V8VirtualValue

        +
        public V8VirtualValue(V8Runtime v8Runtime,
+                      java.lang.Object object)
+               throws JavetException
        +
        Instantiates a new V8 virtual value.
        +
        +
        Parameters:
        +
        v8Runtime - the V8 runtime
        +
        object - the object
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.5
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + + + + + +
        +
      • +

        get

        +
        public <T extends V8Value> T get()
        +
        Get the value.
        +
        +
        Type Parameters:
        +
        T - the type parameter
        +
        Returns:
        +
        the value
        +
        Since:
        +
        0.8.5
        +
        +
        • +
      + + + +
        +
      • +

        isClosed

        +
        public boolean isClosed()
        +
        Description copied from interface: IJavetClosable
        +
        Is closed.
        +
        +
        Specified by:
        +
        isClosed in interface IJavetClosable
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/virtual/V8VirtualValueList.html b/docs/reference/javadoc/com/caoccao/javet/values/virtual/V8VirtualValueList.html new file mode 100644 index 000000000..14b292494 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/virtual/V8VirtualValueList.html @@ -0,0 +1,410 @@ + + + + + +V8VirtualValueList (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + +
+
com.caoccao.javet.values.virtual
+

Class V8VirtualValueList

+
+
+
    +
  • java.lang.Object
    • +
  • +
      +
    • com.caoccao.javet.values.virtual.V8VirtualValueList
      • +
    +
    • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    IJavetClosable, java.lang.AutoCloseable
    +
    +
    +
    +
    public class V8VirtualValueList
+extends java.lang.Object
+implements IJavetClosable
    +
    The type V8 virtual value list.
    +
    +
    Since:
    +
    0.8.5
    +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Summary

      + + + + + + + + + + + + + + +
      Fields 
      Modifier and TypeField and Description
      protected java.util.List<V8Value>toBeClosedValues +
      The To be closed values.
      +
      protected java.util.List<V8Value>values +
      The Values.
      +
      +
      • +
    + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + +
      Constructors 
      Constructor and Description
      V8VirtualValueList(V8Runtime v8Runtime, + java.lang.Object... objects) +
      Instantiates a new V8 virtual value list.
      +
      +
      • +
    + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + +
      All Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      voidclose() 
      V8Value[]get() +
      Get V8 value array.
      +
      booleanisClosed() +
      Is closed.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Detail

      + + + +
        +
      • +

        toBeClosedValues

        +
        protected java.util.List<V8Value> toBeClosedValues
        +
        The To be closed values.
        +
        +
        Since:
        +
        0.8.5
        +
        +
        • +
      + + + +
        +
      • +

        values

        +
        protected java.util.List<V8Value> values
        +
        The Values.
        +
        +
        Since:
        +
        0.8.5
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        V8VirtualValueList

        +
        public V8VirtualValueList(V8Runtime v8Runtime,
+                          java.lang.Object... objects)
+                   throws JavetException
        +
        Instantiates a new V8 virtual value list.
        +
        +
        Parameters:
        +
        v8Runtime - the V8 runtime
        +
        objects - the objects
        +
        Throws:
        +
        JavetException - the javet exception
        +
        Since:
        +
        0.8.5
        +
        +
        • +
      +
      • +
    + +
      +
    • + + +

      Method Detail

      + + + + + + + +
        +
      • +

        get

        +
        public V8Value[] get()
        +
        Get V8 value array.
        +
        +
        Returns:
        +
        the V8 value array
        +
        Since:
        +
        0.8.5
        +
        +
        • +
      + + + +
        +
      • +

        isClosed

        +
        public boolean isClosed()
        +
        Description copied from interface: IJavetClosable
        +
        Is closed.
        +
        +
        Specified by:
        +
        isClosed in interface IJavetClosable
        +
        Returns:
        +
        the boolean
        +
        +
        • +
      +
      • +
    +
    • +
+
+
+ + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+
+ + +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/virtual/package-frame.html b/docs/reference/javadoc/com/caoccao/javet/values/virtual/package-frame.html new file mode 100644 index 000000000..5017a5fbf --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/virtual/package-frame.html @@ -0,0 +1,20 @@ + + + + + +com.caoccao.javet.values.virtual (javet 0.9.12 API) + + + + +

com.caoccao.javet.values.virtual

+
+

Classes

+ +
+ + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/virtual/package-summary.html b/docs/reference/javadoc/com/caoccao/javet/values/virtual/package-summary.html new file mode 100644 index 000000000..8d1308603 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/virtual/package-summary.html @@ -0,0 +1,160 @@ + + + + + +com.caoccao.javet.values.virtual (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Package com.caoccao.javet.values.virtual

+
+
Classes for V8 virtual reference values.
+
+

See: Description

+
+
+
    +
  • + + + + + + + + + + + + + + + + +
    Class Summary 
    ClassDescription
    V8VirtualValue +
    The type V8 virtual value.
    +
    V8VirtualValueList +
    The type V8 virtual value list.
    +
    +
    • +
+ + + +

Package com.caoccao.javet.values.virtual Description

+
Classes for V8 virtual reference values.
+
+
Since:
+
0.7.0
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/com/caoccao/javet/values/virtual/package-tree.html b/docs/reference/javadoc/com/caoccao/javet/values/virtual/package-tree.html new file mode 100644 index 000000000..a1f51bec7 --- /dev/null +++ b/docs/reference/javadoc/com/caoccao/javet/values/virtual/package-tree.html @@ -0,0 +1,135 @@ + + + + + +com.caoccao.javet.values.virtual Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ +
+

Hierarchy For Package com.caoccao.javet.values.virtual

+Package Hierarchies: + +
+
+

Class Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+ + + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/constant-values.html b/docs/reference/javadoc/constant-values.html new file mode 100644 index 000000000..d439294bd --- /dev/null +++ b/docs/reference/javadoc/constant-values.html @@ -0,0 +1,1850 @@ + + + + + +Constant Field Values (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+
    +
  • Prev
    • +
  • Next
    • +
+ + +
+ +
+ + +
+ +
+

Constant Field Values

+

Contents

+ +
+
+ + +

com.caoccao.*

+ + + + + + + + +
    +
  • + + + + + + + + + + + + + + +
    com.caoccao.javet.utils.SimpleFreeMarkerFormat 
    Modifier and TypeConstant FieldValue
    + +public static final java.lang.StringSTRING_NULL"<null>"
    +
    • +
  • + + + + + + + + + + + + + + +
    com.caoccao.javet.utils.V8ValueUtils 
    Modifier and TypeConstant FieldValue
    + +public static final java.lang.StringEMPTY""
    +
    • +
+
    +
  • + + + + + + + + + + + + + + +
    com.caoccao.javet.utils.receivers.JavetCallbackReceiver 
    Modifier and TypeConstant FieldValue
    + +protected static final java.lang.StringCOMMA","
    +
    • +
+
    +
  • + + + + + + + + + + + + + + +
    com.caoccao.javet.values.primitive.V8ValueNull 
    Modifier and TypeConstant FieldValue
    + +public static final java.lang.StringNULL"null"
    +
    • +
  • + + + + + + + + + + + + + + +
    com.caoccao.javet.values.primitive.V8ValueUndefined 
    Modifier and TypeConstant FieldValue
    + +public static final java.lang.StringUNDEFINED"undefined"
    +
    • +
+ + +
+ +
+ + +
Skip navigation links
+ + + + +
+
+
    +
  • Prev
    • +
  • Next
    • +
+ + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/deprecated-list.html b/docs/reference/javadoc/deprecated-list.html new file mode 100644 index 000000000..ddbab7f97 --- /dev/null +++ b/docs/reference/javadoc/deprecated-list.html @@ -0,0 +1,121 @@ + + + + + +Deprecated List (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+
    +
  • Prev
    • +
  • Next
    • +
+ + +
+ +
+ + +
+ +
+

Deprecated API

+

Contents

+
+ +
+ + +
Skip navigation links
+ + + + +
+
+
    +
  • Prev
    • +
  • Next
    • +
+ + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/help-doc.html b/docs/reference/javadoc/help-doc.html new file mode 100644 index 000000000..753620d67 --- /dev/null +++ b/docs/reference/javadoc/help-doc.html @@ -0,0 +1,222 @@ + + + + + +API Help (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+
    +
  • Prev
    • +
  • Next
    • +
+ + +
+ +
+ + +
+ +
+

How This API Document Is Organized

+
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
+
+
+
    +
  • +

    Overview

    +

    The Overview page is the front page of this API document and provides a list of all packages with a summary for each. This page can also contain an overall description of the set of packages.

    +
    • +
  • +

    Package

    +

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    +
      +
    • Interfaces (italic)
      • +
    • Classes
      • +
    • Enums
      • +
    • Exceptions
      • +
    • Errors
      • +
    • Annotation Types
      • +
    +
    • +
  • +

    Class/Interface

    +

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    +
      +
    • Class inheritance diagram
      • +
    • Direct Subclasses
      • +
    • All Known Subinterfaces
      • +
    • All Known Implementing Classes
      • +
    • Class/interface declaration
      • +
    • Class/interface description
      • +
    +
      +
    • Nested Class Summary
      • +
    • Field Summary
      • +
    • Constructor Summary
      • +
    • Method Summary
      • +
    +
      +
    • Field Detail
      • +
    • Constructor Detail
      • +
    • Method Detail
      • +
    +

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    +
    • +
  • +

    Annotation Type

    +

    Each annotation type has its own separate page with the following sections:

    +
      +
    • Annotation Type declaration
      • +
    • Annotation Type description
      • +
    • Required Element Summary
      • +
    • Optional Element Summary
      • +
    • Element Detail
      • +
    +
    • +
  • +

    Enum

    +

    Each enum has its own separate page with the following sections:

    +
      +
    • Enum declaration
      • +
    • Enum description
      • +
    • Enum Constant Summary
      • +
    • Enum Constant Detail
      • +
    +
    • +
  • +

    Tree (Class Hierarchy)

    +

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    +
      +
    • When viewing the Overview page, clicking on "Tree" displays the hierarchy for all packages.
      • +
    • When viewing a particular package, class or interface page, clicking "Tree" displays the hierarchy for only that package.
      • +
    +
    • +
  • +

    Deprecated API

    +

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    +
    • +
  • +

    Index

    +

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    +
    • +
  • +

    Prev/Next

    +

    These links take you to the next or previous class, interface, package, or related page.

    +
    • +
  • +

    Frames/No Frames

    +

    These links show and hide the HTML frames. All pages are available with or without frames.

    +
    • +
  • +

    All Classes

    +

    The All Classes link shows all classes and interfaces except non-static nested types.

    +
    • +
  • +

    Serialized Form

    +

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking "Serialized Form" in the "See also" section of the class description.

    +
    • +
  • +

    Constant Field Values

    +

    The Constant Field Values page lists the static final fields and their values.

    +
    • +
+This help file applies to API documentation generated using the standard doclet.
+ +
+ + +
Skip navigation links
+ + + + +
+
+
    +
  • Prev
    • +
  • Next
    • +
+ + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/index-all.html b/docs/reference/javadoc/index-all.html new file mode 100644 index 000000000..ad2728f24 --- /dev/null +++ b/docs/reference/javadoc/index-all.html @@ -0,0 +1,5428 @@ + + + + + +Index (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+
    +
  • Prev
    • +
  • Next
    • +
+ + +
+ +
+ + +
+ +
A B C D E F G H I J K L M N O P Q R S T U V W Z _  + + +

A

+
+
accept(T1, T2) - Method in interface com.caoccao.javet.interfaces.IJavetBiConsumer
+
+
Accept.
+
+
accept(int, T1, T2) - Method in interface com.caoccao.javet.interfaces.IJavetBiIndexedConsumer
+
+
Accept.
+
+
accept(T) - Method in interface com.caoccao.javet.interfaces.IJavetUniConsumer
+
+
Accept.
+
+
accept(int, T) - Method in interface com.caoccao.javet.interfaces.IJavetUniIndexedConsumer
+
+
Accept.
+
+
active - Variable in class com.caoccao.javet.interop.engine.JavetEngine
+
 
+
active - Variable in class com.caoccao.javet.interop.engine.JavetEnginePool
+
+
The Active.
+
+
activeEngineList - Variable in class com.caoccao.javet.interop.engine.JavetEnginePool
+
+
The Active engine list.
+
+
add(long, long, int, Object) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
add(IV8ValueSet, V8Value) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
add(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueSet
+
 
+
add(Object) - Method in class com.caoccao.javet.values.reference.V8ValueSet
+
 
+
add(IV8ValueObject) - Method in class com.caoccao.javet.values.reference.V8ValueWeakSet
+
 
+
addListeners(IV8InspectorListener...) - Method in class com.caoccao.javet.interop.V8Inspector
+
 
+
addMethod(Method, int, Map<String, List<Method>>) - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
Add method.
+
+
addNull() - Method in interface com.caoccao.javet.values.reference.IV8ValueSet
+
 
+
addReference(IV8ValueReference) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
addReference() - Method in class com.caoccao.javet.values.reference.V8ValueGlobalObject
+
 
+
addReference() - Method in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
addUndefined() - Method in interface com.caoccao.javet.values.reference.IV8ValueSet
+
 
+
addV8Module(IV8Module) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
all(V8Value) - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
allowCodeGenerationFromStrings(long, boolean) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
allowEval(boolean) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
allSettled(V8Value) - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
allSettledVoid(V8Value) - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
allVoid(V8Value) - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
any(V8Value) - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
anyVoid(V8Value) - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
apply(V8Value, V8Value, V8ValueArray) - Method in interface com.caoccao.javet.interop.proxy.IJavetProxyHandler
+
+
Apply to object
+
+
assign(V8ValueObject, V8ValueObject) - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInObject
+
+
Assign V8 value object.
+
+
await(long) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
await() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
+ + + +

B

+
+
BaseJavetConsoleInterceptor - Class in com.caoccao.javet.interception.logging
+
+
The type Base javet console interceptor.
+
+
BaseJavetConsoleInterceptor(V8Runtime) - Constructor for class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
Instantiates a new Base javet console interceptor.
+
+
BaseJavetInterceptor - Class in com.caoccao.javet.interception
+
 
+
BaseJavetInterceptor(V8Runtime) - Constructor for class com.caoccao.javet.interception.BaseJavetInterceptor
+
 
+
BaseJavetProxyHandler<T> - Class in com.caoccao.javet.interop.proxy
+
+
The type Base javet proxy handler.
+
+
BaseJavetProxyHandler(V8Runtime, T) - Constructor for class com.caoccao.javet.interop.proxy.BaseJavetProxyHandler
+
+
Instantiates a new Base javet proxy handler.
+
+
BaseJavetScriptingException - Exception in com.caoccao.javet.exceptions
+
 
+
BaseJavetScriptingException(JavetError, String, String, String, int, int, int, int, int) - Constructor for exception com.caoccao.javet.exceptions.BaseJavetScriptingException
+
 
+
BaseNodeModule - Class in com.caoccao.javet.node.modules
+
 
+
BaseNodeModule(V8ValueObject, String) - Constructor for class com.caoccao.javet.node.modules.BaseNodeModule
+
 
+
BaseV8Executor - Class in com.caoccao.javet.interop.executors
+
 
+
BaseV8Executor(V8Runtime) - Constructor for class com.caoccao.javet.interop.executors.BaseV8Executor
+
 
+
bind(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Bind both functions via @V8Function and properties via @V8Property.
+
+
bind(Object) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
bindFunction(String, JavetCallbackContext) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Binds function by name and callback context.
+
+
bindFunction(String, String) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Binds function by name and string.
+
+
bindFunction(String, JavetCallbackContext) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
BindingContext - Class in com.caoccao.javet.interop.binding
+
+
The type Binding context.
+
+
BindingContext() - Constructor for class com.caoccao.javet.interop.binding.BindingContext
+
+
Instantiates a new Binding context.
+
+
bindingContextWeakHashMap - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
bindProperty(String, JavetCallbackContext) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Bind property.
+
+
bindProperty(String, JavetCallbackContext, JavetCallbackContext) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Bind property.
+
+
bindProperty(V8ValueString, JavetCallbackContext) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Bind property.
+
+
bindProperty(V8ValueSymbol, JavetCallbackContext) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Bind property.
+
+
bindProperty(V8ValueString, JavetCallbackContext, JavetCallbackContext) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Bind property.
+
+
bindProperty(V8ValueSymbol, JavetCallbackContext, JavetCallbackContext) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Bind property.
+
+
bindProperty(V8ValueString, JavetCallbackContext, JavetCallbackContext) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
bindProperty(V8ValueSymbol, JavetCallbackContext, JavetCallbackContext) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
builtInSymbolMap - Variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
BYTE_LENGTH_1 - Static variable in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
BYTE_LENGTH_2 - Static variable in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
BYTE_LENGTH_3 - Static variable in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
byteBuffer - Variable in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
byteOrder - Variable in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
+ + + +

C

+
+
cachedV8ValueBooleans - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
cachedV8ValueIntegers - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
cachedV8ValueLongs - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
cachedV8ValueNull - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
cachedV8ValueUndefined - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
calculateScore() - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler.ScoredExecutable
+
+
Calculate score double.
+
+
call(long, long, int, Object, boolean, Object[]) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
call(IV8ValueObject, IV8ValueObject, boolean, V8Value...) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
call(IV8ValueObject, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Call function by objects and return V8 value.
+
+
call(IV8ValueObject, V8Value...) - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Call function by V8 values and return V8 value.
+
+
callAsConstructor(long, long, int, Object[]) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
callAsConstructor(IV8ValueObject, V8Value...) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
callAsConstructor(Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Call function as constructor by objects.
+
+
callAsConstructor(V8Value...) - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Call function as constructor by V8 values.
+
+
callAsConstructor(Object...) - Method in class com.caoccao.javet.values.reference.V8ValueFunction
+
 
+
callAsConstructor(V8Value...) - Method in class com.caoccao.javet.values.reference.V8ValueFunction
+
 
+
callback(JavetPromiseRejectEvent, V8ValuePromise, V8Value) - Method in interface com.caoccao.javet.interfaces.IJavetPromiseRejectCallback
+
+
Callback.
+
+
callback(JavetPromiseRejectEvent, V8ValuePromise, V8Value) - Method in class com.caoccao.javet.utils.JavetPromiseRejectCallback
+
 
+
callbackContextLock - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
callbackContextMap - Variable in class com.caoccao.javet.interop.V8Runtime
+
+
The Callback context map.
+
+
CallbackInjectionFailure - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
CallbackMethodFailure - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
CallbackRegistrationFailure - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
CallbackSignatureParameterSizeMismatch - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
CallbackSignatureParameterTypeMismatch - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
CallbackUnknownFailure - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
CallbackUnregistrationFailure - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
callBoolean(IV8ValueObject, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Call function by objects and return boolean.
+
+
callDouble(IV8ValueObject, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Call function by objects and return double.
+
+
callExtended(IV8ValueObject, boolean, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Call function by objects and return V8 value.
+
+
callExtended(IV8ValueObject, boolean, V8Value...) - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Call function by V8 values and return V8 value.
+
+
callExtended(IV8ValueObject, boolean, Object...) - Method in class com.caoccao.javet.values.reference.V8ValueFunction
+
 
+
callExtended(IV8ValueObject, boolean, V8Value...) - Method in class com.caoccao.javet.values.reference.V8ValueFunction
+
 
+
callFloat(IV8ValueObject, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Call function by objects and return float.
+
+
callInteger(IV8ValueObject, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Call function by objects and return integer.
+
+
callLong(IV8ValueObject, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Call function by objects and return long.
+
+
callObject(IV8ValueObject, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Call function by objects and return object.
+
+
callPrimitive(IV8ValueObject, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Call function by objects and return primitive object.
+
+
callString(IV8ValueObject, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Call function by objects and return string.
+
+
callVoid(IV8ValueObject, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Call function by objects without return.
+
+
callVoid(IV8ValueObject, V8Value...) - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Call function by V8 values without return.
+
+
cancel() - Method in interface com.caoccao.javet.interop.engine.IJavetEngineGuard
+
+
Cancel.
+
+
cancel() - Method in class com.caoccao.javet.interop.engine.JavetEngineGuard
+
 
+
CheckReturnValue - Annotation Type in com.caoccao.javet.annotations
+
+
This annotation is for IDE to warn application developers to consume the return value.
+
+
checkV8Runtime() - Method in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
checkV8Runtime() - Method in class com.caoccao.javet.values.V8Value
+
 
+
circularStructure(int) - Static method in exception com.caoccao.javet.exceptions.JavetConverterException
+
+
Circular structure.
+
+
classMode - Variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The Class mode.
+
+
clearInternalStatistic() - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
clearInternalStatistic() - Method in class com.caoccao.javet.interop.V8Host
+
+
Clear internal statistic for internal test purpose.
+
+
clearWeak(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
clearWeak(IV8ValueReference) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
clearWeak() - Method in interface com.caoccao.javet.values.reference.IV8ValueReference
+
 
+
clearWeak() - Method in class com.caoccao.javet.values.reference.V8ValueGlobalObject
+
 
+
clearWeak() - Method in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
clone() - Method in class com.caoccao.javet.entities.JavetEntityMap
+
 
+
cloneV8Value(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
cloneV8Value(IV8ValueReference) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
close() - Method in interface com.caoccao.javet.interfaces.IJavetClosable
+
 
+
close() - Method in class com.caoccao.javet.interop.engine.JavetEngine
+
 
+
close(boolean) - Method in class com.caoccao.javet.interop.engine.JavetEngine
+
 
+
close() - Method in class com.caoccao.javet.interop.engine.JavetEngineGuard
+
 
+
close() - Method in class com.caoccao.javet.interop.engine.JavetEnginePool
+
 
+
close() - Method in class com.caoccao.javet.interop.proxy.DynamicProxyV8ValueFunctionInvocationHandler
+
 
+
close() - Method in class com.caoccao.javet.interop.proxy.DynamicProxyV8ValueObjectInvocationHandler
+
 
+
close() - Method in class com.caoccao.javet.interop.V8Host
+
 
+
close() - Method in class com.caoccao.javet.interop.V8Locker
+
 
+
close() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
close(boolean) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
close() - Method in class com.caoccao.javet.node.modules.BaseNodeModule
+
 
+
close() - Method in class com.caoccao.javet.values.primitive.V8ValueNull
+
 
+
close() - Method in class com.caoccao.javet.values.primitive.V8ValuePrimitive
+
 
+
close() - Method in class com.caoccao.javet.values.primitive.V8ValueUndefined
+
 
+
close(boolean) - Method in interface com.caoccao.javet.values.reference.IV8ValueReference
+
 
+
close(boolean) - Method in class com.caoccao.javet.values.reference.V8ValueGlobalObject
+
 
+
close() - Method in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
close(boolean) - Method in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
close() - Method in class com.caoccao.javet.values.V8Value
+
 
+
close() - Method in class com.caoccao.javet.values.virtual.V8VirtualValue
+
 
+
close() - Method in class com.caoccao.javet.values.virtual.V8VirtualValueList
+
 
+
closed - Variable in class com.caoccao.javet.interop.engine.JavetEngineGuard
+
+
The Closed.
+
+
closeV8Runtime(long) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
closeV8Runtime(V8Runtime) - Method in class com.caoccao.javet.interop.V8Host
+
+
Close V8 runtime.
+
+
code - Variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
com.caoccao.javet.annotations - package com.caoccao.javet.annotations
+
+
Annotations classes for declarative coding and IDE intellisense.
+
+
com.caoccao.javet.entities - package com.caoccao.javet.entities
+
+
Built-in entities for default object conversion.
+
+
com.caoccao.javet.enums - package com.caoccao.javet.enums
+
+
Enums for various API.
+
+
com.caoccao.javet.exceptions - package com.caoccao.javet.exceptions
+
+
Exceptions and errors for error handling.
+
+
com.caoccao.javet.interception - package com.caoccao.javet.interception
+
+
Built-in interceptors.
+
+
com.caoccao.javet.interception.logging - package com.caoccao.javet.interception.logging
+
+
Built-in interceptors for JS logging function console.log(), etc...
+
+
com.caoccao.javet.interfaces - package com.caoccao.javet.interfaces
+
+
Interfaces required by various internal and external API.
+
+
com.caoccao.javet.interop - package com.caoccao.javet.interop
+
+
Interoperation between JVM and C++ via JNI.
+
+
com.caoccao.javet.interop.binding - package com.caoccao.javet.interop.binding
+
+
Callback data structure for binding context and method descriptor.
+
+
com.caoccao.javet.interop.callback - package com.caoccao.javet.interop.callback
+
+
Callback bridge between JVM and C++ via JNI.
+
+
com.caoccao.javet.interop.converters - package com.caoccao.javet.interop.converters
+
+
Built-in converters, interface and config.
+
+
com.caoccao.javet.interop.engine - package com.caoccao.javet.interop.engine
+
+
Engine pool, config and guard.
+
+
com.caoccao.javet.interop.executors - package com.caoccao.javet.interop.executors
+
+
Executors and interface.
+
+
com.caoccao.javet.interop.proxy - package com.caoccao.javet.interop.proxy
+
+
Dynamic proxy handlers for polyfilling Java interfaces with JS functions or objects.
+
+
com.caoccao.javet.node.modules - package com.caoccao.javet.node.modules
+
+
Reference classes for Node.js built-in modules.
+
+
com.caoccao.javet.utils - package com.caoccao.javet.utils
+
+
Built-in utilities.
+
+
com.caoccao.javet.utils.receivers - package com.caoccao.javet.utils.receivers
+
+
Built-in callback receivers.
+
+
com.caoccao.javet.values - package com.caoccao.javet.values
+
+
Classes for V8 values.
+
+
com.caoccao.javet.values.primitive - package com.caoccao.javet.values.primitive
+
+
Classes for V8 primitive values.
+
+
com.caoccao.javet.values.reference - package com.caoccao.javet.values.reference
+
+
Classes for V8 reference values.
+
+
com.caoccao.javet.values.reference.builtin - package com.caoccao.javet.values.reference.builtin
+
+
Classes for V8 built-in reference values.
+
+
com.caoccao.javet.values.virtual - package com.caoccao.javet.values.virtual
+
+
Classes for V8 virtual reference values.
+
+
COMMA - Static variable in class com.caoccao.javet.utils.receivers.JavetCallbackReceiver
+
 
+
CompilationFailure - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
compile(long, String, boolean, String, int, int, int, boolean, boolean) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
compileScript(boolean) - Method in class com.caoccao.javet.interop.executors.BaseV8Executor
+
 
+
compileScript() - Method in interface com.caoccao.javet.interop.executors.IV8Executor
+
 
+
compileScript(boolean) - Method in interface com.caoccao.javet.interop.executors.IV8Executor
+
 
+
compileScript(boolean) - Method in class com.caoccao.javet.interop.executors.V8StringExecutor
+
 
+
compileScript(String, V8ScriptOrigin, boolean) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
compileScriptVoid() - Method in interface com.caoccao.javet.interop.executors.IV8Executor
+
 
+
compileV8Module(boolean) - Method in class com.caoccao.javet.interop.executors.BaseV8Executor
+
 
+
compileV8Module() - Method in interface com.caoccao.javet.interop.executors.IV8Executor
+
 
+
compileV8Module(boolean) - Method in interface com.caoccao.javet.interop.executors.IV8Executor
+
 
+
compileV8Module(boolean) - Method in class com.caoccao.javet.interop.executors.V8StringExecutor
+
 
+
compileV8Module(String, V8ScriptOrigin, boolean) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
compileV8ModuleVoid() - Method in interface com.caoccao.javet.interop.executors.IV8Executor
+
 
+
concat(V8Value...) - Method in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
Concat string.
+
+
concat(String, V8Value...) - Static method in class com.caoccao.javet.utils.V8ValueUtils
+
+
Concat string.
+
+
config - Variable in class com.caoccao.javet.interop.converters.JavetPrimitiveConverter
+
+
The Config.
+
+
config - Variable in class com.caoccao.javet.interop.engine.JavetEnginePool
+
+
The Config.
+
+
consoleDebug(V8Value...) - Method in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
Console debug.
+
+
consoleDebug(V8Value...) - Method in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
 
+
consoleError(V8Value...) - Method in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
Console error.
+
+
consoleError(V8Value...) - Method in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
 
+
consoleInfo(V8Value...) - Method in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
Console info.
+
+
consoleInfo(V8Value...) - Method in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
 
+
consoleLog(V8Value...) - Method in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
Console log.
+
+
consoleLog(V8Value...) - Method in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
 
+
consoleTrace(V8Value...) - Method in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
Console trace.
+
+
consoleTrace(V8Value...) - Method in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
 
+
consoleWarn(V8Value...) - Method in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
Console warn.
+
+
consoleWarn(V8Value...) - Method in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
 
+
construct(V8Value, V8ValueArray, V8Value) - Method in interface com.caoccao.javet.interop.proxy.IJavetProxyHandler
+
+
Construct.
+
+
construct(V8Value, V8ValueArray, V8Value) - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
 
+
constructors - Variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The Constructors.
+
+
containsV8Module(String) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
continuable - Variable in exception com.caoccao.javet.exceptions.JavetTerminatedException
+
 
+
converted - Variable in class com.caoccao.javet.utils.JavetVirtualObject
+
+
The Converted.
+
+
converted - Variable in class com.caoccao.javet.values.virtual.V8VirtualValue
+
+
It indicates whether the value is converted or not.
+
+
converter - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
ConverterCircularStructure - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
ConverterFailure - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
ConverterSymbolNotBuiltIn - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
convertToVirtualObjects(V8Value...) - Static method in class com.caoccao.javet.utils.V8ValueUtils
+
+
Convert to virtual objects.
+
+
createEngine() - Method in class com.caoccao.javet.interop.engine.JavetEnginePool
+
+
Create engine javet engine.
+
+
createEntityFunction() - Method in class com.caoccao.javet.interop.converters.JavetObjectConverter
+
+
Create entity function javet entity function.
+
+
createEntityMap() - Method in class com.caoccao.javet.interop.converters.JavetObjectConverter
+
+
Create entity map map.
+
+
createV8Inspector(long, Object) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
createV8Runtime(String) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
createV8Runtime() - Method in class com.caoccao.javet.interop.V8Host
+
+
Create V8 runtime.
+
+
createV8Runtime(String) - Method in class com.caoccao.javet.interop.V8Host
+
+
Create V8 runtime.
+
+
createV8Runtime(boolean, String) - Method in class com.caoccao.javet.interop.V8Host
+
+
Create V8 runtime.
+
+
createV8Value(long, int, Object) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
createV8ValueArray() - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueArray() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValueArrayBuffer(int) - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueArrayBuffer(int) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValueBoolean(boolean) - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueBoolean(boolean) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValueDataView(V8ValueArrayBuffer) - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueDataView(V8ValueArrayBuffer) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValueDouble(double) - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueDouble(double) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValueFunction(JavetCallbackContext) - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueFunction(String) - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueFunction(JavetCallbackContext) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValueFunction(String) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValueInteger(int) - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueInteger(int) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValueLong(long) - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueLong(long) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValueMap() - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueMap() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValueNull() - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueNull() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValueObject() - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueObject() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValuePromise() - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValuePromise() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValueProxy() - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueProxy(V8ValueObject) - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueProxy(V8ValueObject) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValueSet() - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueSet() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValueString(String) - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueString(String) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValueSymbol(String) - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueSymbol(String, boolean) - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueSymbol(String, boolean) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValueTypedArray(V8ValueReferenceType, int) - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueTypedArray(V8ValueReferenceType, int) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValueUndefined() - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueUndefined() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValueZonedDateTime(long) - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueZonedDateTime(ZonedDateTime) - Method in interface com.caoccao.javet.interop.IV8Creatable
+
 
+
createV8ValueZonedDateTime(long) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
createV8ValueZonedDateTime(ZonedDateTime) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
customObjectLock - Variable in class com.caoccao.javet.interop.converters.JavetObjectConverter
+
+
The Custom object lock.
+
+
customObjectMap - Variable in class com.caoccao.javet.interop.converters.JavetObjectConverter
+
+
The Custom object map.
+
+
+ + + +

D

+
+
daemonThread - Variable in class com.caoccao.javet.interop.engine.JavetEnginePool
+
+
The Daemon thread.
+
+
debug - Variable in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
+
The Debug.
+
+
debug(String) - Method in interface com.caoccao.javet.interfaces.IJavetLogger
+
+
Debug.
+
+
debug(String) - Method in class com.caoccao.javet.utils.JavetDefaultLogger
+
 
+
decorateV8Value(T) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
decorateV8Values(T...) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
DEFAULT_CONVERTER - Static variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
DEFAULT_ENGINE_GUARD_CHECK_INTERVAL_MILLIS - Static variable in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
DEFAULT_ENGINE_GUARD_TIMEOUT_MILLIS - Static variable in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
DEFAULT_GLOBAL_NAME - Static variable in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
DEFAULT_JAVET_LOGGER - Static variable in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
DEFAULT_JS_RUNTIME_TYPE - Static variable in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
DEFAULT_MAX_DEPTH - Static variable in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
The constant DEFAULT_MAX_DEPTH.
+
+
DEFAULT_MESSAGE_FORMAT_JAVET_INSPECTOR - Static variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
DEFAULT_POOL_DAEMON_CHECK_INTERVAL_MILLIS - Static variable in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
DEFAULT_POOL_IDLE_TIMEOUT_SECONDS - Static variable in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
DEFAULT_POOL_MIN_SIZE - Static variable in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
DEFAULT_POOL_SHUTDOWN_TIMEOUT_SECONDS - Static variable in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
DEFAULT_RESET_ENGINE_TIMEOUT_SECONDS - Static variable in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
defaultBoolean - Variable in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
The Default boolean.
+
+
defaultByte - Variable in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
The Default byte.
+
+
defaultChar - Variable in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
The Default char.
+
+
defaultDouble - Variable in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
The Default double.
+
+
defaultFloat - Variable in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
The Default float.
+
+
defaultInt - Variable in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
The Default int.
+
+
defaultLong - Variable in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
The Default long.
+
+
defaultShort - Variable in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
The Default short.
+
+
delete(long, long, int, Object) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
delete(IV8ValueObject, V8Value) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
delete(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Delete boolean.
+
+
delete(Object) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
delete(Object) - Method in class com.caoccao.javet.values.reference.V8ValueWeakMap
+
 
+
delete(Object) - Method in class com.caoccao.javet.values.reference.V8ValueWeakSet
+
 
+
deleteNull() - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Delete null boolean.
+
+
deletePrivateProperty(long, long, int, String) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
deletePrivateProperty(IV8ValueObject, String) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
deletePrivateProperty(String) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Delete private property boolean.
+
+
deletePrivateProperty(String) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
deleteUndefined() - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Delete undefined boolean.
+
+
description - Variable in class com.caoccao.javet.entities.JavetEntitySymbol
+
+
The Description.
+
+
disableGCNotification() - Method in class com.caoccao.javet.interop.V8Host
+
+
Disable GC notification.
+
+
disableInDebugMode() - Method in interface com.caoccao.javet.interop.engine.IJavetEngineGuard
+
+
Disable in debug mode.
+
+
disableInDebugMode() - Method in class com.caoccao.javet.interop.engine.JavetEngineGuard
+
 
+
DUMMY_FUNCTION_STRING - Static variable in class com.caoccao.javet.interop.converters.JavetProxyConverter
+
+
The constant DUMMY_FUNCTION_STRING.
+
+
DynamicProxyV8ValueFunctionInvocationHandler - Class in com.caoccao.javet.interop.proxy
+
+
The type Dynamic proxy V8 value function invocation handler.
+
+
DynamicProxyV8ValueFunctionInvocationHandler(V8ValueFunction) - Constructor for class com.caoccao.javet.interop.proxy.DynamicProxyV8ValueFunctionInvocationHandler
+
+
Instantiates a new Dynamic proxy V8 value function invocation handler.
+
+
DynamicProxyV8ValueObjectInvocationHandler - Class in com.caoccao.javet.interop.proxy
+
+
The type Dynamic proxy V8 value object invocation handler.
+
+
DynamicProxyV8ValueObjectInvocationHandler(V8ValueObject) - Constructor for class com.caoccao.javet.interop.proxy.DynamicProxyV8ValueObjectInvocationHandler
+
+
Instantiates a new Dynamic proxy V8 value object invocation handler.
+
+
+ + + +

E

+
+
echo(V8Value) - Method in class com.caoccao.javet.utils.receivers.JavetCallbackReceiver
+
+
Echo the given V8 value.
+
+
echo(V8Value...) - Method in class com.caoccao.javet.utils.receivers.JavetCallbackReceiver
+
+
Echo the given V8 value array.
+
+
echoString(String) - Method in class com.caoccao.javet.utils.receivers.JavetCallbackReceiver
+
+
Echo string from input string.
+
+
echoString(V8Value) - Method in class com.caoccao.javet.utils.receivers.JavetCallbackReceiver
+
+
Echo string from input V8 value.
+
+
echoString(V8Value...) - Method in class com.caoccao.javet.utils.receivers.JavetCallbackReceiver
+
+
Echo string from the given V8 value array.
+
+
EIGHT_BYTES_PER_VALUE - Static variable in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
The constant EIGHT_BYTES_PER_VALUE.
+
+
EMPTY - Static variable in class com.caoccao.javet.utils.V8ValueUtils
+
+
The constant EMPTY.
+
+
enableGCNotification() - Method in class com.caoccao.javet.interop.V8Host
+
+
Enable GC notification.
+
+
enableInDebugMode() - Method in interface com.caoccao.javet.interop.engine.IJavetEngineGuard
+
+
Enable in debug mode.
+
+
enableInDebugMode() - Method in class com.caoccao.javet.interop.engine.JavetEngineGuard
+
 
+
engineUsedCount - Variable in class com.caoccao.javet.interop.engine.JavetEngineUsage
+
 
+
equals(long, long, long) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
equals(IV8ValueReference, IV8ValueReference) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
equals(V8Value) - Method in interface com.caoccao.javet.values.IV8Value
+
+
Equals.
+
+
equals(V8Value) - Method in class com.caoccao.javet.values.primitive.V8ValueNull
+
 
+
equals(V8Value) - Method in class com.caoccao.javet.values.primitive.V8ValuePrimitive
+
 
+
equals(V8Value) - Method in class com.caoccao.javet.values.primitive.V8ValueUndefined
+
 
+
equals(V8Value) - Method in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
equals(V8Value) - Method in class com.caoccao.javet.values.V8Value
+
 
+
error - Variable in exception com.caoccao.javet.exceptions.JavetException
+
 
+
error - Variable in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
+
The Error.
+
+
error(String) - Method in interface com.caoccao.javet.interfaces.IJavetLogger
+
+
Error.
+
+
error(String, Throwable) - Method in interface com.caoccao.javet.interfaces.IJavetLogger
+
+
Error.
+
+
error(String) - Method in class com.caoccao.javet.utils.JavetDefaultLogger
+
 
+
error(String, Throwable) - Method in class com.caoccao.javet.utils.JavetDefaultLogger
+
 
+
Errored - Static variable in interface com.caoccao.javet.values.reference.IV8Module
+
 
+
evaluate() - Method in interface com.caoccao.javet.values.reference.IV8Module
+
 
+
evaluate(boolean) - Method in interface com.caoccao.javet.values.reference.IV8Module
+
 
+
evaluate(boolean) - Method in class com.caoccao.javet.values.reference.V8Module
+
 
+
Evaluated - Static variable in interface com.caoccao.javet.values.reference.IV8Module
+
 
+
Evaluating - Static variable in interface com.caoccao.javet.values.reference.IV8Module
+
 
+
EXECUTABLE_INDEX_DEFAULT_CONSTRUCTOR - Static variable in class com.caoccao.javet.interop.converters.JavetObjectConverter
+
+
The constant EXECUTABLE_INDEX_DEFAULT_CONSTRUCTOR.
+
+
EXECUTABLE_INDEX_FROM_MAP - Static variable in class com.caoccao.javet.interop.converters.JavetObjectConverter
+
+
The constant EXECUTABLE_INDEX_FROM_MAP.
+
+
EXECUTABLE_INDEX_TO_MAP - Static variable in class com.caoccao.javet.interop.converters.JavetObjectConverter
+
+
The constant EXECUTABLE_INDEX_TO_MAP.
+
+
execute(boolean) - Method in class com.caoccao.javet.interop.executors.BaseV8Executor
+
 
+
execute(boolean) - Method in class com.caoccao.javet.interop.executors.V8StringExecutor
+
 
+
execute() - Method in interface com.caoccao.javet.interop.IV8Executable
+
+
Execute t.
+
+
execute(boolean) - Method in interface com.caoccao.javet.interop.IV8Executable
+
+
Execute t.
+
+
execute(long, String, boolean, String, int, int, int, boolean, boolean) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
execute(V8Runtime, Object, List<E>, JavetVirtualObject[]) - Static method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
Execute.
+
+
execute() - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler.ScoredExecutable
+
+
Execute.
+
+
execute(String, V8ScriptOrigin, boolean) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
execute(boolean) - Method in interface com.caoccao.javet.values.reference.IV8Module
+
 
+
execute(boolean) - Method in class com.caoccao.javet.values.reference.V8Script
+
 
+
executeBoolean() - Method in interface com.caoccao.javet.interop.IV8Executable
+
+
Execute boolean boolean.
+
+
executeDouble() - Method in interface com.caoccao.javet.interop.IV8Executable
+
+
Execute double double.
+
+
executeInteger() - Method in interface com.caoccao.javet.interop.IV8Executable
+
+
Execute integer integer.
+
+
executeLong() - Method in interface com.caoccao.javet.interop.IV8Executable
+
+
Execute long long.
+
+
executeObject() - Method in interface com.caoccao.javet.interop.IV8Executable
+
+
Execute object t.
+
+
executePrimitive() - Method in interface com.caoccao.javet.interop.IV8Executable
+
+
Execute primitive r.
+
+
executeString() - Method in interface com.caoccao.javet.interop.IV8Executable
+
+
Execute string string.
+
+
executeVoid() - Method in interface com.caoccao.javet.interop.IV8Executable
+
+
Execute void.
+
+
executeZonedDateTime() - Method in interface com.caoccao.javet.interop.IV8Executable
+
+
Execute zoned date time zoned date time.
+
+
ExecutionFailure - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
ExecutionTerminated - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
externalLock - Variable in class com.caoccao.javet.interop.engine.JavetEnginePool
+
+
The External lock.
+
+
extractFunctionSourceCode - Variable in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
The Extract function source code.
+
+
+ + + +

F

+
+
FailedToReadPath - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
fieldMap - Variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The Field map.
+
+
flushProtocolNotifications() - Method in interface com.caoccao.javet.interop.IV8InspectorListener
+
 
+
flushProtocolNotifications() - Method in class com.caoccao.javet.interop.V8Inspector
+
 
+
forEach(IJavetUniConsumer<Key, E>) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
For each.
+
+
forEach(IJavetUniIndexedConsumer<Key, E>) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
For each.
+
+
forEach(IJavetBiConsumer<Key, Value, E>) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
For each.
+
+
forEach(IJavetBiIndexedConsumer<Key, Value, E>) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
For each.
+
+
forEach(IJavetUniConsumer<Value, E>) - Method in class com.caoccao.javet.values.reference.V8ValueArray
+
 
+
forEach(IJavetUniIndexedConsumer<Value, E>) - Method in class com.caoccao.javet.values.reference.V8ValueArray
+
 
+
forEach(IJavetUniConsumer<Key, E>) - Method in class com.caoccao.javet.values.reference.V8ValueMap
+
 
+
forEach(IJavetUniIndexedConsumer<Key, E>) - Method in class com.caoccao.javet.values.reference.V8ValueMap
+
 
+
forEach(IJavetBiConsumer<Key, Value, E>) - Method in class com.caoccao.javet.values.reference.V8ValueMap
+
 
+
forEach(IJavetBiIndexedConsumer<Key, Value, E>) - Method in class com.caoccao.javet.values.reference.V8ValueMap
+
 
+
forEach(IJavetUniConsumer<Key, E>) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
forEach(IJavetUniIndexedConsumer<Key, E>) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
forEach(IJavetBiConsumer<Key, Value, E>) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
forEach(IJavetBiIndexedConsumer<Key, Value, E>) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
forEach(IJavetUniConsumer<Key, E>) - Method in class com.caoccao.javet.values.reference.V8ValueSet
+
 
+
forEach(IJavetUniIndexedConsumer<Key, E>) - Method in class com.caoccao.javet.values.reference.V8ValueSet
+
 
+
format - Variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
format(String, Map<String, Object>) - Static method in class com.caoccao.javet.utils.SimpleFreeMarkerFormat
+
 
+
FOUR_BYTES_PER_VALUE - Static variable in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
The constant FOUR_BYTES_PER_VALUE.
+
+
fromBytes(byte[]) - Method in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
fromBytes(byte[]) - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
From byte array.
+
+
fromDoubles(double[]) - Method in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
fromDoubles(double[]) - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
From double array.
+
+
fromFloats(float[]) - Method in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
fromFloats(float[]) - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
From float array.
+
+
fromIntegers(int[]) - Method in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
fromIntegers(int[]) - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
From integer array.
+
+
fromLongs(long[]) - Method in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
fromLongs(long[]) - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
From long array.
+
+
fromShorts(short[]) - Method in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
fromShorts(short[]) - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
From short array.
+
+
FUNCTION_ADD - Static variable in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
FUNCTION_ALL - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
FUNCTION_ALL_SETTLED - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
FUNCTION_ANY - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
FUNCTION_ASSIGN - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInObject
+
+
The constant FUNCTION_ASSIGN.
+
+
FUNCTION_CHDIR - Static variable in class com.caoccao.javet.node.modules.NodeModuleProcess
+
 
+
FUNCTION_CREATE_REQUIRE - Static variable in class com.caoccao.javet.node.modules.NodeModuleModule
+
 
+
FUNCTION_CWD - Static variable in class com.caoccao.javet.node.modules.NodeModuleProcess
+
 
+
FUNCTION_DELETE - Static variable in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
FUNCTION_ENTRIES - Static variable in class com.caoccao.javet.values.reference.V8ValueMap
+
 
+
FUNCTION_ENTRIES - Static variable in class com.caoccao.javet.values.reference.V8ValueSet
+
 
+
FUNCTION_FOR - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
FUNCTION_GET - Static variable in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
FUNCTION_GET_BIG_INT_64 - Static variable in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
FUNCTION_GET_FLOAT_32 - Static variable in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
FUNCTION_GET_FLOAT_64 - Static variable in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
FUNCTION_GET_INT_16 - Static variable in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
FUNCTION_GET_INT_32 - Static variable in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
FUNCTION_GET_INT_8 - Static variable in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
FUNCTION_GET_OWN_PROPERTY_SYMBOLS - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInObject
+
+
The constant FUNCTION_GET_OWN_PROPERTY_SYMBOLS.
+
+
FUNCTION_HAS - Static variable in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
FUNCTION_KEY_FOR - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
FUNCTION_KEYS - Static variable in class com.caoccao.javet.values.reference.V8ValueArray
+
 
+
FUNCTION_KEYS - Static variable in class com.caoccao.javet.values.reference.V8ValueMap
+
 
+
FUNCTION_KEYS - Static variable in class com.caoccao.javet.values.reference.V8ValueSet
+
 
+
FUNCTION_NEXT - Static variable in class com.caoccao.javet.values.reference.V8ValueArray
+
 
+
FUNCTION_NEXT - Static variable in class com.caoccao.javet.values.reference.V8ValueIterator
+
 
+
FUNCTION_ON - Static variable in class com.caoccao.javet.node.modules.NodeModuleProcess
+
 
+
FUNCTION_POP - Static variable in class com.caoccao.javet.values.reference.V8ValueArray
+
 
+
FUNCTION_PUSH - Static variable in class com.caoccao.javet.values.reference.V8ValueArray
+
 
+
FUNCTION_RACE - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
FUNCTION_REJECT - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
FUNCTION_REQUIRE - Static variable in class com.caoccao.javet.interop.NodeRuntime
+
 
+
FUNCTION_RESOLVE - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
FUNCTION_SET - Static variable in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
FUNCTION_SET_BIG_INT_64 - Static variable in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
FUNCTION_SET_FLOAT_32 - Static variable in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
FUNCTION_SET_FLOAT_64 - Static variable in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
FUNCTION_SET_INT_16 - Static variable in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
FUNCTION_SET_INT_32 - Static variable in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
FUNCTION_SET_INT_8 - Static variable in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
FUNCTION_STRINGIFY - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInJson
+
 
+
FUNCTION_TO_STRING - Static variable in class com.caoccao.javet.values.reference.V8ValueSymbol
+
+
The constant FUNCTION_TO_STRING.
+
+
FUNCTION_VALUE_OF - Static variable in class com.caoccao.javet.values.reference.V8ValueSymbolObject
+
+
The constant FUNCTION_VALUE_OF.
+
+
FUNCTION_VALUES - Static variable in class com.caoccao.javet.values.reference.V8ValueMap
+
 
+
functionMap - Variable in class com.caoccao.javet.interop.binding.BindingContext
+
+
The Function map.
+
+
future - Variable in class com.caoccao.javet.interop.engine.JavetEngineGuard
+
+
The Future.
+
+
+ + + +

G

+
+
gcScheduled - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
genericGetters - Variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The Generic getters.
+
+
genericSetters - Variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The Generic setters.
+
+
get() - Method in interface com.caoccao.javet.interfaces.IJavetSupplier
+
 
+
get(long, long, int, Object) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
get(V8Value, V8Value, V8Value) - Method in interface com.caoccao.javet.interop.proxy.IJavetProxyHandler
+
+
Get by property.
+
+
get(V8Value, V8Value, V8Value) - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
 
+
get(IV8ValueObject, V8Value) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
get(int) - Method in interface com.caoccao.javet.values.reference.IV8ValueArray
+
 
+
get(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Get t.
+
+
get(int) - Method in class com.caoccao.javet.values.reference.V8ValueArray
+
 
+
get(Object) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
get(String) - Method in class com.caoccao.javet.values.reference.V8ValueWeakMap
+
 
+
get(Object) - Method in class com.caoccao.javet.values.reference.V8ValueWeakMap
+
 
+
get() - Method in class com.caoccao.javet.values.virtual.V8VirtualValue
+
+
Get the value.
+
+
get() - Method in class com.caoccao.javet.values.virtual.V8VirtualValueList
+
+
Get V8 value array.
+
+
getActiveEngineCount() - Method in interface com.caoccao.javet.interop.engine.IJavetEnginePool
+
 
+
getActiveEngineCount() - Method in class com.caoccao.javet.interop.engine.JavetEnginePool
+
 
+
getAsyncIterator() - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
getBigInt64(int) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
getBigInt64(int, boolean) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
getBindingContext(Class<?>) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
getBindingContextWeakHashMap() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getBoolean(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets boolean.
+
+
getBuffer() - Method in interface com.caoccao.javet.values.reference.IV8ValueTypedArray
+
 
+
getBuffer() - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
getBuffer() - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
 
+
getBuiltInJson() - Method in class com.caoccao.javet.values.reference.V8ValueGlobalObject
+
 
+
getBuiltInObject() - Method in class com.caoccao.javet.values.reference.V8ValueGlobalObject
+
 
+
getBuiltInPromise() - Method in class com.caoccao.javet.values.reference.V8ValueGlobalObject
+
 
+
getBuiltInSymbol(String) - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
getBuiltInSymbol() - Method in class com.caoccao.javet.values.reference.V8ValueGlobalObject
+
 
+
getByteBuffer() - Method in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
getByteLength() - Method in interface com.caoccao.javet.values.reference.IV8ValueTypedArray
+
 
+
getByteLength() - Method in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
getByteLength() - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
getByteLength() - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
 
+
getByteOffset() - Method in interface com.caoccao.javet.values.reference.IV8ValueTypedArray
+
 
+
getByteOffset() - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
getByteOffset() - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
 
+
getByteOrder() - Method in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
getCallbackContext() - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler.JavetUniversalInterceptor
+
+
Gets callback context.
+
+
getCallbackContext(long) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getCallbackContextCount() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getCallbackMethod() - Method in class com.caoccao.javet.interop.callback.JavetCallbackContext
+
+
Gets callback method.
+
+
getCallbackReceiver() - Method in class com.caoccao.javet.interop.callback.JavetCallbackContext
+
+
Gets callback receiver.
+
+
getCode() - Method in enum com.caoccao.javet.enums.JavetPromiseRejectEvent
+
+
Gets event code.
+
+
getCode() - Method in class com.caoccao.javet.exceptions.JavetError
+
 
+
getConfig() - Method in interface com.caoccao.javet.interop.converters.IJavetConverter
+
+
Gets config.
+
+
getConfig() - Method in class com.caoccao.javet.interop.converters.JavetPrimitiveConverter
+
 
+
getConfig() - Method in interface com.caoccao.javet.interop.engine.IJavetEngine
+
 
+
getConfig() - Method in interface com.caoccao.javet.interop.engine.IJavetEnginePool
+
 
+
getConfig() - Method in class com.caoccao.javet.interop.engine.JavetEngine
+
 
+
getConfig() - Method in class com.caoccao.javet.interop.engine.JavetEnginePool
+
 
+
getConverter() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getCPUCount() - Static method in class com.caoccao.javet.utils.JavetOSUtils
+
 
+
getDebug() - Method in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
+
Gets debug.
+
+
getDefaultBoolean() - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Gets default boolean boolean.
+
+
getDefaultByte() - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Gets default byte.
+
+
getDefaultChar() - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Gets default char.
+
+
getDefaultDouble() - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Gets default double.
+
+
getDefaultEngineGuardTimeoutMillis() - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
getDefaultFloat() - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Gets default float.
+
+
getDefaultInt() - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Gets default int.
+
+
getDefaultLong() - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Gets default long.
+
+
getDefaultShort() - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Gets default short.
+
+
getDescription() - Method in class com.caoccao.javet.entities.JavetEntitySymbol
+
+
Gets description.
+
+
getDescription() - Method in class com.caoccao.javet.values.reference.V8ValueSymbol
+
+
Gets description.
+
+
getDouble(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets double.
+
+
getEndColumn() - Method in class com.caoccao.javet.exceptions.JavetScriptingError
+
 
+
getEndPosition() - Method in class com.caoccao.javet.exceptions.JavetScriptingError
+
 
+
getEngine() - Method in interface com.caoccao.javet.interop.engine.IJavetEnginePool
+
 
+
getEngine() - Method in class com.caoccao.javet.interop.engine.JavetEnginePool
+
 
+
getEngineGuardCheckIntervalMillis() - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
getEngineUsedCount() - Method in class com.caoccao.javet.interop.engine.JavetEngineUsage
+
 
+
getEntries() - Method in interface com.caoccao.javet.values.reference.IV8ValueMap
+
 
+
getEntries() - Method in interface com.caoccao.javet.values.reference.IV8ValueSet
+
 
+
getEntries() - Method in class com.caoccao.javet.values.reference.V8ValueMap
+
 
+
getEntries() - Method in class com.caoccao.javet.values.reference.V8ValueSet
+
 
+
getError() - Method in exception com.caoccao.javet.exceptions.JavetException
+
 
+
getError() - Method in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
+
Gets error.
+
+
getException() - Method in interface com.caoccao.javet.values.reference.IV8Module
+
 
+
getException() - Method in class com.caoccao.javet.values.reference.V8Module
+
 
+
getExecutor(File) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getExecutor(Path) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getExecutor(String) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getExecutorService() - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
getFlags() - Method in class com.caoccao.javet.interop.V8Host
+
+
Gets flags.
+
+
getFloat(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets float.
+
+
getFloat32(int) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
getFloat32(int, boolean) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
getFloat64(int) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
getFloat64(int, boolean) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
getFormat() - Method in class com.caoccao.javet.exceptions.JavetError
+
 
+
getFunctionMap() - Method in class com.caoccao.javet.interop.binding.BindingContext
+
+
Gets function map.
+
+
getGetterPrefixLength(Method) - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
Gets getter prefix length.
+
+
getGlobalName() - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
getGlobalName() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getGlobalObject(long) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
getGlobalObject() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getGuard() - Method in interface com.caoccao.javet.interop.engine.IJavetEngine
+
 
+
getGuard(long) - Method in interface com.caoccao.javet.interop.engine.IJavetEngine
+
 
+
getGuard() - Method in class com.caoccao.javet.interop.engine.JavetEngine
+
 
+
getGuard(long) - Method in class com.caoccao.javet.interop.engine.JavetEngine
+
 
+
getHandle() - Method in class com.caoccao.javet.interop.callback.JavetCallbackContext
+
+
Gets handle.
+
+
getHandle() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getHandle() - Method in interface com.caoccao.javet.values.reference.IV8ValueReference
+
 
+
getHandle() - Method in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
getHandler() - Method in interface com.caoccao.javet.values.reference.IV8ValueProxy
+
+
Gets handler.
+
+
getHandler() - Method in class com.caoccao.javet.values.reference.V8ValueProxy
+
 
+
getHasInstance() - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
getId() - Method in enum com.caoccao.javet.enums.JSFunctionType
+
 
+
getId() - Method in enum com.caoccao.javet.enums.JSScopeType
+
 
+
getId() - Method in enum com.caoccao.javet.enums.V8ValueReferenceType
+
 
+
getIdentityHash(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
getIdentityHash(IV8ValueReference) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getIdentityHash() - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Returns the identity hash for this object.
+
+
getIdentityHash() - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
getIdleEngineCount() - Method in interface com.caoccao.javet.interop.engine.IJavetEnginePool
+
 
+
getIdleEngineCount() - Method in class com.caoccao.javet.interop.engine.JavetEnginePool
+
 
+
getInfo() - Method in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
+
Gets info.
+
+
getInstance(JSRuntimeType) - Static method in class com.caoccao.javet.interop.V8Host
+
+
Gets instance by JS runtime type.
+
+
getInt16(int) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
getInt16(int, boolean) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
getInt32(int) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
getInt32(int, boolean) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
getInt8(int) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
getInteger(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets integer.
+
+
getInternalProperties(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
getInternalProperties(IV8ValueFunction) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getInternalProperties() - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Gets internal properties.
+
+
getInternalProperties() - Method in class com.caoccao.javet.values.reference.V8ValueFunction
+
 
+
getInternalStatistic() - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
getInternalStatistic() - Method in class com.caoccao.javet.interop.V8Host
+
+
Get internal statistic internal for test purpose.
+
+
getIsConcatSpreadable() - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
getIterator() - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
getJavetLogger() - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
getJavetVersion() - Method in class com.caoccao.javet.interop.V8Host
+
+
Gets javet version.
+
+
getJSFunctionType() - Method in class com.caoccao.javet.entities.JavetEntityFunction
+
 
+
getJSFunctionType() - Method in interface com.caoccao.javet.interfaces.IJavetEntityFunction
+
+
Gets JS function type.
+
+
getJSFunctionType(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
getJSFunctionType(IV8ValueFunction) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getJSFunctionType() - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Gets JS function type.
+
+
getJSFunctionType() - Method in class com.caoccao.javet.values.reference.V8ValueFunction
+
 
+
getJSMethodName() - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler.JavetUniversalInterceptor
+
+
Gets JS method name.
+
+
getJSRuntimeType() - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
getJSRuntimeType() - Method in class com.caoccao.javet.interop.JavetLibLoader
+
 
+
getJSRuntimeType() - Method in class com.caoccao.javet.interop.NodeRuntime
+
 
+
getJSRuntimeType() - Method in class com.caoccao.javet.interop.V8Host
+
+
Gets JS runtime type.
+
+
getJSRuntimeType() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getJSScopeType(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
getJSScopeType(IV8ValueFunction) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getJSScopeType() - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Gets JS scope type.
+
+
getJSScopeType() - Method in class com.caoccao.javet.values.reference.V8ValueFunction
+
 
+
getKeys() - Method in interface com.caoccao.javet.values.reference.IV8ValueArray
+
 
+
getKeys() - Method in interface com.caoccao.javet.values.reference.IV8ValueKeyContainer
+
 
+
getKeys() - Method in class com.caoccao.javet.values.reference.V8ValueArray
+
 
+
getKeys() - Method in class com.caoccao.javet.values.reference.V8ValueMap
+
 
+
getKeys() - Method in class com.caoccao.javet.values.reference.V8ValueSet
+
 
+
getLastActiveZonedDatetime() - Method in class com.caoccao.javet.interop.engine.JavetEngineUsage
+
 
+
getLastException() - Method in class com.caoccao.javet.interop.V8Host
+
+
Gets last exception.
+
+
getLength(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
getLength(IV8ValueArray) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getLength(IV8ValueTypedArray) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getLength() - Method in interface com.caoccao.javet.values.reference.IV8ValueArray
+
 
+
getLength() - Method in interface com.caoccao.javet.values.reference.IV8ValueTypedArray
+
 
+
getLength() - Method in class com.caoccao.javet.values.reference.V8ValueArray
+
 
+
getLength() - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
 
+
getLineNumber() - Method in class com.caoccao.javet.exceptions.JavetScriptingError
+
 
+
getLog() - Method in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
+
Gets log.
+
+
getLogger() - Method in class com.caoccao.javet.interop.V8Host
+
+
Gets logger.
+
+
getLogger() - Method in class com.caoccao.javet.interop.V8Inspector
+
 
+
getLogger() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getLogger() - Method in class com.caoccao.javet.utils.JavetDefaultLogger
+
 
+
getLong(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets long.
+
+
getMatch() - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
getMatchAll() - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
getMaxDepth() - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Gets max depth.
+
+
getMemoryUsageThresholdRatio() - Static method in class com.caoccao.javet.interop.V8Host
+
+
Gets memory usage threshold ratio.
+
+
getMessage(Map<String, Object>) - Method in class com.caoccao.javet.exceptions.JavetError
+
 
+
getMessage() - Method in class com.caoccao.javet.exceptions.JavetScriptingError
+
 
+
getMessage() - Method in class com.caoccao.javet.values.reference.V8ValueError
+
 
+
getMethod() - Method in class com.caoccao.javet.interop.binding.MethodDescriptor
+
+
Gets method.
+
+
getMethod(String) - Method in interface com.caoccao.javet.utils.receivers.IJavetCallbackReceiver
+
+
Gets method that does not take any arguments by method name.
+
+
getMethod(String, int) - Method in interface com.caoccao.javet.utils.receivers.IJavetCallbackReceiver
+
+
Gets method.
+
+
getMethod(String, boolean) - Method in interface com.caoccao.javet.utils.receivers.IJavetCallbackReceiver
+
+
Gets method.
+
+
getMethod(String, boolean, int) - Method in interface com.caoccao.javet.utils.receivers.IJavetCallbackReceiver
+
+
Gets method that takes given number of arguments by method name.
+
+
getMethod(String, Class<?>...) - Method in interface com.caoccao.javet.utils.receivers.IJavetCallbackReceiver
+
+
Gets method that is customized to given argument types by method name.
+
+
getMethods() - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler.JavetUniversalInterceptor
+
+
Gets methods.
+
+
getMethodVarargs(String) - Method in interface com.caoccao.javet.utils.receivers.IJavetCallbackReceiver
+
+
Gets method that takes an arbitrary number of arguments by method name.
+
+
getMethodVarargs(String, boolean) - Method in interface com.caoccao.javet.utils.receivers.IJavetCallbackReceiver
+
+
Gets method that takes an arbitrary number of arguments by method name.
+
+
getModuleObject() - Method in class com.caoccao.javet.node.modules.BaseNodeModule
+
 
+
getModuleObject() - Method in interface com.caoccao.javet.node.modules.INodeModule
+
 
+
getName() - Method in enum com.caoccao.javet.enums.JavetPromiseRejectEvent
+
+
Gets event name.
+
+
getName() - Method in enum com.caoccao.javet.enums.JSFunctionType
+
 
+
getName() - Method in enum com.caoccao.javet.enums.JSRuntimeType
+
 
+
getName() - Method in enum com.caoccao.javet.enums.JSScopeType
+
 
+
getName() - Method in enum com.caoccao.javet.enums.V8ValueReferenceType
+
 
+
getName() - Method in class com.caoccao.javet.interop.V8Inspector
+
 
+
getName() - Method in class com.caoccao.javet.node.modules.BaseNodeModule
+
 
+
getName() - Method in interface com.caoccao.javet.node.modules.INodeModule
+
 
+
getName() - Method in class com.caoccao.javet.utils.JavetDefaultLogger
+
 
+
getNamespace() - Method in class com.caoccao.javet.values.reference.V8Module
+
+
Gets namespace.
+
+
getNext() - Method in interface com.caoccao.javet.values.reference.IV8ValueIterator
+
+
Gets next.
+
+
getNext() - Method in class com.caoccao.javet.values.reference.V8ValueIterator
+
 
+
getNodeInstance() - Static method in class com.caoccao.javet.interop.V8Host
+
+
Gets Node instance.
+
+
getNodeModule(Class<Module>) - Method in class com.caoccao.javet.interop.NodeRuntime
+
 
+
getNodeModule(String, Class<NM>) - Method in class com.caoccao.javet.interop.NodeRuntime
+
 
+
getNodeModuleCount() - Method in class com.caoccao.javet.interop.NodeRuntime
+
 
+
getNull(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets null.
+
+
getObject() - Method in class com.caoccao.javet.utils.JavetVirtualObject
+
+
Gets object.
+
+
getObject(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets object.
+
+
getOwnPropertyNames(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
getOwnPropertyNames(IV8ValueObject) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getOwnPropertyNames() - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets own property names.
+
+
getOwnPropertyNames() - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
getOwnPropertySymbols(IV8ValueObject) - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInObject
+
+
Gets own property symbols.
+
+
getParameters() - Method in exception com.caoccao.javet.exceptions.JavetException
+
 
+
getPoolDaemonCheckIntervalMillis() - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
getPoolIdleTimeoutSeconds() - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
getPoolMaxSize() - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
getPoolMinSize() - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
getPoolShutdownTimeoutSeconds() - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
getPrimitive(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets primitive.
+
+
getPrivateProperty(long, long, int, String) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
getPrivateProperty(IV8ValueObject, String) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getPrivateProperty(String) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets private property.
+
+
getPrivateProperty(String) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
getPrivatePropertyBoolean(String) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets private property boolean.
+
+
getPrivatePropertyDouble(String) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets private property double.
+
+
getPrivatePropertyFloat(String) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets private property float.
+
+
getPrivatePropertyInteger(String) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets private property integer.
+
+
getPrivatePropertyLong(String) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets private property long.
+
+
getPrivatePropertyNull(String) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets private property null.
+
+
getPrivatePropertyObject(String) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets private property object.
+
+
getPrivatePropertyPrimitive(String) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets private property primitive.
+
+
getPrivatePropertyString(String) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets private property string.
+
+
getPrivatePropertyUndefined(String) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets private property undefined.
+
+
getPrivatePropertyZonedDateTime(String) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets private property zoned date time.
+
+
getPromise() - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Gets promise.
+
+
getPromise() - Method in class com.caoccao.javet.values.reference.V8ValuePromise
+
 
+
getPromiseRejectCallback() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getProperty(long, long, int, Object) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
getProperty(IV8ValueObject, V8Value) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getProperty(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets property.
+
+
getProperty(Object) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
getPropertyBoolean(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets property boolean.
+
+
getPropertyDouble(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets property double.
+
+
getPropertyFloat(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets property float.
+
+
getPropertyGetterMap() - Method in class com.caoccao.javet.interop.binding.BindingContext
+
+
Gets property getter map.
+
+
getPropertyInteger(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets property integer.
+
+
getPropertyLong(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets property long.
+
+
getPropertyNames(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
getPropertyNames(IV8ValueObject) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getPropertyNames() - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets property names.
+
+
getPropertyNames() - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
getPropertyObject(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets property object.
+
+
getPropertyPrimitive(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets property primitive.
+
+
getPropertySetterMap() - Method in class com.caoccao.javet.interop.binding.BindingContext
+
+
Gets property setter map.
+
+
getPropertyString(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets property string.
+
+
getPropertyZonedDateTime(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets property zoned date time.
+
+
getPrototype(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
getPrototype(IV8ValueObject) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getPrototype() - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets prototype.
+
+
getPrototype() - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
getPrototypeOf(V8Value) - Method in interface com.caoccao.javet.interop.proxy.IJavetProxyHandler
+
+
Gets prototype of.
+
+
getReferenceCount() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getReplace() - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
getResetEngineTimeoutSeconds() - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
getResourceColumnOffset() - Method in class com.caoccao.javet.interop.V8ScriptOrigin
+
 
+
getResourceFileName() - Method in class com.caoccao.javet.interop.JavetLibLoader
+
 
+
getResourceLineOffset() - Method in class com.caoccao.javet.interop.V8ScriptOrigin
+
 
+
getResourceName() - Method in class com.caoccao.javet.exceptions.JavetScriptingError
+
 
+
getResourceName() - Method in interface com.caoccao.javet.interop.executors.IV8Executor
+
 
+
getResourceName() - Method in class com.caoccao.javet.interop.V8ScriptOrigin
+
 
+
getResourceName() - Method in interface com.caoccao.javet.values.reference.IV8Module
+
 
+
getResourceName() - Method in interface com.caoccao.javet.values.reference.IV8Script
+
 
+
getResourceName() - Method in class com.caoccao.javet.values.reference.V8Module
+
 
+
getResourceName() - Method in class com.caoccao.javet.values.reference.V8Script
+
 
+
getResult() - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Gets result.
+
+
getResult() - Method in class com.caoccao.javet.values.reference.V8ValuePromise
+
 
+
getResultBoolean() - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Gets result boolean.
+
+
getResultDouble() - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Gets result double.
+
+
getResultInteger() - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Gets result integer.
+
+
getResultLong() - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Gets result long.
+
+
getResultObject(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Gets result object.
+
+
getResultPrimitive() - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Gets result primitive.
+
+
getResultString() - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Gets result string.
+
+
getResultZonedDateTime() - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Gets result zoned date time.
+
+
getScore() - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler.ScoredExecutable
+
+
Gets score.
+
+
getScriptId() - Method in class com.caoccao.javet.interop.V8ScriptOrigin
+
 
+
getScriptId() - Method in interface com.caoccao.javet.values.reference.IV8Module
+
+
Gets script id.
+
+
getScriptId() - Method in class com.caoccao.javet.values.reference.V8Module
+
 
+
getScriptingError() - Method in exception com.caoccao.javet.exceptions.BaseJavetScriptingException
+
 
+
getScriptPath() - Method in class com.caoccao.javet.interop.executors.V8PathExecutor
+
 
+
getScriptString() - Method in class com.caoccao.javet.interop.executors.BaseV8Executor
+
 
+
getScriptString() - Method in interface com.caoccao.javet.interop.executors.IV8Executor
+
 
+
getScriptString() - Method in class com.caoccao.javet.interop.executors.V8PathExecutor
+
 
+
getScriptString() - Method in class com.caoccao.javet.interop.executors.V8StringExecutor
+
 
+
getSearch() - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
getSetterPrefixLength(Method) - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
Gets setter prefix length.
+
+
getSize(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
getSize(IV8ValueKeyContainer) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getSize() - Method in interface com.caoccao.javet.values.reference.IV8ValueKeyContainer
+
 
+
getSize() - Method in class com.caoccao.javet.values.reference.V8ValueMap
+
 
+
getSize() - Method in class com.caoccao.javet.values.reference.V8ValueSet
+
 
+
getSizeInBytes() - Method in interface com.caoccao.javet.values.reference.IV8ValueTypedArray
+
 
+
getSizeInBytes() - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
 
+
getSourceCode() - Method in class com.caoccao.javet.entities.JavetEntityFunction
+
 
+
getSourceCode() - Method in interface com.caoccao.javet.interfaces.IJavetEntityFunction
+
+
Gets source code.
+
+
getSourceCode(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
getSourceCode(IV8ValueFunction) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getSourceCode() - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Gets source code.
+
+
getSourceCode() - Method in class com.caoccao.javet.values.reference.V8ValueFunction
+
 
+
getSourceLine() - Method in class com.caoccao.javet.exceptions.JavetScriptingError
+
 
+
getSpecies() - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
getSplit() - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
getStack() - Method in class com.caoccao.javet.values.reference.V8ValueError
+
 
+
getStartColumn() - Method in class com.caoccao.javet.exceptions.JavetScriptingError
+
 
+
getStartPosition() - Method in class com.caoccao.javet.exceptions.JavetScriptingError
+
 
+
getState() - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Gets state.
+
+
getState() - Method in class com.caoccao.javet.values.reference.V8ValuePromise
+
 
+
getStatus() - Method in interface com.caoccao.javet.values.reference.IV8Module
+
 
+
getStatus() - Method in class com.caoccao.javet.values.reference.V8Module
+
 
+
getString(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets string.
+
+
getSymbolType() - Method in class com.caoccao.javet.interop.binding.MethodDescriptor
+
+
Gets symbol type.
+
+
getTarget() - Method in interface com.caoccao.javet.values.reference.IV8ValueProxy
+
+
Gets target.
+
+
getTarget() - Method in class com.caoccao.javet.values.reference.V8ValueProxy
+
 
+
getTargetObject() - Method in class com.caoccao.javet.interop.proxy.BaseJavetProxyHandler
+
 
+
getTargetObject() - Method in interface com.caoccao.javet.interop.proxy.IJavetProxyHandler
+
+
Gets target object.
+
+
getTargetObject() - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler.JavetUniversalInterceptor
+
+
Gets target object.
+
+
GETTER_PREFIX_ARRAY - Static variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The constant GETTER_PREFIX_ARRAY.
+
+
gettersMap - Variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The Getters map.
+
+
getTimeoutMillis() - Method in interface com.caoccao.javet.interop.engine.IJavetEngineGuard
+
+
Gets timeout millis.
+
+
getTimeoutMillis() - Method in class com.caoccao.javet.interop.engine.JavetEngineGuard
+
 
+
getToPrimitive() - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
getToStringTag() - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
getTrace() - Method in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
+
Gets trace.
+
+
getType() - Method in class com.caoccao.javet.exceptions.JavetError
+
 
+
getType() - Method in interface com.caoccao.javet.values.reference.IV8ValueReference
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8Module
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8Script
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValueArguments
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValueArray
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValueError
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValueFunction
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValueIterator
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValueMap
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValuePromise
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValueProxy
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValueRegExp
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValueSet
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValueSharedArrayBuffer
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValueSymbol
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValueSymbolObject
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValueWeakMap
+
 
+
getType() - Method in class com.caoccao.javet.values.reference.V8ValueWeakSet
+
 
+
getUndefined(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets undefined.
+
+
getUnscopables() - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
getUsage() - Method in class com.caoccao.javet.interop.engine.JavetEngine
+
 
+
getUTCNow() - Method in class com.caoccao.javet.interop.engine.JavetEngine
+
+
Gets utc now.
+
+
getUTCNow() - Method in class com.caoccao.javet.interop.engine.JavetEngineGuard
+
+
Gets utc now.
+
+
getUTCNow() - Method in class com.caoccao.javet.interop.engine.JavetEnginePool
+
+
Gets utc now.
+
+
getUTCNow() - Static method in class com.caoccao.javet.utils.JavetDateTimeUtils
+
+
Gets utc now.
+
+
getV8BindEnabler() - Method in class com.caoccao.javet.interop.binding.BindingContext
+
+
Gets V8 bind enabler.
+
+
getV8Inspector() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getV8Inspector(String) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getV8Instance() - Static method in class com.caoccao.javet.interop.V8Host
+
+
Gets V8 instance.
+
+
getV8Locker() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getV8Module(String, IV8Module) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getV8ModuleCount() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getV8ModuleResolver() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getV8Runtime() - Method in class com.caoccao.javet.interception.BaseJavetInterceptor
+
 
+
getV8Runtime() - Method in interface com.caoccao.javet.interop.engine.IJavetEngine
+
 
+
getV8Runtime() - Method in class com.caoccao.javet.interop.engine.JavetEngine
+
 
+
getV8Runtime() - Method in class com.caoccao.javet.interop.executors.BaseV8Executor
+
 
+
getV8Runtime() - Method in interface com.caoccao.javet.interop.executors.IV8Executor
+
 
+
getV8Runtime() - Method in class com.caoccao.javet.interop.proxy.BaseJavetProxyHandler
+
+
Gets V8 runtime.
+
+
getV8Runtime() - Method in interface com.caoccao.javet.utils.receivers.IJavetCallbackReceiver
+
 
+
getV8Runtime() - Method in class com.caoccao.javet.utils.receivers.JavetCallbackReceiver
+
 
+
getV8Runtime() - Method in interface com.caoccao.javet.values.IV8Value
+
+
Gets V8 runtime.
+
+
getV8Runtime() - Method in class com.caoccao.javet.values.V8Value
+
 
+
getV8RuntimeCount() - Method in class com.caoccao.javet.interop.V8Host
+
+
Gets V8 runtime count.
+
+
getV8RuntimeSetter() - Method in class com.caoccao.javet.interop.binding.BindingContext
+
+
Gets V8 runtime setter.
+
+
getV8ScriptOrigin() - Method in class com.caoccao.javet.interop.executors.BaseV8Executor
+
 
+
getV8ScriptOrigin() - Method in interface com.caoccao.javet.interop.executors.IV8Executor
+
 
+
getV8Value() - Method in class com.caoccao.javet.utils.JavetVirtualObject
+
+
Gets V8 value.
+
+
getValue() - Method in class com.caoccao.javet.values.primitive.V8ValuePrimitive
+
 
+
getValues() - Method in interface com.caoccao.javet.values.reference.IV8ValueMap
+
 
+
getValues() - Method in class com.caoccao.javet.values.reference.V8ValueMap
+
 
+
getVersion() - Method in enum com.caoccao.javet.enums.JSRuntimeType
+
 
+
getVersion() - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
getVersion() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
getVersion() - Method in class com.caoccao.javet.node.modules.NodeModuleProcess
+
 
+
getWarn() - Method in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
+
Gets warn.
+
+
getWorkingDirectory() - Method in class com.caoccao.javet.node.modules.NodeModuleProcess
+
 
+
getZonedDateTime(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Gets zoned date time.
+
+
GLOBAL_THIS - Static variable in class com.caoccao.javet.interop.V8Host
+
+
The constant GLOBAL_THIS.
+
+
globalName - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
+ + + +

H

+
+
handle - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
handle - Variable in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
handleNotification(Notification, Object) - Method in class com.caoccao.javet.interop.V8Notifier
+
 
+
has(long, long, int, Object) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
has(V8Value, V8Value) - Method in interface com.caoccao.javet.interop.proxy.IJavetProxyHandler
+
+
Has property
+
+
has(V8Value, V8Value) - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
 
+
has(IV8ValueObject, V8Value) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
has(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Has object property key.
+
+
has(Object) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
has(Object) - Method in class com.caoccao.javet.values.reference.V8ValueWeakMap
+
 
+
has(Object) - Method in class com.caoccao.javet.values.reference.V8ValueWeakSet
+
 
+
hasConstructors() - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
Has constructors.
+
+
hasHandler() - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Has handler.
+
+
hasHandler() - Method in class com.caoccao.javet.values.reference.V8ValuePromise
+
 
+
hasNull() - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Has null property key.
+
+
hasOwnProperty(long, long, int, Object) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
hasOwnProperty(IV8ValueObject, V8Value) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
hasOwnProperty(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Has own property key.
+
+
hasOwnProperty(Object) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
hasPrivateProperty(long, long, int, String) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
hasPrivateProperty(IV8ValueObject, String) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
hasPrivateProperty(String) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Has private property boolean.
+
+
hasPrivateProperty(String) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
hasUndefined() - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Has undefined property key.
+
+
+ + + +

I

+
+
idleEngineList - Variable in class com.caoccao.javet.interop.engine.JavetEnginePool
+
+
The Idle engine list.
+
+
idleNotificationDeadline(long, long) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
idleNotificationDeadline(long) - Method in class com.caoccao.javet.interop.V8Runtime
+
+
Idle notification deadline.
+
+
IJavetBiConsumer<T1 extends V8Value,T2 extends V8Value,E extends java.lang.Throwable> - Interface in com.caoccao.javet.interfaces
+
+
The interface Javet bi-consumer.
+
+
IJavetBiIndexedConsumer<T1 extends V8Value,T2 extends V8Value,E extends java.lang.Throwable> - Interface in com.caoccao.javet.interfaces
+
+
The interface Javet bi-indexed consumer.
+
+
IJavetCallbackReceiver - Interface in com.caoccao.javet.utils.receivers
+
+
The interface Javet callback receiver.
+
+
IJavetClosable - Interface in com.caoccao.javet.interfaces
+
+
The interface Javet closable.
+
+
IJavetConverter - Interface in com.caoccao.javet.interop.converters
+
+
The interface Javet converter.
+
+
IJavetEngine<R extends V8Runtime> - Interface in com.caoccao.javet.interop.engine
+
 
+
iJavetEngine - Variable in class com.caoccao.javet.interop.engine.JavetEngineGuard
+
+
The Javet engine.
+
+
IJavetEngineGuard - Interface in com.caoccao.javet.interop.engine
+
+
The interface Javet engine guard is the one guarding the script execution with a timeout.
+
+
IJavetEnginePool<R extends V8Runtime> - Interface in com.caoccao.javet.interop.engine
+
 
+
iJavetEnginePool - Variable in class com.caoccao.javet.interop.engine.JavetEngine
+
 
+
IJavetEntityFunction - Interface in com.caoccao.javet.interfaces
+
+
The interface Javet entity function.
+
+
IJavetEntityMap - Interface in com.caoccao.javet.interfaces
+
+
The interface Javet entity map.
+
+
IJavetInterceptor - Interface in com.caoccao.javet.interfaces
+
+
The interface Javet interceptor.
+
+
IJavetLogger - Interface in com.caoccao.javet.interfaces
+
+
The interface Javet logger.
+
+
IJavetPromiseRejectCallback - Interface in com.caoccao.javet.interfaces
+
+
The interface Javet promise reject callback.
+
+
IJavetProxyHandler<T> - Interface in com.caoccao.javet.interop.proxy
+
+
The interface Javet proxy handler.
+
+
IJavetResettable - Interface in com.caoccao.javet.interfaces
+
+
The interface Javet resettable.
+
+
IJavetSupplier<T,E extends java.lang.Throwable> - Interface in com.caoccao.javet.interfaces
+
 
+
IJavetUniConsumer<T extends V8Value,E extends java.lang.Throwable> - Interface in com.caoccao.javet.interfaces
+
+
The interface Javet uni consumer.
+
+
IJavetUniIndexedConsumer<T extends V8Value,E extends java.lang.Throwable> - Interface in com.caoccao.javet.interfaces
+
+
The interface Javet uni indexed consumer.
+
+
increaseUsedCount() - Method in class com.caoccao.javet.interop.engine.JavetEngineUsage
+
 
+
info - Variable in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
+
The Info.
+
+
info(String) - Method in interface com.caoccao.javet.interfaces.IJavetLogger
+
+
Info.
+
+
info(String) - Method in class com.caoccao.javet.utils.JavetDefaultLogger
+
 
+
initialize() - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
Initialize.
+
+
initializeFieldsAndMethods(Class, boolean) - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
Initialize fields and methods.
+
+
initializeV8ValueCache() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
INodeModule - Interface in com.caoccao.javet.node.modules
+
 
+
INodeNative - Interface in com.caoccao.javet.interop
+
 
+
instantiate() - Method in interface com.caoccao.javet.values.reference.IV8Module
+
 
+
instantiate() - Method in class com.caoccao.javet.values.reference.V8Module
+
 
+
Instantiated - Static variable in interface com.caoccao.javet.values.reference.IV8Module
+
 
+
Instantiating - Static variable in interface com.caoccao.javet.values.reference.IV8Module
+
 
+
INVALID_HANDLE - Static variable in class com.caoccao.javet.interop.callback.JavetCallbackContext
+
+
The constant INVALID_HANDLE.
+
+
INVALID_HANDLE - Static variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
INVALID_HANDLE - Static variable in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
invoke(long, long, int, String, boolean, Object[]) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
invoke(Object, Method, Object[]) - Method in class com.caoccao.javet.interop.proxy.DynamicProxyV8ValueFunctionInvocationHandler
+
 
+
invoke(Object, Method, Object[]) - Method in class com.caoccao.javet.interop.proxy.DynamicProxyV8ValueObjectInvocationHandler
+
 
+
invoke(V8Value...) - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler.JavetUniversalInterceptor
+
+
Invoke.
+
+
invoke(IV8ValueObject, String, boolean, V8Value...) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
invoke(String, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Invoke function with return V8 value by name and objects as arguments.
+
+
invoke(String, V8Value...) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Invoke function with return V8 value by name and V8 values as arguments.
+
+
invokeBoolean(String, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Invoke function with return value boolean by name and objects as arguments.
+
+
invokeDouble(String, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Invoke function with return value double by name and objects as arguments.
+
+
invokeExtended(String, boolean, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Invoke extended and return V8 value which must be consumed, + otherwise memory leak may occur.
+
+
invokeExtended(String, boolean, V8Value...) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Invoke extended and return V8 value which must be consumed, + otherwise memory leak may occur.
+
+
invokeExtended(String, boolean, Object...) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
invokeExtended(String, boolean, V8Value...) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
invokeFloat(String, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Invoke function with return value float by name and objects as arguments.
+
+
invokeInteger(String, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Invoke function with return value integer by name and objects as arguments.
+
+
invokeLong(String, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Invoke function with return value long by name and objects as arguments.
+
+
invokeObject(String, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Invoke function with return value object by name and objects as arguments.
+
+
invokePrimitive(String, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Invoke function with return value primitive by name and objects as arguments.
+
+
invokeString(String, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Invoke function with return value string by name and objects as arguments.
+
+
invokeVoid(String, Object...) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Invoke function without return value by name and objects as arguments.
+
+
invokeVoid(String, V8Value...) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Invoke function without return value by name and V8 values as arguments.
+
+
IS_IN_DEBUG_MODE - Static variable in class com.caoccao.javet.interop.engine.JavetEngineGuard
+
+
The constant IS_IN_DEBUG_MODE.
+
+
IS_LINUX - Static variable in class com.caoccao.javet.utils.JavetOSUtils
+
 
+
IS_MACOS - Static variable in class com.caoccao.javet.utils.JavetOSUtils
+
 
+
IS_WINDOWS - Static variable in class com.caoccao.javet.utils.JavetOSUtils
+
 
+
isActive() - Method in interface com.caoccao.javet.interop.engine.IJavetEngine
+
 
+
isActive() - Method in interface com.caoccao.javet.interop.engine.IJavetEnginePool
+
 
+
isActive() - Method in class com.caoccao.javet.interop.engine.JavetEngine
+
 
+
isActive() - Method in class com.caoccao.javet.interop.engine.JavetEnginePool
+
 
+
isAllowEval() - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
isAllowNativesSyntax() - Method in class com.caoccao.javet.interop.V8Flags
+
 
+
isAPI() - Method in enum com.caoccao.javet.enums.JSFunctionType
+
 
+
isAutoSendGCNotification() - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
isBlock() - Method in enum com.caoccao.javet.enums.JSScopeType
+
 
+
isCatch() - Method in enum com.caoccao.javet.enums.JSScopeType
+
 
+
isClass() - Method in enum com.caoccao.javet.enums.JSScopeType
+
 
+
isClassMode(Class) - Static method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
Is class mode.
+
+
isClassMode() - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
Is class mode.
+
+
isClosed() - Method in interface com.caoccao.javet.interfaces.IJavetClosable
+
+
Is closed.
+
+
isClosed() - Method in class com.caoccao.javet.interop.engine.JavetEngine
+
 
+
isClosed() - Method in class com.caoccao.javet.interop.engine.JavetEngineGuard
+
 
+
isClosed() - Method in class com.caoccao.javet.interop.engine.JavetEnginePool
+
 
+
isClosed() - Method in class com.caoccao.javet.interop.proxy.DynamicProxyV8ValueFunctionInvocationHandler
+
 
+
isClosed() - Method in class com.caoccao.javet.interop.proxy.DynamicProxyV8ValueObjectInvocationHandler
+
 
+
isClosed() - Method in class com.caoccao.javet.interop.V8Locker
+
 
+
isClosed() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
isClosed() - Method in class com.caoccao.javet.node.modules.BaseNodeModule
+
 
+
isClosed(Object) - Static method in class com.caoccao.javet.utils.JavetResourceUtils
+
+
Is closed.
+
+
isClosed() - Method in interface com.caoccao.javet.values.reference.IV8ValueReference
+
 
+
isClosed() - Method in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
isClosed() - Method in class com.caoccao.javet.values.V8Value
+
 
+
isClosed() - Method in class com.caoccao.javet.values.virtual.V8VirtualValue
+
 
+
isClosed() - Method in class com.caoccao.javet.values.virtual.V8VirtualValueList
+
 
+
isContinuable() - Method in exception com.caoccao.javet.exceptions.JavetTerminatedException
+
 
+
isConverted() - Method in class com.caoccao.javet.utils.JavetVirtualObject
+
+
Is converted.
+
+
isDead(long) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
isDead() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
isEmpty() - Method in class com.caoccao.javet.values.primitive.V8ValuePrimitive
+
 
+
isEval() - Method in enum com.caoccao.javet.enums.JSScopeType
+
 
+
isExposeGC() - Method in class com.caoccao.javet.interop.V8Flags
+
 
+
isExposeInspectorScripts() - Method in class com.caoccao.javet.interop.V8Flags
+
 
+
isExtensible(V8Value) - Method in interface com.caoccao.javet.interop.proxy.IJavetProxyHandler
+
+
Is extensible.
+
+
isExtractFunctionSourceCode() - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Is extract function source code boolean.
+
+
isFinite() - Method in class com.caoccao.javet.values.primitive.V8ValueDouble
+
 
+
isFulfilled() - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Is fulfilled.
+
+
isFunction() - Method in enum com.caoccao.javet.enums.JSScopeType
+
 
+
isGcBeforeEngineClose() - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
isGCScheduled() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
isGenericGetter(Method) - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
Is generic getter boolean.
+
+
isGenericSetter(Method) - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
Is generic setter boolean.
+
+
isInfinite() - Method in class com.caoccao.javet.values.primitive.V8ValueDouble
+
 
+
isInUse(long) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
isInUse() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
isIsolateCreated() - Method in class com.caoccao.javet.interop.V8Host
+
+
Is isolate created.
+
+
isLibraryLoaded() - Method in class com.caoccao.javet.interop.V8Host
+
+
Is library loaded.
+
+
isLibraryReloadable() - Static method in class com.caoccao.javet.interop.V8Host
+
+
Determines whether the JNI library is reloadable or not.
+
+
isLoaded() - Method in class com.caoccao.javet.interop.JavetLibLoader
+
 
+
isLocked() - Method in class com.caoccao.javet.interop.V8Locker
+
+
Is locked.
+
+
isModule() - Method in enum com.caoccao.javet.enums.JSScopeType
+
 
+
isModule() - Method in interface com.caoccao.javet.interop.executors.IV8Executor
+
 
+
isModule() - Method in class com.caoccao.javet.interop.V8ScriptOrigin
+
 
+
isNaN() - Method in class com.caoccao.javet.values.primitive.V8ValueDouble
+
 
+
isNative() - Method in enum com.caoccao.javet.enums.JSFunctionType
+
 
+
isNode() - Method in enum com.caoccao.javet.enums.JSRuntimeType
+
 
+
isNull() - Method in interface com.caoccao.javet.values.IV8Value
+
+
Is null.
+
+
isNullOrUndefined() - Method in interface com.caoccao.javet.values.IV8Value
+
+
Is null or undefined.
+
+
isPending() - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Is pending.
+
+
isPooled() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
isPresent() - Method in class com.caoccao.javet.values.primitive.V8ValuePrimitive
+
 
+
isProxyMapEnabled() - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Is proxy map enabled.
+
+
isProxySetEnabled() - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Is proxy set enabled.
+
+
isQuitting() - Method in interface com.caoccao.javet.interop.engine.IJavetEnginePool
+
 
+
isQuitting() - Method in class com.caoccao.javet.interop.engine.JavetEngineGuard
+
+
Is quitting boolean.
+
+
isQuitting() - Method in class com.caoccao.javet.interop.engine.JavetEnginePool
+
 
+
isRejected() - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Is rejected.
+
+
isReturnResult() - Method in class com.caoccao.javet.interop.callback.JavetCallbackContext
+
+
Is return result.
+
+
isRevoked() - Method in interface com.caoccao.javet.values.reference.IV8ValueProxy
+
+
Is revoked.
+
+
isRevoked() - Method in class com.caoccao.javet.values.reference.V8ValueProxy
+
 
+
isScript() - Method in enum com.caoccao.javet.enums.JSScopeType
+
 
+
isSealed() - Method in class com.caoccao.javet.interop.V8Flags
+
 
+
isSkipFunctionInObject() - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Is skip functions boolean.
+
+
isTargetTypeMap - Variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The Is target type map.
+
+
isTargetTypeSet - Variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The Is target type set.
+
+
isThisObjectRequired() - Method in class com.caoccao.javet.interop.binding.MethodDescriptor
+
+
Is this object required boolean.
+
+
isThisObjectRequired() - Method in class com.caoccao.javet.interop.callback.JavetCallbackContext
+
+
Is this object required.
+
+
isTrackRetainingPath() - Method in class com.caoccao.javet.interop.V8Flags
+
 
+
isUndefined() - Method in interface com.caoccao.javet.values.IV8Value
+
+
Is undefined.
+
+
isUserDefined() - Method in enum com.caoccao.javet.enums.JSFunctionType
+
 
+
isUseStrict() - Method in class com.caoccao.javet.interop.V8Flags
+
 
+
isV8() - Method in enum com.caoccao.javet.enums.JSRuntimeType
+
 
+
isV8BindEnabled(String) - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
Is V8 bind enabled.
+
+
isValid() - Method in class com.caoccao.javet.interop.callback.JavetCallbackContext
+
+
Is valid.
+
+
isValid() - Method in interface com.caoccao.javet.values.reference.IV8ValueTypedArray
+
 
+
isValid() - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
 
+
isWasm() - Method in class com.caoccao.javet.interop.V8ScriptOrigin
+
 
+
isWeak(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
isWeak(IV8ValueReference) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
isWeak() - Method in interface com.caoccao.javet.values.reference.IV8ValueReference
+
 
+
isWeak(boolean) - Method in interface com.caoccao.javet.values.reference.IV8ValueReference
+
 
+
isWeak() - Method in class com.caoccao.javet.values.reference.V8ValueGlobalObject
+
 
+
isWeak() - Method in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
isWeak(boolean) - Method in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
isWith() - Method in enum com.caoccao.javet.enums.JSScopeType
+
 
+
IV8Cloneable - Interface in com.caoccao.javet.interop
+
 
+
IV8Convertible - Interface in com.caoccao.javet.interop
+
+
The interface V8 convertible.
+
+
IV8Creatable - Interface in com.caoccao.javet.interop
+
 
+
IV8Executable - Interface in com.caoccao.javet.interop
+
+
The interface V8 executable.
+
+
IV8Executor - Interface in com.caoccao.javet.interop.executors
+
 
+
IV8InspectorListener - Interface in com.caoccao.javet.interop
+
 
+
IV8Module - Interface in com.caoccao.javet.values.reference
+
 
+
IV8ModuleResolver - Interface in com.caoccao.javet.interfaces
+
+
The interface V8 module resolver is for resolving V8 module look-up in dynamic import.
+
+
IV8Native - Interface in com.caoccao.javet.interop
+
 
+
IV8Script - Interface in com.caoccao.javet.values.reference
+
 
+
IV8Value - Interface in com.caoccao.javet.values
+
+
The interface V8 value.
+
+
IV8ValueArray - Interface in com.caoccao.javet.values.reference
+
 
+
IV8ValueFunction - Interface in com.caoccao.javet.values.reference
+
+
The interface V8 value function.
+
+
IV8ValueIterator<T extends V8Value> - Interface in com.caoccao.javet.values.reference
+
+
The interface V8 value iterator.
+
+
IV8ValueKeyContainer - Interface in com.caoccao.javet.values.reference
+
 
+
IV8ValueMap - Interface in com.caoccao.javet.values.reference
+
 
+
IV8ValueObject - Interface in com.caoccao.javet.values.reference
+
+
The interface V8 value object.
+
+
IV8ValuePromise - Interface in com.caoccao.javet.values.reference
+
+
The interface V8 value promise is 2-sided.
+
+
IV8ValueProxy - Interface in com.caoccao.javet.values.reference
+
+
The interface V8 value proxy.
+
+
IV8ValueReference - Interface in com.caoccao.javet.values.reference
+
 
+
IV8ValueSet - Interface in com.caoccao.javet.values.reference
+
 
+
IV8ValueTypedArray - Interface in com.caoccao.javet.values.reference
+
 
+
+ + + +

J

+
+
JAVA_CONSOLE_DEBUG - Static variable in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
The constant JAVA_CONSOLE_DEBUG.
+
+
JAVA_CONSOLE_ERROR - Static variable in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
The constant JAVA_CONSOLE_ERROR.
+
+
JAVA_CONSOLE_INFO - Static variable in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
The constant JAVA_CONSOLE_INFO.
+
+
JAVA_CONSOLE_LOG - Static variable in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
The constant JAVA_CONSOLE_LOG.
+
+
JAVA_CONSOLE_TRACE - Static variable in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
The constant JAVA_CONSOLE_TRACE.
+
+
JAVA_CONSOLE_WARN - Static variable in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
The constant JAVA_CONSOLE_WARN.
+
+
JAVET_DAEMON_THREAD_NAME - Static variable in class com.caoccao.javet.interop.engine.JavetEnginePool
+
+
The constant JAVET_DAEMON_THREAD_NAME.
+
+
JavetCallbackContext - Class in com.caoccao.javet.interop.callback
+
+
The type Javet callback context.
+
+
JavetCallbackContext(Object, Method) - Constructor for class com.caoccao.javet.interop.callback.JavetCallbackContext
+
+
Instantiates a new Javet callback context.
+
+
JavetCallbackContext(Object, Method, boolean) - Constructor for class com.caoccao.javet.interop.callback.JavetCallbackContext
+
+
Instantiates a new Javet callback context.
+
+
JavetCallbackReceiver - Class in com.caoccao.javet.utils.receivers
+
+
The type Javet explicit callback receiver.
+
+
JavetCallbackReceiver(V8Runtime) - Constructor for class com.caoccao.javet.utils.receivers.JavetCallbackReceiver
+
+
Instantiates a new V8 callback receiver.
+
+
JavetCompilationException - Exception in com.caoccao.javet.exceptions
+
 
+
JavetCompilationException(String, String, String, int, int, int, int, int) - Constructor for exception com.caoccao.javet.exceptions.JavetCompilationException
+
 
+
JavetConverterConfig<T extends JavetConverterConfig> - Class in com.caoccao.javet.interop.converters
+
+
The type Javet converter config.
+
+
JavetConverterConfig() - Constructor for class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Instantiates a new Javet converter config.
+
+
JavetConverterException - Exception in com.caoccao.javet.exceptions
+
+
The type Javet converter exception is for JNI.
+
+
JavetConverterException(JavetError, Map<String, Object>) - Constructor for exception com.caoccao.javet.exceptions.JavetConverterException
+
+
Instantiates a new Javet converter exception.
+
+
JavetConverterException(String) - Constructor for exception com.caoccao.javet.exceptions.JavetConverterException
+
+
Instantiates a new Javet converter exception.
+
+
JavetDateTimeUtils - Class in com.caoccao.javet.utils
+
+
The type Date time utils.
+
+
JavetDefaultLogger - Class in com.caoccao.javet.utils
+
 
+
JavetDefaultLogger(String) - Constructor for class com.caoccao.javet.utils.JavetDefaultLogger
+
 
+
JavetEngine<R extends V8Runtime> - Class in com.caoccao.javet.interop.engine
+
 
+
JavetEngine(IJavetEnginePool<R>, R) - Constructor for class com.caoccao.javet.interop.engine.JavetEngine
+
 
+
JavetEngineConfig - Class in com.caoccao.javet.interop.engine
+
 
+
JavetEngineConfig() - Constructor for class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
JavetEngineGuard - Class in com.caoccao.javet.interop.engine
+
+
The type Javet engine guard.
+
+
JavetEngineGuard(IJavetEngine<?>, V8Runtime, long) - Constructor for class com.caoccao.javet.interop.engine.JavetEngineGuard
+
+
Instantiates a new Javet engine guard.
+
+
JavetEnginePool<R extends V8Runtime> - Class in com.caoccao.javet.interop.engine
+
+
The type Javet engine pool.
+
+
JavetEnginePool() - Constructor for class com.caoccao.javet.interop.engine.JavetEnginePool
+
+
Instantiates a new Javet engine pool.
+
+
JavetEnginePool(JavetEngineConfig) - Constructor for class com.caoccao.javet.interop.engine.JavetEnginePool
+
+
Instantiates a new Javet engine pool.
+
+
JavetEngineUsage - Class in com.caoccao.javet.interop.engine
+
 
+
JavetEngineUsage() - Constructor for class com.caoccao.javet.interop.engine.JavetEngineUsage
+
 
+
JavetEntityFunction - Class in com.caoccao.javet.entities
+
+
The type Javet entity function is for converting JS function + to or from Java object.
+
+
JavetEntityFunction() - Constructor for class com.caoccao.javet.entities.JavetEntityFunction
+
+
Instantiates a new Javet entity function.
+
+
JavetEntityFunction(String) - Constructor for class com.caoccao.javet.entities.JavetEntityFunction
+
+
Instantiates a new Javet entity function.
+
+
JavetEntityMap - Class in com.caoccao.javet.entities
+
+
The type Javet entity map is for converting JS map + to or from Java map.
+
+
JavetEntityMap(int, float) - Constructor for class com.caoccao.javet.entities.JavetEntityMap
+
+
Instantiates a new Javet entity map.
+
+
JavetEntityMap(int) - Constructor for class com.caoccao.javet.entities.JavetEntityMap
+
+
Instantiates a new Javet entity map.
+
+
JavetEntityMap() - Constructor for class com.caoccao.javet.entities.JavetEntityMap
+
+
Instantiates a new Javet entity map.
+
+
JavetEntityMap(Map<? extends String, ?>) - Constructor for class com.caoccao.javet.entities.JavetEntityMap
+
+
Instantiates a new Javet entity map.
+
+
JavetEntitySymbol - Class in com.caoccao.javet.entities
+
+
The type Javet entity symbol is for converting JS symbol + to or from Java symbol.
+
+
JavetEntitySymbol(String) - Constructor for class com.caoccao.javet.entities.JavetEntitySymbol
+
+
Instantiates a new Javet entity symbol.
+
+
JavetError - Class in com.caoccao.javet.exceptions
+
 
+
JavetErrorType - Enum in com.caoccao.javet.enums
+
+
The enum Javet error type is for categorizing the errors.
+
+
JavetException - Exception in com.caoccao.javet.exceptions
+
 
+
JavetException(JavetError) - Constructor for exception com.caoccao.javet.exceptions.JavetException
+
 
+
JavetException(JavetError, Map<String, Object>) - Constructor for exception com.caoccao.javet.exceptions.JavetException
+
 
+
JavetException(JavetError, Throwable) - Constructor for exception com.caoccao.javet.exceptions.JavetException
+
 
+
JavetException(JavetError, Map<String, Object>, Throwable) - Constructor for exception com.caoccao.javet.exceptions.JavetException
+
 
+
JavetExecutionException - Exception in com.caoccao.javet.exceptions
+
 
+
JavetExecutionException(String, String, String, int, int, int, int, int) - Constructor for exception com.caoccao.javet.exceptions.JavetExecutionException
+
 
+
JavetLibLoader - Class in com.caoccao.javet.interop
+
 
+
JavetLibLoader(JSRuntimeType) - Constructor for class com.caoccao.javet.interop.JavetLibLoader
+
 
+
JavetObjectConverter - Class in com.caoccao.javet.interop.converters
+
+
The type Javet object converter.
+
+
JavetObjectConverter() - Constructor for class com.caoccao.javet.interop.converters.JavetObjectConverter
+
+
Instantiates a new Javet object converter.
+
+
JavetOSUtils - Class in com.caoccao.javet.utils
+
 
+
JavetPrimitiveConverter - Class in com.caoccao.javet.interop.converters
+
+
The type Javet primitive converter.
+
+
JavetPrimitiveConverter() - Constructor for class com.caoccao.javet.interop.converters.JavetPrimitiveConverter
+
+
Instantiates a new Javet primitive converter.
+
+
JavetPrimitiveUtils - Class in com.caoccao.javet.utils
+
 
+
JavetPrimitiveUtils() - Constructor for class com.caoccao.javet.utils.JavetPrimitiveUtils
+
 
+
JavetPromiseRejectCallback - Class in com.caoccao.javet.utils
+
 
+
JavetPromiseRejectCallback(IJavetLogger) - Constructor for class com.caoccao.javet.utils.JavetPromiseRejectCallback
+
 
+
JavetPromiseRejectEvent - Enum in com.caoccao.javet.enums
+
+
The enum Javet promise reject event represents the corresponding event in V8.
+
+
JavetProxyConverter - Class in com.caoccao.javet.interop.converters
+
+
The type Javet proxy converter.
+
+
JavetProxyConverter() - Constructor for class com.caoccao.javet.interop.converters.JavetProxyConverter
+
+
Instantiates a new Javet proxy converter.
+
+
JavetReflectionUtils - Class in com.caoccao.javet.utils
+
+
The type Javet reflection utils.
+
+
JavetResourceUtils - Class in com.caoccao.javet.utils
+
+
The type Javet resource utils.
+
+
JavetScriptingError - Class in com.caoccao.javet.exceptions
+
 
+
JavetScriptingError(String, String, String, int, int, int, int, int) - Constructor for class com.caoccao.javet.exceptions.JavetScriptingError
+
 
+
JavetStandardConsoleInterceptor - Class in com.caoccao.javet.interception.logging
+
+
The type Javet standard console interceptor.
+
+
JavetStandardConsoleInterceptor(V8Runtime) - Constructor for class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
+
Instantiates a new Javet standard console interceptor.
+
+
JavetTerminatedException - Exception in com.caoccao.javet.exceptions
+
 
+
JavetTerminatedException(boolean) - Constructor for exception com.caoccao.javet.exceptions.JavetTerminatedException
+
 
+
JavetUniversalInterceptor(V8Runtime, Object, String, List<Method>) - Constructor for class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler.JavetUniversalInterceptor
+
+
Instantiates a new Javet universal interceptor.
+
+
JavetUniversalProxyHandler<T> - Class in com.caoccao.javet.interop.proxy
+
+
The type Javet universal proxy handler.
+
+
JavetUniversalProxyHandler(V8Runtime, T) - Constructor for class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
Instantiates a new Javet universal proxy handler.
+
+
JavetUniversalProxyHandler.JavetUniversalInterceptor - Class in com.caoccao.javet.interop.proxy
+
+
The type Javet universal interceptor.
+
+
JavetUniversalProxyHandler.ScoredExecutable<E extends java.lang.reflect.Executable> - Class in com.caoccao.javet.interop.proxy
+
+
The type Scored executable.
+
+
JavetVirtualObject - Class in com.caoccao.javet.utils
+
+
The type Javet virtual object.
+
+
JavetVirtualObject(V8Value) - Constructor for class com.caoccao.javet.utils.JavetVirtualObject
+
+
Instantiates a new Javet virtual object.
+
+
JS_FUNCTION_DEBUG - Static variable in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
The constant JS_FUNCTION_DEBUG.
+
+
JS_FUNCTION_ERROR - Static variable in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
The constant JS_FUNCTION_ERROR.
+
+
JS_FUNCTION_INFO - Static variable in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
The constant JS_FUNCTION_INFO.
+
+
JS_FUNCTION_LOG - Static variable in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
The constant JS_FUNCTION_LOG.
+
+
JS_FUNCTION_TRACE - Static variable in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
The constant JS_FUNCTION_TRACE.
+
+
JS_FUNCTION_WARN - Static variable in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
The constant JS_FUNCTION_WARN.
+
+
jsFunctionType - Variable in class com.caoccao.javet.entities.JavetEntityFunction
+
+
The JS function type.
+
+
JSFunctionType - Enum in com.caoccao.javet.enums
+
 
+
jsFunctionType - Variable in class com.caoccao.javet.values.reference.V8ValueFunction
+
 
+
JSRuntimeType - Enum in com.caoccao.javet.enums
+
 
+
JSScopeType - Enum in com.caoccao.javet.enums
+
 
+
+ + + +

K

+
+
keyFor(V8ValueSymbol) - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
+ + + +

L

+
+
lastActiveZonedDatetime - Variable in class com.caoccao.javet.interop.engine.JavetEngineUsage
+
 
+
LibraryNotFound - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
LibraryNotLoaded - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
LINE_SEPARATOR - Static variable in class com.caoccao.javet.utils.JavetOSUtils
+
 
+
load() - Method in class com.caoccao.javet.interop.JavetLibLoader
+
 
+
loadLibrary() - Method in class com.caoccao.javet.interop.V8Host
+
+
Load library.
+
+
LockAcquisitionFailure - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
LockConflictThreadIdMismatch - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
LockReleaseFailure - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
lockV8Runtime(long) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
log - Variable in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
+
The Log.
+
+
logDebug(String, Object...) - Method in interface com.caoccao.javet.interfaces.IJavetLogger
+
+
Log debug.
+
+
logError(Throwable, String, Object...) - Method in interface com.caoccao.javet.interfaces.IJavetLogger
+
+
Log error.
+
+
logError(String, Object...) - Method in interface com.caoccao.javet.interfaces.IJavetLogger
+
+
Log error.
+
+
logger - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
logger - Variable in class com.caoccao.javet.utils.JavetDefaultLogger
+
 
+
logger - Variable in class com.caoccao.javet.utils.JavetPromiseRejectCallback
+
 
+
logInfo(String, Object...) - Method in interface com.caoccao.javet.interfaces.IJavetLogger
+
+
Log info.
+
+
logWarn(String, Object...) - Method in interface com.caoccao.javet.interfaces.IJavetLogger
+
+
Log warn.
+
+
lowMemoryNotification(long) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
lowMemoryNotification() - Method in class com.caoccao.javet.interop.V8Runtime
+
+
Send low memory notification to current V8 isolate.
+
+
+ + + +

M

+
+
markAsHandled() - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Mark as handled.
+
+
markAsHandled() - Method in class com.caoccao.javet.values.reference.V8ValuePromise
+
 
+
maxDepth - Variable in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
The Max depth.
+
+
MESSAGE - Static variable in class com.caoccao.javet.values.reference.V8ValueError
+
 
+
method - Variable in class com.caoccao.javet.interop.binding.MethodDescriptor
+
+
The Method.
+
+
METHOD_NAME_CONSTRUCT - Static variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The constant METHOD_NAME_CONSTRUCT.
+
+
METHOD_NAME_CONSTRUCTOR - Static variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The constant METHOD_NAME_CONSTRUCTOR.
+
+
METHOD_NAME_FROM_MAP - Static variable in class com.caoccao.javet.interop.converters.JavetObjectConverter
+
+
The constant METHOD_NAME_FROM_MAP.
+
+
METHOD_NAME_TO_MAP - Static variable in class com.caoccao.javet.interop.converters.JavetObjectConverter
+
+
The constant METHOD_NAME_TO_MAP.
+
+
METHOD_PREFIX_GET - Static variable in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
METHOD_PREFIX_IS - Static variable in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
METHOD_PREFIX_SET - Static variable in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
MethodDescriptor - Class in com.caoccao.javet.interop.binding
+
+
The type Method descriptor.
+
+
MethodDescriptor(Method, boolean) - Constructor for class com.caoccao.javet.interop.binding.MethodDescriptor
+
+
Instantiates a new Method descriptor.
+
+
MethodDescriptor(Method, boolean, V8ValueSymbolType) - Constructor for class com.caoccao.javet.interop.binding.MethodDescriptor
+
+
Instantiates a new Method descriptor.
+
+
methodsMap - Variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The Methods map.
+
+
moduleEvaluate(long, long, int, boolean) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
moduleEvaluate(IV8Module, boolean) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
moduleGetException(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
moduleGetException(IV8Module) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
moduleGetNamespace(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
moduleGetNamespace(IV8Module) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
moduleGetScriptId(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
moduleGetScriptId(IV8Module) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
moduleGetStatus(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
moduleGetStatus(IV8Module) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
moduleInstantiate(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
moduleInstantiate(IV8Module) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
ModuleNameEmpty - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
ModuleNotFound - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
moduleObject - Variable in class com.caoccao.javet.node.modules.BaseNodeModule
+
 
+
ModulePermissionDenied - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
+ + + +

N

+
+
name - Variable in class com.caoccao.javet.node.modules.BaseNodeModule
+
 
+
name - Variable in class com.caoccao.javet.utils.JavetDefaultLogger
+
 
+
NodeModule - Annotation Type in com.caoccao.javet.annotations
+
+
The annotation Node module.
+
+
NodeModuleAny - Class in com.caoccao.javet.node.modules
+
 
+
NodeModuleAny(V8ValueObject, String) - Constructor for class com.caoccao.javet.node.modules.NodeModuleAny
+
 
+
nodeModuleMap - Variable in class com.caoccao.javet.interop.NodeRuntime
+
 
+
NodeModuleModule - Class in com.caoccao.javet.node.modules
+
 
+
NodeModuleModule(V8ValueObject, String) - Constructor for class com.caoccao.javet.node.modules.NodeModuleModule
+
 
+
NodeModuleProcess - Class in com.caoccao.javet.node.modules
+
 
+
NodeModuleProcess(V8ValueObject, String) - Constructor for class com.caoccao.javet.node.modules.NodeModuleProcess
+
 
+
NodeRuntime - Class in com.caoccao.javet.interop
+
+
Node runtime is a thin wrapper over V8 runtime.
+
+
NotSupported - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
NULL - Static variable in class com.caoccao.javet.values.primitive.V8ValueNull
+
 
+
+ + + +

O

+
+
object - Variable in class com.caoccao.javet.utils.JavetVirtualObject
+
+
The Object.
+
+
of(K, V) - Static method in class com.caoccao.javet.utils.SimpleMap
+
 
+
of(K, V, K, V) - Static method in class com.caoccao.javet.utils.SimpleMap
+
 
+
of(K, V, K, V, K, V) - Static method in class com.caoccao.javet.utils.SimpleMap
+
 
+
of(K, V, K, V, K, V, K, V) - Static method in class com.caoccao.javet.utils.SimpleMap
+
 
+
of(K, V, K, V, K, V, K, V, K, V) - Static method in class com.caoccao.javet.utils.SimpleMap
+
 
+
of(K, V, K, V, K, V, K, V, K, V, K, V) - Static method in class com.caoccao.javet.utils.SimpleMap
+
 
+
of(K, V, K, V, K, V, K, V, K, V, K, V, K, V) - Static method in class com.caoccao.javet.utils.SimpleMap
+
 
+
of(K, V, K, V, K, V, K, V, K, V, K, V, K, V, K, V) - Static method in class com.caoccao.javet.utils.SimpleMap
+
 
+
on(String, V8ValueFunction) - Method in class com.caoccao.javet.node.modules.NodeModuleProcess
+
 
+
ONE_BYTE_PER_VALUE - Static variable in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
The constant ONE_BYTE_PER_VALUE.
+
+
OS_NAME - Static variable in class com.caoccao.javet.utils.JavetOSUtils
+
 
+
OSNotSupported - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
ownKeys(V8Value) - Method in interface com.caoccao.javet.interop.proxy.IJavetProxyHandler
+
+
Own keys V8 value.
+
+
ownKeys(V8Value) - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
 
+
+ + + +

P

+
+
PARAMETER_ACTUAL_PARAMETER_SIZE - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_ACTUAL_PARAMETER_TYPE - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_CONTINUABLE - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_COUNT - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_CURRENT_THREAD_ID - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_END_COLUMN - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_END_POSITION - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_EXPECTED_PARAMETER_SIZE - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_EXPECTED_PARAMETER_TYPE - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_FEATURE - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_LINE_NUMBER - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_LOCKED_THREAD_ID - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_MAX_DEPTH - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_MESSAGE - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_METHOD_NAME - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_OS - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_PATH - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_REASON - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_RESOURCE_NAME - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_SOURCE_LINE - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_START_COLUMN - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_START_POSITION - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
PARAMETER_SYMBOL - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
parameters - Variable in exception com.caoccao.javet.exceptions.JavetException
+
 
+
parse(int) - Static method in enum com.caoccao.javet.enums.JavetPromiseRejectEvent
+
+
Parse javet promise reject event by code.
+
+
parse(int) - Static method in enum com.caoccao.javet.enums.JSFunctionType
+
 
+
parse(int) - Static method in enum com.caoccao.javet.enums.JSScopeType
+
 
+
parse(int) - Static method in enum com.caoccao.javet.enums.V8ValueReferenceType
+
 
+
PATTERN_CAPITALIZED_PREFIX - Static variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The constant PATTERN_CAPITALIZED_PREFIX.
+
+
pooled - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
pop() - Method in interface com.caoccao.javet.values.reference.IV8ValueArray
+
 
+
pop() - Method in class com.caoccao.javet.values.reference.V8ValueArray
+
 
+
popBoolean() - Method in interface com.caoccao.javet.values.reference.IV8ValueArray
+
 
+
popDouble() - Method in interface com.caoccao.javet.values.reference.IV8ValueArray
+
 
+
popInteger() - Method in interface com.caoccao.javet.values.reference.IV8ValueArray
+
 
+
popLong() - Method in interface com.caoccao.javet.values.reference.IV8ValueArray
+
 
+
popNull() - Method in interface com.caoccao.javet.values.reference.IV8ValueArray
+
 
+
popObject() - Method in interface com.caoccao.javet.values.reference.IV8ValueArray
+
 
+
popPrimitive() - Method in interface com.caoccao.javet.values.reference.IV8ValueArray
+
 
+
popString() - Method in interface com.caoccao.javet.values.reference.IV8ValueArray
+
 
+
popUndefined() - Method in interface com.caoccao.javet.values.reference.IV8ValueArray
+
 
+
PREFIX_PROPERTY - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
preventExtensions(V8Value) - Method in interface com.caoccao.javet.interop.proxy.IJavetProxyHandler
+
+
Prevent extensions.
+
+
PRIVATE_PROPERTY_CUSTOM_OBJECT_CLASS_NAME - Static variable in class com.caoccao.javet.interop.converters.JavetObjectConverter
+
+
The constant PRIVATE_PROPERTY_CUSTOM_OBJECT_CLASS_NAME.
+
+
PRIVATE_PROPERTY_PROXY_TARGET - Static variable in class com.caoccao.javet.interop.converters.JavetObjectConverter
+
+
The constant PRIVATE_PROPERTY_PROXY_TARGET.
+
+
PROCESS_ID - Static variable in class com.caoccao.javet.utils.JavetOSUtils
+
 
+
promiseCatch(long, long, int, long) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
promiseCatch(IV8ValuePromise, IV8ValueFunction) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
promiseGetPromise(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
promiseGetPromise(V8ValuePromise) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
promiseGetResult(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
promiseGetResult(IV8ValuePromise) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
promiseGetState(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
promiseGetState(IV8ValuePromise) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
promiseHasHandler(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
promiseHasHandler(IV8ValuePromise) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
promiseMarkAsHandled(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
promiseMarkAsHandled(IV8ValuePromise) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
promiseReject(long, long, int, Object) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
promiseReject(V8ValuePromise, V8Value) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
promiseRejectCallback - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
promiseResolve(long, long, int, Object) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
promiseResolve(V8ValuePromise, V8Value) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
promiseThen(long, long, int, long, long) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
promiseThen(IV8ValuePromise, IV8ValueFunction, IV8ValueFunction) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
PROPERTY_ASYNC_ITERATOR - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
PROPERTY_BUFFER - Static variable in class com.caoccao.javet.values.reference.V8ValueDataView
+
+
The constant PROPERTY_BUFFER.
+
+
PROPERTY_BUFFER - Static variable in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
The constant PROPERTY_BUFFER.
+
+
PROPERTY_BYTE_LENGTH - Static variable in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
PROPERTY_BYTE_LENGTH - Static variable in class com.caoccao.javet.values.reference.V8ValueDataView
+
+
The constant PROPERTY_BYTE_LENGTH.
+
+
PROPERTY_BYTE_LENGTH - Static variable in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
The constant PROPERTY_BYTE_LENGTH.
+
+
PROPERTY_BYTE_OFFSET - Static variable in class com.caoccao.javet.values.reference.V8ValueDataView
+
+
The constant PROPERTY_BYTE_OFFSET.
+
+
PROPERTY_BYTE_OFFSET - Static variable in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
The constant PROPERTY_BYTE_OFFSET.
+
+
PROPERTY_CONSOLE - Static variable in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
The constant PROPERTY_CONSOLE.
+
+
PROPERTY_DATA_VIEW - Static variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
PROPERTY_DESCRIPTION - Static variable in class com.caoccao.javet.values.reference.V8ValueSymbol
+
+
The constant PROPERTY_DESCRIPTION.
+
+
PROPERTY_DIRNAME - Static variable in class com.caoccao.javet.interop.NodeRuntime
+
 
+
PROPERTY_DONE - Static variable in class com.caoccao.javet.values.reference.V8ValueArray
+
 
+
PROPERTY_DONE - Static variable in class com.caoccao.javet.values.reference.V8ValueIterator
+
 
+
PROPERTY_FILENAME - Static variable in class com.caoccao.javet.interop.NodeRuntime
+
 
+
PROPERTY_HAS_INSTANCE - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
PROPERTY_IS_CONCAT_SPREADABLE - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
PROPERTY_ITERATOR - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
PROPERTY_JSON - Static variable in class com.caoccao.javet.values.reference.V8ValueGlobalObject
+
 
+
PROPERTY_MATCH - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
PROPERTY_MATCH_ALL - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
PROPERTY_NAME - Static variable in class com.caoccao.javet.interop.converters.JavetObjectConverter
+
+
The constant PROPERTY_NAME.
+
+
PROPERTY_NAME - Static variable in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
The constant PROPERTY_NAME.
+
+
PROPERTY_OBJECT - Static variable in class com.caoccao.javet.values.reference.V8ValueGlobalObject
+
 
+
PROPERTY_PROMISE - Static variable in class com.caoccao.javet.values.reference.V8ValueGlobalObject
+
 
+
PROPERTY_PROTOTYPE - Static variable in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
PROPERTY_REPLACE - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
PROPERTY_REQUIRE - Static variable in class com.caoccao.javet.node.modules.NodeModuleModule
+
 
+
PROPERTY_SEARCH - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
PROPERTY_SPECIES - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
PROPERTY_SPLIT - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
PROPERTY_SYMBOL - Static variable in class com.caoccao.javet.values.reference.V8ValueGlobalObject
+
 
+
PROPERTY_TO_PRIMITIVE - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
PROPERTY_TO_STRING_TAG - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
PROPERTY_UNSCOPABLES - Static variable in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
PROPERTY_VALUE - Static variable in class com.caoccao.javet.values.reference.V8ValueArray
+
 
+
PROPERTY_VALUE - Static variable in class com.caoccao.javet.values.reference.V8ValueIterator
+
 
+
PROPERTY_VERSION - Static variable in class com.caoccao.javet.node.modules.NodeModuleProcess
+
 
+
propertyGetterMap - Variable in class com.caoccao.javet.interop.binding.BindingContext
+
+
The Property getter map.
+
+
propertySetterMap - Variable in class com.caoccao.javet.interop.binding.BindingContext
+
+
The Property setter map.
+
+
proxyGetHandler(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
proxyGetHandler(IV8ValueProxy) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
proxyGetTarget(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
proxyGetTarget(IV8ValueProxy) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
proxyIsRevoked(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
proxyIsRevoked(IV8ValueProxy) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
proxyMapEnabled - Variable in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
The Proxy map enabled.
+
+
proxyRevoke(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
proxyRevoke(IV8ValueProxy) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
proxySetEnabled - Variable in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
The Proxy set enabled.
+
+
PUBLIC_PROPERTY_CONSTRUCTOR - Static variable in class com.caoccao.javet.interop.converters.JavetObjectConverter
+
+
The constant PUBLIC_PROPERTY_CONSTRUCTOR.
+
+
push(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueArray
+
 
+
push(Object) - Method in class com.caoccao.javet.values.reference.V8ValueArray
+
 
+
pushNull() - Method in interface com.caoccao.javet.values.reference.IV8ValueArray
+
 
+
pushUndefined() - Method in interface com.caoccao.javet.values.reference.IV8ValueArray
+
 
+
+ + + +

Q

+
+
quitting - Variable in class com.caoccao.javet.interop.engine.JavetEngineGuard
+
+
The Quitting.
+
+
quitting - Variable in class com.caoccao.javet.interop.engine.JavetEnginePool
+
+
The Quitting.
+
+
+ + + +

R

+
+
race(V8Value) - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
raceVoid(V8Value) - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
receiveCallback(V8Runtime, JavetCallbackContext, V8Value, V8ValueArray) - Static method in class com.caoccao.javet.interop.callback.V8FunctionCallback
+
+
Receive callback V8 value.
+
+
receiveNotification(String) - Method in interface com.caoccao.javet.interop.IV8InspectorListener
+
 
+
receiveNotification(String) - Method in class com.caoccao.javet.interop.V8Inspector
+
 
+
receivePromiseRejectCallback(int, V8ValuePromise, V8Value) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
receiveResponse(String) - Method in interface com.caoccao.javet.interop.IV8InspectorListener
+
 
+
receiveResponse(String) - Method in class com.caoccao.javet.interop.V8Inspector
+
 
+
referenceLock - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
referenceMap - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
register(IV8ValueObject...) - Method in class com.caoccao.javet.interception.BaseJavetInterceptor
+
 
+
register(IV8ValueObject...) - Method in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
 
+
register(IV8ValueObject, String, String) - Method in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
Register a JS function by name.
+
+
register(IV8ValueObject...) - Method in interface com.caoccao.javet.interfaces.IJavetInterceptor
+
+
Register the interceptor to the given V8 value object.
+
+
registerCustomObject(Class<?>) - Method in class com.caoccao.javet.interop.converters.JavetObjectConverter
+
+
Register custom object.
+
+
registerCustomObject(Class<?>, String, String) - Method in class com.caoccao.javet.interop.converters.JavetObjectConverter
+
+
Register custom object.
+
+
registerListeners() - Method in class com.caoccao.javet.interop.V8Notifier
+
 
+
registerV8Runtime(long, Object) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
reject(V8Value) - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
reject(V8Value) - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Reject.
+
+
reject(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Reject.
+
+
reject(V8Value) - Method in class com.caoccao.javet.values.reference.V8ValuePromise
+
 
+
rejectVoid(V8Value) - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
releaseEngine(IJavetEngine<R>) - Method in interface com.caoccao.javet.interop.engine.IJavetEnginePool
+
 
+
releaseEngine(IJavetEngine<R>) - Method in class com.caoccao.javet.interop.engine.JavetEnginePool
+
 
+
removeAllReferences() - Method in class com.caoccao.javet.interop.NodeRuntime
+
 
+
removeAllReferences() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
removeCallbackContext(long) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
removeCallbackContexts() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
removeJNIGlobalRef(long) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
removeJNIGlobalRef(long) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
removeListeners(IV8InspectorListener...) - Method in class com.caoccao.javet.interop.V8Inspector
+
 
+
removeNodeModule(INodeModule) - Method in class com.caoccao.javet.interop.NodeRuntime
+
 
+
removeNodeModules() - Method in class com.caoccao.javet.interop.NodeRuntime
+
 
+
removeReference(IV8ValueReference) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
removeReference() - Method in class com.caoccao.javet.values.reference.V8ValueGlobalObject
+
 
+
removeReference() - Method in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
removeReferenceHandle(long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
removeReferences() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
removeV8Module(String, boolean) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
removeV8Module(String) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
removeV8Module(IV8Module) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
removeV8Module(IV8Module, boolean) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
removeV8Modules() - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
removeV8Modules(boolean) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
requestGarbageCollectionForTesting(long, boolean) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
requestGarbageCollectionForTesting(boolean) - Method in class com.caoccao.javet.interop.V8Runtime
+
+
Requests GC for testing.
+
+
reset() - Method in interface com.caoccao.javet.interfaces.IJavetResettable
+
+
Reset.
+
+
reset() - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
reset() - Method in class com.caoccao.javet.interop.engine.JavetEngineUsage
+
 
+
resetContext() - Method in interface com.caoccao.javet.interop.engine.IJavetEngine
+
 
+
resetContext() - Method in class com.caoccao.javet.interop.engine.JavetEngine
+
 
+
resetContext() - Method in class com.caoccao.javet.interop.V8Runtime
+
+
Reset V8 context.
+
+
resetIsolate() - Method in interface com.caoccao.javet.interop.engine.IJavetEngine
+
 
+
resetIsolate() - Method in class com.caoccao.javet.interop.engine.JavetEngine
+
 
+
resetIsolate() - Method in class com.caoccao.javet.interop.V8Runtime
+
+
Reset V8 isolate.
+
+
resetV8Context(long, String) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
resetV8Isolate(long, String) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
resolve(V8Runtime, String, IV8Module) - Method in interface com.caoccao.javet.interfaces.IV8ModuleResolver
+
+
Resolve V8 module.
+
+
resolve(V8Value) - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
resolve(V8Value) - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Resolve.
+
+
resolve(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Resolve.
+
+
resolve(V8Value) - Method in class com.caoccao.javet.values.reference.V8ValuePromise
+
 
+
resolveVoid(V8Value) - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
resourceName - Variable in class com.caoccao.javet.values.reference.V8Module
+
 
+
resourceName - Variable in class com.caoccao.javet.values.reference.V8Script
+
 
+
revoke() - Method in interface com.caoccao.javet.values.reference.IV8ValueProxy
+
+
Revoke.
+
+
revoke() - Method in class com.caoccao.javet.values.reference.V8ValueProxy
+
 
+
run() - Method in class com.caoccao.javet.interop.engine.JavetEngineGuard
+
 
+
run() - Method in class com.caoccao.javet.interop.engine.JavetEnginePool
+
 
+
runIfWaitingForDebugger(int) - Method in interface com.caoccao.javet.interop.IV8InspectorListener
+
 
+
runIfWaitingForDebugger(int) - Method in class com.caoccao.javet.interop.V8Inspector
+
 
+
RuntimeAlreadyClosed - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
RuntimeAlreadyRegistered - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
RuntimeCloseFailure - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
RuntimeLeakageDetected - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
RuntimeNotRegistered - Static variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
+ + + +

S

+
+
safeClose(Object...) - Static method in class com.caoccao.javet.utils.JavetResourceUtils
+
+
Safe close.
+
+
safeClose(Object) - Static method in class com.caoccao.javet.utils.JavetResourceUtils
+
+
Safe close.
+
+
safeSetAccessible(AccessibleObject) - Static method in class com.caoccao.javet.utils.JavetReflectionUtils
+
+
Safe set accessible.
+
+
sameValue(long, long, long) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
sameValue(IV8ValueObject, IV8ValueObject) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
sameValue(V8Value) - Method in interface com.caoccao.javet.values.IV8Value
+
+
Same value.
+
+
sameValue(V8Value) - Method in class com.caoccao.javet.values.primitive.V8ValueNull
+
 
+
sameValue(V8Value) - Method in class com.caoccao.javet.values.primitive.V8ValuePrimitive
+
 
+
sameValue(V8Value) - Method in class com.caoccao.javet.values.primitive.V8ValueUndefined
+
 
+
sameValue(V8Value) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
sameValue(V8Value) - Method in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
sameValue(V8Value) - Method in class com.caoccao.javet.values.V8Value
+
 
+
ScoredExecutable(V8Runtime, Object, E, JavetVirtualObject[]) - Constructor for class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler.ScoredExecutable
+
+
Instantiates a new Scored executable.
+
+
scriptingError - Variable in exception com.caoccao.javet.exceptions.BaseJavetScriptingException
+
 
+
scriptPath - Variable in class com.caoccao.javet.interop.executors.V8PathExecutor
+
 
+
scriptRun(long, long, int, boolean) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
scriptRun(IV8Script, boolean) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
scriptString - Variable in class com.caoccao.javet.interop.executors.V8StringExecutor
+
 
+
seal() - Method in class com.caoccao.javet.interop.V8Flags
+
 
+
sendGCNotification() - Method in interface com.caoccao.javet.interop.engine.IJavetEngine
+
 
+
sendGCNotification() - Method in class com.caoccao.javet.interop.engine.JavetEngine
+
 
+
sendRequest(String) - Method in interface com.caoccao.javet.interop.IV8InspectorListener
+
 
+
sendRequest(String) - Method in class com.caoccao.javet.interop.V8Inspector
+
 
+
set(long, long, int, Object, Object) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
set(V8Value, V8Value, V8Value, V8Value) - Method in interface com.caoccao.javet.interop.proxy.IJavetProxyHandler
+
+
Set value by property.
+
+
set(V8Value, V8Value, V8Value, V8Value) - Method in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
 
+
set(IV8ValueObject, V8Value, V8Value) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
set(Object, Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Set boolean.
+
+
set(Object, Object) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
set(Object, Object) - Method in class com.caoccao.javet.values.reference.V8ValueWeakMap
+
 
+
setAccessor(long, long, int, Object, Object, Object) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
setAccessor(IV8ValueObject, V8Value, JavetCallbackContext, JavetCallbackContext) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
setActive(boolean) - Method in class com.caoccao.javet.interop.engine.JavetEngine
+
 
+
setAllowEval(boolean) - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
setAllowNativesSyntax(boolean) - Method in class com.caoccao.javet.interop.V8Flags
+
 
+
setAutoSendGCNotification(boolean) - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
setBigInt64(int, long) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
setBigInt64(int, long, boolean) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
setByteOrder(ByteOrder) - Method in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
setConfig(JavetConverterConfig) - Method in class com.caoccao.javet.interop.converters.JavetPrimitiveConverter
+
+
Sets config.
+
+
setConverter(IJavetConverter) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
setDebug(PrintStream) - Method in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
+
Sets debug.
+
+
setDefaultBoolean(boolean) - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Sets default boolean.
+
+
setDefaultByte(byte) - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Sets default byte.
+
+
setDefaultChar(char) - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Sets default char.
+
+
setDefaultDouble(double) - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Sets default double.
+
+
setDefaultEngineGuardTimeoutMillis(int) - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
setDefaultFloat(float) - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Sets default float.
+
+
setDefaultInt(int) - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Sets default int.
+
+
setDefaultLong(long) - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Sets default long.
+
+
setDefaultShort(short) - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Sets default short.
+
+
setEndColumn(int) - Method in class com.caoccao.javet.exceptions.JavetScriptingError
+
 
+
setEndPosition(int) - Method in class com.caoccao.javet.exceptions.JavetScriptingError
+
 
+
setEngineGuardCheckIntervalMillis(int) - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
setError(PrintStream) - Method in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
+
Sets error.
+
+
setExposeGC(boolean) - Method in class com.caoccao.javet.interop.V8Flags
+
 
+
setExposeInspectorScripts(boolean) - Method in class com.caoccao.javet.interop.V8Flags
+
 
+
setExtractFunctionSourceCode(boolean) - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Sets extract function source code.
+
+
setFlags(String) - Method in interface com.caoccao.javet.interop.IV8Native
+
+
Sets flags.
+
+
setFlags() - Method in class com.caoccao.javet.interop.V8Host
+
+
Sets flags.
+
+
setFloat32(int, float) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
setFloat32(int, float, boolean) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
setFloat64(int, double) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
setFloat64(int, double, boolean) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
setGcBeforeEngineClose(boolean) - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
setGCScheduled(boolean) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
setGlobalName(String) - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
setGlobalName(String) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
setHandle(long) - Method in class com.caoccao.javet.interop.callback.JavetCallbackContext
+
+
Sets handle.
+
+
setInfo(PrintStream) - Method in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
+
Sets info.
+
+
setInt16(int, short) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
setInt16(int, short, boolean) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
setInt32(int, int) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
setInt32(int, int, boolean) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
setInt8(int, byte) - Method in class com.caoccao.javet.values.reference.V8ValueDataView
+
 
+
setJavetLogger(IJavetLogger) - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
setJSFunctionType(JSFunctionType) - Method in class com.caoccao.javet.entities.JavetEntityFunction
+
 
+
setJSFunctionType(JSFunctionType) - Method in interface com.caoccao.javet.interfaces.IJavetEntityFunction
+
+
Sets JS function type.
+
+
setJSRuntimeType(JSRuntimeType) - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
setLastActiveZonedDatetime(ZonedDateTime) - Method in class com.caoccao.javet.interop.engine.JavetEngineUsage
+
 
+
setLibraryReloadable(boolean) - Static method in class com.caoccao.javet.interop.V8Host
+
+
Sets whether the JNI library is reloadable or not.
+
+
setLineNumber(int) - Method in class com.caoccao.javet.exceptions.JavetScriptingError
+
 
+
setLog(PrintStream) - Method in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
+
Sets log.
+
+
setLogger(IJavetLogger) - Method in class com.caoccao.javet.interop.V8Inspector
+
 
+
setLogger(IJavetLogger) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
setMaxDepth(int) - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Sets max depth.
+
+
setMemoryUsageThresholdRatio(double) - Static method in class com.caoccao.javet.interop.V8Host
+
+
Sets memory usage threshold ratio.
+
+
setMessage(String) - Method in class com.caoccao.javet.exceptions.JavetScriptingError
+
 
+
setModule(boolean) - Method in interface com.caoccao.javet.interop.executors.IV8Executor
+
 
+
setModule(boolean) - Method in class com.caoccao.javet.interop.V8ScriptOrigin
+
 
+
setNull(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Sets null.
+
+
setPoolDaemonCheckIntervalMillis(int) - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
setPoolIdleTimeoutSeconds(int) - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
setPoolMaxSize(int) - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
setPoolMinSize(int) - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
setPoolShutdownTimeoutSeconds(int) - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
setPrivateProperty(long, long, int, String, Object) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
setPrivateProperty(IV8ValueObject, String, V8Value) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
setPrivateProperty(String, Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Sets private property.
+
+
setPrivateProperty(String, Object) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
setPrivatePropertyNull(String) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Sets private property null.
+
+
setPrivatePropertyUndefined(String) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Sets private property undefined.
+
+
setPromiseRejectCallback(IJavetPromiseRejectCallback) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
setProperty(long, long, int, Object, Object) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
setProperty(IV8ValueObject, V8Value, V8Value) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
setProperty(Object, Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Sets property.
+
+
setProperty(Object, Object) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
setPropertyNull(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Sets property null.
+
+
setPropertyUndefined(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Sets property undefined.
+
+
setPrototype(long, long, int, long) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
setPrototype(IV8ValueObject, IV8ValueObject) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
setPrototype(IV8ValueObject) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Sets prototype.
+
+
setPrototype(IV8ValueObject) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
setPrototypeOf(V8Value, V8Value) - Method in interface com.caoccao.javet.interop.proxy.IJavetProxyHandler
+
+
Sets prototype of.
+
+
setProxyMapEnabled(boolean) - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Sets proxy map enabled.
+
+
setProxySetEnabled(boolean) - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Sets proxy set enabled.
+
+
setRequireRootDirectory(Path) - Method in class com.caoccao.javet.node.modules.NodeModuleModule
+
 
+
setResetEngineTimeoutSeconds(int) - Method in class com.caoccao.javet.interop.engine.JavetEngineConfig
+
 
+
setResourceColumnOffset(int) - Method in class com.caoccao.javet.interop.V8ScriptOrigin
+
 
+
setResourceLineOffset(int) - Method in class com.caoccao.javet.interop.V8ScriptOrigin
+
 
+
setResourceName(String) - Method in class com.caoccao.javet.exceptions.JavetScriptingError
+
 
+
setResourceName(String) - Method in interface com.caoccao.javet.interop.executors.IV8Executor
+
 
+
setResourceName(String) - Method in class com.caoccao.javet.interop.V8ScriptOrigin
+
 
+
setResourceName(String) - Method in interface com.caoccao.javet.values.reference.IV8Module
+
 
+
setResourceName(String) - Method in interface com.caoccao.javet.values.reference.IV8Script
+
 
+
setResourceName(String) - Method in class com.caoccao.javet.values.reference.V8Module
+
 
+
setResourceName(String) - Method in class com.caoccao.javet.values.reference.V8Script
+
 
+
setScriptId(int) - Method in class com.caoccao.javet.interop.V8ScriptOrigin
+
 
+
setSkipFunctionInObject(boolean) - Method in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
Sets skip functions.
+
+
setSourceCode(String) - Method in class com.caoccao.javet.entities.JavetEntityFunction
+
 
+
setSourceCode(String) - Method in interface com.caoccao.javet.interfaces.IJavetEntityFunction
+
+
Sets source code.
+
+
setSourceCode(long, long, int, String) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
setSourceCode(IV8ValueFunction, String) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
setSourceCode(String) - Method in interface com.caoccao.javet.values.reference.IV8ValueFunction
+
+
Sets source code.
+
+
setSourceCode(String) - Method in class com.caoccao.javet.values.reference.V8ValueFunction
+
 
+
setSourceLine(String) - Method in class com.caoccao.javet.exceptions.JavetScriptingError
+
 
+
setStartColumn(int) - Method in class com.caoccao.javet.exceptions.JavetScriptingError
+
 
+
setStartPosition(int) - Method in class com.caoccao.javet.exceptions.JavetScriptingError
+
 
+
SETTER_PREFIX_ARRAY - Static variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The constant SETTER_PREFIX_ARRAY.
+
+
settersMap - Variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The Setters map.
+
+
setTimeoutMillis(long) - Method in interface com.caoccao.javet.interop.engine.IJavetEngineGuard
+
+
Sets timeout millis.
+
+
setTimeoutMillis(long) - Method in class com.caoccao.javet.interop.engine.JavetEngineGuard
+
 
+
setTrace(PrintStream) - Method in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
+
Sets trace.
+
+
setTrackRetainingPath(boolean) - Method in class com.caoccao.javet.interop.V8Flags
+
 
+
setType(V8ValueReferenceType) - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
Sets type.
+
+
setUndefined(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Sets undefined.
+
+
setUseStrict(boolean) - Method in class com.caoccao.javet.interop.V8Flags
+
 
+
setV8BindEnabler(Method) - Method in class com.caoccao.javet.interop.binding.BindingContext
+
+
Sets V8 bind enabler.
+
+
setV8ModuleResolver(IV8ModuleResolver) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
setV8Runtime(V8Runtime) - Method in interface com.caoccao.javet.values.IV8Value
+
+
Sets V8 runtime.
+
+
setV8Runtime(V8Runtime) - Method in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
setV8Runtime(V8Runtime) - Method in class com.caoccao.javet.values.V8Value
+
 
+
setV8RuntimeSetter(Method) - Method in class com.caoccao.javet.interop.binding.BindingContext
+
+
Sets V8 runtime setter.
+
+
setWarn(PrintStream) - Method in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
+
Sets warn.
+
+
setWasm(boolean) - Method in class com.caoccao.javet.interop.V8ScriptOrigin
+
 
+
setWeak(long, long, int, Object) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
setWeak(IV8ValueReference) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
setWeak() - Method in interface com.caoccao.javet.values.reference.IV8ValueReference
+
 
+
setWeak() - Method in class com.caoccao.javet.values.reference.V8ValueGlobalObject
+
 
+
setWeak() - Method in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
setWorkingDirectory(Path) - Method in class com.caoccao.javet.node.modules.NodeModuleProcess
+
 
+
SimpleFreeMarkerFormat - Class in com.caoccao.javet.utils
+
 
+
SimpleFreeMarkerFormat() - Constructor for class com.caoccao.javet.utils.SimpleFreeMarkerFormat
+
 
+
SimpleMap - Class in com.caoccao.javet.utils
+
+
The type Simple map is a polyfill because Map.of is not available at JDK 8 .
+
+
SimpleMap() - Constructor for class com.caoccao.javet.utils.SimpleMap
+
 
+
sizeInBytes - Variable in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
The Size in bytes.
+
+
skipFunctionInObject - Variable in class com.caoccao.javet.interop.converters.JavetConverterConfig
+
+
This flag determines whether function should be skipped in object or not.
+
+
skipInDebugMode - Variable in class com.caoccao.javet.interop.engine.JavetEngineGuard
+
+
The Skip in debug mode.
+
+
sourceCode - Variable in class com.caoccao.javet.entities.JavetEntityFunction
+
+
The Source code.
+
+
SPACE - Static variable in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
+
The constant SPACE.
+
+
STACK - Static variable in class com.caoccao.javet.values.reference.V8ValueError
+
 
+
startDaemon() - Method in class com.caoccao.javet.interop.engine.JavetEnginePool
+
+
Start daemon.
+
+
STATE_FULFILLED - Static variable in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
The constant STATE_FULFILLED.
+
+
STATE_PENDING - Static variable in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
The constant STATE_PENDING.
+
+
STATE_REJECTED - Static variable in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
The constant STATE_REJECTED.
+
+
stopDaemon() - Method in class com.caoccao.javet.interop.engine.JavetEnginePool
+
+
Stop daemon.
+
+
strictEquals(long, long, long) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
strictEquals(IV8ValueObject, IV8ValueObject) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
strictEquals(V8Value) - Method in interface com.caoccao.javet.values.IV8Value
+
+
Strict equals boolean.
+
+
strictEquals(V8Value) - Method in class com.caoccao.javet.values.primitive.V8ValueNull
+
 
+
strictEquals(V8Value) - Method in class com.caoccao.javet.values.primitive.V8ValuePrimitive
+
 
+
strictEquals(V8Value) - Method in class com.caoccao.javet.values.primitive.V8ValueUndefined
+
 
+
strictEquals(V8Value) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
strictEquals(V8Value) - Method in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
strictEquals(V8Value) - Method in class com.caoccao.javet.values.V8Value
+
 
+
STRING_NULL - Static variable in class com.caoccao.javet.utils.SimpleFreeMarkerFormat
+
 
+
stringify(V8Value) - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInJson
+
 
+
symbolType - Variable in class com.caoccao.javet.interop.binding.MethodDescriptor
+
+
The Symbol type.
+
+
+ + + +

T

+
+
targetClass - Variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The Target class.
+
+
targetObject - Variable in class com.caoccao.javet.interop.proxy.BaseJavetProxyHandler
+
+
The Target object.
+
+
TEMP_DIRECTORY - Static variable in class com.caoccao.javet.utils.JavetOSUtils
+
 
+
terminateExecution(long) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
terminateExecution() - Method in class com.caoccao.javet.interop.V8Runtime
+
+
Terminate execution.
+
+
then(IV8ValueFunction) - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Then.
+
+
then(IV8ValueFunction, IV8ValueFunction) - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Then.
+
+
then(String) - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Then.
+
+
then(String, String) - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Then.
+
+
then(IV8ValueFunction, IV8ValueFunction) - Method in class com.caoccao.javet.values.reference.V8ValuePromise
+
 
+
thisObjectRequired - Variable in class com.caoccao.javet.interop.binding.MethodDescriptor
+
+
The This object required.
+
+
timeoutMillis - Variable in class com.caoccao.javet.interop.engine.JavetEngineGuard
+
+
The Timeout millis.
+
+
toArray() - Method in interface com.caoccao.javet.values.reference.IV8ValueArray
+
 
+
toBeClosedValues - Variable in class com.caoccao.javet.values.virtual.V8VirtualValueList
+
+
The To be closed values.
+
+
toBytes() - Method in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
toBytes() - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
To byte array.
+
+
toClone() - Method in interface com.caoccao.javet.interop.IV8Cloneable
+
 
+
toClone(V8Value[]) - Static method in class com.caoccao.javet.utils.JavetResourceUtils
+
+
To clone V8 value array.
+
+
toClone() - Method in class com.caoccao.javet.values.primitive.V8ValueBoolean
+
 
+
toClone() - Method in class com.caoccao.javet.values.primitive.V8ValueDouble
+
 
+
toClone() - Method in class com.caoccao.javet.values.primitive.V8ValueInteger
+
 
+
toClone() - Method in class com.caoccao.javet.values.primitive.V8ValueLong
+
 
+
toClone() - Method in class com.caoccao.javet.values.primitive.V8ValueNull
+
 
+
toClone() - Method in class com.caoccao.javet.values.primitive.V8ValueString
+
 
+
toClone() - Method in class com.caoccao.javet.values.primitive.V8ValueUndefined
+
 
+
toClone() - Method in class com.caoccao.javet.values.primitive.V8ValueUnknown
+
 
+
toClone() - Method in class com.caoccao.javet.values.primitive.V8ValueZonedDateTime
+
 
+
toClone() - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInJson
+
 
+
toClone() - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInObject
+
 
+
toClone() - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
toClone() - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
toClone() - Method in class com.caoccao.javet.values.reference.V8Module
+
 
+
toClone() - Method in class com.caoccao.javet.values.reference.V8Script
+
 
+
toClone() - Method in class com.caoccao.javet.values.reference.V8ValueGlobalObject
+
 
+
toClone() - Method in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
toClone() - Method in class com.caoccao.javet.values.reference.V8ValueWeakMap
+
 
+
toClone() - Method in class com.caoccao.javet.values.reference.V8ValueWeakSet
+
 
+
toClone() - Method in class com.caoccao.javet.values.V8Value
+
 
+
toDoubles() - Method in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
toDoubles() - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
To double array.
+
+
toExactPrimitive(Class<?>, Object) - Static method in class com.caoccao.javet.utils.JavetPrimitiveUtils
+
 
+
toFloats() - Method in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
toFloats() - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
To float array.
+
+
toIntegers() - Method in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
toIntegers() - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
To int array.
+
+
toJsonString() - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
To json string.
+
+
toJsonString() - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
toLongs() - Method in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
toLongs() - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
To long array.
+
+
toObject(V8Value) - Method in interface com.caoccao.javet.interop.converters.IJavetConverter
+
+
To object from V8 value.
+
+
toObject(V8Value, boolean) - Method in interface com.caoccao.javet.interop.converters.IJavetConverter
+
+
To object from V8 value and auto close the V8 value.
+
+
toObject(V8Value, int) - Method in class com.caoccao.javet.interop.converters.JavetObjectConverter
+
 
+
toObject(V8Value) - Method in class com.caoccao.javet.interop.converters.JavetPrimitiveConverter
+
 
+
toObject(V8Value, int) - Method in class com.caoccao.javet.interop.converters.JavetPrimitiveConverter
+
+
To object with stack depth.
+
+
toObject(V) - Method in interface com.caoccao.javet.interop.executors.IV8Executor
+
 
+
toObject(V) - Method in interface com.caoccao.javet.interop.IV8Convertible
+
+
Convert from V8 value to object.
+
+
toObject(V, boolean) - Method in interface com.caoccao.javet.interop.IV8Convertible
+
+
Convert from V8 value to object.
+
+
toObject(V) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
toObject(V) - Method in interface com.caoccao.javet.values.reference.IV8Module
+
 
+
toObject(V) - Method in interface com.caoccao.javet.values.reference.IV8Script
+
 
+
toPrimitive() - Method in class com.caoccao.javet.values.primitive.V8ValueBoolean
+
 
+
toPrimitive() - Method in class com.caoccao.javet.values.primitive.V8ValueDouble
+
 
+
toPrimitive() - Method in class com.caoccao.javet.values.primitive.V8ValueInteger
+
 
+
toPrimitive() - Method in class com.caoccao.javet.values.primitive.V8ValueLong
+
 
+
toPrimitive() - Method in class com.caoccao.javet.values.primitive.V8ValueString
+
 
+
toPrimitive() - Method in class com.caoccao.javet.values.primitive.V8ValueZonedDateTime
+
 
+
toProtoString(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
toProtoString(IV8ValueReference) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
toProtoString() - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
To proto string.
+
+
toProtoString() - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
toShorts() - Method in class com.caoccao.javet.values.reference.V8ValueArrayBuffer
+
 
+
toShorts() - Method in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
To short array.
+
+
toString() - Method in class com.caoccao.javet.exceptions.JavetScriptingError
+
 
+
toString(long, long, int) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
toString(IV8ValueReference) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
toString() - Method in class com.caoccao.javet.values.primitive.V8ValueNull
+
 
+
toString() - Method in class com.caoccao.javet.values.primitive.V8ValuePrimitive
+
 
+
toString() - Method in class com.caoccao.javet.values.primitive.V8ValueUndefined
+
 
+
toString() - Method in class com.caoccao.javet.values.reference.V8Module
+
 
+
toString() - Method in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
toString() - Method in class com.caoccao.javet.values.reference.V8ValueSymbol
+
 
+
touchLastActiveZonedDateTime() - Method in class com.caoccao.javet.interop.engine.JavetEngine
+
 
+
toV8Value(V8Runtime, Object) - Method in interface com.caoccao.javet.interop.converters.IJavetConverter
+
+
To V8 value from object.
+
+
toV8Value(V8Runtime, Object, int) - Method in class com.caoccao.javet.interop.converters.JavetObjectConverter
+
 
+
toV8Value(V8Runtime, Object) - Method in class com.caoccao.javet.interop.converters.JavetPrimitiveConverter
+
 
+
toV8Value(V8Runtime, Object, int) - Method in class com.caoccao.javet.interop.converters.JavetPrimitiveConverter
+
+
To V8 value with stack depth.
+
+
toV8Value(V8Runtime, Object, int) - Method in class com.caoccao.javet.interop.converters.JavetProxyConverter
+
 
+
toV8Value(T) - Method in interface com.caoccao.javet.interop.executors.IV8Executor
+
 
+
toV8Value(T) - Method in interface com.caoccao.javet.interop.IV8Convertible
+
+
Convert object to V8 value.
+
+
toV8Value(T) - Method in class com.caoccao.javet.interop.V8Runtime
+
 
+
toV8Value(T) - Method in interface com.caoccao.javet.values.reference.IV8Module
+
 
+
toV8Value(T) - Method in interface com.caoccao.javet.values.reference.IV8Script
+
 
+
toZonedDateTime(long, ZoneId) - Static method in class com.caoccao.javet.utils.JavetDateTimeUtils
+
+
From JS timestamp to zoned date time.
+
+
toZonedDateTime(long) - Static method in class com.caoccao.javet.utils.JavetDateTimeUtils
+
+
From JS timestamp to zoned date time.
+
+
trace - Variable in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
+
The Trace.
+
+
TWO_BYTES_PER_VALUE - Static variable in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
The constant TWO_BYTES_PER_VALUE.
+
+
type - Variable in class com.caoccao.javet.exceptions.JavetError
+
 
+
type - Variable in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
The Type.
+
+
+ + + +

U

+
+
unbind(Object) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Unbind the interception.
+
+
unbind(Object) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
unbindFunction(String) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Unbind function.
+
+
unbindFunction(String) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
unbindProperty(String) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Unbind property.
+
+
unbindProperty(V8ValueString) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Unbind property boolean.
+
+
unbindProperty(V8ValueSymbol) - Method in interface com.caoccao.javet.values.reference.IV8ValueObject
+
+
Unbind property boolean.
+
+
unbindProperty(V8ValueString) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
unbindProperty(V8ValueSymbol) - Method in class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
UNDEFINED - Static variable in class com.caoccao.javet.values.primitive.V8ValueUndefined
+
 
+
Uninstantiated - Static variable in interface com.caoccao.javet.values.reference.IV8Module
+
 
+
uniqueKeySet - Variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The Unique key set.
+
+
unloadLibrary() - Method in class com.caoccao.javet.interop.V8Host
+
+
Unload library.
+
+
unlockV8Runtime(long) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
unregister(IV8ValueObject...) - Method in class com.caoccao.javet.interception.BaseJavetInterceptor
+
 
+
unregister(IV8ValueObject...) - Method in class com.caoccao.javet.interception.logging.BaseJavetConsoleInterceptor
+
 
+
unregister(IV8ValueObject...) - Method in interface com.caoccao.javet.interfaces.IJavetInterceptor
+
+
Unregister the interceptor from the given V8 value object.
+
+
unregisterCustomObject(Class<?>) - Method in class com.caoccao.javet.interop.converters.JavetObjectConverter
+
+
Unregister custom object.
+
+
unregisterListener() - Method in class com.caoccao.javet.interop.V8Notifier
+
 
+
usage - Variable in class com.caoccao.javet.interop.engine.JavetEngine
+
 
+
+ + + +

V

+
+
V8_VALUE_BOOLEAN_FALSE_INDEX - Static variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
V8_VALUE_BOOLEAN_TRUE_INDEX - Static variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
V8_VALUE_CLASS - Static variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The constant V8_VALUE_CLASS.
+
+
V8_VALUE_FUNCTION_CLASS - Static variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The constant V8_VALUE_FUNCTION_CLASS.
+
+
V8_VALUE_NUMBER_LOWER_BOUND - Static variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
V8_VALUE_NUMBER_UPPER_BOUND - Static variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
V8_VALUE_OBJECT_CLASS - Static variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The constant V8_VALUE_OBJECT_CLASS.
+
+
V8_VALUE_PROXY_CLASS - Static variable in class com.caoccao.javet.interop.proxy.JavetUniversalProxyHandler
+
+
The constant V8_VALUE_PROXY_CLASS.
+
+
V8BindEnabler - Annotation Type in com.caoccao.javet.annotations
+
+
The interface V8 bind config is for determining whether certain injection is enabled or not.
+
+
v8BindEnabler - Variable in class com.caoccao.javet.interop.binding.BindingContext
+
+
The V8 bind enabler.
+
+
V8Data - Class in com.caoccao.javet.values
+
 
+
V8Data() - Constructor for class com.caoccao.javet.values.V8Data
+
 
+
V8Flags - Class in com.caoccao.javet.interop
+
 
+
V8Function - Annotation Type in com.caoccao.javet.annotations
+
+
The annotation V8 function is for auto-registering JS function interception.
+
+
V8FunctionCallback - Class in com.caoccao.javet.interop.callback
+
+
The type V8 function callback.
+
+
V8FunctionCallback() - Constructor for class com.caoccao.javet.interop.callback.V8FunctionCallback
+
 
+
V8Host - Class in com.caoccao.javet.interop
+
+
The type V8 host.
+
+
v8Host - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
V8Inspector - Class in com.caoccao.javet.interop
+
 
+
v8Inspector - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
v8InspectorSend(long, String) - Method in interface com.caoccao.javet.interop.IV8Native
+
 
+
V8Locker - Class in com.caoccao.javet.interop
+
+
The type V8 locker.
+
+
V8Module - Class in com.caoccao.javet.values.reference
+
 
+
V8Module(long) - Constructor for class com.caoccao.javet.values.reference.V8Module
+
 
+
v8ModuleLock - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
v8ModuleMap - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
v8ModuleResolver - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
v8Native - Variable in class com.caoccao.javet.interop.V8Runtime
+
 
+
V8Notifier - Class in com.caoccao.javet.interop
+
 
+
V8Notifier(ConcurrentHashMap<Long, V8Runtime>) - Constructor for class com.caoccao.javet.interop.V8Notifier
+
 
+
V8PathExecutor - Class in com.caoccao.javet.interop.executors
+
 
+
V8PathExecutor(V8Runtime, Path) - Constructor for class com.caoccao.javet.interop.executors.V8PathExecutor
+
 
+
V8Property - Annotation Type in com.caoccao.javet.annotations
+
+
The interface V8 property is for auto-registering JS property interception.
+
+
v8Runtime - Variable in class com.caoccao.javet.interception.BaseJavetInterceptor
+
 
+
v8Runtime - Variable in class com.caoccao.javet.interop.engine.JavetEngine
+
 
+
v8Runtime - Variable in class com.caoccao.javet.interop.engine.JavetEngineGuard
+
+
The V8 runtime.
+
+
v8Runtime - Variable in class com.caoccao.javet.interop.executors.BaseV8Executor
+
 
+
v8Runtime - Variable in class com.caoccao.javet.interop.proxy.BaseJavetProxyHandler
+
+
The V8 runtime.
+
+
V8Runtime - Class in com.caoccao.javet.interop
+
 
+
v8Runtime - Variable in class com.caoccao.javet.utils.receivers.JavetCallbackReceiver
+
+
The V8 runtime.
+
+
v8Runtime - Variable in class com.caoccao.javet.values.V8Value
+
 
+
V8RuntimeSetter - Annotation Type in com.caoccao.javet.annotations
+
+
The interface V8 runtime setter.
+
+
v8RuntimeSetter - Variable in class com.caoccao.javet.interop.binding.BindingContext
+
+
The V8 runtime setter.
+
+
V8Script - Class in com.caoccao.javet.values.reference
+
 
+
V8Script(long) - Constructor for class com.caoccao.javet.values.reference.V8Script
+
 
+
v8ScriptOrigin - Variable in class com.caoccao.javet.interop.executors.BaseV8Executor
+
 
+
V8ScriptOrigin - Class in com.caoccao.javet.interop
+
 
+
V8ScriptOrigin(String, int, int, int, boolean, boolean) - Constructor for class com.caoccao.javet.interop.V8ScriptOrigin
+
 
+
V8ScriptOrigin() - Constructor for class com.caoccao.javet.interop.V8ScriptOrigin
+
 
+
V8ScriptOrigin(String) - Constructor for class com.caoccao.javet.interop.V8ScriptOrigin
+
 
+
V8ScriptOrigin(String, int, int) - Constructor for class com.caoccao.javet.interop.V8ScriptOrigin
+
 
+
V8ScriptOrigin(String, int) - Constructor for class com.caoccao.javet.interop.V8ScriptOrigin
+
 
+
V8StringExecutor - Class in com.caoccao.javet.interop.executors
+
 
+
V8StringExecutor(V8Runtime) - Constructor for class com.caoccao.javet.interop.executors.V8StringExecutor
+
 
+
V8StringExecutor(V8Runtime, String) - Constructor for class com.caoccao.javet.interop.executors.V8StringExecutor
+
 
+
v8Value - Variable in class com.caoccao.javet.utils.JavetVirtualObject
+
+
The V8 value.
+
+
V8Value - Class in com.caoccao.javet.values
+
 
+
V8Value() - Constructor for class com.caoccao.javet.values.V8Value
+
 
+
V8ValueArguments - Class in com.caoccao.javet.values.reference
+
 
+
V8ValueArray - Class in com.caoccao.javet.values.reference
+
 
+
V8ValueArrayBuffer - Class in com.caoccao.javet.values.reference
+
 
+
V8ValueBoolean - Class in com.caoccao.javet.values.primitive
+
 
+
V8ValueBoolean() - Constructor for class com.caoccao.javet.values.primitive.V8ValueBoolean
+
 
+
V8ValueBoolean(boolean) - Constructor for class com.caoccao.javet.values.primitive.V8ValueBoolean
+
 
+
V8ValueBuiltInJson - Class in com.caoccao.javet.values.reference.builtin
+
 
+
V8ValueBuiltInJson(long) - Constructor for class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInJson
+
 
+
V8ValueBuiltInObject - Class in com.caoccao.javet.values.reference.builtin
+
+
The type V8 value built in object.
+
+
V8ValueBuiltInObject(long) - Constructor for class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInObject
+
+
Instantiates a new V 8 value built in object.
+
+
V8ValueBuiltInPromise - Class in com.caoccao.javet.values.reference.builtin
+
 
+
V8ValueBuiltInPromise(long) - Constructor for class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInPromise
+
 
+
V8ValueBuiltInSymbol - Class in com.caoccao.javet.values.reference.builtin
+
 
+
V8ValueBuiltInSymbol(long) - Constructor for class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
V8ValueDataView - Class in com.caoccao.javet.values.reference
+
 
+
V8ValueDouble - Class in com.caoccao.javet.values.primitive
+
 
+
V8ValueDouble() - Constructor for class com.caoccao.javet.values.primitive.V8ValueDouble
+
 
+
V8ValueDouble(double) - Constructor for class com.caoccao.javet.values.primitive.V8ValueDouble
+
 
+
V8ValueError - Class in com.caoccao.javet.values.reference
+
 
+
V8ValueFunction - Class in com.caoccao.javet.values.reference
+
 
+
V8ValueFunction(long) - Constructor for class com.caoccao.javet.values.reference.V8ValueFunction
+
 
+
V8ValueGlobalObject - Class in com.caoccao.javet.values.reference
+
+
The type V8 value global object is a special object.
+
+
V8ValueInteger - Class in com.caoccao.javet.values.primitive
+
 
+
V8ValueInteger() - Constructor for class com.caoccao.javet.values.primitive.V8ValueInteger
+
 
+
V8ValueInteger(int) - Constructor for class com.caoccao.javet.values.primitive.V8ValueInteger
+
 
+
V8ValueIterator<T extends V8Value> - Class in com.caoccao.javet.values.reference
+
 
+
V8ValueLong - Class in com.caoccao.javet.values.primitive
+
 
+
V8ValueLong() - Constructor for class com.caoccao.javet.values.primitive.V8ValueLong
+
 
+
V8ValueLong(long) - Constructor for class com.caoccao.javet.values.primitive.V8ValueLong
+
 
+
V8ValueLong(String) - Constructor for class com.caoccao.javet.values.primitive.V8ValueLong
+
 
+
V8ValueMap - Class in com.caoccao.javet.values.reference
+
 
+
V8ValueNull - Class in com.caoccao.javet.values.primitive
+
 
+
V8ValueNull() - Constructor for class com.caoccao.javet.values.primitive.V8ValueNull
+
 
+
V8ValueObject - Class in com.caoccao.javet.values.reference
+
 
+
V8ValueObject(long) - Constructor for class com.caoccao.javet.values.reference.V8ValueObject
+
 
+
V8ValuePrimitive<T> - Class in com.caoccao.javet.values.primitive
+
 
+
V8ValuePrimitive() - Constructor for class com.caoccao.javet.values.primitive.V8ValuePrimitive
+
 
+
V8ValuePrimitive(T) - Constructor for class com.caoccao.javet.values.primitive.V8ValuePrimitive
+
 
+
V8ValuePromise - Class in com.caoccao.javet.values.reference
+
+
The type V8 value promise.
+
+
V8ValueProxy - Class in com.caoccao.javet.values.reference
+
+
The type V8 value proxy.
+
+
V8ValueReference - Class in com.caoccao.javet.values.reference
+
 
+
V8ValueReferenceType - Enum in com.caoccao.javet.enums
+
 
+
V8ValueRegExp - Class in com.caoccao.javet.values.reference
+
 
+
V8ValueSet - Class in com.caoccao.javet.values.reference
+
 
+
V8ValueSharedArrayBuffer - Class in com.caoccao.javet.values.reference
+
 
+
V8ValueString - Class in com.caoccao.javet.values.primitive
+
 
+
V8ValueString() - Constructor for class com.caoccao.javet.values.primitive.V8ValueString
+
 
+
V8ValueString(String) - Constructor for class com.caoccao.javet.values.primitive.V8ValueString
+
 
+
V8ValueSymbol - Class in com.caoccao.javet.values.reference
+
+
The type V8 value symbol.
+
+
V8ValueSymbolObject - Class in com.caoccao.javet.values.reference
+
+
The type V8 value symbol object.
+
+
V8ValueSymbolType - Enum in com.caoccao.javet.enums
+
 
+
V8ValueTypedArray - Class in com.caoccao.javet.values.reference
+
+
The type V8 value typed array.
+
+
V8ValueUndefined - Class in com.caoccao.javet.values.primitive
+
 
+
V8ValueUndefined() - Constructor for class com.caoccao.javet.values.primitive.V8ValueUndefined
+
 
+
V8ValueUnknown - Class in com.caoccao.javet.values.primitive
+
 
+
V8ValueUnknown() - Constructor for class com.caoccao.javet.values.primitive.V8ValueUnknown
+
 
+
V8ValueUnknown(String) - Constructor for class com.caoccao.javet.values.primitive.V8ValueUnknown
+
 
+
V8ValueUtils - Class in com.caoccao.javet.utils
+
+
The type V8 value utils.
+
+
V8ValueWeakMap - Class in com.caoccao.javet.values.reference
+
 
+
V8ValueWeakSet - Class in com.caoccao.javet.values.reference
+
 
+
V8ValueZonedDateTime - Class in com.caoccao.javet.values.primitive
+
 
+
V8ValueZonedDateTime() - Constructor for class com.caoccao.javet.values.primitive.V8ValueZonedDateTime
+
 
+
V8ValueZonedDateTime(long) - Constructor for class com.caoccao.javet.values.primitive.V8ValueZonedDateTime
+
 
+
V8ValueZonedDateTime(ZonedDateTime) - Constructor for class com.caoccao.javet.values.primitive.V8ValueZonedDateTime
+
 
+
V8VirtualValue - Class in com.caoccao.javet.values.virtual
+
+
The type V8 virtual value.
+
+
V8VirtualValue(V8Runtime, Object) - Constructor for class com.caoccao.javet.values.virtual.V8VirtualValue
+
+
Instantiates a new V8 virtual value.
+
+
V8VirtualValueList - Class in com.caoccao.javet.values.virtual
+
+
The type V8 virtual value list.
+
+
V8VirtualValueList(V8Runtime, Object...) - Constructor for class com.caoccao.javet.values.virtual.V8VirtualValueList
+
+
Instantiates a new V8 virtual value list.
+
+
validateDepth(int) - Method in class com.caoccao.javet.interop.converters.JavetPrimitiveConverter
+
+
Validate the stack depth.
+
+
value - Variable in class com.caoccao.javet.values.primitive.V8ValuePrimitive
+
 
+
value - Variable in class com.caoccao.javet.values.virtual.V8VirtualValue
+
+
The Value.
+
+
valueOf(String) - Static method in enum com.caoccao.javet.enums.JavetErrorType
+
+
Returns the enum constant of this type with the specified name.
+
+
valueOf(String) - Static method in enum com.caoccao.javet.enums.JavetPromiseRejectEvent
+
+
Returns the enum constant of this type with the specified name.
+
+
valueOf(String) - Static method in enum com.caoccao.javet.enums.JSFunctionType
+
+
Returns the enum constant of this type with the specified name.
+
+
valueOf(String) - Static method in enum com.caoccao.javet.enums.JSRuntimeType
+
+
Returns the enum constant of this type with the specified name.
+
+
valueOf(String) - Static method in enum com.caoccao.javet.enums.JSScopeType
+
+
Returns the enum constant of this type with the specified name.
+
+
valueOf(String) - Static method in enum com.caoccao.javet.enums.V8ValueReferenceType
+
+
Returns the enum constant of this type with the specified name.
+
+
valueOf(String) - Static method in enum com.caoccao.javet.enums.V8ValueSymbolType
+
+
Returns the enum constant of this type with the specified name.
+
+
valueOf() - Method in class com.caoccao.javet.values.reference.V8ValueSymbolObject
+
+
Value of V8 value symbol.
+
+
values() - Static method in enum com.caoccao.javet.enums.JavetErrorType
+
+
Returns an array containing the constants of this enum type, in +the order they are declared.
+
+
values() - Static method in enum com.caoccao.javet.enums.JavetPromiseRejectEvent
+
+
Returns an array containing the constants of this enum type, in +the order they are declared.
+
+
values() - Static method in enum com.caoccao.javet.enums.JSFunctionType
+
+
Returns an array containing the constants of this enum type, in +the order they are declared.
+
+
values() - Static method in enum com.caoccao.javet.enums.JSRuntimeType
+
+
Returns an array containing the constants of this enum type, in +the order they are declared.
+
+
values() - Static method in enum com.caoccao.javet.enums.JSScopeType
+
+
Returns an array containing the constants of this enum type, in +the order they are declared.
+
+
values() - Static method in enum com.caoccao.javet.enums.V8ValueReferenceType
+
+
Returns an array containing the constants of this enum type, in +the order they are declared.
+
+
values() - Static method in enum com.caoccao.javet.enums.V8ValueSymbolType
+
+
Returns an array containing the constants of this enum type, in +the order they are declared.
+
+
values - Variable in class com.caoccao.javet.values.virtual.V8VirtualValueList
+
+
The Values.
+
+
+ + + +

W

+
+
warn - Variable in class com.caoccao.javet.interception.logging.JavetStandardConsoleInterceptor
+
+
The Warn.
+
+
warn(String) - Method in interface com.caoccao.javet.interfaces.IJavetLogger
+
+
Warn.
+
+
warn(String) - Method in class com.caoccao.javet.utils.JavetDefaultLogger
+
 
+
weak - Variable in class com.caoccao.javet.values.reference.V8ValueReference
+
 
+
WORKING_DIRECTORY - Static variable in class com.caoccao.javet.utils.JavetOSUtils
+
 
+
+ + + +

Z

+
+
ZERO_BYTE_PER_VALUE - Static variable in class com.caoccao.javet.values.reference.V8ValueTypedArray
+
+
The constant ZERO_BYTE_PER_VALUE.
+
+
ZONE_ID_UTC - Static variable in class com.caoccao.javet.utils.JavetDateTimeUtils
+
+
The constant ZONE_ID_UTC.
+
+
+ + + +

_

+
+
_catch(V8ValueFunction) - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Catch.
+
+
_catch(String) - Method in interface com.caoccao.javet.values.reference.IV8ValuePromise
+
+
Catch.
+
+
_catch(V8ValueFunction) - Method in class com.caoccao.javet.values.reference.V8ValuePromise
+
 
+
_for(String) - Method in class com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol
+
 
+
+A B C D E F G H I J K L M N O P Q R S T U V W Z _ 
+ +
+ + +
Skip navigation links
+ + + + +
+
+
    +
  • Prev
    • +
  • Next
    • +
+ + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/index.html b/docs/reference/javadoc/index.html new file mode 100644 index 000000000..8d90632dd --- /dev/null +++ b/docs/reference/javadoc/index.html @@ -0,0 +1,75 @@ + + + + + +javet 0.9.12 API + + + + + + + + + +<noscript> +<div>JavaScript is disabled on your browser.</div> +</noscript> +<h2>Frame Alert</h2> +<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href="overview-summary.html">Non-frame version</a>.</p> + + + diff --git a/docs/reference/javadoc/index.rst b/docs/reference/javadoc/index.rst new file mode 100644 index 000000000..a26617ce3 --- /dev/null +++ b/docs/reference/javadoc/index.rst @@ -0,0 +1,3 @@ +============= +API Reference +============= \ No newline at end of file diff --git a/docs/reference/javadoc/overview-frame.html b/docs/reference/javadoc/overview-frame.html new file mode 100644 index 000000000..fe8555c45 --- /dev/null +++ b/docs/reference/javadoc/overview-frame.html @@ -0,0 +1,41 @@ + + + + + +Overview List (javet 0.9.12 API) + + + + +
All Classes
+
+

Packages

+ +
+

 

+ + diff --git a/docs/reference/javadoc/overview-summary.html b/docs/reference/javadoc/overview-summary.html new file mode 100644 index 000000000..91f78c80e --- /dev/null +++ b/docs/reference/javadoc/overview-summary.html @@ -0,0 +1,263 @@ + + + + + +Overview (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+
    +
  • Prev
    • +
  • Next
    • +
+ + +
+ +
+ + +
+ +
+

javet 0.9.12 API

+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Packages 
PackageDescription
com.caoccao.javet.annotations +
Annotations classes for declarative coding and IDE intellisense.
+
com.caoccao.javet.entities +
Built-in entities for default object conversion.
+
com.caoccao.javet.enums +
Enums for various API.
+
com.caoccao.javet.exceptions +
Exceptions and errors for error handling.
+
com.caoccao.javet.interception +
Built-in interceptors.
+
com.caoccao.javet.interception.logging +
Built-in interceptors for JS logging function console.log(), etc...
+
com.caoccao.javet.interfaces +
Interfaces required by various internal and external API.
+
com.caoccao.javet.interop +
Interoperation between JVM and C++ via JNI.
+
com.caoccao.javet.interop.binding +
Callback data structure for binding context and method descriptor.
+
com.caoccao.javet.interop.callback +
Callback bridge between JVM and C++ via JNI.
+
com.caoccao.javet.interop.converters +
Built-in converters, interface and config.
+
com.caoccao.javet.interop.engine +
Engine pool, config and guard.
+
com.caoccao.javet.interop.executors +
Executors and interface.
+
com.caoccao.javet.interop.proxy +
Dynamic proxy handlers for polyfilling Java interfaces with JS functions or objects.
+
com.caoccao.javet.node.modules +
Reference classes for Node.js built-in modules.
+
com.caoccao.javet.utils +
Built-in utilities.
+
com.caoccao.javet.utils.receivers +
Built-in callback receivers.
+
com.caoccao.javet.values +
Classes for V8 values.
+
com.caoccao.javet.values.primitive +
Classes for V8 primitive values.
+
com.caoccao.javet.values.reference +
Classes for V8 reference values.
+
com.caoccao.javet.values.reference.builtin +
Classes for V8 built-in reference values.
+
com.caoccao.javet.values.virtual +
Classes for V8 virtual reference values.
+
+
+ +
+ + +
Skip navigation links
+ + + + +
+
+
    +
  • Prev
    • +
  • Next
    • +
+ + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/overview-tree.html b/docs/reference/javadoc/overview-tree.html new file mode 100644 index 000000000..abd23c182 --- /dev/null +++ b/docs/reference/javadoc/overview-tree.html @@ -0,0 +1,704 @@ + + + + + +Class Hierarchy (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+
    +
  • Prev
    • +
  • Next
    • +
+ + +
+ +
+ + +
+ +
+

Hierarchy For All Packages

+Package Hierarchies: + +
+
+

Class Hierarchy

+ +

Interface Hierarchy

+ +

Annotation Type Hierarchy

+
    +
  • com.caoccao.javet.annotations.CheckReturnValue (implements java.lang.annotation.Annotation)
    • +
  • com.caoccao.javet.annotations.NodeModule (implements java.lang.annotation.Annotation)
    • +
  • com.caoccao.javet.annotations.V8BindEnabler (implements java.lang.annotation.Annotation)
    • +
  • com.caoccao.javet.annotations.V8Function (implements java.lang.annotation.Annotation)
    • +
  • com.caoccao.javet.annotations.V8Property (implements java.lang.annotation.Annotation)
    • +
  • com.caoccao.javet.annotations.V8RuntimeSetter (implements java.lang.annotation.Annotation)
    • +
+

Enum Hierarchy

+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+
    +
  • Prev
    • +
  • Next
    • +
+ + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/package-list b/docs/reference/javadoc/package-list new file mode 100644 index 000000000..59bd54f9a --- /dev/null +++ b/docs/reference/javadoc/package-list @@ -0,0 +1,22 @@ +com.caoccao.javet.annotations +com.caoccao.javet.entities +com.caoccao.javet.enums +com.caoccao.javet.exceptions +com.caoccao.javet.interception +com.caoccao.javet.interception.logging +com.caoccao.javet.interfaces +com.caoccao.javet.interop +com.caoccao.javet.interop.binding +com.caoccao.javet.interop.callback +com.caoccao.javet.interop.converters +com.caoccao.javet.interop.engine +com.caoccao.javet.interop.executors +com.caoccao.javet.interop.proxy +com.caoccao.javet.node.modules +com.caoccao.javet.utils +com.caoccao.javet.utils.receivers +com.caoccao.javet.values +com.caoccao.javet.values.primitive +com.caoccao.javet.values.reference +com.caoccao.javet.values.reference.builtin +com.caoccao.javet.values.virtual diff --git a/docs/reference/javadoc/script.js b/docs/reference/javadoc/script.js new file mode 100644 index 000000000..c3a1cae44 --- /dev/null +++ b/docs/reference/javadoc/script.js @@ -0,0 +1,30 @@ +function show(type) +{ + count = 0; + for (var key in methods) { + var row = document.getElementById(key); + if ((methods[key] & type) != 0) { + row.style.display = ''; + row.className = (count++ % 2) ? rowColor : altColor; + } + else + row.style.display = 'none'; + } + updateTabs(type); +} + +function updateTabs(type) +{ + for (var value in tabs) { + var sNode = document.getElementById(tabs[value][0]); + var spanNode = sNode.firstChild; + if (value == type) { + sNode.className = activeTableTab; + spanNode.innerHTML = tabs[value][1]; + } + else { + sNode.className = tableTab; + spanNode.innerHTML = "" + tabs[value][1] + ""; + } + } +} diff --git a/docs/reference/javadoc/serialized-form.html b/docs/reference/javadoc/serialized-form.html new file mode 100644 index 000000000..c32b8921d --- /dev/null +++ b/docs/reference/javadoc/serialized-form.html @@ -0,0 +1,206 @@ + + + + + +Serialized Form (javet 0.9.12 API) + + + + + + + +
+ + +
Skip navigation links
+ + + + +
+
+
    +
  • Prev
    • +
  • Next
    • +
+ + +
+ +
+ + +
+ +
+

Serialized Form

+
+
+ +
+ +
+ + +
Skip navigation links
+ + + + +
+
+
    +
  • Prev
    • +
  • Next
    • +
+ + +
+ +
+ + +
+ + + diff --git a/docs/reference/javadoc/stylesheet.css b/docs/reference/javadoc/stylesheet.css new file mode 100644 index 000000000..b8dad0891 --- /dev/null +++ b/docs/reference/javadoc/stylesheet.css @@ -0,0 +1,574 @@ +/* Javadoc style sheet */ +/* +Overall document style +*/ + +@import url('resources/fonts/dejavu.css'); + +body { + background-color:#ffffff; + color:#353833; + font-family:'DejaVu Sans', Arial, Helvetica, sans-serif; + font-size:14px; + margin:0; +} +a:link, a:visited { + text-decoration:none; + color:#4A6782; +} +a:hover, a:focus { + text-decoration:none; + color:#bb7a2a; +} +a:active { + text-decoration:none; + color:#4A6782; +} +a[name] { + color:#353833; +} +a[name]:hover { + text-decoration:none; + color:#353833; +} +pre { + font-family:'DejaVu Sans Mono', monospace; + font-size:14px; +} +h1 { + font-size:20px; +} +h2 { + font-size:18px; +} +h3 { + font-size:16px; + font-style:italic; +} +h4 { + font-size:13px; +} +h5 { + font-size:12px; +} +h6 { + font-size:11px; +} +ul { + list-style-type:disc; +} +code, tt { + font-family:'DejaVu Sans Mono', monospace; + font-size:14px; + padding-top:4px; + margin-top:8px; + line-height:1.4em; +} +dt code { + font-family:'DejaVu Sans Mono', monospace; + font-size:14px; + padding-top:4px; +} +table tr td dt code { + font-family:'DejaVu Sans Mono', monospace; + font-size:14px; + vertical-align:top; + padding-top:4px; +} +sup { + font-size:8px; +} +/* +Document title and Copyright styles +*/ +.clear { + clear:both; + height:0px; + overflow:hidden; +} +.aboutLanguage { + float:right; + padding:0px 21px; + font-size:11px; + z-index:200; + margin-top:-9px; +} +.legalCopy { + margin-left:.5em; +} +.bar a, .bar a:link, .bar a:visited, .bar a:active { + color:#FFFFFF; + text-decoration:none; +} +.bar a:hover, .bar a:focus { + color:#bb7a2a; +} +.tab { + background-color:#0066FF; + color:#ffffff; + padding:8px; + width:5em; + font-weight:bold; +} +/* +Navigation bar styles +*/ +.bar { + background-color:#4D7A97; + color:#FFFFFF; + padding:.8em .5em .4em .8em; + height:auto;/*height:1.8em;*/ + font-size:11px; + margin:0; +} +.topNav { + background-color:#4D7A97; + color:#FFFFFF; + float:left; + padding:0; + width:100%; + clear:right; + height:2.8em; + padding-top:10px; + overflow:hidden; + font-size:12px; +} +.bottomNav { + margin-top:10px; + background-color:#4D7A97; + color:#FFFFFF; + float:left; + padding:0; + width:100%; + clear:right; + height:2.8em; + padding-top:10px; + overflow:hidden; + font-size:12px; +} +.subNav { + background-color:#dee3e9; + float:left; + width:100%; + overflow:hidden; + font-size:12px; +} +.subNav div { + clear:left; + float:left; + padding:0 0 5px 6px; + text-transform:uppercase; +} +ul.navList, ul.subNavList { + float:left; + margin:0 25px 0 0; + padding:0; +} +ul.navList li{ + list-style:none; + float:left; + padding: 5px 6px; + text-transform:uppercase; +} +ul.subNavList li{ + list-style:none; + float:left; +} +.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited { + color:#FFFFFF; + text-decoration:none; + text-transform:uppercase; +} +.topNav a:hover, .bottomNav a:hover { + text-decoration:none; + color:#bb7a2a; + text-transform:uppercase; +} +.navBarCell1Rev { + background-color:#F8981D; + color:#253441; + margin: auto 5px; +} +.skipNav { + position:absolute; + top:auto; + left:-9999px; + overflow:hidden; +} +/* +Page header and footer styles +*/ +.header, .footer { + clear:both; + margin:0 20px; + padding:5px 0 0 0; +} +.indexHeader { + margin:10px; + position:relative; +} +.indexHeader span{ + margin-right:15px; +} +.indexHeader h1 { + font-size:13px; +} +.title { + color:#2c4557; + margin:10px 0; +} +.subTitle { + margin:5px 0 0 0; +} +.header ul { + margin:0 0 15px 0; + padding:0; +} +.footer ul { + margin:20px 0 5px 0; +} +.header ul li, .footer ul li { + list-style:none; + font-size:13px; +} +/* +Heading styles +*/ +div.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 { + background-color:#dee3e9; + border:1px solid #d0d9e0; + margin:0 0 6px -8px; + padding:7px 5px; +} +ul.blockList ul.blockList ul.blockList li.blockList h3 { + background-color:#dee3e9; + border:1px solid #d0d9e0; + margin:0 0 6px -8px; + padding:7px 5px; +} +ul.blockList ul.blockList li.blockList h3 { + padding:0; + margin:15px 0; +} +ul.blockList li.blockList h2 { + padding:0px 0 20px 0; +} +/* +Page layout container styles +*/ +.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer { + clear:both; + padding:10px 20px; + position:relative; +} +.indexContainer { + margin:10px; + position:relative; + font-size:12px; +} +.indexContainer h2 { + font-size:13px; + padding:0 0 3px 0; +} +.indexContainer ul { + margin:0; + padding:0; +} +.indexContainer ul li { + list-style:none; + padding-top:2px; +} +.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt { + font-size:12px; + font-weight:bold; + margin:10px 0 0 0; + color:#4E4E4E; +} +.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd { + margin:5px 0 10px 0px; + font-size:14px; + font-family:'DejaVu Sans Mono',monospace; +} +.serializedFormContainer dl.nameValue dt { + margin-left:1px; + font-size:1.1em; + display:inline; + font-weight:bold; +} +.serializedFormContainer dl.nameValue dd { + margin:0 0 0 1px; + font-size:1.1em; + display:inline; +} +/* +List styles +*/ +ul.horizontal li { + display:inline; + font-size:0.9em; +} +ul.inheritance { + margin:0; + padding:0; +} +ul.inheritance li { + display:inline; + list-style:none; +} +ul.inheritance li ul.inheritance { + margin-left:15px; + padding-left:15px; + padding-top:1px; +} +ul.blockList, ul.blockListLast { + margin:10px 0 10px 0; + padding:0; +} +ul.blockList li.blockList, ul.blockListLast li.blockList { + list-style:none; + margin-bottom:15px; + line-height:1.4; +} +ul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList { + padding:0px 20px 5px 10px; + border:1px solid #ededed; + background-color:#f8f8f8; +} +ul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList { + padding:0 0 5px 8px; + background-color:#ffffff; + border:none; +} +ul.blockList ul.blockList ul.blockList ul.blockList li.blockList { + margin-left:0; + padding-left:0; + padding-bottom:15px; + border:none; +} +ul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast { + list-style:none; + border-bottom:none; + padding-bottom:0; +} +table tr td dl, table tr td dl dt, table tr td dl dd { + margin-top:0; + margin-bottom:1px; +} +/* +Table styles +*/ +.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary { + width:100%; + border-left:1px solid #EEE; + border-right:1px solid #EEE; + border-bottom:1px solid #EEE; +} +.overviewSummary, .memberSummary { + padding:0px; +} +.overviewSummary caption, .memberSummary caption, .typeSummary caption, +.useSummary caption, .constantsSummary caption, .deprecatedSummary caption { + position:relative; + text-align:left; + background-repeat:no-repeat; + color:#253441; + font-weight:bold; + clear:none; + overflow:hidden; + padding:0px; + padding-top:10px; + padding-left:1px; + margin:0px; + white-space:pre; +} +.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link, +.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link, +.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover, +.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover, +.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active, +.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active, +.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited, +.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited { + color:#FFFFFF; +} +.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span, +.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span { + white-space:nowrap; + padding-top:5px; + padding-left:12px; + padding-right:12px; + padding-bottom:7px; + display:inline-block; + float:left; + background-color:#F8981D; + border: none; + height:16px; +} +.memberSummary caption span.activeTableTab span { + white-space:nowrap; + padding-top:5px; + padding-left:12px; + padding-right:12px; + margin-right:3px; + display:inline-block; + float:left; + background-color:#F8981D; + height:16px; +} +.memberSummary caption span.tableTab span { + white-space:nowrap; + padding-top:5px; + padding-left:12px; + padding-right:12px; + margin-right:3px; + display:inline-block; + float:left; + background-color:#4D7A97; + height:16px; +} +.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab { + padding-top:0px; + padding-left:0px; + padding-right:0px; + background-image:none; + float:none; + display:inline; +} +.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd, +.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd { + display:none; + width:5px; + position:relative; + float:left; + background-color:#F8981D; +} +.memberSummary .activeTableTab .tabEnd { + display:none; + width:5px; + margin-right:3px; + position:relative; + float:left; + background-color:#F8981D; +} +.memberSummary .tableTab .tabEnd { + display:none; + width:5px; + margin-right:3px; + position:relative; + background-color:#4D7A97; + float:left; + +} +.overviewSummary td, .memberSummary td, .typeSummary td, +.useSummary td, .constantsSummary td, .deprecatedSummary td { + text-align:left; + padding:0px 0px 12px 10px; +} +th.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th, +td.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{ + vertical-align:top; + padding-right:0px; + padding-top:8px; + padding-bottom:3px; +} +th.colFirst, th.colLast, th.colOne, .constantsSummary th { + background:#dee3e9; + text-align:left; + padding:8px 3px 3px 7px; +} +td.colFirst, th.colFirst { + white-space:nowrap; + font-size:13px; +} +td.colLast, th.colLast { + font-size:13px; +} +td.colOne, th.colOne { + font-size:13px; +} +.overviewSummary td.colFirst, .overviewSummary th.colFirst, +.useSummary td.colFirst, .useSummary th.colFirst, +.overviewSummary td.colOne, .overviewSummary th.colOne, +.memberSummary td.colFirst, .memberSummary th.colFirst, +.memberSummary td.colOne, .memberSummary th.colOne, +.typeSummary td.colFirst{ + width:25%; + vertical-align:top; +} +td.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover { + font-weight:bold; +} +.tableSubHeadingColor { + background-color:#EEEEFF; +} +.altColor { + background-color:#FFFFFF; +} +.rowColor { + background-color:#EEEEEF; +} +/* +Content styles +*/ +.description pre { + margin-top:0; +} +.deprecatedContent { + margin:0; + padding:10px 0; +} +.docSummary { + padding:0; +} + +ul.blockList ul.blockList ul.blockList li.blockList h3 { + font-style:normal; +} + +div.block { + font-size:14px; + font-family:'DejaVu Serif', Georgia, "Times New Roman", Times, serif; +} + +td.colLast div { + padding-top:0px; +} + + +td.colLast a { + padding-bottom:3px; +} +/* +Formatting effect styles +*/ +.sourceLineNo { + color:green; + padding:0 30px 0 0; +} +h1.hidden { + visibility:hidden; + overflow:hidden; + font-size:10px; +} +.block { + display:block; + margin:3px 10px 2px 0px; + color:#474747; +} +.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink, +.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel, +.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink { + font-weight:bold; +} +.deprecationComment, .emphasizedPhrase, .interfaceName { + font-style:italic; +} + +div.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase, +div.block div.block span.interfaceName { + font-style:normal; +} + +div.contentContainer ul.blockList li.blockList h2{ + padding-bottom:0px; +} diff --git a/docs/reference/load_and_unload.html b/docs/reference/load_and_unload.html new file mode 100644 index 000000000..95257a92c --- /dev/null +++ b/docs/reference/load_and_unload.html @@ -0,0 +1,391 @@ + + + + + + + + Load and Unload - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Load and Unload

+

As documented in Javet Design, Javet supports loading and unloading the JNI libraries during runtime in both Node.js and V8 modes.

+
+

How?

+
+

Unload

+

Assuming the JNI library per mode is already loaded, here are the step-by-step on how to unload it.

+
// Step 1: Set library reloadable. Why? Because Javet defaults that switch to false.
+V8Host.setLibraryReloadable(true);
+// Step 2: Get V8Host per JS runtime type.
+V8Host v8Host = V8Host.getInstance(jsRuntimeType);
+// Step 3: Unload the library.
+v8Host.unloadLibrary();
+// Step 4: Restore the switch.
+V8Host.setLibraryReloadable(false);
+
+
+

How does unloadLibrary() work? There is no API that allows unloading a JNI library explicitly. The only way is GC will automatically unload the library if all references to that library are garbage collectable. So, application is supposed to close all V8 values, V8 runtimes prior to calling unloadLibrary().

+
+
+

Load

+

Assuming the JNI library per mode is already unloaded, here are the step-by-step on how to load it again.

+
// Step 1: Get V8Host per JS runtime type.
+V8Host v8Host = V8Host.getInstance(jsRuntimeType);
+// Step 2: Load the library.
+v8Host.loadLibrary();
+
+
+
+
+
+

Notes

+
    +

  • unloadLibrary() can only take effect after all references are garbage collectable.

    • +

  • loadLibrary() is internally called by Javet at the first time and only takes effect after unloadLibrary() is called.

    • +

  • loadLibrary() and unloadLibrary() are for experiment only. They may be unstable and crash JVM. Please use this feature at your own risk.

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/reference/load_and_unload.rst b/docs/reference/load_and_unload.rst index 1b358b642..3a77133b8 100644 --- a/docs/reference/load_and_unload.rst +++ b/docs/reference/load_and_unload.rst @@ -2,7 +2,7 @@ Load and Unload =============== -As documented in `design <../development/design.rst>`_, Javet supports loading and unloading the JNI libraries during runtime in both Node.js and V8 modes. +As documented in :doc:`../development/design`, Javet supports loading and unloading the JNI libraries during runtime in both Node.js and V8 modes. How? ==== @@ -43,5 +43,3 @@ Notes * ``unloadLibrary()`` can only take effect after all references are garbage collectable. * ``loadLibrary()`` is internally called by Javet at the first time and only takes effect after ``unloadLibrary()`` is called. * ``loadLibrary()`` and ``unloadLibrary()`` are for experiment only. **They may be unstable and crash JVM. Please use this feature at your own risk.** - -[`Home <../../README.rst>`_] [`Javet Reference `_] diff --git a/docs/reference/lock.html b/docs/reference/lock.html new file mode 100644 index 000000000..cf43dfec0 --- /dev/null +++ b/docs/reference/lock.html @@ -0,0 +1,389 @@ + + + + + + + + Know the Lock - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Know the Lock

+
+

What does Lock Mean in Javet?

+

V8 runtime runs in an isolated and single-threaded environment so that there is no race condition issue. How about playing V8 runtime in JVM among multiple threads? Yes, that is possible in 2 modes.

+
+

1. Implicit Mode

+

Javet automatically handles the lock() and unlock() regardless of thread context switch. So, in most of the cases, application just calls regular API without calling single line of locking API.

+
+
+

2. Explicit Mode

+

In explicit mode, application just needs to surround the code block with a V8Locker applied by try-with-resource. Internally, Javet allocates a long-live V8 locker instead of creating V8 locker per API call to achieve better performance.

+
try (V8Locker v8Locker = v8Runtime.getV8Locker()) {
+    // Do whatever you want to do.
+}
+
+
+

Be careful, V8Locker cannot be nested, otherwise checked exception will be thrown reporting lock conflict. Also, if the JS runtime type is Node.js, calling resetContext() or resetIsolate() may trigger core dump. Please refer to the source code for detail.

+
+
+
+

Comparisons

+
+

Performance

+

Implicit mode comes with a slight performance overhead in V8 because every native call is protected by a new V8 locker.

+

Explicit mode is designed for performance sensitive work. In extreme performance test cases, the performance improvement may be up to 150% compared to implicit mode.

+
+
+

Thread-safety

+

Implicit mode is thread-safe because its locking granularity is at API call level. Multiple threads are free to share the same V8 runtime in concurrent scenarios. Of course, be careful that JavaScript variables may be changed by other threads. It's better not to touch the same JavaScript variable among multiple threads, otherwise, Javet may crash. Yes, crash, because Javet doesn't perform this kind of check.

+

Explicit mode is NOT thread-safe because it's designed to improve performance in single-threaded scenarios. Sharing V8 locker protected V8 runtime among multiple threads will result in Javet crash immediately.

+
+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/reference/lock.rst b/docs/reference/lock.rst index 97cd90e44..81c6fd2aa 100644 --- a/docs/reference/lock.rst +++ b/docs/reference/lock.rst @@ -23,7 +23,7 @@ In explicit mode, application just needs to surround the code block with a ``V8L // Do whatever you want to do. } -Be careful, ``V8Locker`` cannot be nested, otherwise checked exception will be thrown reporting lock conflict. Also, if the JS runtime type is Node.js, calling ``resetContext()`` or ``resetIsolate()`` may trigger core dump. Please refer to `TestPerformance.java <../../src/test/java/com/caoccao/javet/interop/engine/TestPerformance.java>`_ for detail. +Be careful, ``V8Locker`` cannot be nested, otherwise checked exception will be thrown reporting lock conflict. Also, if the JS runtime type is Node.js, calling ``resetContext()`` or ``resetIsolate()`` may trigger core dump. Please refer to the :extsource2:`source code <../../src/test/java/com/caoccao/javet/interop/engine/TestPerformance.java>` for detail. Comparisons =========== @@ -41,5 +41,3 @@ Thread-safety Implicit mode is thread-safe because its locking granularity is at API call level. Multiple threads are free to share the same V8 runtime in concurrent scenarios. Of course, be careful that JavaScript variables may be changed by other threads. It's better not to touch the same JavaScript variable among multiple threads, otherwise, Javet may crash. Yes, crash, because Javet doesn't perform this kind of check. Explicit mode is **NOT** thread-safe because it's designed to improve performance in single-threaded scenarios. Sharing V8 locker protected V8 runtime among multiple threads will result in Javet crash immediately. - -[`Home <../../README.rst>`_] [`Javet Reference `_] diff --git a/docs/reference/logging.html b/docs/reference/logging.html new file mode 100644 index 000000000..1bc09fccf --- /dev/null +++ b/docs/reference/logging.html @@ -0,0 +1,419 @@ + + + + + + + + Logging - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Logging

+

As Javet is a fundamental SDK, it doesn't rely on any other libraries except JDK so that Javet users don't get dependency hell. That also means Javet has to use the JDK logging API, but Javet allows injecting 3rd party logging API.

+
+

Step 1: Implement IJavetLogger

+

IJavetLogger is the the only logging interface accepted by Javet. You may implement IJavetLogger with slf4j as following.

+
import com.caoccao.javet.interfaces.IJavetLogger;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+public class MyJavetLogger implements IJavetLogger {
+    protected Logger logger;
+
+    public MyJavetLogger(String name) {
+        logger = LoggerFactory.getLogger(name);
+    }
+
+    @Override
+    public void debug(String message) {
+        if (logger.isDebugEnabled()) {
+            logger.debug(message);
+        }
+    }
+
+    @Override
+    public void error(String message) {
+        if (logger.isDebugEnabled()) {
+            logger.error(message);
+        }
+    }
+
+    @Override
+    public void error(String message, Throwable throwable) {
+        if (logger.isDebugEnabled()) {
+            logger.error(message, throwable);
+        }
+    }
+
+    @Override
+    public void info(String message) {
+        if (logger.isInfoEnabled()) {
+            logger.info(message);
+        }
+    }
+
+    @Override
+    public void warn(String message) {
+        if (logger.isWarnEnabled()) {
+            logger.warn(message);
+        }
+    }
+}
+
+
+
+
+

Step 2: Inject the Logger

+

Injecting the logger is quite simple.

+
    +

  • Create an instance of the logger.

    • +

  • Set the logger to a config.

    • +

  • Set the config to a pool.

    • +
+
MyJavetLogger javetLogger = new MyJavetLogger("TestLogger");
+JavetEngineConfig javetEngineConfig = new JavetEngineConfig();
+javetEngineConfig.setJavetLogger(javetLogger);
+JavetEnginePool javetEnginePool = new JavetEnginePool(javetEngineConfig);
+
+
+

Now, Javet is integrated into your logging system.

+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/reference/logging.rst b/docs/reference/logging.rst index 09fe72a81..ec7b55889 100644 --- a/docs/reference/logging.rst +++ b/docs/reference/logging.rst @@ -75,5 +75,3 @@ Injecting the logger is quite simple. JavetEnginePool javetEnginePool = new JavetEnginePool(javetEngineConfig); Now, Javet is integrated into your logging system. - -[`Home <../../README.rst>`_] [`Javet Reference `_] diff --git a/docs/reference/memory_management.html b/docs/reference/memory_management.html new file mode 100644 index 000000000..a8e571853 --- /dev/null +++ b/docs/reference/memory_management.html @@ -0,0 +1,580 @@ + + + + + + + + Memory Management - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Memory Management

+
+

3 Challenges in Memory Management

+
+

JVM GC

+

JVM is known to have a GC that manages memory automatically. However, that doesn't cover the objects in JNI native implementation. Once NewGlobalRef(javaObject) is called, that javaObject lives forever in JVM until DeleteGlobalRef(javaObject) is called.

+
+
+

C++ Runtime

+

Smart pointers in C++ cannot easily work across JNI to JVM, in other words, raw pointers are directly referenced in JVM as long. C++ runtime has no idea when to free the memory of those raw pointers unless JVM tells C++ runtime to release via JNI.

+
+
+

V8 GC

+

V8 generally categorizes objects in memory to 3 types.

+
    +

  1. v8::Local - It lives within the local scope of a C++ function call.

    2. +

  2. v8::Persistent - Its lifecycle is managed by V8 GC.

    3. +

  3. v8::External - V8 GC treats it as root object so that it lives as long as the V8 isolate lives.

    4. +
+

The awful thing in V8 GC is V8 does not make final callback when a context is being closed. From V8 perspective, that's a performance improvement. But from Javet perspective, Javet cannot completely rely on V8 to do the resource management. So, Javet keeps track of all unmanaged resource and makes sure there is no memory leak in all cases.

+
+
+ +
+

Alternative Option: ArrayBuffer

+

The ArrayBuffer object is used to represent a generic, fixed-length raw binary data buffer.

+

It is an array of bytes, often referred to in other languages as a "byte array".You cannot directly manipulate the contents of an ArrayBuffer; instead, you create one of the typed array objects or a DataView object which represents the buffer in a specific format, and use that to read and write the contents of the buffer.

+

Javet offers complete support to all the typed arrays as well as DataView as following. There is a java.nio.ByteBuffer inside every typed array and DataView. That ByteBuffer directly links to the corresponding backing store of V8 typed array. In other words, Javet and V8 can both access the same address to achieve zero memory copy. Please consider using typed array in performance sensitive scenarios.

+
++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Type

Value Range

Size in bytes

Description

Web IDL type

Equivalent C type

Int8Array

-128 to 127

1

8-bit two's complement signed integer

byte

int8_t

Uint8Array

0 to 255

1

8-bit unsigned integer

octet

uint8_t

Uint8ClampedArray

0 to 255

1

8-bit unsigned integer (clamped)

octet

uint8_t

Int16Array

-32768 to 32767

2

16-bit two's complement signed integer

short

int16_t

Uint16Array

0 to 65535

2

16-bit unsigned integer

unsigned short

uint16_t

Int32Array

-2147483648 to 2147483647

4

32-bit two's complement signed integer

long

int32_t

Uint32Array

0 to 4294967295

4

32-bit unsigned integer

unsigned long

uint32_t

Float32Array

1.2×10-38 to 3.4×1038

4

32-bit IEEE floating point number (7 significant digits e.g., 1.234567)

unrestricted float

float

Float64Array

5.0×10-324 to 1.8×10308

8

64-bit IEEE floating point number (16 significant digits e.g., 1.23456789012345)

unrestricted double

double

BigInt64Array

-263 to 263-1

8

64-bit two's complement signed integer

bigint

int64_t (signed long long)

BigUint64Array

0 to 264-1

8

64-bit unsigned integer

bigint

uint64_t (unsigned long long)

+

Please refer to TestV8ValueTypedArray and TestV8ValueDataView for sample code snippets.

+
+
+

GC

+
+

Automatic GC

+

Javet has built-in automatic GC in both Node.js mode and V8 mode. Why? In high frequency API calling area, V8 may not keep up with the GC pace that JVM performs. Sometimes, JVM is running out of heap memory whereas V8 holds many zombie objects that are referenced by Javet in JVM. In this case, JVM ignores those objects unless V8 releases them in V8 GC cycle.

+
+

Passive GC

+

So, how to notify V8 GC that Java heap memory pool is running out of space? Javet automates this via V8Host and V8Notifier. By default, this feature is disabled. Here is the step-by-step on how to enable this feature.

+
    +

  1. (Optional) Call V8Host.setMemoryUsageThresholdRatio(double) to set memory usage threshold ratio. This is optional because the default value is 0.7.

    2. +

  2. Call V8Host.getNodeInstance().enableGCNotification() or V8Host.getV8Instance().enableGCNotification() to enable the notification.

    3. +
+

Here is a sample heap memory usage with default memory usage threshold ration and -Xms64m -Xmx64m. Please note that in this sample, application is under high pressure of creating and destroying V8 objects. In normal cases, the curve is much smoother.

+Javet Memory Management Passive GC +

What happens internally is as following.

+
    +

  1. V8Notifier listens to the heap memory notification from JVM per V8Host instance.

    2. +

  2. JVM notifies V8Notifier that memory threshold exceeds.

    3. +

  3. V8Notifier broadcasts GC scheduled flag to all V8Runtime managed by the V8Host instance.

    4. +

  4. Each V8Runtime performs GC in its own isolate.

    5. +
+
+
+

Aggressive GC

+

Just get V8Runtime from Javet engine pool that aggressively sends GC notification to idle engine in daemon thread. There is no performance overhead because:

+
    +

  • The engine performs GC when it is idle in a dedicated thread.

    • +

  • Javet engine pool is lock free so that the GC doesn't affect other worker threads.

    • +
+

Of course, this behavior can be turned off by calling JavetEngineConfig.setAutoSendGCNotification(false).

+
+
+
+

Manual GC

+

There are 3 ways of manually triggering GC in both Node.js mode and V8 mode.

+
+

V8Runtime.await()

+

This API represents a light-weighted way of giving V8 a hint to perform GC. It actually tells Node.js or V8 runtime to drain the message or task queue. As a side effect of the drain, a GC may occur based on the decision of Node.js or V8 runtime.

+
+
+

V8Runtime.idleNotificationDeadline(long deadlineInMillis)

+

This API explicitly tells Node.js or V8 runtime that the application expects a GC to happen in the given milliseconds. Be careful, Node.js or V8 runtime may disregard this instruction.

+
+
+

V8Runtime.lowMemoryNotification()

+

This API explicitly tells Node.js or V8 runtime to perform a GC immediately. It is also used in automatic GC aforementioned.

+
+
+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/reference/memory_management.rst b/docs/reference/memory_management.rst index 77c257152..0e850c637 100644 --- a/docs/reference/memory_management.rst +++ b/docs/reference/memory_management.rst @@ -31,8 +31,8 @@ Recommended Options Javet directly borrows the way V8 manages objects in JVM. The rule is simple in the following 2 Options. -Automatic Management with ``try-with-resource`` ------------------------------------------------ +Automatic Management with try-with-resource +------------------------------------------- .. code-block:: java @@ -96,7 +96,7 @@ Javet offers complete support to all the typed arrays as well as ``DataView`` as | BigUint64Array | 0 to 264-1 | 8 | 64-bit unsigned integer | bigint | uint64_t (unsigned long long) | +-------------------+-----------------------------+---------------+------------------------------------------------------------------------------------+---------------------+-------------------------------+ -Please refer to `TestV8ValueTypedArray <../../src/test/java/com/caoccao/javet/values/reference/TestV8ValueTypedArray.java>`_ and `TestV8ValueDataView <../../src/test/java/com/caoccao/javet/values/reference/TestV8ValueDataView.java>`_ for sample code snippets. +Please refer to :extsource2:`TestV8ValueTypedArray <../../src/test/java/com/caoccao/javet/values/reference/TestV8ValueTypedArray.java>` and :extsource2:`TestV8ValueDataView <../../src/test/java/com/caoccao/javet/values/reference/TestV8ValueDataView.java>` for sample code snippets. GC == @@ -116,7 +116,7 @@ So, how to notify V8 GC that Java heap memory pool is running out of space? Jave Here is a sample heap memory usage with default memory usage threshold ration and ``-Xms64m -Xmx64m``. Please note that in this sample, application is under high pressure of creating and destroying V8 objects. In normal cases, the curve is much smoother. -.. image:: ../resources/images/javet_memory_management_passive_gc.png?raw=true +.. image:: ../resources/images/javet_memory_management_passive_gc.png :alt: Javet Memory Management Passive GC What happens internally is as following. @@ -141,19 +141,17 @@ Manual GC There are 3 ways of manually triggering GC in both Node.js mode and V8 mode. -``V8Runtime.await()`` -^^^^^^^^^^^^^^^^^^^^^ +V8Runtime.await() +^^^^^^^^^^^^^^^^^ This API represents a light-weighted way of giving V8 a hint to perform GC. It actually tells Node.js or V8 runtime to drain the message or task queue. As a side effect of the drain, a GC may occur based on the decision of Node.js or V8 runtime. -``V8Runtime.idleNotificationDeadline(long deadlineInMillis)`` -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +V8Runtime.idleNotificationDeadline(long deadlineInMillis) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ This API explicitly tells Node.js or V8 runtime that the application expects a GC to happen in the given milliseconds. Be careful, Node.js or V8 runtime may disregard this instruction. -``V8Runtime.lowMemoryNotification()`` -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +V8Runtime.lowMemoryNotification() +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ This API explicitly tells Node.js or V8 runtime to perform a GC immediately. It is also used in automatic GC aforementioned. - -[`Home <../../README.rst>`_] [`Javet Reference `_] diff --git a/docs/reference/modularization.html b/docs/reference/modularization.html new file mode 100644 index 000000000..66428fbf5 --- /dev/null +++ b/docs/reference/modularization.html @@ -0,0 +1,566 @@ + + + + + + + + Modularization - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Modularization

+
+

Node.js Mode

+
+

Example

+

In Node.js mode, Javet leaves Node.js with its own ways of handling modules. The coding experience is identical to the one in Node.js and applications can get all features supported by Javet, like function interception. Here is an example.

+
try (JavetEnginePool<NodeRuntime> javetEnginePool = new JavetEnginePool<NodeRuntime>()) {
+    javetEnginePool.getConfig().setJSRuntimeType(JSRuntimeType.Node);
+    try (IJavetEngine<NodeRuntime> iJavetEngine = javetEnginePool.getEngine()) {
+        NodeRuntime nodeRuntime = iJavetEngine.getV8Runtime();
+        Path workingDirectory = new File(JavetOSUtils.WORKING_DIRECTORY, "scripts/node/test-node").toPath();
+        // Set the require root directory so that Node.js is able to locate node_modules.
+        nodeRuntime.getNodeModule(NodeModuleModule.class).setRequireRootDirectory(workingDirectory);
+        getLogger().logInfo("1.23 + 2.34 = {0}", nodeRuntime.getExecutor(
+                "const Decimal = require('decimal.js');" +
+                        "const a = new Decimal(1.23);" +
+                        "const b = new Decimal(2.34);" +
+                        "a.add(b).toString();").executeString());
+    }
+}
+
+
+
+
+

Gaps between Javet Node.js Mode and Native Node.js

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Feature

Javet Node.js Mode

Native Node.js

require() Root

Java Application Working Directory

JavaScript Application Working Directory

Working Directory

Java Application Working Directory

JavaScript Application Working Directory

__dirname

N/A

Yes

__filename

N/A

Yes

Module Mode

default: false

default: true

+

Usually the Java application working directory doesn't contain node_modules. That for sure breaks Node.js. No worry, here are the steps on closing the gaps.

+
    +

  1. Set the require() root directory so that Node.js is able to locate node_modules.

    2. +

  2. Set working directory to where the script is located.

    3. +

  3. Set __dirname.

    4. +

  4. Set __filename.

    5. +
+

Luckily, in Javet, when getExecutor(File scriptFile) or getExecutor(Path scriptPath) is called, all these 4 steps are automatically performed. If getExecutor(String scriptString) is called, obviously Javet doesn't know what to do, but application may call IV8Executor.setResourceName(String resourceName) later to perform these 4 steps. So, Javet Node.js mode doesn't care where the script comes from. Application may feel free to virtualize Node.js.

+

Can Javet run script in Node.js Module Mode? Yes, just call IV8Executor.setModule(true).

+

The exciting thing is: in Javet, applications may have multiple instances of Node.js pointing to different node_modules and potentially these Node.js instances can share the same piece of data.

+
+
+

Deal with Native Modules

+

Node.js native modules usually cannot be dynamically loaded to Javet. E.g. sqlite3. That issue also bothers Electron. Electron folks created project electron-rebuild which rebuilds the native modules from source code and its own native symbols.

+

Javet follows the same approach on Windows, and a simpler approach on Linux.

+
+

Patch ELF Native Modules on Linux

+

The native modules on Linux don't know the existence of Javet. When they look up Node.js symbols which are provided by Javet, they just fail with errors like the following.

+
+

com.caoccao.javet.exceptions.JavetExecutionException: Error: /....../node_modules/sqlite3/lib/binding/napi-v3-linux-x64/node_sqlite3.node: undefined symbol: napi_create_error

+
+

The fix is very simple. Here is a sample sqlite3.

+
# Install patchelf on Ubuntu (Optional)
+sudo apt install patchelf
+cd scripts/node
+# Install sqlite3
+npm install
+cd javet-rebuild
+export NODE_MODULE_FILE="../node_modules/sqlite3/lib/binding/napi-v3-linux-x64/node_sqlite3.node"
+./rebuild.sh
+
+
+

The rebuild.sh actually calls patchelf to add Javet to the node module's dependency.

+
+
+

Rebuild Native Modules on Windows

+

The native modules on Windows don't know the existence of Javet. Windows dynamic library loading API LoadLibraryExW throws the following error.

+
+

A dynamic link library (DLL) initialization routine failed.

+
+

The fix is a bit complicated.

+
    +

  • Prepare the Windows build environment by following Build Javet.

    • +

  • Install the node modules from source code npm install --build-from-source.

    • +

  • Download the corresponding Javet library file from this drive.

    • +

  • Unzip the Javet library file somewhere.

    • +

  • Create a rebuild script pointing to the Javet library file by referencing rebuild-sqlite3.cmd and rebuild.cmd.

    • +

  • Run the rebuild script.

    • +
+

The rebuild script actually replaces node.lib with libjavet....lib during the rebuild so that the new node modules can tell LoadLibraryExW to look for Javet instead of Node.js.

+

Javet calls for someone who can voluntarily host the Javet libraries and Javet compatible node modules so that major Javet users don't need to go through these. For now, it has to be a pretty manual work.

+
+
+

Caution!

+
    +

  • Once the node modules are patched or rebuilt, they can only be loaded by that particular version of Javet and they cannot be loaded by Node.js any more.

    • +

  • Make backups.

    • +
+
+
+
+
+

V8 Mode

+

In V8 mode, there is no out-of-box support to ES6 dynamic import. But, Javet provides complete support on top of V8. There are 2 ways of playing around with the ES6 dynamic import: Pre-load and On-demand.

+
+

Pre-load

+

Javet stores compiled modules in a map with key = module path, value = compiled module. When V8 meets a new module to be imported, Javet will look up the map and return the compiled module to V8. So, in order to simulate dynamic import, application needs to compile those required modules before the final execution.

+

For instance: The dependency is as following.

+
Application
+├─A
+│ ├─a.js (depends on b.js)
+│ └─B
+│   └─b.js
+├─C
+│ └─c.js
+└─d.js
+
+
+

The execution steps are as following.

+
    +

  1. Compile module ./A/B/b.js

    2. +

  2. Compile module ./A/a.js

    3. +

  3. Compile module ./C/c.js

    4. +

  4. Compile module ./d.js

    5. +

  5. Launch the application

    6. +
+

Here is an example. Assuming test.js depends on module.js, the code looks like the following.

+
String codeString = "export function testFromModule() { return { a: 1 }; };";
+// Step 1: Assign a resource name to a piece of code.
+IV8Executor iV8Executor = v8Runtime.getExecutor(codeString).setResourceName("./module.js");
+// Step 2: Compile the module.js.
+try (V8Module v8Module = iV8Executor.compileModule()) {
+    // Step 3: Evaluate the module.js.
+    v8Module.executeVoid();
+    if (v8Runtime.containsModule("./module.js")) {
+        System.out.println("./module.js is registered as a module.");
+    }
+    codeString = "import { testFromModule } from './module.js'; testFromModule();";
+    // Step 4: Do the same to test.js.
+    iV8Executor = v8Runtime.getExecutor(codeString).setResourceName("./test.js").setModule(true);
+    // Step 5: Compile and evaluate test.js and Javet will automatically feed V8 with module.js.
+    try (V8ValueObject v8ValueObject = iV8Executor.execute()) {
+        // Step 6: Verify the module.js taking effect.
+        System.out.println("Variable a = " + v8ValueObject.getInteger("a") + ".");
+    }
+}
+
+
+
+
+

On-demand

+

Obviously, pre-loading modules requires application to analyze the code for complete dependency. That is too heavy in most of the cases. Luckily, Javet also supports registering a module resolver which is called back when the modules are being imported. With the module resolver, application doesn't need to analyze the code for dependency. Of course, application is responsible for security check.

+

Here is an example. Assuming test.js depends on module.js, the code looks like the following.

+
// Step 1: Create a V8 runtime from V8 host in try-with-resource.
+try (V8Runtime v8Runtime = V8Host.getV8Instance().createV8Runtime()) {
+    // Step 2: Register a custom module resolver.
+    v8Runtime.setV8ModuleResolver((runtime, resourceName, v8ModuleReferrer) -> {
+        // Step 3: Compile module.js from source code if the resource name matches.
+        if ("./module.js".equals(resourceName)) {
+            return runtime.getExecutor("export function test() { return 1; }")
+                    .setResourceName(resourceName).compileV8Module();
+        } else {
+            return null;
+        }
+    });
+    // Step 4: Import module.js in test.js and expose test() in global context.
+    v8Runtime.getExecutor("import { test } from './module.js'; globalThis.test = test;")
+            .setModule(true).setResourceName("./test.js").executeVoid();
+    // Step 5: Call test() in global context.
+    System.out.println("test() -> " + v8Runtime.getExecutor("test()").executeInteger());
+}
+
+
+

It is V8 that performs the dependency analysis. Javet just relays the callback to application and actively caches the compiled modules so that the module resolver is only called one time per module.

+
+
+
+

Internals

+

How Javet and V8 work internally for supporting modules can be found at Javet Design.

+Javet Module System +

Please note that the way Javet handles dynamic import in V8 mode can be applied to Node.js mode. That means all Node.js modules can be virtualized by Javet.

+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/reference/modularization.rst b/docs/reference/modularization.rst index efe55b40b..1287ce081 100644 --- a/docs/reference/modularization.rst +++ b/docs/reference/modularization.rst @@ -91,7 +91,7 @@ The native modules on Windows don't know the existence of Javet. Windows dynamic The fix is a bit complicated. -* Prepare the Windows build environment by following `Build Javet <../development/build.rst>`_. +* Prepare the Windows build environment by following :doc:`../development/build`. * Install the node modules from source code ``npm install --build-from-source``. * Download the corresponding Javet library file from this `drive `_. * Unzip the Javet library file somewhere. @@ -196,11 +196,9 @@ It is V8 that performs the dependency analysis. Javet just relays the callback t Internals ========= -How Javet and V8 work internally for supporting modules can be found at `here <../development/design.rst>`_. +How Javet and V8 work internally for supporting modules can be found at :doc:`../development/design`. -.. image:: ../resources/images/javet_module_system.png?raw=true +.. image:: ../resources/images/javet_module_system.png :alt: Javet Module System Please note that the way Javet handles dynamic import in V8 mode can be applied to Node.js mode. That means all Node.js modules can be virtualized by Javet. - -[`Home <../../README.rst>`_] [`Javet Reference `_] diff --git a/docs/reference/performance.html b/docs/reference/performance.html new file mode 100644 index 000000000..e999feba6 --- /dev/null +++ b/docs/reference/performance.html @@ -0,0 +1,429 @@ + + + + + + + + Javet Performance - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Javet Performance

+

In V8, a context is an execution environment that allows separate, unrelated, JavaScript applications to run in a single instance of V8.

+

It's recommended to reset context if a new execution environment is required.

+
+

Result

+

Here is the performance test result from i7 10700K + Windows 10. Test case is just 1 + 1 = 2.

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Type

Case

TPS

Node

Single Context with 1 Thread

751,032

Node

Ad-hoc Context with 1 Thread

65

Node

Single Context with 8 Threads

4,410,143

Node

Ad-hoc Context with 8 Threads

363

Node

Ad-hoc Isolate with 1 Thread

51

Node

Ad-hoc Isolate with 8 Threads

263

V8

Single Context with 1 Thread

647,458

V8

Ad-hoc Context with 1 Thread

2,846

V8

Single Context with 8 Threads

3,968,253

V8

Ad-hoc Context with 8 Threads

16,508

V8

Ad-hoc Isolate with 1 Thread

748

V8

Ad-hoc Isolate with 8 Threads

3,660

+
+
+

Highlights

+
    +

  • Node.js performs slightly better in Single Context mode mainly because the V8 embedded in Node.js is much older than the built-in V8.

    • +

  • Built-in V8 dramatically outperforms Node.js in Ad-hoc mode mainly because Node.js comes with a huge overhead that seriously slows down the context and isolate creation and recycle.

    • +

  • It's recommended to use built-in V8 unless Node.js is required in some particular cases.

    • +

  • Node.js on Linux is built as position independent code which comes with an additional performance overhead.

    • +
+

Reference: https://v8.dev/docs/embed#contexts

+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/reference/performance.rst b/docs/reference/performance.rst index b14178c42..d4995fd19 100644 --- a/docs/reference/performance.rst +++ b/docs/reference/performance.rst @@ -37,5 +37,3 @@ Highlights * Node.js on Linux is built as `position independent code `_ which comes with an additional performance overhead. Reference: https://v8.dev/docs/embed#contexts - -[`Home <../../README.rst>`_] [`Javet Reference `_] diff --git a/docs/reference/termination.html b/docs/reference/termination.html new file mode 100644 index 000000000..fa8d64bee --- /dev/null +++ b/docs/reference/termination.html @@ -0,0 +1,413 @@ + + + + + + + + Termination - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Termination

+

Terminating scripts that run out of control is quite important in terms of protecting the applications from being attacked by malicious scripts. In Javet, there are 2 typical ways of terminating scripts.

+
+

Automatic Termination with Pool and Engine

+

IJavetEngineGuard is the built-in support for terminating a script which runs out of control.

+
// Get an engine from the pool as usual.
+try (IJavetEngine iJavetEngine = iJavetEnginePool.getEngine()) {
+    V8Runtime v8Runtime = iJavetEngine.getV8Runtime();
+    // Get a guard from the engine and apply try-with-resource pattern.
+    try (IJavetEngineGuard iJavetEngineGuard = iJavetEngine.getGuard(10000)) {
+        v8Runtime.getExecutor("while (true) {}").executeVoid();
+        // That infinite loop will be terminated in 10 seconds by the guard.
+    } catch (JavetTerminatedException e) {
+        // JavetTerminatedException will be thrown to mark that.
+        assertFalse(e.isContinuable());
+    }
+    assertEquals(2, v8Runtime.getExecutor("1 + 1").executeInteger(),
+            "The V8 runtime is not dead and still be able to execute code afterwards.");
+}
+
+
+

Does IJavetEngineGuard hang normal scripts till timeout is hit? No, it doesn't cause any overhead. If the script completes, IJavetEngineGuard.close() will be called via try-with-resource pattern and cancel the daemon thread immediately.

+

Please refer to the source code for more detail.

+
+
+

Manual Termination

+

Manual termination gives applications complete control. In return, the coding effort is considerable.

+
V8Host v8Host = V8Host.getV8Instance();
+try (V8Runtime v8Runtime = v8Host.createV8Runtime()) {
+    // Create a daemon thread monitoring the V8 runtime status.
+    Thread daemonThread = new Thread(() -> {
+        // V8 runtime isInUse() does not require lock.
+        while (!v8Runtime.isInUse()) {
+            try {
+                TimeUnit.MILLISECONDS.sleep(1);
+            } catch (InterruptedException e) {
+                e.printStackTrace();
+            }
+        }
+        // V8 runtime terminateExecution() does not require lock.
+        v8Runtime.terminateExecution();
+    });
+    daemonThread.start();
+    try {
+        v8Runtime.getExecutor(
+                "var count = 0; while (true) { ++count; }")
+                .executeVoid();
+        fail("Failed to throw exception when execution is terminated.");
+    } catch (JavetTerminatedException e) {
+        assertFalse(e.isContinuable());
+    }
+    final int count = v8Runtime.getGlobalObject().getInteger("count");
+    assertTrue(count > 0, "Count should be greater than 0.");
+    assertEquals(2, v8Runtime.getExecutor("1 + 1").executeInteger(),
+            "V8 runtime should still be able to execute script after being terminated.");
+}
+
+
+
+
+

How about Debug Mode?

+

Usually, when application is being debugged, JavetEngineGuard may easily interrupt the debug. No worry, JavetEngineGuard is by default disabled in debug mode. Please refer to disableInDebugMode() and enableInDebugMode() for detail.

+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/reference/termination.rst b/docs/reference/termination.rst index a2bcfd3ed..596846033 100644 --- a/docs/reference/termination.rst +++ b/docs/reference/termination.rst @@ -28,7 +28,7 @@ Automatic Termination with Pool and Engine Does ``IJavetEngineGuard`` hang normal scripts till timeout is hit? No, it doesn't cause any overhead. If the script completes, ``IJavetEngineGuard.close()`` will be called via try-with-resource pattern and cancel the daemon thread immediately. -Please refer to `source code <../../src/test/java/com/caoccao/javet/interop/engine/TestJavetEngineGuard.java>`_ for more detail. +Please refer to the :extsource2:`source code <../../src/test/java/com/caoccao/javet/interop/engine/TestJavetEngineGuard.java>` for more detail. Manual Termination ================== @@ -71,5 +71,3 @@ How about Debug Mode? ===================== Usually, when application is being debugged, ``JavetEngineGuard`` may easily interrupt the debug. No worry, ``JavetEngineGuard`` is by default disabled in debug mode. Please refer to ``disableInDebugMode()`` and ``enableInDebugMode()`` for detail. - -[`Home <../../README.rst>`_] [`Javet Reference `_] diff --git a/docs/reference/todo_list.html b/docs/reference/todo_list.html new file mode 100644 index 000000000..31538ee10 --- /dev/null +++ b/docs/reference/todo_list.html @@ -0,0 +1,335 @@ + + + + + + + + TODO List - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

TODO List

+
    +

  • To upgrade V8 and Node.js periodically.

    • +

  • To expose more Node.js modules in Javet style.

    • +

  • To polyfill V8 mode with more API.

    • +
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/todo_list.rst b/docs/reference/todo_list.rst similarity index 85% rename from docs/todo_list.rst rename to docs/reference/todo_list.rst index dbb3f7ff7..772b4f6c9 100644 --- a/docs/todo_list.rst +++ b/docs/reference/todo_list.rst @@ -5,5 +5,3 @@ TODO List * To upgrade V8 and Node.js periodically. * To expose more Node.js modules in Javet style. * To polyfill V8 mode with more API. - -[`Home <../README.rst>`_] diff --git a/docs/reference/v8_collection.html b/docs/reference/v8_collection.html new file mode 100644 index 000000000..ee72c0bbf --- /dev/null +++ b/docs/reference/v8_collection.html @@ -0,0 +1,520 @@ + + + + + + + + V8 Collection - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

V8 Collection

+
+

Collection in V8

+

Javet provides decent support on manipulating V8 collection as following.

+
+++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Collection

getLength() / getSize()

add() / set()

delete()

has()

get()

getKeys() / getOwnPropertyNames()

getValues()

getEntries()

forEach(Consumer)

forEach(BiConsumer)

Object

No

Yes

yes

Yes

Yes

Yes

No

No

Yes

Yes

Array

Yes

Yes

yes

Yes

Yes

Yes

No

No

Yes

No

Map

Yes

Yes

yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Set

Yes

Yes

yes

Yes

Yes

Yes

No

No

Yes

No

WeakMap

No

Yes

yes

Yes

Yes

No

No

No

No

No

WeakSet

No

Yes

yes

Yes

No

No

No

No

No

No

+
+
+

Usage

+
+

V8ValueArray

+
try (V8ValueArray v8ValueArray = v8Runtime.getExecutor("const a = new Array(0,1,2); a;").execute()) {
+    AtomicInteger count = new AtomicInteger(0);
+    v8ValueArray.forEach((V8ValueInteger value) -> {
+        assertEquals(count.getAndIncrement(), value.getValue());
+    });
+    assertEquals(4, v8ValueArray.push(3));
+    assertEquals(3, v8ValueArray.popInteger());
+}
+
+
+
+
+

V8ValueSet

+
try (V8ValueSet v8ValueSet = v8Runtime.getExecutor(
+        "const a = new Set(); a.add('0'); a.add('1'); a.add('2'); a;").execute()) {
+    // V8 feature: Order is preserved.
+    AtomicInteger count = new AtomicInteger(0);
+    assertEquals(3, v8ValueSet.forEach((V8ValueString key) -> {
+        assertEquals(Integer.toString(count.getAndIncrement()), key.getValue());
+    }));
+    v8ValueSet.add("3");
+    assertTrue(v8ValueSet.has("3"));
+    assertTrue(v8ValueSet.delete("3"));
+    assertFalse(v8ValueSet.has("3"));
+}
+
+
+
+
+

V8ValueMap

+
try (V8ValueMap v8ValueMap = v8Runtime.getExecutor(
+        "const a = new Map(); a.set('0', 0); a.set('1', 1); a.set('2', 2); a;").execute()) {
+    // V8 feature: Order is preserved.
+    AtomicInteger count = new AtomicInteger(0);
+    assertEquals(3, v8ValueMap.forEach((V8ValueString key) -> {
+        assertNotNull(key);
+        assertEquals(Integer.toString(count.getAndIncrement()), key.getValue());
+    }));
+    count.set(0);
+    assertEquals(3, v8ValueMap.forEach((V8ValueString key, V8ValueInteger value) -> {
+        assertNotNull(key);
+        assertNotNull(value);
+        assertEquals(Integer.toString(count.get()), key.getValue());
+        assertEquals(count.getAndIncrement(), value.getValue());
+    }));
+    v8ValueMap.set("a", 1);
+    assertEquals(4, v8ValueMap.getSize());
+    assertTrue(v8ValueMap.has("a"));
+    assertTrue(v8ValueMap.delete("a"));
+}
+
+
+
+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/reference/v8_collection.rst b/docs/reference/v8_collection.rst index 27fd7b4ed..6a54652d5 100644 --- a/docs/reference/v8_collection.rst +++ b/docs/reference/v8_collection.rst @@ -78,5 +78,3 @@ V8ValueMap assertTrue(v8ValueMap.has("a")); assertTrue(v8ValueMap.delete("a")); } - -[`Home <../../README.rst>`_] [`Javet Reference `_] diff --git a/docs/reference/v8_function.html b/docs/reference/v8_function.html new file mode 100644 index 000000000..2670ccdb0 --- /dev/null +++ b/docs/reference/v8_function.html @@ -0,0 +1,848 @@ + + + + + + + + V8 Function - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

V8 Function

+
+

Function Types

+

In general, there are 3 types of function exposed by Javet.

+
    +

  • Native functions are V8 built-in functions.

    • +

  • API functions are C++ backed functions. Node.js defined C++ functions and Javet defined Java functions are all API functions.

    • +

  • User Defined functions are JavaScript backed functions. Basically, any function generated via JavaScript code execution is user defined function.

    • +
+
+

Comparisons

+
++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Type

V8 Built-in

C++ or Java

JavaScript

Interception

Change on the Fly

Native

Yes

Yes

No

Yes

No

API

No

Yes

No

Yes

No

User Defined

No

No

Yes

Yes

Yes

+

Call getJSFunctionType() to determine which function type it is.

+
+
+
+

Function Interception

+

Functions can be intercepted via Javet API. This is equivalent to the capability provided by Node.js. However, there is still a key difference between user defined functions and function interception: local scoped context is visible to user defined function, but invisible to function interceptor. Why? That's a long story related to how closure is implemented in V8 which is not the goal in this section. If local scoped context has to be required, please consider changing the function on the fly which is documented in next section.

+

com.caoccao.javet.values.reference.IV8ValueObject exposes a set of bindFunction() that allow caller to register function interceptors in automatic or manual ways.

+
+

Automatic Registration

+
+

bind()

+

bind() scans the input callback receiver for functions decorated by @V8Function and @V8Property. It allows registering many getters / setters and functions in one call.

+
List<JavetCallbackContext> bind(Object functionCallbackReceiver);
+
+
+
+
+

How about Object Type Conversion?

+

As V8 only accepts data represented by its own format, Java objects need to be converted to native V8Value objects. Creating native V8Value objects is tricky in the callback receiver. There are typically 2 options.

+
    +

  1. Use Object Converter - Enhance the Object Converter and it just works as a charm. This is the recommended option. Please refer to generateArrayWithConverter().

    2. +
+

The beauty of the object converter is Javet doesn't intrude into the receiver at all so that application may pass any objects that are untouchable in the application code, e.g. a native object from a 3rd party library. Of course, in that situation, application may ignore the annotation and register the methods directly in the manual registration which is documented in the next section.

+
    +

  1. Convert via V8Runtime - V8Runtime can be directly used to perform the type conversion. V8Runtime can be manually set by application, or borrowed from the input arguments. Sometimes the callback receiver is not able to borrow V8Runtime from input arguments, it may decorate a setter with @V8RuntimeSetter so that Javet will inject the current V8Runtime. Please refer to generateArrayWithoutConverter().

    2. +
+

Here is a sample. The first step is to declare callback receiver and callback functions. That is quite easy as the sample code shows.

+
public class AnnotationBasedCallbackReceiver {
+    private V8Runtime v8Runtime;
+    private String stringValue;
+
+    public AnnotationBasedCallbackReceiver() {
+        stringValue = null;
+        v8Runtime = null;
+    }
+
+    // Javet detects the getter automatically.
+    @V8Property(name = "stringValue")
+    public String getStringValue() {
+        return stringValue;
+    }
+
+    // Javet detects the setter and property name automatically.
+    @V8Property
+    public void setStringValue(String stringValue) {
+        this.stringValue = stringValue;
+    }
+
+    // Instance method with same name and same signature.
+    @V8Function(name = "echo")
+    public String echo(String str) {
+        return str;
+    }
+
+    // Instance method with different name and same signature.
+    @V8Function(name = "add")
+    public Integer mathAdd(Integer a, Integer b) {
+        return a + b;
+    }
+
+    // Instance method with converter for non-primitive objects.
+    @V8Function(name = "generateArrayWithConverter")
+    public Object[] generateArrayWithConverter() throws JavetException {
+        // Converter is able to recognize non-primitive types.
+        return new Object[]{"a", 1};
+    }
+
+    // Instance method requiring V8Runtime without converter.
+    @V8Function(name = "generateArrayWithoutConverter")
+    public V8ValueArray generateArrayWithoutConverter() throws JavetException {
+        V8ValueArray v8ValueArray = v8Runtime.createV8ValueArray();
+        v8ValueArray.push("a");
+        v8ValueArray.push(1);
+        return v8ValueArray;
+    }
+
+    // Static method.
+    @V8Function(name = "staticEcho")
+    public static String staticEcho(String str) {
+        return str;
+    }
+
+    // Declare the V8RuntimeSetter for dependency injection.
+    @V8RuntimeSetter
+    public void setV8Runtime(V8Runtime v8Runtime) {
+        this.v8Runtime = v8Runtime;
+    }
+}
+
+
+

The second step is to call the functions or properties.

+
try (V8ValueObject v8ValueObject = v8Runtime.createV8ValueObject()) {
+    v8Runtime.getGlobalObject().set("a", v8ValueObject);
+    AnnotationBasedCallbackReceiver annotationBasedCallbackReceiver = new AnnotationBasedCallbackReceiver();
+    v8ValueObject.bind(annotationBasedCallbackReceiver);
+    assertEquals("test", v8Runtime.getExecutor("a.echo('test')").executeString());
+    assertEquals(3, v8Runtime.getExecutor("a.add(1, 2)").executeInteger());
+    try (V8ValueArray v8ValueArray = v8Runtime.getExecutor(
+            "a.generateArrayWithConverter()").execute()) {
+        assertEquals("[\"a\",1]", v8ValueArray.toJsonString());
+    }
+    try (V8ValueArray v8ValueArray = v8Runtime.getExecutor(
+            "a.generateArrayWithoutConverter()").execute()) {
+        assertEquals("[\"a\",1]", v8ValueArray.toJsonString());
+    }
+    assertEquals("static", v8Runtime.getExecutor("a.staticEcho('static')").executeString());
+    v8Runtime.getExecutor("a.stringValue = 'abc';").executeVoid();
+    assertEquals("abc", v8Runtime.getExecutor("a.stringValue").executeString());
+    v8Runtime.getGlobalObject().delete("a");
+}
+
+
+
+
+

Can this be Passed in?

+

Yes, both @V8Function and @V8Property support thisObjectRequired. Just set it to true and specify the first argument as this.

+
@V8Property(thisObjectRequired = true)
+public ... functionName(V8ValueObject thisObject, ...) {
+    // function body
+}
+
+
+

This feature is especially useful when this needs to be returned. Just simply return the input this object and there is no need to create a new V8 object.

+
+
+

Can Symbol Properties be Intercepted?

+

Yes, @V8Property supports symbol. Just set it to true.

+
@V8Property(symbol = true)
+public String getValue() {
+    return value;
+}
+
+@V8Property(symbol = true)
+public void setValue(String value) {
+    this.value = value;
+}
+
+
+

Be careful, Javet only supports symbols that are registered as global symbols in property interception.

+
+
+

How to Disable Properties or Functions?

+

As @V8Function and @V8Property are statically declared, there is no way of selectively disabling them. @V8BindEnabler is designed to give Javet a hint on which properties or functions are enabled. Here is a sample.

+
@V8Function
+public String disabledFunction() {
+    return "I am a disabled function.";
+}
+
+@V8Property
+public String disabledProperty() {
+    return "I am a disabled property.";
+}
+
+@V8BindEnabler
+public boolean isV8BindEnabled(String methodName) {
+    if ("disabledFunction".equals(methodName) || "disabledProperty".equals(methodName)) {
+        return false;
+    }
+    return true;
+}
+
+
+

@V8BindEnabler can be used to decorate a method with signature boolean arbitraryMethod(String methodName). Javet calls that method by each method name for whether each method is enabled or not.

+
+
+

How to Unregister Properties or Functions?

+

unbind() follows the same way that bind() goes to unregister both properties and functions.

+

unbindProperty() and unbindFunction() provide precise way of unregistering single property or function.

+
+
+
+

Manual Registration

+

Manual registration allows the applications to have full control over every step of the function interception.

+
+

boolean bindFunction(String functionName, JavetCallbackContext javetCallbackContext)

+

This method is for binding a Java code based function in semi-manual way. The caller is expected to do the following steps.

+
    +

  • Create a callback receiver.

    • +

  • Find certain callback method in the callback receiver.

    • +

  • Create JavetCallbackContext by the callback receiver and callback method.

    • +

  • Bind the callback context to a V8 object via bindFunction.

    • +

  • Call the function to trigger the callback.

    • +
+
MockCallbackReceiver mockCallbackReceiver = new MockCallbackReceiver(v8Runtime);
+JavetCallbackContext javetCallbackContext = new JavetCallbackContext(
+        mockCallbackReceiver, mockCallbackReceiver.getMethod("blank"));
+V8ValueObject globalObject = v8Runtime.getGlobalObject();
+globalObject.bindFunction("blank", javetCallbackContext);
+v8Runtime.getExecutor("blank();").executeVoid();
+globalObject.delete("blank");
+
+
+
+
+

boolean set(String key, V8Value value)

+

This method is for binding a Java code based function in complete manual way. The caller is expected to do the following steps.

+
    +

  • Create a callback receiver.

    • +

  • Find certain callback method in the callback receiver.

    • +

  • Create JavetCallbackContext by the callback receiver and callback method.

    • +

  • Create V8ValueFunction by JavetCallbackContext.

    • +

  • Bind the function to a V8 object via set.

    • +

  • Call the function to trigger the callback.

    • +
+
MockCallbackReceiver mockCallbackReceiver = new MockCallbackReceiver(v8Runtime);
+JavetCallbackContext javetCallbackContext = new JavetCallbackContext(
+        mockCallbackReceiver, mockCallbackReceiver.getMethod("blank"));
+V8ValueObject globalObject = v8Runtime.getGlobalObject();
+try (V8ValueFunction v8ValueFunction = v8Runtime.createV8ValueFunction(javetCallbackContext);
+        V8ValueObject a = v8Runtime.createV8ValueObject()) {
+    globalObject.set("a", a);
+    a.set("blank", v8ValueFunction);
+    assertFalse(mockCallbackReceiver.isCalled());
+    v8Runtime.getExecutor("a.blank();").executeVoid();
+    assertTrue(mockCallbackReceiver.isCalled());
+    a.delete("blank");
+    globalObject.delete("a");
+}
+
+
+
+
+

boolean bindFunction(String functionName, String codeString)

+

This method is for binding a JavaScript code based function.

+
v8Runtime.getGlobalObject().bindFunction("b", "(x) => x + 1;");
+assertEquals(2, v8Runtime.getExecutor("b(1);").executeInteger());
+v8Runtime.getGlobalObject().delete("b");
+
+
+
+
+
+

Type Mismatch

+

It is very easy to cause type mismatches in JavaScript. The Javet exception is so generic that applications may not be happy with it. So, how to customize the type mismatch exception? The recommended way is to declare the function signature to (V8Value... v8Values) or (Object... objects).

+
    +

  • Javet doesn't throw exceptions under this signature in all cases.

    • +

  • Application is the one that performs the argument validation so that the error handling is completely customized.

    • +

  • When dealing with V8Value..., application is responsible for the type conversion.

    • +

  • Variable arguments can be achieved under this signature so that a JavaScript function can be completely mirrored in Java.

    • +
+
+
+

Resource Management

+

In the function callback, Javet manages the lifecycle of the input arguments and the return value. So, DO NOT close the input arguments, and DO NOT apply try-with-resource to the return value.

+
+
+

Summary

+

Obviously, the automatic registration is much better than the manual registration. Please use them wisely.

+
+
+
+

Change a User Defined JavaScript Function on the Fly

+
+

Why is Changing a User Defined JavaScript Function Important?

+

Functions can be changed on the fly at JavaScript code level via Javet API. Why to choose this approach? Because sometimes local scoped context is required which is usually called closure. E.g:

+
const a = function () {
+    const b = 1;
+    return () => b;
+}
+const x = a();
+console.log(x());
+// Output is: 1
+
+
+

Local const b is visible to the anonymous function at line 3, but invisible to the function interceptor. Javet provides a way of changing the function at JavaScript source code level so that local scoped context is still visible.

+
+
+

How to Change a User Defined JavaScript Function on the Fly?

+

getSourceCode() and setSourceCode(String sourceCode) are designed for getting and setting the source code. setSourceCode(String sourceCode) actually performs the follow steps.

+
def setSourceCode(sourceCode):
+    existingSourceCode = v8Function.getSourceCode()
+    (startPosition, endPosition) = v8Function.getPosition()
+    newSourceCode = existingSourceCode[:startPosition] + sourceCode + existingSourceCode[endPosition:]
+    v8Function.setSourceCode(newSourceCode)
+    v8Function.setPosition(startPosition, startPosition + len(sourceCode))
+
+
+

Be careful, setSourceCode(String sourceCode) has radical impacts that may break the execution because all functions during one execution share the same source code but have their own positions. The following diagram shows the rough memory layout. Assuming function (4) has been changed to something else with position changed, function (1) and (2) will not be impacted because their positions remain the same, but function (3) will be broken because its end position is not changed to the end position of function (4) accordingly.

+Memory Layout of V8 Function +

Javet does not scan memory for all impacted function. So, it is caller's responsibility for restoring the original source code after invocation. The pseudo logic is as following.

+
originalSourceCode = v8ValueFunction.getSourceCode()
+v8ValueFunction.setSourceCode(sourceCode)
+v8ValueFunction.call(...)
+v8ValueFunction.setSourceCode(originalSourceCode)
+
+
+

Why does setSourceCode() sometimes return false? Usually, that means the local scoped context hasn't been generated by V8. getJSScopeType().isClass() == true indicates that state. After callVoid(null), the local scoped context will be created with getJSScopeType().isFunction() == true and setSourceCode() will work. The pseudo logic is as following.

+
originalSourceCode = v8ValueFunction.getSourceCode()
+if (v8ValueFunction.getJSScopeType().isClass()) {
+    try {
+        v8ValueFunction.callVoid(null);
+        // Now v8ValueFunction.getJSScopeType().isFunction() is true
+    } catch (JavetException e) {
+    }
+}
+v8ValueFunction.setSourceCode(sourceCode) // true
+v8ValueFunction.call(...)
+v8ValueFunction.setSourceCode(originalSourceCode)
+
+
+

The rough lifecycle of a V8 function is as following.

+Lifecycle of V8 Function +
+
+

What is the Source Code of a Function in V8?

+

When V8 calculates start position of a function, it does not include the keyword function and function name. E.g.

+
function abc(a, b, c) { ... } // Source code is (a, b, c) { ... }
+
+(a, b, c) => { ... }          // Source code is (a, b, c) => { ... }
+
+
+

So, please always discard the keyword function and function name when calling setSourceCode().

+
+
+
+

Automatic Type Conversion

+

Javet is capable of automatically converting its internal V8Value to primitive types by inspecting the function signature. So, the following 4 functions are all the same and valid.

+
// Option 1
+public String echo(String str) {
+    return str;
+}
+
+// Option 2
+public String echo(V8Value arg) {
+    return arg == null ? null : arg.toString();
+}
+
+// Option 3
+public V8Value echo(String str) {
+    return v8Runtime.createV8ValueString(str);
+}
+
+// Option 4
+public V8Value echo(V8Value arg) throws JavetException {
+    return arg.toClone();
+}
+
+// All 4 functions above can be handled in Javet as the following function
+echo("123");
+
+
+

Primitive types can be in either primitive or object form in the method signature. Javet just automatically handles the type conversion and it is null safe.

+
    +

  • boolean: boolean, Boolean, null ⟶️ false, undefined ⟶️ false.

    • +

  • byte, integer, long, Short: int, Integer, long, Long, short, Short, byte, Byte, null ⟶️ 0, undefined ⟶️ 0.

    • +

  • char: char, Char, null ⟶️ \0, undefined ⟶️ \0.

    • +

  • float, double: float, Float, double, Double, int, Integer, long, Long, short, Short, byte, Byte, null ⟶️ 0, undefined ⟶️ 0.

    • +
+

For instance: The following 4 functions are all the same and valid.

+
// Option 1
+public int echo(Integer i) {
+    return i == null? 0: i.intValue();
+}
+
+// Option 2
+public Integer echo(int arg) {
+    return Integer.valueOf(int);
+}
+
+// Option 3
+public V8ValueInteger echo(int i) {
+    return new V8ValueInteger(i);
+}
+
+// Option 4
+public Integer echo(V8ValueInteger i) {
+    return i == null? 0: i.getValue();
+}
+
+
+

Can the default values be changed in terms of null safety? Yes, Object Converter allows overriding the default values.

+
+
+

Call vs. Invoke

+

In one sentence, call() belongs to function and invoke() belongs to object.

+
+

Call

+

call() is almost equivalent to Function.prototype.call(). It allows the caller to specify receiver. Besides, Javet combines Function.prototype.call() and Function.prototype.apply() because Java is friendly to varargs.

+
func.call(object, a, b, c); // func.call(object, a, b, c); with V8 object returned
+func.callVoid(object, a, b, c); // func.call(object, a, b, c); without return
+func.callObject(object, a, b, c); // func.call(object, a, b, c); with Java object returned
+func.callPrimitive(object, a, b, c); // func.call(object, a, b, c); with Java primitive returned
+func.callAsConstructor(a, b, c); // new func(a, b, c);
+
+
+
+
+

Invoke

+

invoke() takes function name and arguments, but not receiver because the object itself is the receiver. So the API is almost identical to call() except for the first argument.

+
object.invoke("func", a, b, c); // object.func(a, b, c); with V8 object returned
+object.invokeVoid("func", a, b, c); // object.func(a, b, c); without return
+object.invokeObject("func", a, b, c); // object.func(a, b, c); with Java object returned
+object.invokePrimitive("func", a, b, c); // object.func(a, b, c); with Java primitive returned
+
+
+

invoke() is heavily used in Javet so that the JNI implementation can be dramatically simplified. In few extreme cases, V8 doesn't expose its C++ API and invoke() appears to be the only way. So, feel free to invoke all kinds of JS API despite of the deficit of Javet built-in API.

+
+
+

How about Bind?

+

Function.prototype.bind() is simply a set() in Javet.

+
// func.bind(object); func(a, b, c); with return
+object.set("func", func); object.invoke("func", a, b, c);
+
+// func.bind(object); func(a, b, c); without return
+object.set("func", func); object.invokeVoid("func", a, b, c);
+
+
+

Please review the test cases for more detail.

+
+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/reference/v8_function.rst b/docs/reference/v8_function.rst index 16c5a544b..575960ab2 100644 --- a/docs/reference/v8_function.rst +++ b/docs/reference/v8_function.rst @@ -34,8 +34,8 @@ Functions can be intercepted via Javet API. This is equivalent to the capability Automatic Registration ---------------------- -``bind()`` -^^^^^^^^^^ +bind() +^^^^^^ ``bind()`` scans the input callback receiver for functions decorated by ``@V8Function`` and ``@V8Property``. It allows registering many getters / setters and functions in one call. @@ -48,7 +48,7 @@ How about Object Type Conversion? As V8 only accepts data represented by its own format, Java objects need to be converted to native ``V8Value`` objects. Creating native ``V8Value`` objects is tricky in the callback receiver. There are typically 2 options. -1. **Use Object Converter** - Enhance the `Object Converter `_ and it just works as a charm. This is the recommended option. Please refer to ``generateArrayWithConverter()``. +1. **Use Object Converter** - Enhance the :doc:`../tutorial/advanced/object_converter` and it just works as a charm. This is the recommended option. Please refer to ``generateArrayWithConverter()``. The beauty of the object converter is Javet doesn't intrude into the receiver at all so that application may pass any objects that are untouchable in the application code, e.g. a native object from a 3rd party library. Of course, in that situation, application may ignore the annotation and register the methods directly in the manual registration which is documented in the next section. @@ -144,7 +144,7 @@ The second step is to call the functions or properties. v8Runtime.getGlobalObject().delete("a"); } -Can ``this`` be Passed in? +Can **this** be Passed in? ^^^^^^^^^^^^^^^^^^^^^^^^^^ Yes, both ``@V8Function`` and ``@V8Property`` support ``thisObjectRequired``. Just set it to ``true`` and specify the first argument as ``this``. @@ -216,8 +216,8 @@ Manual Registration Manual registration allows the applications to have full control over every step of the function interception. -``boolean bindFunction(String functionName, JavetCallbackContext javetCallbackContext)`` -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +boolean bindFunction(String functionName, JavetCallbackContext javetCallbackContext) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ This method is for binding a Java code based function in semi-manual way. The caller is expected to do the following steps. @@ -237,8 +237,8 @@ This method is for binding a Java code based function in semi-manual way. The ca v8Runtime.getExecutor("blank();").executeVoid(); globalObject.delete("blank"); -``boolean set(String key, V8Value value)`` -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +boolean set(String key, V8Value value) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ This method is for binding a Java code based function in complete manual way. The caller is expected to do the following steps. @@ -266,8 +266,8 @@ This method is for binding a Java code based function in complete manual way. Th globalObject.delete("a"); } -``boolean bindFunction(String functionName, String codeString)`` -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +boolean bindFunction(String functionName, String codeString) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ This method is for binding a JavaScript code based function. @@ -333,7 +333,7 @@ How to Change a User Defined JavaScript Function on the Fly? Be careful, ``setSourceCode(String sourceCode)`` has radical impacts that may break the execution because all functions during one execution share the same source code but have their own positions. The following diagram shows the rough memory layout. Assuming function (4) has been changed to something else with position changed, function (1) and (2) will not be impacted because their positions remain the same, but function (3) will be broken because its end position is not changed to the end position of function (4) accordingly. -.. image:: ../resources/images/memory_layout_of_v8_function.png?raw=true +.. image:: ../resources/images/memory_layout_of_v8_function.png :alt: Memory Layout of V8 Function Javet does not scan memory for all impacted function. So, it is caller's responsibility for restoring the original source code after invocation. The pseudo logic is as following. @@ -363,7 +363,7 @@ Why does ``setSourceCode()`` sometimes return ``false``? Usually, that means the The rough lifecycle of a V8 function is as following. -.. image:: ../resources/images/lifecycle_of_v8_function.png?raw=true +.. image:: ../resources/images/lifecycle_of_v8_function.png :alt: Lifecycle of V8 Function What is the Source Code of a Function in V8? @@ -411,10 +411,10 @@ Javet is capable of automatically converting its internal ``V8Value`` to primiti Primitive types can be in either primitive or object form in the method signature. Javet just automatically handles the type conversion and it is null safe. -* ``boolean``: ``boolean``, ``Boolean``, ``null`` ➡️ ``false``, ``undefined`` ➡️ ``false``. -* ``byte``, ``integer``, ``long``, ``Short``: ``int``, ``Integer``, ``long``, ``Long``, ``short``, ``Short``, ``byte``, ``Byte``, ``null`` ➡️ ``0``, ``undefined`` ➡️ ``0``. -* ``char``: ``char``, ``Char``, ``null`` ➡️ ``\0``, ``undefined`` ➡️ ``\0``. -* ``float``, ``double``: ``float``, ``Float``, ``double``, ``Double``, ``int``, ``Integer``, ``long``, ``Long``, ``short``, ``Short``, ``byte``, ``Byte``, ``null`` ➡️ ``0``, ``undefined`` ➡️ ``0``. +* ``boolean``: ``boolean``, ``Boolean``, ``null`` ⟶️ ``false``, ``undefined`` ⟶️ ``false``. +* ``byte``, ``integer``, ``long``, ``Short``: ``int``, ``Integer``, ``long``, ``Long``, ``short``, ``Short``, ``byte``, ``Byte``, ``null`` ⟶️ ``0``, ``undefined`` ⟶️ ``0``. +* ``char``: ``char``, ``Char``, ``null`` ⟶️ ``\0``, ``undefined`` ⟶️ ``\0``. +* ``float``, ``double``: ``float``, ``Float``, ``double``, ``Double``, ``int``, ``Integer``, ``long``, ``Long``, ``short``, ``Short``, ``byte``, ``Byte``, ``null`` ⟶️ ``0``, ``undefined`` ⟶️ ``0``. For instance: The following 4 functions are all the same and valid. @@ -440,7 +440,7 @@ For instance: The following 4 functions are all the same and valid. return i == null? 0: i.getValue(); } -Can the default values be changed in terms of null safety? Yes, `Object Converter `_ allows overriding the default values. +Can the default values be changed in terms of null safety? Yes, :doc:`../tutorial/advanced/object_converter` allows overriding the default values. Call vs. Invoke =============== @@ -481,9 +481,10 @@ How about Bind? .. code-block:: java - object.set("func", func); object.invoke("func", a, b, c); // func.bind(object); func(a, b, c); with return - object.set("func", func); object.invokeVoid("func", a, b, c); // func.bind(object); func(a, b, c); without return + // func.bind(object); func(a, b, c); with return + object.set("func", func); object.invoke("func", a, b, c); -Please review `test cases <../../src/test/java/com/caoccao/javet/values/reference/TestV8ValueFunction.java>`_ for more detail. + // func.bind(object); func(a, b, c); without return + object.set("func", func); object.invokeVoid("func", a, b, c); -[`Home <../../README.rst>`_] [`Javet Reference `_] +Please review the :extsource2:`test cases <../../src/test/java/com/caoccao/javet/values/reference/TestV8ValueFunction.java>` for more detail. diff --git a/docs/reference/v8_promise.html b/docs/reference/v8_promise.html new file mode 100644 index 000000000..eab625baa --- /dev/null +++ b/docs/reference/v8_promise.html @@ -0,0 +1,432 @@ + + + + + + + + V8 Promise - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

V8 Promise

+

V8 promise is an advanced topic because it's usually hard to be mastered due to its multi-threaded nature. Javet enables applications to play with V8 promise in a decent way.

+
+

Promise and Resolver

+

Resolver is a new concept to some JavaScript developers. In fact, it is already an old friend. Inside new Promise((resolve, reject) => {});, (resolve, reject) is called resolver in V8. Javet exposes the V8 promise and resolver via the same interface IV8ValuePromise because in V8 they really are the same. So, they both share the same set of API. But the ownership of the API makes the difference as the following chart shows.

+V8 Promise and Resolver +
+
+

Lifecycle

+

The lifecycle is as the following chart shows.

+
    +

  1. JavaScript application calls an API for certain resource. E.g. readFileAsync.

    2. +

  2. Java application receives a callback from V8 for the resource.

    3. +

  3. Java application creates a V8 promise resolver and holds the resolver.

    4. +

  4. Java application gets a V8 promise from the resolver and returns that V8 promise as callback return.

    5. +

  5. JavaScript application gets that promise and binds the .then() and .catch().

    6. +

  6. Java application fetches the resource and calls the resolver via .resolve().

    7. +

  7. JavaScript application receives the resource in .then() and processes the result.

    8. +
+V8 Promise Lifecycle +
+
+

Example fs.readFileAsync()

+

Requirements: Create a JavaScript API fs.readFileAsync() for reading a file in async manner.

+

The pseudo code is as following.

+
// Java application injects an interceptor as 'fs'.
+v8Runtime.getGlobalObject().set("fs", fs);
+
+
+
// JavaScript application calls 'readFileAsync()' and registers 'then()'
+fs.readFileAsync('a.log').then(fileContent => console.log(fileContent));
+
+
+
// Java application creates a resolver, pushes the resolver to task queue, returns a promise from the resolver.
+@V8Function
+public V8ValuePromise readFileAsync(String filePath) throws JavetException {
+    V8ValuePromise v8ValuePromiseResolver = v8Runtime.createV8ValuePromise();
+    queue.add(new Task(v8ValuePromiseResolver, filePath, timeout));
+    return v8ValuePromiseResolver.getPromise();
+}
+
+
+
// Java application fetches the file content and resolve/reject the promise in a background thread.
+String fileContent = getFileContent(task.getFilePath());
+try (V8ValuePromise promise = task.getPromise()) {
+    if (fileContent == null) {
+        promise.reject(v8Runtime.createV8ValueUndefined());
+    } else {
+        promise.resolve(fileContent);
+    }
+}
+// JavaScript application prints the file content in console afterwards.
+
+
+
+

Notes

+
    +

  • Java application needs to have background thread(s) process async calls from V8.

    • +

  • Node.js mode has its own event loop. So, sometimes, Java application has to call await() after resolve() or reject().

    • +
+
+
+
+

Unhandled Rejection

+

Sometimes Java application breaks when unhandled rejection is raised.

+

In V8 mode, V8Runtime.setPromiseRejectCallback() allows Java application to register a callback implementing IJavetPromiseRejectCallback.

+

In Node.js mode, event unhandledRejection is recommended to be listened.

+
import process from 'process';
+
+process.on('unhandledRejection', (reason, promise) => {
+    console.log('Unhandled Rejection at:', promise, 'reason:', reason);
+    // Application specific logging, throwing an error, or other logic here
+});
+
+
+

Be careful, the V8Runtime.setPromiseRejectCallback() in V8 mode also works in Node.js mode and it can disable the built-in Node.js event unhandledRejection. Sometimes, this is a handy feature.

+

Please review the test cases for more detail.

+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/reference/v8_promise.rst b/docs/reference/v8_promise.rst index 205f63199..2ecf7d696 100644 --- a/docs/reference/v8_promise.rst +++ b/docs/reference/v8_promise.rst @@ -9,7 +9,7 @@ Promise and Resolver Resolver is a new concept to some JavaScript developers. In fact, it is already an old friend. Inside ``new Promise((resolve, reject) => {});``, ``(resolve, reject)`` is called resolver in V8. Javet exposes the V8 promise and resolver via the same interface ``IV8ValuePromise`` because in V8 they really are the same. So, they both share the same set of API. But the ownership of the API makes the difference as the following chart shows. -.. image:: ../resources/images/v8_promise_and_resolver.png?raw=true +.. image:: ../resources/images/v8_promise_and_resolver.png :alt: V8 Promise and Resolver Lifecycle @@ -25,7 +25,7 @@ The lifecycle is as the following chart shows. 6. Java application fetches the resource and calls the resolver via ``.resolve()``. 7. JavaScript application receives the resource in ``.then()`` and processes the result. -.. image:: ../resources/images/v8_promise_lifecycle.png?raw=true +.. image:: ../resources/images/v8_promise_lifecycle.png :alt: V8 Promise Lifecycle Example fs.readFileAsync() @@ -94,6 +94,4 @@ In Node.js mode, event ``unhandledRejection`` is recommended to be listened. Be careful, the ``V8Runtime.setPromiseRejectCallback()`` in V8 mode also works in Node.js mode and it can disable the built-in Node.js event ``unhandledRejection``. Sometimes, this is a handy feature. -Please review `test cases <../../src/test/java/com/caoccao/javet/values/reference/TestV8ValuePromise.java>`_ for more detail. - -[`Home <../../README.rst>`_] [`Javet Reference `_] +Please review the :extsource2:`test cases <../../src/test/java/com/caoccao/javet/values/reference/TestV8ValuePromise.java>` for more detail. diff --git a/docs/release_notes.rst b/docs/release_notes.rst deleted file mode 100644 index 9bf84fd9a..000000000 --- a/docs/release_notes.rst +++ /dev/null @@ -1,228 +0,0 @@ -============= -Release Notes -============= - -0.9.11 ------- - -* Upgraded Node.js to ``v14.17.6`` `(2021-08-31) `_ -* Upgraded V8 to ``v9.3.345.16`` `(2021-08-17) `_ -* Added ``unbind()``, ``unbindProperty()``, ``unbindFunction()`` to ``IV8ValueObject`` -* Updated ``V8Runtime`` to be completely thread-safe -* Added ``V8ValueBuiltInSymbol`` -* Added ``getOwnPropertySymbols()`` to ``V8ValueBuiltInObject`` -* Added ``createV8ValueSymbol()`` to ``V8Runtime`` -* Added ``symbol`` to ``V8Property`` to enable getter and setter on symbol -* Added error code 407 and 805 - -0.9.10 ------- - -* Added ``JavetVirtualObject`` -* Updated ``JavetUniversalProxyHandler`` to allow passing ``V8Value`` -* Updated ``JavetUniversalProxyHandler`` to allow passing ``V8ValueFunction`` as anonymous function -* Updated ``JavetUniversalProxyHandler`` to allow passing ``V8ValueObject`` as anonymous object -* Added ``isClosed()`` to ``IJavetClosable`` -* Added error code 602 and 603 - -0.9.9 ------ - -* Upgraded Node.js to ``v14.17.4`` `(2021-07-29) `_ -* Added support to Mac OS x86_64 -* Removed ``staticClassEnabled`` from ``JavetProxyConverter`` - -0.9.8 ------ - -* Added ``resolve()`` and ``reject()`` to ``V8ValuePromise`` -* Added ``staticClassEnabled`` to ``JavetProxyConverter`` -* Added ``construct()`` to ``JavetUniversalProxyHandler`` -* Added Dockerfile for Linux x86-64 -* Refactored document for how to build Javet - -0.9.7 ------ - -* Added static mode to ``JavetUniversalProxyHandler`` -* Added ``ownKeys()`` to ``JavetUniversalProxyHandler`` - -0.9.6 ------ - -* Added ``IV8ValueProxy`` and ``V8ValueProxy`` -* Added ``getTarget()``, ``getHandler()``, ``isRevoked()`` and ``revoke()`` to ``IV8ValueProxy`` -* Added ``createV8ValueProxy()`` to ``V8Runtime`` -* Added ``JavetUniversalProxyHandler`` and ``JavetProxyConverter`` - -0.9.5 ------ - -* Upgraded V8 to ``v9.2.230.21`` `(2021-07-19) `_ - -0.9.4 ------ - -* Added ``JavetConverterConfig`` -* Added ``JavetEntityFunction`` for ``JavetObjectConverter`` -* Updated ``JavetObjectConverter`` to allow skipping functions -* Added ``getPrototype()`` and ``setPrototype()`` to ``IV8ValueObject`` -* Changed the way that Javet libraries are deployed to be multi-process safe - -0.9.3 ------ - -* Upgraded Node.js to ``v14.17.2`` `(2021-07-01) `_ -* Added ``IV8ModuleResolver`` to allow intercepting module resolving callback -* Added ``V8BindEnabler`` to determine whether certain injection is enabled or not -* Added ``NodeModuleProcess#getVersion`` -* Updated ``JavetPrimitiveConverter`` and ``JavetObjectConverter`` to check recursion depth for circular structure detection - -0.9.2 ------ - -* Upgraded Node.js to ``v14.17.1`` `(2021-06-15) `_ -* Updated ``JavetObjectConverter`` to handle anonymous functions more efficiently -* Added ``V8ValueBuiltInObject#assign`` - -0.9.1 ------ - -* Moved V8 to a custom classloader -* Enabled ``unloadLibrary()`` and ``loadLibrary()`` in ``V8Host`` - -0.9.0 ------ - -* Upgraded Node.js to ``v14.17.0`` `(2021-05-11) `_ -* Upgraded V8 to ``v9.1.269.28`` `(2021-05-10) `_ -* Added ``thisObjectRequired`` to ``@V8Function`` and ``@V8Property`` - -0.8.10 ------- - -* Renamed ``IJavetConsumer`` to ``IJavetUniConsumer`` -* Added ``IJavetUniIndexedConsumer`` and ``IJavetBiIndexedConsumer`` -* Fixed a bug in ``V8FunctionCallback`` on varargs -* Deprecated ``bindFunctions()`` and ``bindProperties()`` -* Added ``@CheckReturnValue`` to warn ignored return value - -0.8.9 ------ - -* Renamed ``setFunction()`` to ``bindFunction()`` in ``IV8ValueObject`` -* Renamed ``setFunctions()`` to ``bindFunctions()`` in ``IV8ValueObject`` -* Added ``disableInDebugMode()`` and ``enableInDebugMode()`` to ``JavetEngineGuard`` -* Added ``bind()``, ``bindProperty()`` and ``bindProperties()`` in ``IV8ValueObject`` -* Added ``@V8Property`` for ``IV8ValueObject.bindProperties()`` - -0.8.8 ------ - -* Re-organized doc. -* Added ``getJSFunctionType()``, ``getSourceCode()`` and ``setSourceCode()`` to ``IV8ValueFunction`` - -0.8.7 ------ - -* Supported native modules with rebuilt scripts -* Fixed ``NodeRuntime.await()`` to emit tasks - -0.8.6 ------ - -* Upgraded Linux build environment to Ubuntu 20.04 + GCC 9.3 -* Enhanced ``NodeRuntime.await()`` to allow interaction from other threads - -0.8.5 ------ - -* Universal object conversion is turned on for all API -* Added ``createV8ValueDouble()``, ``createV8ValueString()`` and ``createV8ValueZonedDateTime()`` to ``V8Runtime`` -* Added ``JavetError`` with error codes -* Refactored ``invoke()``, ``call()``, ``set()``, ``has()`` to take ``Object`` instead of ``V8Value`` -* Removed a few exceptions - -0.8.4 ------ - -* Added ``gcBeforeEngineClose`` to ``JavetEngineConfig`` -* Added ``JavetCallbackException`` -* Added ``IV8Value#isNullOrUndefined`` -* Upgraded Node.js to ``v14.16.1`` `(2021-04-06) `_ -* Upgraded V8 to ``v9.0.257`` `(2021-02-24) `_ - -0.8.3 ------ - -* Added ``V8Runtime.lowMemoryNotification()`` and ``V8Runtime.idleNotificationDeadline()`` -* Added ``V8Host.setMemoryUsageThresholdRatio()``, ``V8Host.enableGCNotification()``, and ``V8Host.disableGCNotification()`` -* Updated JavetEnginePool to be lock free -* Added ``autoSendGCNotification`` to ``JavetEngineConfig`` -* Moved ``JavetCallbackContext`` management from ``V8ValueFunction`` to V8 -* Added ``JavetPromiseRejectCallback`` for V8 mode - -0.8.2 ------ - -* Enabled auto type conversion in primitive types -* Fixed a memory leak issue during V8Runtime ``resetContext()``, ``resetIsolate()``, ``close()`` - -0.8.1 ------ - -* Enabled declarative function interception -* Enabled custom object converter in function callback -* Added ``allowEval`` to ``JavetEngineConfig`` -* Refactored built-in module API for Node.js mode - -0.8.0 ------ - -* Supported Node.js ``v14.16.0`` `(2021-02-23) `_ -* Added ``V8Module`` and ``V8Script`` -* Enhanced ``V8ValuePromise`` -* Added dynamic switch between Node.js and V8 - -0.7.4 ------ - -* Added V8 primitive value cache -* Added live debug for Chrome Developer Tools - -0.7.3 ------ - -* Added ``V8ValueWeakMap`` and ``V8ValueWeakSet`` -* Added ``forEach()`` to Collection -* Added ``V8Locker`` for Performance Sensitive Scenarios - -0.7.2 ------ - -* Added ``setFunction(String functionName, String codeString)`` to ``IV8ValueObject`` -* Added ``equals()`` and ``strictEquals()`` and ``sameValue()`` to ``IV8Value`` -* Added ``getIdentityHash()`` to ``IV8ValueReference`` -* Added ``isDead()``, ``isInUse()``, ``callAsConstructor()`` and ``terminateExecution()`` to ``V8Runtime`` -* Added V8 typed array and data view -* Added ``IJavetEngineGuard`` - -0.7.1 ------ - -* Easy spring integration -* Performance test cases -* Few bug fixes - -0.7.0 ------ - -* First release of Javet -* Linux + Windows -* V8 ``v8.9.255`` `(2021-02-04) `_ -* Exposure of the majority of V8 API in JVM -* JS function interception -* Native BigInt and Date -* Javet engine pool - -[`Home <../README.rst>`_] diff --git a/docs/release_notes/index.html b/docs/release_notes/index.html new file mode 100644 index 000000000..9fc73232f --- /dev/null +++ b/docs/release_notes/index.html @@ -0,0 +1,337 @@ + + + + + + + + Release Notes - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+ +
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/release_notes/index.rst b/docs/release_notes/index.rst new file mode 100644 index 000000000..63ed9ba28 --- /dev/null +++ b/docs/release_notes/index.rst @@ -0,0 +1,10 @@ +============= +Release Notes +============= + +.. toctree:: + :maxdepth: 1 + + release_notes_0_9 + release_notes_0_8 + release_notes_0_7 diff --git a/docs/release_notes/release_notes_0_7.html b/docs/release_notes/release_notes_0_7.html new file mode 100644 index 000000000..f7b50cfa9 --- /dev/null +++ b/docs/release_notes/release_notes_0_7.html @@ -0,0 +1,399 @@ + + + + + + + + Release Notes 0.7.x - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Release Notes 0.7.x

+
+

0.7.4 Live Debug

+
    +

  • Added V8 primitive value cache

    • +

  • Added live debug for Chrome Developer Tools

    • +
+
+
+

0.7.3 Locker

+
    +

  • Added V8ValueWeakMap and V8ValueWeakSet

    • +

  • Added forEach() to Collection

    • +

  • Added V8Locker for Performance Sensitive Scenarios

    • +
+
+
+

0.7.2 Engine Guard

+
    +

  • Added setFunction(String functionName, String codeString) to IV8ValueObject

    • +

  • Added equals() and strictEquals() and sameValue() to IV8Value

    • +

  • Added getIdentityHash() to IV8ValueReference

    • +

  • Added isDead(), isInUse(), callAsConstructor() and terminateExecution() to V8Runtime

    • +

  • Added V8 typed array and data view

    • +

  • Added IJavetEngineGuard

    • +
+
+
+

0.7.1 Bug Fixes

+
    +

  • Easy spring integration

    • +

  • Performance test cases

    • +

  • Few bug fixes

    • +
+
+
+

0.7.0 Birth with V8 v8.9

+
    +

  • First release of Javet

    • +

  • Linux + Windows

    • +

  • V8 v8.9.255 (2021-02-04)

    • +

  • Exposure of the majority of V8 API in JVM

    • +

  • JS function interception

    • +

  • Native BigInt and Date

    • +

  • Javet engine pool

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/release_notes/release_notes_0_7.rst b/docs/release_notes/release_notes_0_7.rst new file mode 100644 index 000000000..65796b08e --- /dev/null +++ b/docs/release_notes/release_notes_0_7.rst @@ -0,0 +1,44 @@ +=================== +Release Notes 0.7.x +=================== + +0.7.4 Live Debug +---------------- + +* Added V8 primitive value cache +* Added live debug for Chrome Developer Tools + +0.7.3 Locker +------------ + +* Added ``V8ValueWeakMap`` and ``V8ValueWeakSet`` +* Added ``forEach()`` to Collection +* Added ``V8Locker`` for Performance Sensitive Scenarios + +0.7.2 Engine Guard +------------------ + +* Added ``setFunction(String functionName, String codeString)`` to ``IV8ValueObject`` +* Added ``equals()`` and ``strictEquals()`` and ``sameValue()`` to ``IV8Value`` +* Added ``getIdentityHash()`` to ``IV8ValueReference`` +* Added ``isDead()``, ``isInUse()``, ``callAsConstructor()`` and ``terminateExecution()`` to ``V8Runtime`` +* Added V8 typed array and data view +* Added ``IJavetEngineGuard`` + +0.7.1 Bug Fixes +--------------- + +* Easy spring integration +* Performance test cases +* Few bug fixes + +0.7.0 Birth with V8 v8.9 +------------------------ + +* First release of Javet +* Linux + Windows +* V8 ``v8.9.255`` `(2021-02-04) `_ +* Exposure of the majority of V8 API in JVM +* JS function interception +* Native BigInt and Date +* Javet engine pool diff --git a/docs/release_notes/release_notes_0_8.html b/docs/release_notes/release_notes_0_8.html new file mode 100644 index 000000000..17fbc912d --- /dev/null +++ b/docs/release_notes/release_notes_0_8.html @@ -0,0 +1,456 @@ + + + + + + + + Release Notes 0.8.x - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Release Notes 0.8.x

+
+

0.8.10 Index in forEach

+
    +

  • Renamed IJavetConsumer to IJavetUniConsumer

    • +

  • Added IJavetUniIndexedConsumer and IJavetBiIndexedConsumer

    • +

  • Fixed a bug in V8FunctionCallback on varargs

    • +

  • Deprecated bindFunctions() and bindProperties()

    • +

  • Added @CheckReturnValue to warn ignored return value

    • +
+
+
+

0.8.9 Declarative Property Interception

+
    +

  • Renamed setFunction() to bindFunction() in IV8ValueObject

    • +

  • Renamed setFunctions() to bindFunctions() in IV8ValueObject

    • +

  • Added disableInDebugMode() and enableInDebugMode() to JavetEngineGuard

    • +

  • Added bind(), bindProperty() and bindProperties() in IV8ValueObject

    • +

  • Added @V8Property for IV8ValueObject.bindProperties()

    • +
+
+
+

0.8.8 Hotfix the Source Code

+
    +

  • Re-organized doc.

    • +

  • Added getJSFunctionType(), getSourceCode() and setSourceCode() to IV8ValueFunction

    • +
+
+
+

0.8.7 Native Modules for Node.js

+
    +

  • Supported native modules with rebuilt scripts

    • +

  • Fixed NodeRuntime.await() to emit tasks

    • +
+
+
+

0.8.6 Event Loop for Node.js

+
    +

  • Upgraded Linux build environment to Ubuntu 20.04 + GCC 9.3

    • +

  • Enhanced NodeRuntime.await() to allow interaction from other threads

    • +
+
+
+

0.8.5 Error Codes

+
    +

  • Universal object conversion is turned on for all API

    • +

  • Added createV8ValueDouble(), createV8ValueString() and createV8ValueZonedDateTime() to V8Runtime

    • +

  • Added JavetError with error codes

    • +

  • Refactored invoke(), call(), set(), has() to take Object instead of V8Value

    • +

  • Removed a few exceptions

    • +
+
+
+

0.8.4 V8 v9.0

+
    +

  • Added gcBeforeEngineClose to JavetEngineConfig

    • +

  • Added JavetCallbackException

    • +

  • Added IV8Value#isNullOrUndefined

    • +

  • Upgraded Node.js to v14.16.1 (2021-04-06)

    • +

  • Upgraded V8 to v9.0.257 (2021-02-24)

    • +
+
+
+

0.8.3 GC

+
    +

  • Added V8Runtime.lowMemoryNotification() and V8Runtime.idleNotificationDeadline()

    • +

  • Added V8Host.setMemoryUsageThresholdRatio(), V8Host.enableGCNotification(), and V8Host.disableGCNotification()

    • +

  • Updated JavetEnginePool to be lock free

    • +

  • Added autoSendGCNotification to JavetEngineConfig

    • +

  • Moved JavetCallbackContext management from V8ValueFunction to V8

    • +

  • Added JavetPromiseRejectCallback for V8 mode

    • +
+
+
+

0.8.2 Conversion for Primitive

+
    +

  • Enabled auto type conversion in primitive types

    • +

  • Fixed a memory leak issue during V8Runtime resetContext(), resetIsolate(), close()

    • +
+
+
+

0.8.1 Declarative Function Interception

+
    +

  • Enabled declarative function interception

    • +

  • Enabled custom object converter in function callback

    • +

  • Added allowEval to JavetEngineConfig

    • +

  • Refactored built-in module API for Node.js mode

    • +
+
+
+

0.8.0 First Time with Node.js

+
    +

  • Supported Node.js v14.16.0 (2021-02-23)

    • +

  • Added V8Module and V8Script

    • +

  • Enhanced V8ValuePromise

    • +

  • Added dynamic switch between Node.js and V8

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/release_notes/release_notes_0_8.rst b/docs/release_notes/release_notes_0_8.rst new file mode 100644 index 000000000..3db323872 --- /dev/null +++ b/docs/release_notes/release_notes_0_8.rst @@ -0,0 +1,89 @@ +=================== +Release Notes 0.8.x +=================== + +0.8.10 Index in forEach +----------------------- + +* Renamed ``IJavetConsumer`` to ``IJavetUniConsumer`` +* Added ``IJavetUniIndexedConsumer`` and ``IJavetBiIndexedConsumer`` +* Fixed a bug in ``V8FunctionCallback`` on varargs +* Deprecated ``bindFunctions()`` and ``bindProperties()`` +* Added ``@CheckReturnValue`` to warn ignored return value + +0.8.9 Declarative Property Interception +--------------------------------------- + +* Renamed ``setFunction()`` to ``bindFunction()`` in ``IV8ValueObject`` +* Renamed ``setFunctions()`` to ``bindFunctions()`` in ``IV8ValueObject`` +* Added ``disableInDebugMode()`` and ``enableInDebugMode()`` to ``JavetEngineGuard`` +* Added ``bind()``, ``bindProperty()`` and ``bindProperties()`` in ``IV8ValueObject`` +* Added ``@V8Property`` for ``IV8ValueObject.bindProperties()`` + +0.8.8 Hotfix the Source Code +---------------------------- + +* Re-organized doc. +* Added ``getJSFunctionType()``, ``getSourceCode()`` and ``setSourceCode()`` to ``IV8ValueFunction`` + +0.8.7 Native Modules for Node.js +-------------------------------- + +* Supported native modules with rebuilt scripts +* Fixed ``NodeRuntime.await()`` to emit tasks + +0.8.6 Event Loop for Node.js +---------------------------- + +* Upgraded Linux build environment to Ubuntu 20.04 + GCC 9.3 +* Enhanced ``NodeRuntime.await()`` to allow interaction from other threads + +0.8.5 Error Codes +----------------- + +* Universal object conversion is turned on for all API +* Added ``createV8ValueDouble()``, ``createV8ValueString()`` and ``createV8ValueZonedDateTime()`` to ``V8Runtime`` +* Added ``JavetError`` with error codes +* Refactored ``invoke()``, ``call()``, ``set()``, ``has()`` to take ``Object`` instead of ``V8Value`` +* Removed a few exceptions + +0.8.4 V8 v9.0 +------------- + +* Added ``gcBeforeEngineClose`` to ``JavetEngineConfig`` +* Added ``JavetCallbackException`` +* Added ``IV8Value#isNullOrUndefined`` +* Upgraded Node.js to ``v14.16.1`` `(2021-04-06) `_ +* Upgraded V8 to ``v9.0.257`` `(2021-02-24) `_ + +0.8.3 GC +-------- + +* Added ``V8Runtime.lowMemoryNotification()`` and ``V8Runtime.idleNotificationDeadline()`` +* Added ``V8Host.setMemoryUsageThresholdRatio()``, ``V8Host.enableGCNotification()``, and ``V8Host.disableGCNotification()`` +* Updated JavetEnginePool to be lock free +* Added ``autoSendGCNotification`` to ``JavetEngineConfig`` +* Moved ``JavetCallbackContext`` management from ``V8ValueFunction`` to V8 +* Added ``JavetPromiseRejectCallback`` for V8 mode + +0.8.2 Conversion for Primitive +------------------------------ + +* Enabled auto type conversion in primitive types +* Fixed a memory leak issue during V8Runtime ``resetContext()``, ``resetIsolate()``, ``close()`` + +0.8.1 Declarative Function Interception +--------------------------------------- + +* Enabled declarative function interception +* Enabled custom object converter in function callback +* Added ``allowEval`` to ``JavetEngineConfig`` +* Refactored built-in module API for Node.js mode + +0.8.0 First Time with Node.js +----------------------------- + +* Supported Node.js ``v14.16.0`` `(2021-02-23) `_ +* Added ``V8Module`` and ``V8Script`` +* Enhanced ``V8ValuePromise`` +* Added dynamic switch between Node.js and V8 diff --git a/docs/release_notes/release_notes_0_9.html b/docs/release_notes/release_notes_0_9.html new file mode 100644 index 000000000..15b27479e --- /dev/null +++ b/docs/release_notes/release_notes_0_9.html @@ -0,0 +1,481 @@ + + + + + + + + Release Notes 0.9.x - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Release Notes 0.9.x

+
+

0.9.12 Private Properties

+
    +

  • Added error code 503

    • +

  • Enhanced V8Property to support built-in symbols

    • +

  • Added V8ValueSharedArrayBuffer

    • +

  • Added registerCustomObject() and unregisterCustomObject() to JavetObjectConverter

    • +

  • Added private property support to IV8ValueObject

    • +

  • Fixed potential core dump issue in V8 runtime close.

    • +

  • Added Javadoc.

    • +
+
+
+

0.9.11 V8 v9.3

+
    +

  • Upgraded Node.js to v14.17.6 (2021-08-31)

    • +

  • Upgraded V8 to v9.3.345.16 (2021-08-17)

    • +

  • Added unbind(), unbindProperty(), unbindFunction() to IV8ValueObject

    • +

  • Updated V8Runtime to be completely thread-safe

    • +

  • Added V8ValueBuiltInSymbol

    • +

  • Added getOwnPropertySymbols() to V8ValueBuiltInObject

    • +

  • Added createV8ValueSymbol() to V8Runtime

    • +

  • Added symbol to V8Property to enable getter and setter on symbol

    • +

  • Added error code 407 and 805

    • +
+
+
+

0.9.10 Polyfill Java Interfaces

+
    +

  • Added JavetVirtualObject

    • +

  • Updated JavetUniversalProxyHandler to allow passing V8Value

    • +

  • Updated JavetUniversalProxyHandler to allow passing V8ValueFunction as anonymous function

    • +

  • Updated JavetUniversalProxyHandler to allow passing V8ValueObject as anonymous object

    • +

  • Added isClosed() to IJavetClosable

    • +

  • Added error code 602 and 603

    • +
+
+
+

0.9.9 Mac OS x86_64

+
    +

  • Upgraded Node.js to v14.17.4 (2021-07-29)

    • +

  • Added support to Mac OS x86_64

    • +

  • Removed staticClassEnabled from JavetProxyConverter

    • +
+
+
+

0.9.8 Empower the Promise

+
    +

  • Added resolve() and reject() to V8ValuePromise

    • +

  • Added staticClassEnabled to JavetProxyConverter

    • +

  • Added construct() to JavetUniversalProxyHandler

    • +

  • Added Dockerfile for Linux x86-64

    • +

  • Refactored document for how to build Javet

    • +
+
+
+

0.9.7 Proxy Converter v2

+
    +

  • Added static mode to JavetUniversalProxyHandler

    • +

  • Added ownKeys() to JavetUniversalProxyHandler

    • +
+
+
+

0.9.6 Proxy Converter v1

+
    +

  • Added IV8ValueProxy and V8ValueProxy

    • +

  • Added getTarget(), getHandler(), isRevoked() and revoke() to IV8ValueProxy

    • +

  • Added createV8ValueProxy() to V8Runtime

    • +

  • Added JavetUniversalProxyHandler and JavetProxyConverter

    • +
+
+
+

0.9.5 V8 v9.2

+ +
+
+

0.9.4 Multi-process Safe

+
    +

  • Added JavetConverterConfig

    • +

  • Added JavetEntityFunction for JavetObjectConverter

    • +

  • Updated JavetObjectConverter to allow skipping functions

    • +

  • Added getPrototype() and setPrototype() to IV8ValueObject

    • +

  • Changed the way that Javet libraries are deployed to be multi-process safe

    • +
+
+
+

0.9.3 Module Resolver

+
    +

  • Upgraded Node.js to v14.17.2 (2021-07-01)

    • +

  • Added IV8ModuleResolver to allow intercepting module resolving callback

    • +

  • Added V8BindEnabler to determine whether certain injection is enabled or not

    • +

  • Added NodeModuleProcess#getVersion

    • +

  • Updated JavetPrimitiveConverter and JavetObjectConverter to check recursion depth for circular structure detection

    • +
+
+
+

0.9.2 Anonymous Functions in Converter

+
    +

  • Upgraded Node.js to v14.17.1 (2021-06-15)

    • +

  • Updated JavetObjectConverter to handle anonymous functions more efficiently

    • +

  • Added V8ValueBuiltInObject#assign

    • +
+
+
+

0.9.1 V8 in Classloader

+
    +

  • Moved V8 to a custom classloader

    • +

  • Enabled unloadLibrary() and loadLibrary() in V8Host

    • +
+
+
+

0.9.0 V8 v9.1

+
    +

  • Upgraded Node.js to v14.17.0 (2021-05-11)

    • +

  • Upgraded V8 to v9.1.269.28 (2021-05-10)

    • +

  • Added thisObjectRequired to @V8Function and @V8Property

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/release_notes/release_notes_0_9.rst b/docs/release_notes/release_notes_0_9.rst new file mode 100644 index 000000000..7517a8137 --- /dev/null +++ b/docs/release_notes/release_notes_0_9.rst @@ -0,0 +1,110 @@ +=================== +Release Notes 0.9.x +=================== + +0.9.12 Private Properties +------------------------- + +* Added error code 503 +* Enhanced ``V8Property`` to support built-in symbols +* Added ``V8ValueSharedArrayBuffer`` +* Added ``registerCustomObject()`` and ``unregisterCustomObject()`` to ``JavetObjectConverter`` +* Added private property support to ``IV8ValueObject`` +* Fixed potential core dump issue in V8 runtime close. +* Added Javadoc. + +0.9.11 V8 v9.3 +-------------- + +* Upgraded Node.js to ``v14.17.6`` `(2021-08-31) `_ +* Upgraded V8 to ``v9.3.345.16`` `(2021-08-17) `_ +* Added ``unbind()``, ``unbindProperty()``, ``unbindFunction()`` to ``IV8ValueObject`` +* Updated ``V8Runtime`` to be completely thread-safe +* Added ``V8ValueBuiltInSymbol`` +* Added ``getOwnPropertySymbols()`` to ``V8ValueBuiltInObject`` +* Added ``createV8ValueSymbol()`` to ``V8Runtime`` +* Added ``symbol`` to ``V8Property`` to enable getter and setter on symbol +* Added error code 407 and 805 + +0.9.10 Polyfill Java Interfaces +------------------------------- + +* Added ``JavetVirtualObject`` +* Updated ``JavetUniversalProxyHandler`` to allow passing ``V8Value`` +* Updated ``JavetUniversalProxyHandler`` to allow passing ``V8ValueFunction`` as anonymous function +* Updated ``JavetUniversalProxyHandler`` to allow passing ``V8ValueObject`` as anonymous object +* Added ``isClosed()`` to ``IJavetClosable`` +* Added error code 602 and 603 + +0.9.9 Mac OS x86_64 +------------------- + +* Upgraded Node.js to ``v14.17.4`` `(2021-07-29) `_ +* Added support to Mac OS x86_64 +* Removed ``staticClassEnabled`` from ``JavetProxyConverter`` + +0.9.8 Empower the Promise +------------------------- + +* Added ``resolve()`` and ``reject()`` to ``V8ValuePromise`` +* Added ``staticClassEnabled`` to ``JavetProxyConverter`` +* Added ``construct()`` to ``JavetUniversalProxyHandler`` +* Added Dockerfile for Linux x86-64 +* Refactored document for how to build Javet + +0.9.7 Proxy Converter v2 +------------------------ + +* Added static mode to ``JavetUniversalProxyHandler`` +* Added ``ownKeys()`` to ``JavetUniversalProxyHandler`` + +0.9.6 Proxy Converter v1 +------------------------ + +* Added ``IV8ValueProxy`` and ``V8ValueProxy`` +* Added ``getTarget()``, ``getHandler()``, ``isRevoked()`` and ``revoke()`` to ``IV8ValueProxy`` +* Added ``createV8ValueProxy()`` to ``V8Runtime`` +* Added ``JavetUniversalProxyHandler`` and ``JavetProxyConverter`` + +0.9.5 V8 v9.2 +------------- + +* Upgraded V8 to ``v9.2.230.21`` `(2021-07-19) `_ + +0.9.4 Multi-process Safe +------------------------ + +* Added ``JavetConverterConfig`` +* Added ``JavetEntityFunction`` for ``JavetObjectConverter`` +* Updated ``JavetObjectConverter`` to allow skipping functions +* Added ``getPrototype()`` and ``setPrototype()`` to ``IV8ValueObject`` +* Changed the way that Javet libraries are deployed to be multi-process safe + +0.9.3 Module Resolver +--------------------- + +* Upgraded Node.js to ``v14.17.2`` `(2021-07-01) `_ +* Added ``IV8ModuleResolver`` to allow intercepting module resolving callback +* Added ``V8BindEnabler`` to determine whether certain injection is enabled or not +* Added ``NodeModuleProcess#getVersion`` +* Updated ``JavetPrimitiveConverter`` and ``JavetObjectConverter`` to check recursion depth for circular structure detection + +0.9.2 Anonymous Functions in Converter +-------------------------------------- + +* Upgraded Node.js to ``v14.17.1`` `(2021-06-15) `_ +* Updated ``JavetObjectConverter`` to handle anonymous functions more efficiently +* Added ``V8ValueBuiltInObject#assign`` + +0.9.1 V8 in Classloader +----------------------- + +* Moved V8 to a custom classloader +* Enabled ``unloadLibrary()`` and ``loadLibrary()`` in ``V8Host`` + +0.9.0 V8 v9.1 +------------- + +* Upgraded Node.js to ``v14.17.0`` `(2021-05-11) `_ +* Upgraded V8 to ``v9.1.269.28`` `(2021-05-10) `_ +* Added ``thisObjectRequired`` to ``@V8Function`` and ``@V8Property`` diff --git a/docs/requirements.txt b/docs/requirements.txt new file mode 100644 index 000000000..3c42a0721 --- /dev/null +++ b/docs/requirements.txt @@ -0,0 +1,4 @@ +Pygments==2.9.0 +furo==2021.9.8 +sphinx==4.2.0 +sphinx_inline_tabs==2021.8.17b10 diff --git a/docs/resources/css/custom.css b/docs/resources/css/custom.css new file mode 100644 index 000000000..ca805991e --- /dev/null +++ b/docs/resources/css/custom.css @@ -0,0 +1,7 @@ +h4, h5, h6 { + text-transform: initial; +} + +code.literal { + background-color: lightgray; +} \ No newline at end of file diff --git a/docs/resources/images/logo.drawio b/docs/resources/images/logo.drawio new file mode 100644 index 000000000..8da09ac9c --- /dev/null +++ b/docs/resources/images/logo.drawio @@ -0,0 +1 @@ +zVbbctowEP0aHsP4xu0xMZc0k3bSSdqEvKlY2KKy15UFGL6+kr3GFoYmnaGdwAx4z14s7Tlau+P6cT4TJI0+Q0B5x7GCvOOOO47jDBz1q4EdAh4CoWBBCdk18Mj2FEEL0TULaGYESgAuWWqCC0gSupAGRoSArRm2BG7eNSUhbQGPC8Lb6DMLZFSiw55V47eUhVF1Z9tCT0yqYASyiASwbUDupOP6AkCWV3HuU657V/WlzJue8R4WJmgi35MwWt1++QrRXX+feQGbk/nKnV0NRrg4uat2TAPVADRByAhCSAif1OiNgHUSUF3WUlYdcw+QKtBW4IpKuUM2yVqCgiIZc/TSnMkXnd7toTVveMY5Vi6MXWUkUuxemsa8rqDNOq2w6rzgWutAmQkktESmjHP0LyGRuFC7sn3gIIpuuN5YfxXebjcyoPvVALD5MwoxVetQAYJyItnGFBRBXYaHOExViyW7RkAKLJFZo/KDBlQAnrAByqs6X7ahAnVRFnxXsj2yzNVlsBYLiklG1cYOa6hQ3Gn1PT/d7Gfh/vUb+3Q3vk/ms3D1ejUs77YhfI3daalxGzFJH1Oy0PZWjRhTSSRLy1O/ZLlWZEHflMSM6y3dUr6hki2IybPjtXm2rH7f9xW+oUJn8GvOwkT5YhYEheozKeAnrVJQS0slpEYV35/0ptODWnQtmp89r2f0UiX0tbgNeqqhuK0nkYc9jBpDqMJOacyg8G/5clt83V23GFM7liZJb3YOIYItX6gOUfEnLk6pwpxKnPyg/AEyJhmcrHl/FHCoXQgFt2NfhMcjFpX8jlm0nW6l/SaRjvWPiPRaRE46Tp9r3rKUJAah/V9r/Ygq+nKFsGLdSkDEhNd+dRXq/6eqklpZWazEP6hQmnS7l6B7OOoOhm8z7v1fxnstxr9/YELOTvBTE9s8sO1JfwlSB27XbX68I4Lbg9nRR7r5uQjZyqzfGMvHcP3a7U5+Aw== \ No newline at end of file diff --git a/docs/resources/images/logo.ico b/docs/resources/images/logo.ico new file mode 100644 index 000000000..2ebbc2723 Binary files /dev/null and b/docs/resources/images/logo.ico differ diff --git a/docs/resources/images/logo.png b/docs/resources/images/logo.png new file mode 100644 index 000000000..fca42ab03 Binary files /dev/null and b/docs/resources/images/logo.png differ diff --git a/docs/search.html b/docs/search.html new file mode 100644 index 000000000..ff36cd68c --- /dev/null +++ b/docs/search.html @@ -0,0 +1,316 @@ + + + + + + + Search - Javet 0.9.12 documentation + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+ +
+

Error

+

+ Please activate JavaScript to enable the search functionality. +

+
+ + +
+ +
+
+ +
+ +
+
+ + + + + + + + + + \ No newline at end of file diff --git a/docs/searchindex.js b/docs/searchindex.js new file mode 100644 index 000000000..c96c54eb5 --- /dev/null +++ b/docs/searchindex.js @@ -0,0 +1 @@ +Search.setIndex({docnames:["development/build","development/build_javet_from_scratch","development/build_javet_with_docker","development/build_javet_with_pre_built_binaries","development/debug_with_chrome_developer_tools","development/design","development/index","development/test","development/tools","faq/background/history_with_j2v8","faq/background/index","faq/background/what_is_the_motivation","faq/development/how_to_think_in_javet","faq/development/index","faq/development/where_are_es6_api_in_v8_mode","faq/environment/can_javet_support_legacy_linux","faq/environment/can_javet_support_mac","faq/environment/index","faq/index","faq/troubleshooting/a_dynamic_link_library_dll_initialization_routine_failed","faq/troubleshooting/can_i_debug_javet_in_chrome_dev_tools","faq/troubleshooting/index","faq/troubleshooting/why_node_js_crashes_when_being_closed","index","reference/best_practices","reference/error_codes","reference/index","reference/javadoc/index","reference/load_and_unload","reference/lock","reference/logging","reference/memory_management","reference/modularization","reference/performance","reference/termination","reference/todo_list","reference/v8_collection","reference/v8_function","reference/v8_promise","release_notes/index","release_notes/release_notes_0_7","release_notes/release_notes_0_8","release_notes/release_notes_0_9","tutorial/advanced/index","tutorial/advanced/interact_with_node_js","tutorial/advanced/java_and_javascript_interop","tutorial/advanced/object_converter","tutorial/basic/engine_pool","tutorial/basic/hello_javet","tutorial/basic/index","tutorial/basic/installation","tutorial/basic/interception","tutorial/basic/javet_shell","tutorial/basic/node_js_mode_and_v8_mode","tutorial/basic/polyfill","tutorial/basic/spring_integration","tutorial/index","tutorial/migration_guides/index","tutorial/migration_guides/migrate_from_j2v8"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":4,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":3,"sphinx.domains.rst":2,"sphinx.domains.std":2,sphinx:56},filenames:["development\\build.rst","development\\build_javet_from_scratch.rst","development\\build_javet_with_docker.rst","development\\build_javet_with_pre_built_binaries.rst","development\\debug_with_chrome_developer_tools.rst","development\\design.rst","development\\index.rst","development\\test.rst","development\\tools.rst","faq\\background\\history_with_j2v8.rst","faq\\background\\index.rst","faq\\background\\what_is_the_motivation.rst","faq\\development\\how_to_think_in_javet.rst","faq\\development\\index.rst","faq\\development\\where_are_es6_api_in_v8_mode.rst","faq\\environment\\can_javet_support_legacy_linux.rst","faq\\environment\\can_javet_support_mac.rst","faq\\environment\\index.rst","faq\\index.rst","faq\\troubleshooting\\a_dynamic_link_library_dll_initialization_routine_failed.rst","faq\\troubleshooting\\can_i_debug_javet_in_chrome_dev_tools.rst","faq\\troubleshooting\\index.rst","faq\\troubleshooting\\why_node_js_crashes_when_being_closed.rst","index.rst","reference\\best_practices.rst","reference\\error_codes.rst","reference\\index.rst","reference\\javadoc\\index.rst","reference\\load_and_unload.rst","reference\\lock.rst","reference\\logging.rst","reference\\memory_management.rst","reference\\modularization.rst","reference\\performance.rst","reference\\termination.rst","reference\\todo_list.rst","reference\\v8_collection.rst","reference\\v8_function.rst","reference\\v8_promise.rst","release_notes\\index.rst","release_notes\\release_notes_0_7.rst","release_notes\\release_notes_0_8.rst","release_notes\\release_notes_0_9.rst","tutorial\\advanced\\index.rst","tutorial\\advanced\\interact_with_node_js.rst","tutorial\\advanced\\java_and_javascript_interop.rst","tutorial\\advanced\\object_converter.rst","tutorial\\basic\\engine_pool.rst","tutorial\\basic\\hello_javet.rst","tutorial\\basic\\index.rst","tutorial\\basic\\installation.rst","tutorial\\basic\\interception.rst","tutorial\\basic\\javet_shell.rst","tutorial\\basic\\node_js_mode_and_v8_mode.rst","tutorial\\basic\\polyfill.rst","tutorial\\basic\\spring_integration.rst","tutorial\\index.rst","tutorial\\migration_guides\\index.rst","tutorial\\migration_guides\\migrate_from_j2v8.rst"],objects:{},objnames:{},objtypes:{},terms:{"0":[1,3,4,9,15,23,24,31,32,34,36,37,39,44,46,50,51,54,58],"00000000":4,"003":9,"009":9,"01":42,"019":9,"02":[40,41],"032":33,"04":[1,2,3,15,40,41,50],"05":42,"06":[41,42],"07":42,"08":42,"1":[1,3,5,9,12,15,24,28,31,32,33,34,36,37,46,51,52,53,54,58],"10":[1,2,3,31,33,34,50],"1000":44,"10000":34,"100000000":4,"101":25,"102":25,"103":25,"10308":31,"1038":31,"104":25,"105":25,"10700k":[9,33],"10gb":2,"11":[1,3,46],"110":9,"12":[23,50],"120gb":2,"123":[37,45,46,51,54],"124":51,"127":[4,31],"128":31,"14":[8,9],"143":33,"15":42,"150":29,"16":[1,3,15,23,31,33,41,42,50],"17":[8,23,42],"175":45,"18":[15,50],"19":42,"2":[8,9,12,15,16,23,24,28,31,32,33,34,36,37,46,48,51,52,53,54,58],"20":[1,2,3,22,41,50],"200":51,"201":25,"2012":[16,23],"2015":9,"2016":9,"2017":9,"2019":[1,3,6,9],"2020":[9,11],"2021":[40,41,42,58],"21":42,"213":9,"2147483647":31,"2147483648":31,"23":[32,41,54],"230":42,"234567":31,"23456789012345":31,"24":41,"253":33,"255":[9,31,40,45],"257":41,"263":[31,33],"264":31,"269":42,"274":9,"28":42,"29":42,"299":9,"3":[0,1,3,6,9,15,22,23,28,32,33,36,37,45,46,48,51,52],"301":25,"302":25,"31":42,"32":[4,31],"324":31,"32767":31,"32768":31,"338":9,"34":[32,54],"345":[23,42],"35":9,"363":33,"38":31,"3rd":[30,37],"4":[1,3,9,28,31,32,33,36,37,44,46,51,52],"401":25,"402":25,"403":25,"404":25,"405":25,"406":25,"407":[25,42],"410":33,"428":9,"4294967295":31,"45":54,"458":33,"4g":2,"5":[4,22,31,32,44,51,52],"500":44,"501":25,"502":25,"503":[25,42],"508":33,"51":33,"571":9,"6":[4,8,9,23,32,44,51,52],"60":2,"601":25,"602":[25,42],"603":[25,42],"64":[31,42],"647":33,"65":33,"65535":31,"660":33,"688":9,"7":[1,3,4,15,23,31,39,44,50,51,52,58],"70":15,"701":25,"702":25,"703":25,"748":33,"751":33,"76":51,"8":[1,3,4,6,9,15,23,31,33,39,44,46],"80":15,"801":25,"802":25,"803":25,"804":25,"805":[25,42],"82":22,"846":33,"8991":44,"9":[9,15,23,39,44,50],"90":15,"9229":4,"968":33,"boolean":46,"break":[9,32,37,38,44,46,52],"byte":[5,31,37],"case":[5,7,9,29,31,32,33,37,38,40,58],"catch":[34,37,38,44,46,52],"char":37,"class":[30,32,37,44,46,51,55],"const":[32,36,37,44,45,54],"default":[4,5,28,31,32,34,37,46,51,53],"do":[7,9,12,20,22,24,29,31,32,37],"export":[1,32],"final":[25,31,32,34],"float":[31,37],"function":[5,14,23,26,31,32,40,44,45,51,58],"import":[22,30,32,34,38,58],"instanceof":46,"int":[34,37,44,46,51],"long":[2,29,37,46],"new":[1,5,7,9,11,16,23,29,30,32,33,34,36,37,38,44,45,46,47,51,52,53,54,55],"null":[32,37,38,44,51,52],"public":[30,37,38,44,46,51,54,55],"return":[24,32,34,37,38,41,45,46,51,55],"short":[16,31,37],"static":[0,1,37,42,44],"super":46,"switch":[4,23,24,28,29,41],"throw":[32,34,37,38,44,46,54],"true":[1,11,28,32,34,37,44,45,46,52],"try":[5,9,11,23,24,29,32,34,36,37,38,44,46,47,48,51,52,53,54],"var":[34,44],"void":[30,37,44,46,51,54],"voil\u00e0":[4,44,46],"while":[2,3,34,44,46,52],A:[1,5,18,21,32,46],And:[9,23,44],As:[2,3,4,5,12,28,30,31,37,46,55],At:[9,11],Be:[2,4,24,29,31,37,38,46],But:[31,32,38,55],By:[31,51],For:[8,12,32,37,46],If:[1,3,12,16,22,23,24,32,34,37,46,51,52,58],In:[1,4,5,12,22,24,29,31,32,33,34,37,38,44,46,58],It:[0,5,9,12,23,24,29,31,32,33,37,47,52,53,58],Its:[9,31,58],NOT:[5,29,37],No:[5,9,32,34,36,37,44,46,50],Not:[5,50],Of:[2,29,31,32,37,58],One:5,Or:[2,23],That:[5,9,16,22,30,31,32,34,37,46,58],The:[1,2,4,5,7,9,12,16,19,22,25,28,31,32,34,37,38,44,45,46,51,52,53,58],Then:46,There:[5,9,12,15,16,25,28,31,32,37,46,53],To:[4,9,16,35,45],With:[9,12,32],__dirnam:32,__filenam:32,_zn4nodel23thread_local_modpending:1,a123:46,abandon:[16,58],abc:[37,45,46],abl:[11,12,16,22,32,34,37,44,58],about:29,abov:[37,46],absent:14,absolute_path_to_node_js_build:3,absolute_path_to_v8_build:3,accept:[4,30,37],access:[3,12,25,31,46],accordingli:37,achiev:[5,9,29,31,37,46],acquir:[24,25,58],across:31,activ:[9,22,32],actual:[2,4,5,9,12,25,31,32,37,44],actualparameters:25,actualparametertyp:25,ad:[1,9,33,40,41,42],add:[4,15,32,36,37,38,46,51,54,58],addit:[15,33,46,58],address:[4,22,24,31,44],admit:9,advanc:[15,23,38,56],affect:31,aforement:31,after:[3,4,9,24,28,34,37,38,46,58],afterward:[34,38],ag:9,again:[28,46],against:1,aim:[14,54,58],air:[9,16,23],aka:4,alien:46,align:5,all:[1,3,4,5,9,22,28,31,32,37,41,44,46,58],alloc:[5,29],allow:[5,9,28,30,33,37,38,41,42,44,45,46,47,51,58],allowev:41,almost:[5,9,37,44,46],alreadi:[25,28,38],also:[1,2,5,9,11,12,23,29,30,31,32,38,44,46,58],altern:[15,46],altogeth:3,alwai:[5,24,37,46],am:[9,37,46],among:[29,58],amount:58,an:[4,5,9,11,12,14,23,24,29,30,31,32,33,34,38,46,51,52,53],analysi:32,analyz:32,android:9,ani:[1,9,16,23,25,30,32,34,37,46,58],annot:[37,46],annotationbasedcallbackreceiv:37,anonym:37,anoth:54,answer:16,anytim:23,apach:23,api:[4,5,9,11,12,13,18,23,26,28,29,30,31,32,35,37,38,40,41,44,46,54,58],app:44,appear:[4,37],append:[45,46],appli:[5,24,29,32,34,37,44],applic:[4,5,12,22,28,29,31,32,33,34,37,38,44,45,46,47,51,52,58],approach:[32,37],apt:[15,32],ar:[0,1,2,3,4,5,8,9,12,13,15,16,18,22,23,24,25,28,29,31,32,34,37,38,42,44,45,46,51,53,58],arbitrari:[4,5,12,45,46,58],arbitrarymethod:37,architectur:[6,9],area:31,arg:[1,37,44,46],argument:[37,46,58],arm64:[23,50],around:[9,32],arrai:[31,36,40,46],articl:5,artifactid:[23,50],ask:58,assertarrayequ:46,assertequ:[34,36,37,46],assertfals:[34,36,37,46],assertnotnul:[36,46],assertthrow:46,asserttru:[34,36,37,46],assign:[32,42,45],assum:[28,32,37],ast:12,async:[5,22,38],atomicboolean:44,atomicinteg:36,attack:[34,46],attent:58,aussi:46,authent:4,author:4,auto:[4,15,41],autoclos:46,autom:[31,46],automat:[5,7,25,28,29,32,46,48,51,58],autosendgcnotif:41,avail:[2,3,4,5,19,53],avoid:[5,12,24,46],aw:31,await:[5,24,38,41,44],awar:[23,24],awesom:[23,53],awt:45,b:[4,32,37,45,46,52,54],back:[12,31,32,37,46],background:[18,23,38],backup:32,bad:[5,9],base:[2,7,31,37,46,58],bases:2,basic:[14,23,37,47,54,56,58],bat:1,bean:55,beauti:[5,37],becaus:[4,5,8,9,16,22,23,24,25,28,29,31,33,37,38,46,47,53,54,58],been:[8,9,22,37,58],befor:[4,12,22,32,46],begin:5,behavior:[24,31],behind:[5,11,12,22],being:[18,21,31,32,34,46],belong:37,below:46,besid:[16,37],best:[5,23,26],better:[4,5,29,33,37],between:[5,9,23,24,37,41,45,46],beyond:5,bi:46,biconsum:36,bigdecim:54,bigint64arrai:31,bigint:[23,31,40],biguint64arrai:31,bin:[1,15],binari:[0,1,6,25,31],bind:[32,38,41,51,58],bindfunct:41,bindproperti:41,bit:[12,31,32,46],blank:37,block:[29,31,46,48],blogspot:23,bodi:[37,44],borrow:[31,37],both:[5,16,25,28,31,37,38,46,53,58],bother:32,boundari:5,box:32,brand:5,breakpoint:4,brew:[1,3],bring:[5,46],broadcast:31,broken:[1,9,31,37],browser:[4,24],buffer:[5,31],bug:[41,58],bui:[9,16],build:[4,5,6,8,11,15,23,32,41,42,50],builder:12,built:[0,1,2,4,6,7,25,31,33,34,37,38,41,42,46,58],bundl:8,busi:58,bytebuff:31,c:[1,32,37,46],cach:[32,40],calcul:[5,37],call:[5,9,12,22,24,28,29,31,32,34,38,41,44,45,46,51,58],callabl:46,callasconstructor:[37,40,54],callback:[4,22,25,31,32,37,38,41,42,44],callbackinjectionfailur:25,callbackmethodfailur:25,callbackregistrationfailur:25,callbacksignatureparametersizemismatch:25,callbacksignatureparametertypemismatch:25,callbackunknownfailur:25,callbackunregistrationfailur:25,caller:37,callobject:37,callprimit:37,callvoid:[37,44],can:[1,2,4,5,12,17,18,21,22,24,28,31,32,38,44,45,46,50,53,54,55,58],canaccess:46,cancel:34,canexecut:46,cannot:[19,29,31,32,46],canread:[46,54],canwrit:46,caoccao:[23,30,31,32,37,50],capabl:37,captur:52,care:[2,4,16,24,29,31,32,37,38,46],carri:[46,58],catalina:[1,3,16],categor:31,caus:[9,16,19,34,37,58],cd:[1,32],cdt:[6,52],central:[2,8],ceo:46,certain:[1,4,5,12,37,38,42],cfo:46,chain:[15,31],challeng:[5,9,12,46],chanc:9,chang:[4,25,29,42,46,51],channel:23,charm:37,chart:38,cheap:46,cheaper:5,check:[12,29,32,42,58],checkout:1,checkreturnvalu:41,choic:15,choos:[22,37],chrome:[5,6,18,21,23,40],chromedevtool:4,circular:[25,42],clamp:31,classload:[5,58],classpath:55,clean:3,click:4,clone:[1,2],close:[5,9,12,18,21,24,25,28,31,32,34,37,41,42,44,46,47],closur:37,cmake:[1,3,9],cmakelist:9,cmd:[3,32],co:5,code:[1,4,5,9,12,16,23,24,26,29,31,32,33,34,38,42,45,46,47,48,51,52,54,58],codefil:44,codestr:[32,40],collect:[22,23,26,28,40],color:45,com:[2,23,30,31,32,37,50],combin:37,come:[1,3,5,29,32,33],command:52,commit:15,common:[12,15],commun:[1,3,4,6,9],compar:[5,7,29],comparison:[5,9],compat:32,compel:11,compil:[1,5,25,32,45,46,58],compilationfailur:25,compilemodul:32,compilev8modul:[32,58],complement:31,complet:[4,5,7,24,31,32,34,37,42,44,45,46,58],complic:[32,46],con:46,concept:[5,12,38],concurr:29,condit:[5,29,46],config:[15,30],configur:1,configurationproperti:55,conflict:[25,29],connect:[2,4,5,47],consid:[16,31,37],consider:[15,16,34,46],consist:58,consol:[4,5,37,38,44,46,47,48,51,52],constantli:4,construct:[8,42],constructor:[46,54],consum:36,contact:[1,3,9,15,58],contain:[24,32,46],containsmodul:32,content:[31,38],context:[4,12,22,24,29,31,32,33,37],continu:25,contribut:9,contributor:2,control:[5,22,34,37],convers:[12,46],convert:[25,37,41,43,56,58],convertercircularstructur:25,converterfailur:25,convertersymbolnotbuiltin:25,cooki:44,copi:[5,31],core:[5,24,29,42],correctli:16,correspond:[2,3,5,22,24,31,32],corrupt:22,cost:11,could:[9,16],couldn:[9,58],count:[5,25,34,36,44],cours:[2,29,31,32,37,58],cover:[12,31,46,58],cpp:3,cpu:9,crash:[18,21,28,29],creat:[4,16,29,30,31,32,34,37,38,44,47,48,51,52,55,58],createv8runtim:[23,32,34,44,46,48,51,52,53],createv8valuearrai:37,createv8valuedoubl:41,createv8valuefunct:37,createv8valueobject:[31,37,46,51],createv8valuepromis:38,createv8valueproxi:42,createv8valuestr:[37,41],createv8valuesymbol:42,createv8valueundefin:38,createv8valuezoneddatetim:41,creation:[33,47],cross:[6,16,58],cruel:9,cstdint:1,current:[4,5,9,25,37],currentthreadid:25,curv:31,custom:[5,6,24,32,37,41,42],customfrommap:46,customobject:46,customtomap:46,cycl:[16,31],d:[32,45,46],daemon:[2,31,34],daemonthread:34,dai:24,danger:46,dangl:24,data:[5,31,32,37,40,46],databas:47,dataview:31,date:[23,40],db:5,dead:34,deal:[31,37,46],debug:[5,6,18,21,23,30],debugg:4,debuggerid:4,decent:[4,9,16,36,38],decim:32,decimaljsfil:54,decis:31,declar:[37,55,58],decor:[12,37,51,58],decoratev8valu:46,dedic:[5,24,31,44,58],deepli:9,def:[37,44,46],deficit:37,defin:5,definit:5,delet:[5,36,37,45,46,51],deleteglobalref:31,deliv:58,delta:51,demo:4,demonstr:4,deni:25,depend:[2,5,9,30,32,37,55],deploi:[5,42],depot_tools_win_toolchain:1,deprec:[23,41],depth:[25,42,46],descript:31,design:[6,7,23,28,29,32,37,53,58],desper:0,despit:37,destroi:31,detail:[4,5,11,20,29,34,37,38,45,46,47,48,51,52,53,54,58],detect:[6,25,37,42,46],determin:[31,37,42],dev:33,develop:[0,18,20,23,25,38,40,58],devic:[9,16,23],devtool:[4,18,21,23],diagnos:4,diagram:[5,37],didn:9,differ:[9,12,24,32,37,38,46],differenti:46,difficulti:16,digit:31,direct:46,directli:[4,31,37,45,58],directori:[2,5,32,54],disabl:[1,12,24,31,34,38],disabledfunct:37,disabledproperti:37,disablegcnotif:41,disableindebugmod:[34,41],discard:37,discontinu:23,discord:[23,58],disregard:31,distribut:[15,50],dll:[3,18,21,32],dm:2,dnode_dir:3,doc:[4,33,41],docker:[0,3,6,9],dockerfil:[2,42],document:[28,37,42],doe:[4,5,22,28,31,34,37,58],doesn:[4,5,9,25,29,30,31,32,34,37,46,55,58],don:[5,9,16,23,30,32,46,53,55,58],donat:[9,16,23],done:[4,58],door:44,doubl:[31,37],doubt:16,down:[33,58],download:[15,32],dr:9,drain:[31,46],drain_the_task_queu:44,dramat:[33,37],drive:[3,15,32],drop:[8,9],dsl:8,due:38,dump:[5,24,29,42],duplic:12,dure:[5,22,28,32,37,41,46,58],dv8_dir:3,dy:11,dylib:3,dynam:[18,21,23,32,41],e:[5,12,14,22,31,32,34,37,38,44,46,51,53,54,58],each:[5,31,37,53,58],earli:[9,24],easi:[9,12,23,37,40,46,47,52],easili:[9,31,34,46,55],echo:37,eclips:9,ecmascript:9,ecosystem:[5,53],edit:4,effect:[12,28,31,32,44],effici:[2,42],effort:[15,16,34],eg:15,eight:23,either:[5,7,37],electron:32,elimin:58,els:[32,37,38,44,46,54,58],emb:33,embed:[4,5,9,23,24,33],emit:41,empti:25,enabl:[1,2,4,12,31,37,38,41,42,45,46],enablegcnotif:[31,41],enableindebugmod:[34,41],end:[11,24,31,37,46,48],endposit:37,enforc:4,engin:[6,23,31,49,55,56],enhanc:[37,41,42],enjoi:4,enough:[5,16,46],environ:[4,5,15,18,23,29,32,33,41,47],equal:[32,37,40,52,54],equival:[31,37],err:52,error:[1,2,9,23,26,30,32,37,38,42],es6:[5,9,13,18,32],es:58,especi:[37,47,58],essenti:15,etc:[5,11,12,14,54],eval:24,evalu:[4,5,32,58],even:[0,9,58],event:[4,24,38,44,58],everi:[0,5,12,29,31,37],everyth:12,everywher:58,evolv:9,exampl:[5,45],exce:31,excel:[5,9],except:[29,30,32,34,37,41,46,58],excit:32,excluded_method:46,execut:[2,3,4,5,24,25,32,33,34,36,37,46,47,48,52],executeboolean:46,executeinteg:[32,34,37,46,48],executeobject:[45,46],executestr:[23,32,37,45,46,48,54],executevoid:[32,34,37,44,45,46,47,51,54],executioncontextcr:4,executionfailur:25,executiontermin:25,exist:[5,11,32,46,54],existingsourcecod:37,exit:[22,52],expect:[9,25,31,37],expectedparameters:25,expectedparametertyp:25,experi:[2,12,22,28,32,46,47,52],experienc:12,explain:5,explicit:[5,58],explicitli:[22,24,28,31,46,47],expos:[4,5,16,32,35,37,38,46,58],exposur:[23,40],express:[12,44,46],extend:46,extens:[14,47],extern:31,extra:58,extract:46,extrem:[29,37],ey:24,f:2,face:[1,5],fact:[22,38],fail:[18,21,25,32,34],failedtoreadpath:25,failur:19,fals:[1,28,31,32,37,44,45,46],famou:46,faq:23,far:9,faster:4,featur:[4,5,8,9,12,25,28,31,32,36,37,38,45,53,54,58],feed:[5,32],feel:[4,32,37,46],fetch:[5,38],few:[1,2,4,8,9,11,12,37,40,41,46,52],field:46,file:[1,3,5,9,32,38,44,54],filecont:38,filepath:38,find:[11,37],fine:23,first:[1,4,28,37,40,58],fix:[9,11,16,19,31,32,41,42],flag:31,flavor:[4,52],float32arrai:31,float64arrai:31,fly:4,folder:[3,24,44],folk:[12,32],follow:[1,3,4,5,15,22,23,24,25,30,31,32,36,37,38,44,46,51,53],footprint:5,forc:[22,24,46,47],foreach:[36,40],forev:31,form:[9,37],format:[25,31,37],forward:9,found:[19,25,32,54],fpic:1,framework:[12,55],free:[4,5,12,29,31,32,37,41,46,47,58],freed:5,frequenc:31,frequent:58,friend:38,friendli:[37,58],from:[0,2,5,6,9,11,15,22,24,25,31,32,33,34,37,38,41,42,44,45,46,47,48,51,52,56,57],frommap:46,frustrat:[0,9],fs:5,full:[9,24,37],fulli:[9,46],func:37,functioncallbackreceiv:37,functionnam:40,fund:16,fundament:[30,55],further:4,futur:[9,16],g:[5,12,14,15,22,31,32,37,38,44,45,51,53,54,58],garbag:[22,28],gb:2,gc:[28,47,51],gcbeforeengineclos:41,gcc:[15,41],gcov:15,gen:1,gener:[25,31,37,46],generatearraywithconvert:37,generatearraywithoutconvert:37,genuin:22,get:[5,9,12,16,22,24,28,30,31,32,34,36,37,38,44,46,47,53,54,55,58],getabsolutepath:54,getandincr:36,getclass:46,getconfig:[32,46,53],getconvert:46,getengin:[32,34,47,53],getentri:36,getexecutor:[23,32,34,36,37,44,45,46,47,48,51,52,54],getfilecont:38,getfilepath:38,getglobalobject:[12,34,37,38,44,45,46,47,51,54,58],getguard:34,gethandl:42,getidentityhash:40,getinst:28,getinteg:[32,34],getisolateid:4,getjavetenginepoolnod:55,getjavetenginepoolv8:55,getjoin:46,getjsfunctiontyp:[37,41],getjsscopetyp:37,getkei:36,getlength:36,getlogg:[30,32,54],getmessag:52,getmethod:[37,46],getnam:[46,51,55],getnodeinst:[23,31,44,46,48,53],getnodemodul:32,getobject:46,getownpropertynam:36,getownpropertysymbol:42,getparametercount:46,getposit:37,getpromis:38,getprototyp:42,getsiz:36,getsourcecod:[37,41],getstr:54,getstringvalu:37,gettarget:42,getter:[37,42,46,51,58],getutil:46,getv8inst:[23,31,32,34,48,51,52,53],getv8lock:29,getv8runtim:[32,34,47,54],getvalu:[36,37,46,51],getvers:42,git:2,github:4,give:[31,34,37,46],given:31,global:[5,12,32,37,47,58],globalobject:[12,37],globalthi:[12,32,58],gn:1,go:32,goal:37,goe:[12,37],gone:[9,22],good:[5,31,51],googl:4,got:[9,11],graalj:46,gradl:[1,3,6,9],granular:29,great:23,greater:34,groupid:[23,50],gson:4,guard:34,guess:51,guid:[1,23,56],guido:9,ha:[0,5,8,9,12,30,31,32,36,37,38,41,46,58],hack:[9,12,22],had:[9,11],hair:9,hand:22,handi:38,handl:[12,22,29,32,37,42,46,47],handler:44,hang:34,happen:[19,22,31],happi:37,hard:[0,9,38,58],hashmap:46,hashset:46,hasn:[9,22,37],hasownproperti:54,have:[2,3,9,16,23,31,32,37,38,46,54,58],haven:9,heap:[5,31],heavi:32,heavili:[8,37,46,58],hei:9,hell:[30,55],hello:[44,45,46,47,49,56],help:[4,24],here:[0,4,5,9,11,28,31,32,33,37,38,44,45,46],hide:[5,9],hierarchi:58,high:[5,31,46],highlight:53,hijack:44,hint:[31,37],histori:[10,11,18,58],hit:[22,34],hoc:[9,33],hold:[31,38,46],host:[4,5,32,44,48,51,52],hotfix:58,hour:[2,9,16],how:[4,5,7,11,13,18,22,29,31,32,42,58],howev:[5,9,11,12,22,31,37,46,58],http:[2,4,5,23,33,44],huge:33,i18n:25,i7:[9,33],i:[3,8,9,11,16,18,21,23,37,44,46,58],id:[1,4,5,25],idea:[8,9,11,31],ident:[32,37,51],identifi:46,idl:31,idlenotificationdeadlin:41,ieee:31,ignor:[31,37,41],ijavetbiindexedconsum:41,ijavetclos:[42,46],ijavetconsum:41,ijavetengin:[32,34,47,53,54],ijavetengineguard:[34,40],ijavetenginepool:[34,47,55],ijavetentityfunct:46,ijavetentitymap:46,ijavetpromiserejectcallback:38,ijavetuniconsum:41,ijavetuniindexedconsum:41,imag:[2,9],immedi:[5,24,29,31,34],impact:[24,37],imper:58,implement:[9,23,31,37,38,46,50],impli:[11,15,22,58],implicit:58,improv:[9,29,31],includ:[2,9,16,37,58],inconsist:58,inconveni:46,increas:[5,25,46,58],increaseandget:51,increment:46,inde:[11,24],independ:[1,33],indic:37,ineffici:46,infinit:[34,52],info:30,inform:46,inherit:58,initi:[5,18,21,32,44,47,51],inject:[25,37,38,42,46,58],input:[37,52],insid:[4,5,31,38,46],insight:5,inspect:[4,37],inspector:4,instal:[8,9,15,32,44,49,54,56],instanc:[5,12,24,30,31,32,33,37,51],instead:[29,31,32,41,46,58],instruct:31,int16_t:31,int16arrai:31,int32_t:31,int32arrai:31,int64_t:31,int8_t:31,int8arrai:31,integ:[31,36,37,44,46],integr:[4,9,23,30,40,49,56],intellij:[6,9],intend:[9,12],interact:[4,5,41,43,46,52,56],intercept:[4,6,31,32,40,42,46,49,56],interceptor:[5,22,37,38,47,51],interest:[2,9],interfac:[30,38,58],interfer:5,intermitt:2,intern:[6,28,29,31,37,46],interop:[23,43,56],interpret:[4,5],interrupt:34,interruptedexcept:[34,44],intl:1,intro:23,introduc:[46,58],intrud:37,intrus:46,intvalu:37,invis:37,invoc:37,invok:[12,41,46],invokeobject:[37,45],invokeprimit:37,invokevoid:37,involv:12,io:4,is_component_build:1,is_debug:1,isassignablefrom:46,iscal:37,isclass:37,isclos:42,iscontinu:34,isdead:40,isdebugen:30,isdirectori:46,isfil:46,isfunct:37,isinfoen:30,isinus:[34,40],isnullorundefin:41,isol:[12,24,29,31,33,58],isrevok:42,issu:[1,5,11,22,24,29,32,41,42],istringjoin:46,istringutil:46,isundefin:46,isv8binden:37,iswarnen:30,its:[0,5,9,29,31,32,37,38,46],itself:37,iv8executor:32,iv8inspectorlisten:4,iv8moduleresolv:42,iv8valu:[40,41],iv8valuefunct:41,iv8valueobject:[37,40,41,42],iv8valuepromis:38,iv8valueproxi:42,iv8valuerefer:40,j2v8:[10,11,12,18,56,57],j2v8_win32_x86_64:9,j4:1,jackson:4,jan:58,jar:[5,9],java:[4,5,9,14,23,31,32,37,38,43,44,46,51,54,56,58],javadoc:42,javaobject:[31,58],javascript:[5,22,23,29,32,33,38,43,46,48,51,56,58],javenod:[14,23,54,58],javet:[4,6,8,9,13,14,17,18,19,21,22,24,25,26,28,30,31,34,35,36,37,38,40,42,44,45,46,49,50,51,53,54,55,56],javetcallbackcontext:41,javetcallbackexcept:41,javetconsoleinterceptor:47,javetconverterconfig:[42,46],javetconverterexcept:46,javetengin:[47,53],javetengineconfig:[30,31,41,55],javetengineconfignod:55,javetengineconfigv8:55,javetengineguard:[34,41],javetenginepoo:53,javetenginepool:[30,32,41,47,53,55],javetenginepoolnod:55,javetenginepoolv8:55,javetentityfunct:42,javeterror:41,javeterrortyp:46,javetexcept:[37,38,44,46,54],javetexecutionexcept:[32,46],javetlogg:30,javetnativemonitor:5,javetobjectconvert:[42,46,58],javetosutil:[32,44,54],javetprimitiveconvert:42,javetpromiserejectcallback:41,javetproxyconvert:[42,45,58],javetstandardconsoleinterceptor:[31,47,51],javetterminatedexcept:34,javetuniversalproxyhandl:42,javetvirtualobject:42,jdk:[1,3,6,30,46],jerri:46,jetti:4,jni:[5,8,28,31,37],join:46,joiner:46,joke:9,js:[0,6,7,9,14,16,18,19,21,23,25,28,29,31,33,35,37,38,40,42,43,47,49,56],json:[2,4],jsruntimetyp:[28,32,53,55],just:[4,9,12,29,31,32,33,37,45,46,58],jvm:[5,23,28,29,40,44,46,47,53,58],keep:[5,24,31,46],kei:[5,32,36],keyword:37,kick:3,kind:[5,9,29,37,46,58],know:[5,7,9,22,23,26,32,58],known:[31,46],kotlin:8,l:53,lack:[54,58],lambda:46,land:22,lang:46,languag:31,larg:2,last:[2,9],later:[9,11,32],latest:[1,2,3,16,53],launch:[24,32],layer:[9,58],layout:37,lazi:5,ld:1,lead:[22,24],leak:[6,9,11,24,31,41,46],leakag:[12,25],learn:11,least:[5,9],leav:[5,11,32,46],legaci:[3,5,9,17,18],len:37,length:[31,46],let:[4,9,22,44,46,52],level:[12,29,37,46],lib:[3,32],libjavet:[3,32],libnod:1,librari:[0,1,2,4,5,7,12,18,21,25,28,30,32,37,42],librarynotfound:25,librarynotload:25,lifecycl:[12,24,31,37],light:31,like:[1,4,9,11,12,23,24,25,32,52],limit:[5,12],line:[1,29,37,46,52],link:[1,18,21,31,32],linux:[11,17,18,23,33,40,41,42,50,58],list:[23,26,37,46],listen:[4,22,31,38,44],liter:58,littl:[12,46],live:[4,23,29,31],load:[5,12,19,23,25,26,54,58],loadabl:5,loadj:54,loadlibrari:[28,42],loadlibraryexw:32,local:[9,31,37,46],locat:[5,32,58],lock:[5,23,25,26,31,34,41,58],lockacquisitionfailur:25,lockconflictthreadidmismatch:25,lockedthreadid:25,locker:29,lockreleasefailur:25,log:[23,24,26,31,37,38,44,46,47,51],logerror:54,loggerfactori:30,logic:[9,37,38,44,46,58],loginfo:[32,54],longer:[12,24,31,46,58],look:[1,5,9,11,32],loop:[22,34,38,44,52],lot:[11,47],low:5,lower:11,lowest:[9,16],lowmemorynotif:[41,46,47,51,58],lt:1,luck:9,luckili:[32,46],m:2,mac:[2,3,9,17,18,23,50,58],macbook:[9,16,23],machin:9,maco:[9,23,50],made:[9,11],mai:[1,2,4,5,9,12,22,23,24,28,29,30,31,32,34,37,46,55],mail:23,main:[3,45,46],mainli:33,maintain:[3,15,16,58],major:[32,40,58],make:[0,1,2,3,31,32,38,44,46,54,58],malfunct:16,malici:[24,34],manag:[5,9,12,16,23,26,41],mani:[1,2,9,11,16,31,37,58],manipul:[31,36],manner:[16,38,58],manual:[11,15,32],map:[5,32,36],mark:34,master:[9,38],match:[32,45,46],matcher:[45,46],mathadd:37,maven:[2,6],max:25,max_valu:44,maxdepth:[4,25],maxim:24,maximum:46,maxscriptscaches:4,me:[9,23],mean:[30,32,37],meanwhil:[9,44],mechan:58,meet:[32,46],memor:46,memori:[6,9,11,22,23,24,26,37,41,46,58],mental:58,mere:9,messag:[4,25,30,31],method:[4,12,25,37,46],method_prefix_get:46,method_prefix_i:46,methodnam:[25,37,46],mid:[16,23],might:[11,16],migrat:[12,23,56],millisecond:[31,34,44],mini:[9,16],minim:[5,24,46,47],minut:[2,5,46],mirror:37,mismatch:25,mix:12,mixtur:5,mockcallbackreceiv:37,mode:[6,7,13,15,18,19,22,23,24,28,31,33,35,38,41,42,47,49,56,58],model:5,modul:[6,16,19,22,24,25,35,54],modular:[19,23,24,26,58],modulenam:25,modulenameempti:25,modulenotfound:25,modulepermissiondeni:25,monitor:34,monolith:0,month:[9,11],more:[5,9,15,16,25,32,34,35,37,38,42,46,47,48,51,52,53,54,58],most:[12,24,29,32],mostli:22,motiv:[10,18,58],move:[9,41,42],msvc:1,much:[5,9,24,31,33,37,46,52,54,58],multer:44,multi:[38,47,58],multipl:[5,24,29,32,58],must:54,mvn:3,my:[9,16,23],myjavetengineconfig:55,myjavetlogg:[30,55],n:[32,45,46],name:[4,5,12,25,30,32,37,46,51,54,55],napi:[19,32],napi_create_error:32,nativ:[5,16,19,23,24,29,31,37,40,44,46,58],natur:38,navig:[2,3],nearli:9,necessari:47,need:[0,1,3,4,9,16,29,31,32,37,38,45,46,58],nest:29,net:5,network:2,never:58,newer:7,newglobalref:31,newpath:46,newsourcecod:37,next:[16,37],nextlin:52,ninja:1,nio:31,node:[0,4,6,7,9,14,16,18,19,21,23,25,28,29,31,33,35,37,38,42,43,47,49,52,55,56],node_bind:1,node_modul:[24,32,44,54],node_module_fil:32,node_sqlite3:32,nodemodulemodul:32,nodemoduleprocess:42,noderuntim:[32,41,44,48,53],non:[24,37],none:4,normal:[4,31,34,44],note:[2,4,23,31,32,53],noth:12,notif:[4,31],notifi:[31,51],notsupport:25,now:[8,9,30,32,37,46,51],nowadai:9,npm:[32,44,54],nullpointerexcept:46,number:[31,46],o:1,object:[1,5,12,22,24,31,36,41,42,43,45,47,51,56,58],objectclass:46,obtain:24,obvious:[9,32,37],occur:[22,31,46],octet:31,off:[1,3,4,5,31],offer:[12,14,31],offici:[1,9,15,23],often:31,old:[5,9,16,24,38],older:33,onc:[1,3,25,31,32,44,46],one:[5,7,9,11,12,31,32,37,45,46,51,52,53,58],ones:46,onli:[5,12,14,16,23,24,28,30,32,37,50,58],open:[24,46],oper:[5,46],opportun:46,opposit:46,opt:2,option:[6,24,32,37,51,53],order:[32,36],org:30,organ:41,origin:[4,5,37],originalsourcecod:37,orphan:46,os:[0,2,3,5,23,25,58],osnotsupport:25,other:[5,12,24,29,30,31,38,41,44,50,53,58],otherwis:[4,29,46],out:[1,23,31,32,34,44,45,48,51,52,58],outer:9,outofmemoryerror:46,outperform:33,output:[37,44,45,46],outsid:31,over:[5,22,37,58],overflow:46,overhead:[5,12,29,31,33,34,46,47],overload:46,overrid:[30,37,46],overridden:46,own:[0,5,9,16,28,31,32,37,38,46],ownership:38,ownkei:42,p:[1,46],pace:31,packag:[3,5,8,9],page:4,pai:[9,16,58],pain:58,pair:46,param:4,paramet:25,parent:[24,46],pars:4,parser:44,parti:[30,37],partial:5,particular:[9,32,33],pass:[24,42],patch:1,patch_node_build:1,patch_v8_build:1,patchelf:32,path:[1,15,25,32,44],path_to_depot_tool:1,pattern:[4,12,34],pause_the_event_loop:44,peopl:[22,58],per:[5,16,28,29,31,32,46],perform:[3,4,5,9,22,23,24,26,31,32,37,40,44,46,47,51,58],period:35,permiss:9,persist:31,person:8,perspect:[12,31],phase:1,pid:5,piec:32,pink:45,pitfal:0,place:[3,5,9,22,58],plai:[9,29,32,38,44],plan:[9,16],platform:[0,6,16],pleas:[1,2,3,4,5,11,15,16,20,23,24,28,29,31,32,34,37,38,45,46,47,48,51,52,54,58],point:[31,32],pointer:31,pojoarrai:46,polyfil:[23,35,49,56,58],pom:9,pool:[6,23,30,31,40,49,55,56],popinteg:36,port:[4,44],portal:23,posit:[1,33,37],possibl:[5,24,29,46],potenti:[32,42],ppa:15,practic:[4,5,12,23,26],pre:[0,1,6],preciou:9,precis:[9,16,37,46],prefix:55,prepar:[3,15,32,47],preserv:36,pressur:[31,58],pretti:32,prevent:22,primit:[24,37,40,46],print:[38,52],println:[23,32,44,45,48,51,52],printstacktrac:[34,44,46],prior:28,prioriti:15,privat:[15,37,46,50,51],pro:46,problem:[4,9],problemat:9,proce:1,process:[4,22,38,46],profil:4,prohibit:24,project:[5,9,11,12,14,23,32,54,58],promis:[22,23,24,26],proper:1,properli:5,properti:[15,46,51,55],propertynam:46,propertysourc:55,protect:[29,30,34,46,55],protocol:4,prototyp:37,provid:[5,15,22,32,36,37,46,47,51,58],proxi:46,pseudo:[37,38,44],publish:[3,58],pull:2,purchas:23,purg:5,purpos:46,push:[2,36,37,38],put:[3,24,46],py:1,python2:9,python3:[1,9],python:[1,6],queri:4,question:58,queue:[31,38],quick:16,quickli:4,quit:[0,5,11,12,30,31,34,37,44,46,47,58],r:[15,45],r_x86_64_tpoff32:1,race:[5,29],radic:37,rais:38,rang:31,rapidli:9,ratio:31,ration:31,raw:31,re:[41,44],reach:[25,46],read:[25,31,38],readi:[1,3],realiti:9,realli:[3,9,38],reason:[0,5,9,22,25,38,44,58],rebuilt:[32,41],receiv:[37,38],recogn:37,recommend:[5,8,24,33,37,38,46,47],recompil:1,recurs:[42,46],recycl:[5,22,24,31,33,46,48],redirect:47,refactor:[41,42],refer:[4,11,22,23,24,28,29,33,34,37,45,46,47,48,51,52,54,58],referenc:[31,32],reflect:[24,46],refus:4,regard:[2,4],regardless:[24,29],regist:[12,22,24,25,32,37,38,47,51,58],registercustomobject:[42,46],registr:[25,46,58],regular:[16,29,46],reject:[22,24,42],rel:9,relai:32,relat:37,relationship:46,releas:[1,3,5,9,16,23,25,31,58],reli:[15,30,31,55],reload:28,reloc:1,remain:37,remot:4,remov:[9,41,42],renam:41,repeat:58,replac:32,report:[16,29],repositori:[2,15],repres:[5,12,31,37,46,58],req:44,request:4,requir:[1,8,12,24,32,33,34,37,38,44],reset:[24,33],resetcontext:[5,24,29,41],resetisol:[5,29,41],resolv:[22,32,44,46,58],resourc:[3,5,12,25,29,32,34,38,46,48,51,52,55],resourcenam:32,respons:[4,32,37],rest:4,restart:[2,58],restor:[28,37],result:[4,5,24,29,38,46,48,52],resume_the_event_loop:44,retir:23,reus:[7,12],review:[37,38],revisit:9,reviv:[9,16],revok:42,rich:58,richer:58,rid:58,right:4,risk:[24,28],roi:9,role:58,root:[2,19,31,32,46],root_path_to_javet:1,root_path_to_node_j:1,root_path_to_v8:1,rossum:9,rough:37,routin:[18,21,32],rule:31,run:[2,5,29,31,32,33,34,46,54],runifwaitingfordebugg:4,runtim:[4,5,15,24,25,28,29,32,34,42,44,46,47,48,51,52,53,58],runtimealreadyclos:25,runtimealreadyregist:25,runtimeclosefailur:25,runtimeleakagedetect:25,runtimenotregist:25,s:[0,2,5,9,11,22,24,25,29,31,32,33,37,38,44,46,53,58],safe:[5,22,29,37,46],safeti:37,sai:[9,46],same:[5,24,29,31,32,37,38,46,58],samevalu:40,sampl:[5,31,32,37,44,46],satisfi:9,save:44,scan:37,scanner:52,scenario:[24,29,31,40,58],scene:[5,12,22],schedul:31,school:5,scope:[12,31,37],scratch:[0,6,11],screenshot:4,script:[1,3,5,9,12,24,32,34,41,47,52,54],scriptfil:32,scriptpath:32,scriptstr:32,sdk:[1,3,30,55],seamlessli:44,second:[1,4,34,37],section:37,secur:[5,12,32,54,58],see:[22,53],segfault:[22,58],select:[15,37],semi:37,send:[4,31,44,46],sensit:[24,29,31,40,58],sentenc:[37,58],separ:[5,12,33,46],seriou:[9,11],serious:[9,33],serv:16,server:[4,46,50],serverup:44,session:9,set:[1,4,5,7,9,12,28,30,31,32,36,38,41,44,45,46,51],setallowev:55,setasynccallstackdepth:4,setautosendgcnotif:[31,55],setblackboxpattern:4,setconvert:[45,46],setdefaultengineguardtimeoutmilli:55,setengineguardcheckintervalmilli:55,setextractfunctionsourcecod:46,setfunct:[40,41],setinterv:[14,54],setjavetlogg:[30,55],setjoin:46,setjsruntimetyp:[32,53,55],setlibraryreload:28,setmemoryusagethresholdratio:[31,41],setmodul:32,setnam:[46,51],setpauseonexcept:4,setpooldaemoncheckintervalmilli:55,setpoolidletimeoutsecond:55,setpoolmaxs:55,setpoolmins:55,setpoolshutdowntimeoutsecond:55,setposit:37,setpromiserejectcallback:38,setprototyp:42,setproxymapen:46,setrequirerootdirectori:32,setresetenginetimeoutsecond:55,setresourcenam:32,setskipfunctioninobject:46,setsourcecod:[37,41],setstringvalu:37,setter:[37,42,46,51,58],settimeout:[14,54,58],setutil:46,setv8moduleresolv:32,setv8runtim:37,setvalu:[37,46,51],setweak:[24,31],sh:[3,32],share:[1,5,29,32,37,38,44,58],shell:[6,49,56],ship:4,should:[34,46],show:[4,5,31,37,38,46],showcas:4,shut:58,side:[5,31],sign:31,signatur:[25,37,46],signific:31,significantli:25,similar:[24,46,47],simpl:[30,31,32,44,46,53],simpler:32,simpli:37,simplifi:[5,37],simul:[14,32,54,58],sinc:9,singl:[5,9,29,33,37,44],sit:9,situat:37,size:[2,5,25,31,46],sjtucaocao:[1,2,23],skip:[42,46],slave:15,sleep:[34,44],sleep_a_whil:44,slf4j:30,slight:29,slightli:33,slow:[33,46],slowli:11,smart:[31,46],smartli:46,smooth:58,smoother:31,smoothli:[12,46],snapshot:15,snippet:[31,46],so:[1,2,3,5,7,9,12,14,15,22,24,28,29,30,31,32,37,38,44,46,54,55,58],softwar:15,solut:[1,11,46],solvabl:9,some:[4,5,9,12,14,15,16,19,22,33,38,47,54,58],someon:[9,16,32],someth:[9,37],sometim:[11,31,37,38,46],somewher:32,soon:23,sourc:[1,4,25,29,32,34,45,46,47,48,51,52,54,58],sourcecod:37,space:31,spawn:47,special:46,specif:[31,38],specifi:[37,58],spend:9,split:46,spring:[12,23,40,49,56],sqlite3:32,src:3,stack:46,stackoverflowerror:46,stage:24,stai:[44,58],standard:22,star:23,start:[5,11,34,37,44,46,58],startposit:37,startswith:46,state:[4,37],staticclassen:42,staticecho:37,statu:[15,34],step:[9,12,22,28,31,32,37,46,48,51,52],stick:9,still:[9,16,34,37,58],stop:[1,3,9],storag:2,store:[5,31,32],stori:37,str:[37,46],strictequ:40,string:[5,30,32,38,40,44,46,48,51,52,54],stringjoin:46,stringutil:46,stringvalu:37,structur:[25,42],studio:[1,3,6],style:35,subclass:[24,46],substanti:46,substr:46,success:58,successfulli:[0,4],sudo:[15,32],suffer:9,suit:7,suitabl:51,summari:5,support:[2,5,8,9,17,18,23,25,28,31,32,34,36,37,41,42,46,50,53,58],suppos:[9,28],suppresswarn:46,sure:[1,2,3,9,31,32,44,46,54],surpris:9,surround:29,symbol:[16,19,25,32,42],symbol_level:1,sync:5,synchron:58,system:[5,8,11,23,25,30,32,44,45,48,51,52],system_temporary_directori:5,t:[2,4,5,9,16,22,23,25,29,30,31,32,34,37,46,52,53,55,58],take:[2,5,9,11,16,22,28,32,37,41,44,47,52,58],target:[3,4,7,46,58],target_cpu:1,task:[31,38,41],team:9,technic:[16,53],tediou:[5,12,58],tell:[4,22,31,32,51],temporarili:9,term:[5,34,37],termin:[23,25,26],terminateexecut:[34,40,58],test:[2,3,5,6,9,15,23,29,32,33,37,38,40,44,50,54],testexpress:44,testfrommodul:32,testintercept:51,testinterceptor:51,testlogg:30,testpojo:46,testv8valuedataview:31,testv8valuetypedarrai:31,than:[11,33,34,37,46,54,58],thank:23,thei:[5,9,16,24,25,28,32,38,46,53],them:[3,4,31,37,46],there_are_more_tasks_in_task_queu:44,thi:[1,3,4,5,9,11,12,15,19,22,23,28,29,31,32,38,44,45,46,51,53,58],thin:1,thing:[12,31,32,46],think:[9,11,13,18],thisobject:37,thisobjectrequir:[37,42],those:[1,4,5,12,22,31,32],though:[8,25,47,58],thought:[9,11],thread:[5,9,25,31,33,34,38,41,42,47,58],threshold:31,through:32,throwabl:[30,52],thrown:[29,34],till:34,time:[9,16,28,32,46,47],timeout:[34,38],timestamp:7,timeunit:[34,44],tini:46,tip:4,tl:9,tmp:46,toarrai:46,toclon:37,todo:[23,26],tofil:44,togeth:[4,44],tojsonstr:37,tolowercas:46,tom:46,tomap:46,too:[9,16,32],toobject:46,took:58,tool:[6,15,20,23,40],toolchain:15,top:[12,32,58],topath:[32,46],topic:[38,46],tostr:[32,36,37,45,46,52,54],touch:[29,46],tov8valu:46,tp:[9,33],track:[5,31],trade:5,transpar:[46,58],treat:31,tri:[5,9,19],trick:44,tricki:37,trigger:[29,31,37],troubleshoot:[18,23],turn:[1,4,5,31,41],tutori:23,tweak:46,two:[31,46],txt:9,type:[12,25,28,29,31,33,40,41,46],typic:[5,34,37],ubuntu:[1,2,3,15,32,41,50],uint16_t:31,uint16arrai:31,uint32_t:31,uint32arrai:31,uint64_t:31,uint8_t:31,uint8arrai:31,uint8clampedarrai:31,ultim:4,unbind:[37,42,58],unbindfunct:[37,42],unbindproperti:[37,42],uncertain:24,uncertainti:9,uncheck:46,undefin:[4,32,37,46,52],under:[3,9,24,31,37],understand:9,unexpect:[9,46],unfortun:[5,9,23],unhandl:24,unhandledreject:38,uniqueid:4,unit:5,univers:41,unknown:25,unless:[16,24,31,33,58],unload:[5,23,26,58],unloadlibrari:[28,42],unlock:29,unmanag:[5,31],unoffici:9,unpack:5,unrealist:46,unregist:[47,51],unregistercustomobject:42,unregistr:25,unrel:[5,33],unrestrict:31,unsign:31,unstabl:28,until:31,untouch:37,unzip:32,up:[2,4,5,12,29,31,32,44,46],updat:[2,15,41,42],upgrad:[4,8,9,11,15,35,41,42],upon:46,url:5,us:[1,4,5,8,11,22,23,24,28,30,31,33,37,47,58],usag:[31,58],use_custom_libcxx:1,user:[22,30,32,46,47,52,55],usr:[1,15],usual:[0,32,34,37,38,44,46],util:[1,46],v0:58,v14:[23,41,42],v1:4,v2:9,v3:[8,32],v4:9,v6:9,v7:8,v8:[0,4,6,7,9,11,12,13,16,18,22,23,24,25,26,28,29,33,34,35,44,45,46,47,49,51,52,55,56],v8_enable_i18n_support:1,v8_enable_pointer_compress:1,v8_monolith:1,v8_static_librari:1,v8_use_external_startup_data:1,v8bindenabl:[37,42],v8customobject:46,v8data:58,v8function:[12,37,38,42],v8functioncallback:41,v8host:[23,28,31,32,34,41,42,44,46,48,51,52],v8locker:[24,29,40],v8modul:[32,41],v8modulereferr:32,v8notifi:31,v8properti:[12,37,41,42,58],v8runtim:[5,23,24,29,32,34,36,37,38,40,41,42,45,46,47,48,51,52,53,54],v8runtimesett:37,v8script:41,v8valu:[41,42,46,52,58],v8valuearrai:37,v8valuebuiltinobject:42,v8valuebuiltinsymbol:42,v8valuefunct:[37,41,42,44,46,54],v8valuefunctiondecim:54,v8valueinteg:[36,37],v8valueobject:[31,32,37,42,46,51,54,58],v8valueobjectdecim:54,v8valueprimit:58,v8valuepromis:[38,41,42],v8valuepromiseresolv:38,v8valueproxi:42,v8valuesharedarraybuff:42,v8valuestr:36,v8valuetemp:46,v8valueweakmap:40,v8valueweakset:40,v9:[1,23],v:[3,23],vagu:5,valid:[5,31,37],valu:[5,25,28,31,32,36,40,41,46,51],valueof:37,van:9,vararg:[37,41,46],variabl:[29,32,37,45,51],variou:[0,58],vcbuild:1,ve:[9,11],verbos:58,veri:[5,24,32,37,46,52,53],verifi:[5,32],version:[1,4,5,8,11,16,23,32,46,50,53],via:[4,5,24,31,34,37,38,44,46,51],view:40,violat:5,virtual:[32,46],visibl:[5,37],visit:[20,23,54],visual:[1,3,6],vm:[5,24],voluntarili:32,vs:[1,6,9],vulner:24,wa:[9,16,58],wai:[0,5,12,22,23,24,28,31,32,34,37,38,42,44,46,47,51,55],wait:[2,4,44],want:[5,8,9,12,22,25,29,31,46],warn:[1,30,41],watch:9,weak:5,weakmap:36,weakset:36,web:[4,24,31],websit:4,websocket:4,week:58,weight:31,welcom:[2,52],well:[9,16,22,31,46,58],were:9,what:[4,9,10,18,31,32,46,58],whatev:[5,22,29,31],when:[1,5,9,16,18,19,21,31,32,34,37,38,46,58],where:[12,13,18,32,58],wherea:31,whether:[37,42],which:[0,4,5,7,9,12,15,16,22,31,32,33,34,37,45,46,51,53,54,58],who:[9,32],whole:46,whose:24,why:[1,4,12,18,21,28,31,54],windbg:[1,3],window:[11,12,19,23,33,40,50,58],wise:[2,3,15,37],wish:[9,58],within:31,without:[1,2,4,5,22,29,37,46,58],won:[16,22,46],word:[5,31,44],work:[4,5,9,12,22,23,28,29,31,32,37,38,44,58],worker:31,workflow:2,working_directori:[32,44,54],workingdirectori:32,worri:[32,34,44,46],wors:46,would:[9,11,16],wrap:31,writabl:46,write:[11,31,46,58],written:[16,46],ws:4,wsl2:2,x64:[1,32],x86:[16,42],x86_64:[2,3,23,50],x:[2,9,23,37,39,46],xcode:[1,3],xml:9,xms64m:31,xmx64m:31,y:[15,46],ye:[4,5,15,20,22,29,32,36,37,46,50,54],year:[9,58],yet:22,you:[1,2,3,4,8,9,12,20,22,23,29,30,31,46,54,55,58],your:[4,9,15,24,28,30,55,58],z:46,zero:[5,31],zombi:31},titles:["Build Javet","Build Javet from Scratch","Build Javet with Docker","Build Javet with Pre-built Binaries","Debug with Chrome Developer Tools","Javet Design","Development","Test Javet","Development Tools","History with J2V8","Background","What is the Motivation?","How to Think in Javet?","Development","Where are ES6 API in V8 Mode?","Can Javet Support Legacy Linux?","Can Javet Support Mac?","Environment","FAQ","A dynamic link library (DLL) initialization routine failed","Can I Debug Javet in Chrome DevTools?","Troubleshooting","Why Node.js Crashes When being Closed?","Javet","Best Practices","Error Codes","Reference","API Reference","Load and Unload","Know the Lock","Logging","Memory Management","Modularization","Javet Performance","Termination","TODO List","V8 Collection","V8 Function","V8 Promise","Release Notes","Release Notes 0.7.x","Release Notes 0.8.x","Release Notes 0.9.x","Advanced","Interact with Node.js","Java and JavaScript Interop","Object Converter","Javet Engine Pool","Hello Javet","Basic","Installation","Interception","Javet Shell","Node.js Mode and V8 Mode","Polyfill","Spring Integration","Tutorial","Migration Guides","Migrate from J2V8"],titleterms:{"0":[40,41,42],"1":[4,29,30,40,41,42,44,48],"10":[16,41,42],"11":42,"12":42,"2":[4,29,30,40,41,42,44],"2019":8,"2021":16,"3":[4,8,31,40,41,42,44],"4":[4,40,41,42],"5":[41,42],"6":[41,42],"7":[40,41,42],"8":[8,41,42],"9":[40,41,42],"boolean":37,"class":45,"enum":[45,46],"final":46,"function":[12,37,41,42,46],"import":[5,37],"long":31,"null":46,"static":[45,46],"try":31,A:19,Is:44,It:46,No:16,On:32,That:44,Will:16,about:[16,34,37],advanc:43,aggress:31,alloc:1,altern:31,an:45,anonym:[42,46],api:[14,27],ar:14,architectur:5,arm64:16,arraybuff:31,aug:16,autom:9,automat:[31,34,37],await:[22,31],background:[10,22],backward:25,basic:49,befor:16,being:22,best:24,between:32,binari:3,bind:37,bindfunct:37,birth:40,bless:58,bug:40,build:[0,1,2,3,9,16],built:3,c:31,call:37,can:[15,16,20,37],caus:22,caution:32,cdt:4,central:3,challeng:31,chang:37,chrome:[4,20],circular:46,classload:42,close:22,co:53,code:[25,37,41],codestr:37,collect:36,commun:8,comparison:[29,37],compat:[25,50],configur:55,context:5,convers:[37,41,58],convert:[42,46],cppgc:1,crash:22,creat:46,cross:5,custom:[4,46],deadlineinmilli:31,deal:32,debug:[4,20,34,40],decim:54,declar:[12,41],defin:[37,46],demand:32,depend:[23,50],deploi:9,design:[5,46],detect:5,develop:[4,6,8,13],devtool:20,disabl:37,dll:19,docker:2,document:23,doe:[29,46],download:3,dsl:[23,50],dynam:[19,46],elf:32,empow:42,engin:[5,24,34,40,47],enhanc:46,environ:[1,2,3,17],error:[25,41],es6:[14,58],event:[22,41],exampl:[32,38],execut:12,executor:12,exist:53,explicit:29,fail:19,faq:18,featur:[23,46],file:46,first:41,fix:40,fly:37,foreach:41,from:[1,12,58],fs:38,functionnam:37,gap:32,gc:[31,41],github:2,go:46,goal:47,gradl:[8,23,50],groovi:[23,50],guard:40,guid:[57,58],h:1,handshak:4,hello:[23,48],highlight:[33,46],histori:9,hotfix:41,how:[12,16,28,34,37,44,46],hub:2,i:20,idlenotificationdeadlin:31,ijavetlogg:30,implement:30,implicit:29,includ:1,index:41,initi:19,inject:[30,45,55],instal:50,instanc:46,integr:55,intellij:8,interact:44,intercept:[5,12,37,41,51],interfac:[42,46],intern:[4,32],interop:45,invok:37,isol:5,issu:[9,16],j2v8:[9,58],jar:3,java:[42,45],javascript:[37,44,45],javet:[0,1,2,3,5,7,12,15,16,20,23,29,32,33,47,48,52,58],javetcallbackcontext:37,javetproxyconvert:46,jdk:8,jni:3,js:[1,3,5,8,22,24,32,41,44,48,53,54,58],jvm:31,kei:37,know:29,known:16,kotlin:[23,50],latest:9,leak:5,learn:12,legaci:15,librari:[3,19],licens:23,lifecycl:38,link:19,linux:[1,2,3,9,15,32],list:35,live:40,load:[28,32],lock:29,locker:40,log:30,logger:30,loop:41,lowmemorynotif:[22,31],lt:16,mac:[1,16,42],maco:[1,3],main:44,major:23,manag:[24,31,37],manual:[31,34,37],map:46,maven:[3,8,9,23,50],mean:29,memori:[5,31],migrat:[57,58],mismatch:37,mode:[5,14,29,32,34,48,53,54],modul:[5,32,41,42,58],modular:32,motiv:[11,47],multi:[5,42],nativ:[32,41],node:[1,3,5,8,22,24,32,41,44,48,53,54,58],noderuntim:22,note:[15,28,38,39,40,41,42,46],now:16,object:[37,46],onli:9,open:4,option:[3,8,31],os:[1,16,42,50],pass:37,passiv:31,patch:32,path:46,pattern:[45,46],perform:[29,33],platform:5,pojo:46,pojoconvert:46,polyfil:[42,54],pool:[5,24,34,47,53],possibl:44,practic:24,pre:[3,32],prepar:[1,46],primit:[5,41,58],print:48,privat:42,process:[5,42],promis:[38,42],properti:[12,37,41,42],proxi:42,python:8,quick:23,readfileasync:38,readi:46,rebuild:32,recommend:31,refer:[5,26,27,31],regist:46,registerjavamethod:58,registr:37,reject:38,releas:[39,40,41,42],repositori:9,requir:5,resolv:[38,42],resourc:[24,31,37],result:33,root:22,routin:19,run:4,runtim:31,safe:42,safeti:[5,29,46],sampl:51,scratch:1,script:4,secur:24,server:44,set:37,shell:[4,52],solut:22,sourc:[37,41],spring:55,start:23,step:[30,44],string:37,stringbuild:[45,46],structur:46,studio:8,summari:37,support:[15,16],symbol:37,system:9,termin:34,test:[7,12,51],thi:37,think:12,thread:[24,29,44],time:41,todo:35,tool:[4,8],troubleshoot:21,tutori:56,type:[5,37,58],unhandl:38,unhandledreject:22,unit:12,univers:46,unload:28,unregist:37,upload:3,usag:[36,46,47,53],user:37,usual:4,v1:42,v2:42,v8:[1,3,5,14,31,32,36,37,38,40,41,42,48,53,54,58],v8function:[51,58],v8host:53,v8locker:58,v8properti:51,v8runtim:[12,31,58],v8valu:37,v8valuearrai:36,v8valueglobalobject:12,v8valuemap:36,v8valueset:36,v9:[41,42],valu:37,version:9,virtual:5,visual:8,vs:[5,37],weak:31,what:[11,29,37],when:22,where:14,why:[9,22,25,37,58],window:[1,2,3,9,32],work:46,worker:44,x86_64:42,x:[40,41,42],ye:16}}) \ No newline at end of file diff --git a/docs/tutorial/advanced/index.html b/docs/tutorial/advanced/index.html new file mode 100644 index 000000000..ebc9092b7 --- /dev/null +++ b/docs/tutorial/advanced/index.html @@ -0,0 +1,337 @@ + + + + + + + + Advanced - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+ +
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/tutorial/advanced/index.rst b/docs/tutorial/advanced/index.rst new file mode 100644 index 000000000..3c893598b --- /dev/null +++ b/docs/tutorial/advanced/index.rst @@ -0,0 +1,10 @@ +======== +Advanced +======== + +.. toctree:: + :maxdepth: 1 + + object_converter + java_and_javascript_interop + interact_with_node_js diff --git a/docs/tutorial/advanced/interact_with_node_js.html b/docs/tutorial/advanced/interact_with_node_js.html new file mode 100644 index 000000000..0c4b62fd6 --- /dev/null +++ b/docs/tutorial/advanced/interact_with_node_js.html @@ -0,0 +1,486 @@ + + + + + + + + Interact with Node.js - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Interact with Node.js

+
+

Is That Possible?

+

In native Node.js, once a JavaScript server application (e.g. express server) is up, there is no normal way of interacting with the Node.js runtime via console. The reasons are quite simple:

+
    +

  • V8 is single-threaded.

    • +

  • Node.js event loop is dedicated to that JavaScript server application.

    • +
+

So, that almost closes the door to interacting with Node.js runtime from JVM. No worry, Javet is able to hijack the Node.js event loop to allow interaction from JVM. In other words, Java application can seamlessly interact with Node.js runtime as usual. That applies to all Javet API.

+
+
+

How?

+
+

Step 1: JavaScript Server

+
    +

  • Create a JavaScript server application. Here is a sample.

    • +
+
/*
+npm install express body-parser cookie-parser multer --save
+*/
+
+const express = require("express");
+const app = express();
+
+// This is the callback function that takes calls from JVM.
+var test = (count) => {
+    console.log(`Call #${count}`);
+}
+
+// This is the express handler.
+app.get('/', function (req, res) {
+res.send('Hello');
+    console.log('GET /');
+})
+
+// Start the express server.
+const server = app.listen(8991, "0.0.0.0", () => {
+    const host = server.address().address;
+    const port = server.address().port;
+    console.log(`Listening at http://${host}:${port}`);
+});
+
+
+
+
+

Step 2: Worker Thread for the JavaScript Server

+
    +

  • Create a worker thread hosting that JavaScript server application.

    • +

  • Call NodeRuntime.await() in that worker thread once the Node.js runtime is up.

    • +

  • Make sure that Node.js runtime is shared with the main thread.

    • +
+
+
+

Step 3: Main Thread for the Interaction

+
    +

  • Start that worker thread.

    • +

  • Wait for the Node.js runtime completely initialized.

    • +

  • Perform the interaction as usual.

    • +
+
public class TestExpress {
+    public static void main(String[] args) throws JavetException, InterruptedException {
+        // Make sure node_modules and test folders stay together.
+        File codeFile = Path.of(JavetOSUtils.WORKING_DIRECTORY)
+                .resolve("test/test-express.js").toFile();
+        AtomicBoolean serverUp = new AtomicBoolean(false);
+        // Make sure Node.js runtime is shared with all threads.
+        try (NodeRuntime nodeRuntime = V8Host.getNodeInstance().createV8Runtime()) {
+            // Create a worker thread.
+            Thread thread = new Thread(() -> {
+                try {
+                    System.out.println("Starting the server.");
+                    nodeRuntime.getExecutor(codeFile).executeVoid();
+                    serverUp.set(true);
+                    System.out.println("Awaiting...");
+                    nodeRuntime.await();
+                } catch (JavetException e) {
+                    e.printStackTrace();
+                }
+            });
+            // Start the worker thread.
+            thread.start();
+            while (!serverUp.get()) {
+                System.out.println("Waiting for server getting up.");
+                TimeUnit.MILLISECONDS.sleep(500);
+            }
+            System.out.println("Server is up.");
+            // Let's call Node.js.
+            for (int i = 0; i < Integer.MAX_VALUE; ++i) {
+                try (V8ValueFunction v8ValueFunction = nodeRuntime.getGlobalObject().get("test")) {
+                    v8ValueFunction.callVoid(null, i);
+                }
+                TimeUnit.MILLISECONDS.sleep(1000);
+            }
+        }
+    }
+}
+
+
+

Voilà! The calls (Call #) from JVM work. And in the meanwhile, calls (GET /) to that JavaScript server also work. Here is the console output.

+
Waiting for server getting up.
+Starting the server.
+Awaiting...
+Listening at http://0.0.0.0:8991
+Server is up.
+Call #0
+Call #1
+Call #2
+Call #3
+Call #4
+GET /
+Call #5
+Call #6
+Call #7
+Call #8
+Call #9
+
+
+

How can this work? The await() in the worker thread actually plays the following trick.

+
# This is the pseudo logic.
+def await():
+    while True:
+        drain_the_task_queue()
+        pause_the_event_loop()
+        if there_are_more_tasks_in_task_queue():
+            sleep_a_while() # This allows calls from other thread to take effect.
+            resume_the_event_loop()
+        else:
+            break
+
+
+
+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/tutorial/interact_with_node_js.rst b/docs/tutorial/advanced/interact_with_node_js.rst similarity index 98% rename from docs/tutorial/interact_with_node_js.rst rename to docs/tutorial/advanced/interact_with_node_js.rst index 3dec5615b..a7ca858e5 100644 --- a/docs/tutorial/interact_with_node_js.rst +++ b/docs/tutorial/advanced/interact_with_node_js.rst @@ -136,5 +136,3 @@ How can this work? The ``await()`` in the worker thread actually plays the follo resume_the_event_loop() else: break - -[`Home <../../README.rst>`_] [`Javet Tutorial `_] diff --git a/docs/tutorial/advanced/java_and_javascript_interop.html b/docs/tutorial/advanced/java_and_javascript_interop.html new file mode 100644 index 000000000..7af2cb5f0 --- /dev/null +++ b/docs/tutorial/advanced/java_and_javascript_interop.html @@ -0,0 +1,426 @@ + + + + + + + + Java and JavaScript Interop - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Java and JavaScript Interop

+

Javet allows injecting arbitrary Java objects into V8 which enables the complete interop between Java and JavaScript. To enable this feature, application just needs to call v8Runtime.setConverter(new JavetProxyConverter());. Here are 3 examples.

+
+

Inject a Static Class

+
v8Runtime.getGlobalObject().set("System", System.class);
+v8Runtime.getExecutor("function main() {\n" +
+        // Java reference can be directly called in JavaScript.
+        "  System.out.println('Hello from Java');\n" +
+        // Java reference can be directly assigned to JavaScript variable.
+        "  const println = System.out.println;\n" +
+        // Java reference can be directly assigned to JavaScript variable.
+        "  println('Hello from JavaScript');\n" +
+        "}\n" +
+        "main();").executeVoid();
+v8Runtime.getGlobalObject().delete("System");
+
+/*
+ * Output:
+ *   Hello from Java
+ *   Hello from JavaScript
+ */
+
+
+
+
+

Inject an Enum

+
v8Runtime.getGlobalObject().set("Color", Color.class);
+System.out.println(v8Runtime.getExecutor("Color.pink.toString();").executeString());
+System.out.println("The enum in JavaScript is the one in Java: " +
+        (Color.pink == (Color) v8Runtime.getExecutor("Color.pink;").executeObject()));
+v8Runtime.getGlobalObject().delete("Color");
+
+/*
+ * Output:
+ *   java.awt.Color[r=255,g=175,b=175]
+ *   The enum in JavaScript is the one in Java: true
+ */
+
+
+
+
+

Inject a Pattern

+
Pattern pattern = Pattern.compile("^\\d+$");
+v8Runtime.getExecutor("function main(pattern) {\n" +
+        "  return [\n" +
+        "    pattern.matcher('123').matches(),\n" +
+        "    pattern.matcher('abc').matches(),\n" +
+        "  ];\n" +
+        "}").executeVoid();
+System.out.println(v8Runtime.getGlobalObject().invokeObject("main", pattern).toString());
+
+/*
+ * Output:
+ *   [true, false]
+ */
+
+
+
+
+

Inject a StringBuilder

+
 v8Runtime.getGlobalObject().set("StringBuilder", StringBuilder.class);
+ System.out.println(v8Runtime.getExecutor("function main() {\n" +
+         "  return new StringBuilder('Hello').append(' from StringBuilder').toString();\n" +
+         "}\n" +
+         "main();").executeString());
+ v8Runtime.getGlobalObject().delete("StringBuilder");
+
+/*
+ * Output:
+ *   Hello from StringBuilder
+ */
+
+
+

Please refer to the source code for detail.

+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/tutorial/java_and_javascript_interop.rst b/docs/tutorial/advanced/java_and_javascript_interop.rst similarity index 93% rename from docs/tutorial/java_and_javascript_interop.rst rename to docs/tutorial/advanced/java_and_javascript_interop.rst index ec27c70c4..d95d0a5bd 100644 --- a/docs/tutorial/java_and_javascript_interop.rst +++ b/docs/tutorial/advanced/java_and_javascript_interop.rst @@ -80,6 +80,4 @@ Inject a StringBuilder * Hello from StringBuilder */ -Please refer to `source code <../../src/test/java/com/caoccao/javet/tutorial/TestJavaAndJSInterop.java>`_ for detail. - -[`Home <../../README.rst>`_] [`Javet Tutorial `_] +Please refer to the :extsource3:`source code <../../../src/test/java/com/caoccao/javet/tutorial/TestJavaAndJSInterop.java>` for detail. diff --git a/docs/tutorial/advanced/object_converter.html b/docs/tutorial/advanced/object_converter.html new file mode 100644 index 000000000..ace3424e5 --- /dev/null +++ b/docs/tutorial/advanced/object_converter.html @@ -0,0 +1,903 @@ + + + + + + + + Object Converter - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Object Converter

+

Javet has a built-in JavetObjectConverter with the following features.

+
    +

  • It covers primitive types + Set + Map + Array.

    • +

  • It is completely open to subclass.

    • +

  • It minimizes the performance overhead.

    • +

  • It allows registering custom objects.

    • +
+

So, Javet doesn't natively support converting POJO objects because a POJO converter has to deal with reflection which is so slow that Javet leaves that to applications. However, if the POJO objects are owned by the application, it is possible to register custom objects with the built-in JavetObjectConverter. Otherwise, designing a POJO converter is the alternative solution.

+

What if the application wants to inject arbitrary Java objects? No worry, the JavetProxyConverter is designed for that purpose.

+
+

Register Custom Objects

+

JavetObjectConverter exposes registerCustomObject() for alien objects which match the following conditions.

+
    +

  • Default constructor without arguments

    • +

  • Method with signature void fromMap(Map<String, Object> map)

    • +

  • Method with signature Map<String, Object> toMap()

    • +
+
+

Enhance the Custom Object

+
    +

  • Create a default constructor without arguments.

    • +

  • Add a method with signature void fromMap(Map<String, Object> map)

    • +

  • Add a method with signature Map<String, Object> toMap()

    • +
+

Can the method names be changed? Yes, they can have arbitrary names.

+
public final class CustomObject {
+    private String name;
+    private int value;
+
+    public CustomObject(String name, int value) {
+        this.name = name;
+        this.value = value;
+    }
+
+    public CustomObject() {
+        this(null, 0);
+    }
+
+    public void fromMap(Map<String, Object> map) {
+        setName((String) map.get("name"));
+        setValue((Integer) map.get("value"));
+    }
+
+    public Map<String, Object> toMap() {
+        return new HashMap<String, Object>() {
+            {
+                put("name", getName());
+                put("value", getValue());
+            }
+        };
+    }
+
+    // getters and setters
+}
+
+
+
+
+

Register the Custom Object

+

As the default converter is JavetObjectConverter, just follow the code snippet below to register a custom object.

+
JavetObjectConverter converter = (JavetObjectConverter)v8Runtime.getConverter();
+converter.registerCustomObject(CustomObject.class);
+
+
+

If the method names are different from the default ones, just provide the names upon registration as the following.

+
converter.registerCustomObject(CustomObject.class, "customFromMap", "customToMap");
+
+
+
+
+

Usage

+

After the registration is completed, there is no additional steps any more. Just follow the regular pattern.

+
CustomObject[] customObjects = new CustomObject[]{
+        new CustomObject("x", 1),
+        new CustomObject("y", 2),
+};
+v8Runtime.getGlobalObject().set("a", customObjects);
+assertEquals(2, v8Runtime.getExecutor("a.length").executeInteger());
+List<CustomObject> v8CustomObjects = v8Runtime.getGlobalObject().getObject("a");
+assertNotNull(v8CustomObjects);
+assertEquals(2, v8CustomObjects.size());
+for (int i = 0; i < customObjects.length; i++) {
+    assertEquals(customObjects[i].getName(), v8Runtime.getExecutor("a[" + i + "].name").executeString());
+    assertEquals(customObjects[i].getValue(), v8Runtime.getExecutor("a[" + i + "].value").executeInteger());
+    assertEquals(customObjects[i].getName(), v8CustomObjects.get(i).getName());
+    assertEquals(customObjects[i].getValue(), v8CustomObjects.get(i).getValue());
+}
+
+
+
+
+

Highlights

+
    +

  • PROS: This is a built-in feature so there is no need to deal with a POJO converter.

    • +

  • CONS: This is a little bit intrusive to the custom objects.

    • +
+
+
+

How does It Work?

+

As V8 supports private properties, JavetObjectConverter sets the custom object class name to the V8 object in toMap() and gets the name from the V8 object in fromMap(). So it is the V8 object that carries the type information all the time and JavetObjectConverter is free from memorizing the complicated relationship between the Java objects and V8 objects.

+
+
+
+

Design a POJO Converter

+

A POJO converter usually is designed for the Java objects that are now owned by the application. So, it has to deal with reflection heavily. The following sample code runs in JDK 11. It's easy to tweak few API for JDK 8.

+
+

Define POJO Object

+

Let's say you have a Pojo that allows you to define a name-value pair.

+
public class Pojo {
+    private String name;
+    private String value;
+
+    public Pojo() {
+        this(null, null);
+    }
+
+    public Pojo(String name, String value) {
+        this.name = name;
+        this.value = value;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public String getValue() {
+        return value;
+    }
+
+    public void setValue(String value) {
+        this.value = value;
+    }
+}
+
+
+
+
+

Create PojoConverter

+

Then, create a generic PojoConverter.

+
    +

  • It is generic enough to cover all kinds of Pojo objects in a recursive way.

    • +

  • There is no need to deal with primitive types because the parent converter handles that.

    • +

  • Always override the methods with depth as argument for circular structure detection.

    • +

  • Always increment the depth in recursive call.

    • +
+
@SuppressWarnings("unchecked")
+public class PojoConverter extends JavetObjectConverter {
+    public static final String METHOD_PREFIX_GET = "get";
+    public static final String METHOD_PREFIX_IS = "is";
+    protected static final Set<String> EXCLUDED_METHODS;
+
+    static {
+        EXCLUDED_METHODS = new HashSet<>();
+        for (Method method : Object.class.getMethods()) {
+            if (method.getParameterCount() == 0) {
+                String methodName = method.getName();
+                if (methodName.startsWith(METHOD_PREFIX_IS) || methodName.startsWith(METHOD_PREFIX_GET)) {
+                    EXCLUDED_METHODS.add(methodName);
+                }
+            }
+        }
+    }
+
+    @Override
+    protected V8Value toV8Value(
+            V8Runtime v8Runtime, Object object, final int depth) throws JavetException {
+        V8Value v8Value = super.toV8Value(v8Runtime, object, depth);
+        if (v8Value != null && !(v8Value.isUndefined())) {
+            return v8Value;
+        }
+        Class objectClass = object.getClass();
+        V8ValueObject v8ValueObject = v8Runtime.createV8ValueObject();
+        for (Method method : objectClass.getMethods()) {
+            if (method.getParameterCount() == 0 && method.canAccess(object)) {
+                String methodName = method.getName();
+                String propertyName = null;
+                if (methodName.startsWith(METHOD_PREFIX_IS) && !EXCLUDED_METHODS.contains(methodName)
+                        && methodName.length() > METHOD_PREFIX_IS.length()) {
+                    propertyName = methodName.substring(METHOD_PREFIX_IS.length(), METHOD_PREFIX_IS.length() + 1).toLowerCase(Locale.ROOT)
+                            + methodName.substring(METHOD_PREFIX_IS.length() + 1);
+                } else if (methodName.startsWith(METHOD_PREFIX_GET) && !EXCLUDED_METHODS.contains(methodName)
+                        && methodName.length() > METHOD_PREFIX_GET.length()) {
+                    propertyName = methodName.substring(METHOD_PREFIX_GET.length(), METHOD_PREFIX_GET.length() + 1).toLowerCase(Locale.ROOT)
+                            + methodName.substring(METHOD_PREFIX_GET.length() + 1);
+                }
+                if (propertyName != null) {
+                    try (V8Value v8ValueTemp = toV8Value(v8Runtime, method.invoke(object), depth + 1)) {
+                        v8ValueObject.set(propertyName, v8ValueTemp);
+                    } catch (Exception e) {
+                        e.printStackTrace();
+                    }
+                }
+            }
+        }
+        v8Value = v8ValueObject;
+        return v8Runtime.decorateV8Value(v8Value);
+    }
+}
+
+
+
+
+

Ready! Go!

+

Just write few lines of code to interact with Javet.

+
public class TestPojo {
+    public static void main(String[] args) throws JavetException {
+        Pojo[] pojoArray = new Pojo[]{
+                new Pojo("Tom", "CEO"),
+                new Pojo("Jerry", "CFO")};
+        try (V8Runtime v8Runtime = V8Host.getNodeInstance().createV8Runtime()) {
+            v8Runtime.setConverter(new PojoConverter());
+            v8Runtime.getGlobalObject().set("pojoArray", pojoArray);
+            v8Runtime.getExecutor("console.log(pojoArray);").executeVoid();
+        }
+    }
+}
+
+
+

The console output is:

+
[ { name: 'Tom', value: 'CEO' }, { name: 'Jerry', value: 'CFO' } ]
+
+
+

This process is transparent and fully automated once the converter is set to V8Runtime.

+
+
+
+

Universal Converter

+

Can I inject arbitrary Java objects and call all the API in JavaScript? Yes, JavetProxyConverter is designed for that. In general, the user experience is very much close to the one provided by GraalJS. As JavetProxyConverter opens almost the whole JVM to V8, it is very dangerous to allow end users to touch that V8 runtime, so JavetProxyConverter is not enabled by default. Here are the steps on how to enable that.

+
+

Preparation

+
// Step 1: Create an instance of JavetProxyConverter.
+JavetProxyConverter javetProxyConverter = new JavetProxyConverter();
+// Step 2: Set the V8Runtime converter to JavetProxyConverter.
+v8Runtime.setConverter(javetProxyConverter);
+// Please feel free to inject arbitrary Java objects.
+
+
+
+
+

Instance: File

+
File file = new File("/tmp/i-am-not-accessible");
+v8Runtime.getGlobalObject().set("file", file);
+assertEquals(file, v8Runtime.getGlobalObject().getObject("file"));
+assertEquals(file.exists(), v8Runtime.getExecutor("file.exists()").executeBoolean());
+assertEquals(file.isFile(), v8Runtime.getExecutor("file.isFile()").executeBoolean());
+assertEquals(file.isDirectory(), v8Runtime.getExecutor("file.isDirectory()").executeBoolean());
+assertEquals(file.canRead(), v8Runtime.getExecutor("file.canRead()").executeBoolean());
+assertEquals(file.canWrite(), v8Runtime.getExecutor("file.canWrite()").executeBoolean());
+assertEquals(file.canExecute(), v8Runtime.getExecutor("file.canExecute()").executeBoolean());
+v8Runtime.getGlobalObject().delete("file");
+v8Runtime.lowMemoryNotification();
+
+
+
+
+

Instance: Map

+
javetProxyConverter.getConfig().setProxyMapEnabled(true);
+Map<String, Object> map = new HashMap<String, Object>() {{
+    put("x", 1);
+    put("y", "2");
+}};
+v8Runtime.getGlobalObject().set("map", map);
+assertTrue(map == v8Runtime.getGlobalObject().getObject("map"));
+assertEquals(1, v8Runtime.getExecutor("map['x']").executeInteger());
+assertEquals("2", v8Runtime.getExecutor("map['y']").executeString());
+assertEquals(1, v8Runtime.getExecutor("map.x").executeInteger());
+assertEquals("2", v8Runtime.getExecutor("map.y").executeString());
+assertEquals("3", v8Runtime.getExecutor("map['z'] = '3'; map.z;").executeString());
+assertEquals("3", map.get("z"));
+assertEquals("4", v8Runtime.getExecutor("map.z = '4'; map.z;").executeString());
+assertEquals("4", map.get("z"));
+v8Runtime.getGlobalObject().delete("map");
+v8Runtime.lowMemoryNotification();
+javetProxyConverter.getConfig().setProxyMapEnabled(false);
+
+
+
+
+

Instance: Path

+
Path path = new File("/tmp/i-am-not-accessible").toPath();
+v8Runtime.getGlobalObject().set("path", path);
+assertEquals(path, v8Runtime.getGlobalObject().getObject("path"));
+assertEquals(path.toString(), v8Runtime.getExecutor("path.toString()").executeString());
+Path newPath = v8Runtime.toObject(v8Runtime.getExecutor("path.resolve('abc')").execute(), true);
+assertNotNull(newPath);
+assertEquals(path.resolve("abc").toString(), newPath.toString());
+assertEquals(path.resolve("abc").toString(), v8Runtime.getExecutor("path.resolve('abc').toString()").executeString());
+v8Runtime.getGlobalObject().delete("path");
+v8Runtime.lowMemoryNotification();
+
+
+
+
+

Static: StringBuilder

+
v8Runtime.getGlobalObject().set("StringBuilder", StringBuilder.class);
+assertEquals("abc def", v8Runtime.getExecutor(
+        "function main() {\n" +
+                "  return new StringBuilder().append('abc').append(' ').append('def').toString();\n" +
+                "}\n" +
+                "main();").executeString());
+v8Runtime.getGlobalObject().delete("StringBuilder");
+v8Runtime.lowMemoryNotification();
+
+
+
+
+

Static: Pattern

+
v8Runtime.getGlobalObject().set("Pattern", Pattern.class);
+assertTrue(v8Runtime.getExecutor("let p = Pattern.compile('^\\\\d+$'); p;").executeObject() instanceof Pattern);
+assertTrue(v8Runtime.getExecutor("p.matcher('123').matches();").executeBoolean());
+assertFalse(v8Runtime.getExecutor("p.matcher('a123').matches();").executeBoolean());
+v8Runtime.getGlobalObject().delete("Pattern");
+v8Runtime.getExecutor("p = undefined;").executeVoid();
+v8Runtime.lowMemoryNotification();
+
+
+
+
+

Static: Enum

+

Static class usually does not have an instance. The universal proxy based converter is smart enough to handle that.

+
v8Runtime.getGlobalObject().set("JavetErrorType", JavetErrorType.class);
+assertEquals(JavetErrorType.Converter, v8Runtime.getExecutor("JavetErrorType.Converter").executeObject());
+assertThrows(
+        JavetExecutionException.class,
+        () -> v8Runtime.getExecutor("JavetErrorType.Converter = 1;").executeVoid(),
+        "Public final field should not be writable.");
+v8Runtime.getGlobalObject().delete("JavetErrorType");
+v8Runtime.getGlobalObject().set("Converter", JavetErrorType.Converter);
+assertEquals(JavetErrorType.Converter, v8Runtime.getGlobalObject().getObject("Converter"));
+v8Runtime.getGlobalObject().delete("Converter");
+v8Runtime.lowMemoryNotification();
+
+
+
+
+

Static: Interface

+

Sometimes an interface or annotation class can be injected for enabling Java reflection in V8.

+
v8Runtime.getGlobalObject().set("AutoCloseable", AutoCloseable.class);
+v8Runtime.getGlobalObject().set("IJavetClosable", IJavetClosable.class);
+assertTrue(AutoCloseable.class.isAssignableFrom(IJavetClosable.class));
+assertTrue(v8Runtime.getExecutor("AutoCloseable.isAssignableFrom(IJavetClosable);").executeBoolean());
+assertEquals(AutoCloseable.class, v8Runtime.getExecutor("AutoCloseable").executeObject());
+assertEquals(IJavetClosable.class, v8Runtime.getExecutor("IJavetClosable").executeObject());
+v8Runtime.getGlobalObject().delete("AutoCloseable");
+v8Runtime.getGlobalObject().delete("IJavetClosable");
+v8Runtime.lowMemoryNotification();
+
+
+
+
+

Dynamic: Anonymous Function

+

This feature is quite special as it allows implementing Java interfaces in JavaScript via anonymous functions, also known as lambda expressions.

+
    +

  1. Define a simple interface IStringJoiner for joining two strings.

    2. +
+
interface IStringJoiner extends AutoCloseable {
+    String join(String a, String b);
+}
+
+
+
    +

  1. Define a simple class StringJoiner which holds the interface IStringJoiner.

    2. +
+
public class StringJoiner implements AutoCloseable {
+    private IStringJoiner joiner;
+
+    public StringJoiner() {
+        joiner = null;
+    }
+
+    @Override
+    public void close() throws Exception {
+        if (joiner != null) {
+            joiner.close();
+            joiner = null;
+        }
+    }
+
+    public IStringJoiner getJoiner() {
+        return joiner;
+    }
+
+    public void setJoiner(IStringJoiner joiner) {
+        this.joiner = joiner;
+    }
+}
+
+
+
    +

  1. Inject the implementation from JavaScript.

    2. +
+
try (StringJoiner stringJoiner = new StringJoiner()) {
+    v8Runtime.getGlobalObject().set("stringJoiner", stringJoiner);
+    v8Runtime.getExecutor("stringJoiner.setJoiner((a, b) => a + ',' + b);").executeVoid();
+    IStringJoiner joiner = stringJoiner.getJoiner();
+    assertEquals("a,b", joiner.join("a", "b"));
+    assertEquals("a,b,c", joiner.join(joiner.join("a", "b"), "c"));
+    v8Runtime.getGlobalObject().delete("stringJoiner");
+}
+v8Runtime.lowMemoryNotification();
+
+
+

Voilà! It works.

+

Note: The JavaScript implementation is backed up by V8ValueFunction which is an orphan object. After its internal V8Runtime is closed, it will no longer callable. It's recommended to have the interface implement AutoClosable as the sample shows so that the orphan V8ValueFunction can be recycled explicitly. If you don't own the interface, Javet will force the recycle of the orphan V8ValueFunction when the V8Runtime is being closed. Be careful, if you keep the application running for long while without recycling them in time, OutOfMemoryError may occur.

+
+
+

Dynamic: Anonymous Object

+

This feature is similar to the dynamic anonymous function, but is an enhanced version because it allows implementing all methods exposed by the Java interface.

+
    +

  1. Define a simple interface IStringUtils for joining two strings.

    2. +
+
interface IStringUtils extends AutoCloseable {
+    String hello();
+    String join(String separator, String... strings);
+    List<String> split(String separator, String string);
+}
+
+
+
    +

  1. Define a simple class StringUtils which holds the interface IStringUtils.

    2. +
+
public class StringUtils implements AutoCloseable {
+    private IStringUtils utils;
+
+    public StringUtils() {
+        utils = null;
+    }
+
+    @Override
+    public void close() throws Exception {
+        if (utils != null) {
+            utils.close();
+            utils = null;
+        }
+    }
+
+    public IStringUtils getUtils() {
+        return utils;
+    }
+
+    public void setUtils(IStringUtils utils) {
+        this.utils = utils;
+    }
+}
+
+
+
    +

  1. Inject the implementation from JavaScript.

    2. +
+
try (StringUtils stringUtils = new StringUtils()) {
+    v8Runtime.getGlobalObject().set("stringUtils", stringUtils);
+    v8Runtime.getExecutor(
+            "stringUtils.setUtils({\n" +
+            "  hello: () => 'hello',\n" +
+            "  join: (separator, ...strings) => [...strings].join(separator),\n" +
+            "  split: (separator, str) => str.split(separator),\n" +
+            "});"
+    ).executeVoid();
+    IStringUtils utils = stringUtils.getUtils();
+    assertEquals("hello", utils.hello());
+    assertEquals("a,b,c", utils.join(",", "a", "b", "c"));
+    assertArrayEquals(
+            new String[]{"a", "b", "c"},
+            utils.split(",", "a,b,c").toArray(new String[0]));
+    v8Runtime.getGlobalObject().delete("stringUtils");
+}
+v8Runtime.lowMemoryNotification();
+
+
+

Voilà aussi! It works again.

+

Note: The JavaScript implementation is backed up by V8ValueObject which is an orphan object. After its internal V8Runtime is closed, it will no longer callable. It's recommended to have the interface implement AutoClosable as the sample shows so that the orphan V8ValueObject can be recycled explicitly. If you don't own the interface, Javet will force the recycle of the orphan V8ValueObject when the V8Runtime is being closed. Be careful, if you keep the application running for long while without recycling them in time, OutOfMemoryError may occur.

+
+
+

Features

+
    +

  • Any Java objects generated inside V8 are automatically handled by the converter.

    • +

  • Getters and setters (get, is, set and put) are smartly handled.

    • +

  • Overloaded methods and varargs methods are identified well.

    • +

  • Primitive types, Set, Map, List, Array are not handled. Map is special because it can be enabled.

    • +

  • Java interfaces can be implemented by anonymous functions in JavaScript.

    • +
+
+
+

How does JavetProxyConverter Work?

+

JavetProxyConverter creates a JavaScript proxy per Java object. For now, the proxy intercepts get, has and set to achieve the complete virtualization of Java objects in JavaScript runtime.

+
+
+

How to Customize JavetProxyConverter?

+

It is recommended to subclass JavetProxyConverter and override few internal API to achieve complete customization.

+
+
+
+

Null Safety

+

What if the object converter meets null or undefined when target type is primitive? This is a quite famous topic in Java because converting null to primitive type results in java.lang.NullPointerException. Luckily, Javet object converter is null safe by injecting default primitive values to JavetConverterConfig and these default primitive values can be overridden.

+
+
+

Functions and Objects

+

There are few challenges in the object conversion.

+
    +

  • V8 functions cannot be easily represented by Java objects.

    • +

  • V8 objects and maps cannot be easily differentiated in Java.

    • +

  • Sometimes unexpected functions from object conversion may break applications.

    • +
+

So, Javet introduced IJavetEntityFunction and IJavetEntityMap so that V8 functions and V8 maps can be precisely represented in Java.

+

Also, JavetConverterConfig exposes setSkipFunctionInObject(boolean) and setExtractFunctionSourceCode(boolean) to give application the opportunity to skip functions in objects or extract source code of functions.

+

If the source code is provided to a user defined function, Javet object converter will inject that function from the source code automatically. That makes sure Java object from V8 object can be smoothly converted back to V8 object at both property and function levels.

+
+
+

Circular Structure

+

It is inefficient and inconvenient for Javet to substantially detect circular structure during object conversion. Instead, Javet converter keeps increasing the depth of recursion and throws JavetConverterException when maximum depth is reach. Maximum depth can be changed before object conversion is started. This is a cheap operation with high performance.

+

Please avoid setting maximum depth to an unrealistic number because JVM will throw StackOverflowError which brings considerable performance overhead. The thing worse than that is there will be memory leak because resource recycling logic written in finally block sometimes won't be called when stack overflow occurs. Attackers may easily drain the server resource in minutes by sending tiny circular structure data.

+
+
+

Final Note

+

The built-in converter supports bi-directional conversion. The sample above shows the way of how to convert Java objects to V8 values. The opposite way follows the same pattern.

+

Please refer to source code for detail.

+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/tutorial/object_converter.rst b/docs/tutorial/advanced/object_converter.rst similarity index 81% rename from docs/tutorial/object_converter.rst rename to docs/tutorial/advanced/object_converter.rst index 2c413a4a6..4db272593 100644 --- a/docs/tutorial/object_converter.rst +++ b/docs/tutorial/advanced/object_converter.rst @@ -7,13 +7,116 @@ Javet has a built-in ``JavetObjectConverter`` with the following features. * It covers primitive types + Set + Map + Array. * It is completely open to subclass. * It minimizes the performance overhead. +* It allows registering custom objects. -So, Javet doesn't natively support converting POJO objects because a POJO converter has to deal with reflection which is so slow that Javet leaves that to applications. +So, Javet doesn't natively support converting POJO objects because a POJO converter has to deal with reflection which is so slow that Javet leaves that to applications. However, if the POJO objects are owned by the application, it is possible to register custom objects with the built-in ``JavetObjectConverter``. Otherwise, designing a POJO converter is the alternative solution. + +What if the application wants to inject arbitrary Java objects? No worry, the ``JavetProxyConverter`` is designed for that purpose. + +Register Custom Objects +======================= + +``JavetObjectConverter`` exposes ``registerCustomObject()`` for alien objects which match the following conditions. + +* Default constructor without arguments +* Method with signature ``void fromMap(Map map)`` +* Method with signature ``Map toMap()`` + +Enhance the Custom Object +------------------------- + +* Create a default constructor without arguments. +* Add a method with signature ``void fromMap(Map map)`` +* Add a method with signature ``Map toMap()`` + +Can the method names be changed? Yes, they can have arbitrary names. + +.. code-block:: java + + public final class CustomObject { + private String name; + private int value; + + public CustomObject(String name, int value) { + this.name = name; + this.value = value; + } + + public CustomObject() { + this(null, 0); + } + + public void fromMap(Map map) { + setName((String) map.get("name")); + setValue((Integer) map.get("value")); + } + + public Map toMap() { + return new HashMap() { + { + put("name", getName()); + put("value", getValue()); + } + }; + } + + // getters and setters + } + +Register the Custom Object +-------------------------- + +As the default converter is ``JavetObjectConverter``, just follow the code snippet below to register a custom object. + +.. code-block:: java + + JavetObjectConverter converter = (JavetObjectConverter)v8Runtime.getConverter(); + converter.registerCustomObject(CustomObject.class); + +If the method names are different from the default ones, just provide the names upon registration as the following. + +.. code-block:: java + + converter.registerCustomObject(CustomObject.class, "customFromMap", "customToMap"); + +Usage +----- + +After the registration is completed, there is no additional steps any more. Just follow the regular pattern. + +.. code-block:: java + + CustomObject[] customObjects = new CustomObject[]{ + new CustomObject("x", 1), + new CustomObject("y", 2), + }; + v8Runtime.getGlobalObject().set("a", customObjects); + assertEquals(2, v8Runtime.getExecutor("a.length").executeInteger()); + List v8CustomObjects = v8Runtime.getGlobalObject().getObject("a"); + assertNotNull(v8CustomObjects); + assertEquals(2, v8CustomObjects.size()); + for (int i = 0; i < customObjects.length; i++) { + assertEquals(customObjects[i].getName(), v8Runtime.getExecutor("a[" + i + "].name").executeString()); + assertEquals(customObjects[i].getValue(), v8Runtime.getExecutor("a[" + i + "].value").executeInteger()); + assertEquals(customObjects[i].getName(), v8CustomObjects.get(i).getName()); + assertEquals(customObjects[i].getValue(), v8CustomObjects.get(i).getValue()); + } + +Highlights +---------- + +* PROS: This is a built-in feature so there is no need to deal with a POJO converter. +* CONS: This is a little bit intrusive to the custom objects. + +How does It Work? +----------------- + +As V8 supports private properties, ``JavetObjectConverter`` sets the custom object class name to the V8 object in ``toMap()`` and gets the name from the V8 object in ``fromMap()``. So it is the V8 object that carries the type information all the time and ``JavetObjectConverter`` is free from memorizing the complicated relationship between the Java objects and V8 objects. Design a POJO Converter ======================= -The following sample code runs in JDK 11. It's easy to tweak few API for JDK 8. +A POJO converter usually is designed for the Java objects that are now owned by the application. So, it has to deal with reflection heavily. The following sample code runs in JDK 11. It's easy to tweak few API for JDK 8. Define POJO Object ------------------ @@ -140,7 +243,7 @@ Just write few lines of code to interact with Javet. The console output is: -.. code-block:: json +.. code-block:: js [ { name: 'Tom', value: 'CEO' }, { name: 'Jerry', value: 'CFO' } ] @@ -462,6 +565,4 @@ Final Note The built-in converter supports bi-directional conversion. The sample above shows the way of how to convert Java objects to V8 values. The opposite way follows the same pattern. -Please refer to `source code <../../src/test/java/com/caoccao/javet/interop/converters/TestJavetCustomConverter.java>`_ for detail. - -[`Home <../../README.rst>`_] [`Javet Tutorial `_] +Please refer to :extsource3:`source code <../../../src/test/java/com/caoccao/javet/interop/converters/TestJavetCustomConverter.java>` for detail. diff --git a/docs/tutorial/basic/engine_pool.html b/docs/tutorial/basic/engine_pool.html new file mode 100644 index 000000000..8815a325c --- /dev/null +++ b/docs/tutorial/basic/engine_pool.html @@ -0,0 +1,394 @@ + + + + + + + + Javet Engine Pool - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Javet Engine Pool

+
+

Motivation

+
    +

  • It takes quite some time to spawn a V8Runtime, especially in Node.js mode.

    • +

  • It takes a lot of time to initialize a V8Runtime to prepare for script execution.

    • +

  • V8Runtime is not recommended to be used in multi-threaded environments. (Though Javet allows it to be used that way.)

    • +
+
+
+

Goals

+
    +

  • Provide a basic user experience similar to a database connection pool.

    • +

  • Minimize the performance overhead of V8Runtime creation and initialization.

    • +

  • Free applications from explicitly closing V8Runtime from time to time.

    • +

  • Allow easy extension.

    • +
+
+
+

Usage

+
// Create a Javet engine pool.
+try (IJavetEnginePool<V8Runtime> javetEnginePool = new JavetEnginePool<>()) {
+    // Get a Javet engine from the pool.
+    try (IJavetEngine<V8Runtime> javetEngine = javetEnginePool.getEngine()) {
+        // Get a V8 runtime from the engine.
+        V8Runtime v8Runtime = javetEngine.getV8Runtime();
+        // Create a Javet console interceptor.
+        JavetStandardConsoleInterceptor javetConsoleInterceptor =
+                new JavetStandardConsoleInterceptor(v8Runtime);
+        // Register the Javet console to V8 global object.
+        javetConsoleInterceptor.register(v8Runtime.getGlobalObject());
+        // V8 console log is redirected to JVM console log.
+        v8Runtime.getExecutor("console.log('Hello Javet from Pool');").executeVoid();
+        // Unregister the Javet console to V8 global object.
+        javetConsoleInterceptor.unregister(v8Runtime.getGlobalObject());
+        // close() is not necessary because the Javet engine pool handles that.
+        v8Runtime.lowMemoryNotification();
+        // Force V8 to GC.
+    }
+}
+
+
+

Please refer to the source code for more detail.

+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/tutorial/engine_pool.rst b/docs/tutorial/basic/engine_pool.rst similarity index 62% rename from docs/tutorial/engine_pool.rst rename to docs/tutorial/basic/engine_pool.rst index 154a534b2..749d9d29f 100644 --- a/docs/tutorial/engine_pool.rst +++ b/docs/tutorial/basic/engine_pool.rst @@ -2,6 +2,24 @@ Javet Engine Pool ================= +Motivation +========== + +* It takes quite some time to spawn a ``V8Runtime``, especially in Node.js mode. +* It takes a lot of time to initialize a ``V8Runtime`` to prepare for script execution. +* ``V8Runtime`` is not recommended to be used in multi-threaded environments. (Though Javet allows it to be used that way.) + +Goals +===== + +* Provide a basic user experience similar to a database connection pool. +* Minimize the performance overhead of ``V8Runtime`` creation and initialization. +* Free applications from explicitly closing ``V8Runtime`` from time to time. +* Allow easy extension. + +Usage +===== + .. code-block:: java // Create a Javet engine pool. @@ -25,6 +43,4 @@ Javet Engine Pool } } -Please refer to `source code <../../src/test/java/com/caoccao/javet/tutorial/HelloJavet.java>`_ for more detail. - -[`Home <../../README.rst>`_] [`Javet Tutorial `_] +Please refer to the :extsource3:`source code <../../../src/test/java/com/caoccao/javet/tutorial/HelloJavet.java>` for more detail. diff --git a/docs/tutorial/basic/hello_javet.html b/docs/tutorial/basic/hello_javet.html new file mode 100644 index 000000000..ae977e119 --- /dev/null +++ b/docs/tutorial/basic/hello_javet.html @@ -0,0 +1,373 @@ + + + + + + + + Hello Javet - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Hello Javet

+ + +
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/tutorial/hello_javet.rst b/docs/tutorial/basic/hello_javet.rst similarity index 86% rename from docs/tutorial/hello_javet.rst rename to docs/tutorial/basic/hello_javet.rst index 643a56028..e0b213764 100644 --- a/docs/tutorial/hello_javet.rst +++ b/docs/tutorial/basic/hello_javet.rst @@ -26,6 +26,4 @@ Print **1 + 1** in Node.js Mode // Step 3: Resource is recycled automatically at the end of the try-with-resource block. } -Please refer to `source code <../../src/test/java/com/caoccao/javet/tutorial/HelloJavet.java>`_ for more detail. - -[`Home <../../README.rst>`_] [`Javet Tutorial `_] +Please refer to the :extsource3:`source code <../../../src/test/java/com/caoccao/javet/tutorial/HelloJavet.java>` for more detail. diff --git a/docs/tutorial/basic/index.html b/docs/tutorial/basic/index.html new file mode 100644 index 000000000..3f388d8ae --- /dev/null +++ b/docs/tutorial/basic/index.html @@ -0,0 +1,342 @@ + + + + + + + + Basic - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+ +
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/tutorial/basic/index.rst b/docs/tutorial/basic/index.rst new file mode 100644 index 000000000..ea2320a2c --- /dev/null +++ b/docs/tutorial/basic/index.rst @@ -0,0 +1,15 @@ +===== +Basic +===== + +.. toctree:: + :maxdepth: 1 + + installation + hello_javet + engine_pool + interception + javet_shell + node_js_mode_and_v8_mode + spring_integration + polyfill diff --git a/docs/tutorial/basic/installation.html b/docs/tutorial/basic/installation.html new file mode 100644 index 000000000..3ee8c4a58 --- /dev/null +++ b/docs/tutorial/basic/installation.html @@ -0,0 +1,433 @@ + + + + + + + + Installation - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Installation

+
+

Dependency

+
+

Maven

+
<!-- Linux or Windows -->
+<dependency>
+    <groupId>com.caoccao.javet</groupId>
+    <artifactId>javet</artifactId>
+    <version>0.9.12</version>
+</dependency>
+
+<!-- Mac OS (x86_64 Only) -->
+<dependency>
+    <groupId>com.caoccao.javet</groupId>
+    <artifactId>javet-macos</artifactId>
+    <version>0.9.12</version>
+</dependency>
+
+
+
+
+

Gradle Kotlin DSL

+
implementation("com.caoccao.javet:javet:0.9.12") // Linux or Windows
+implementation("com.caoccao.javet:javet-macos:0.9.12") // Mac OS (x86_64 Only)
+
+
+
+
+

Gradle Groovy DSL

+
implementation 'com.caoccao.javet:javet:0.9.12' // Linux or Windows
+implementation 'com.caoccao.javet:javet-macos:0.9.12' // Mac OS (x86_64 Only)
+
+
+
+
+
+

OS Compatibility

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

OS

Compatible

Windows 10

Yes

Windows 7

Yes

Windows Server

Not Tested

Ubuntu 20.04

Yes

Ubuntu 18.04

Yes (Private Build)

Ubuntu 16.04

Yes (Private Build)

Other Linux Distributions

Not Tested

MacOS x86_64

Yes

MacOS arm64

No (Can Javet Support Mac?)

+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/tutorial/installation.rst b/docs/tutorial/basic/installation.rst similarity index 74% rename from docs/tutorial/installation.rst rename to docs/tutorial/basic/installation.rst index 8ede56a61..e75b3fb42 100644 --- a/docs/tutorial/installation.rst +++ b/docs/tutorial/basic/installation.rst @@ -1,6 +1,6 @@ -================== -Javet Installation -================== +============ +Installation +============ Dependency ========== @@ -14,14 +14,14 @@ Maven com.caoccao.javet javet - 0.9.11 + 0.9.12 com.caoccao.javet javet-macos - 0.9.11 + 0.9.12 Gradle Kotlin DSL @@ -29,16 +29,16 @@ Gradle Kotlin DSL .. code-block:: kotlin - implementation("com.caoccao.javet:javet:0.9.11") // Linux or Windows - implementation("com.caoccao.javet:javet-macos:0.9.11") // Mac OS (x86_64 Only) + implementation("com.caoccao.javet:javet:0.9.12") // Linux or Windows + implementation("com.caoccao.javet:javet-macos:0.9.12") // Mac OS (x86_64 Only) Gradle Groovy DSL ----------------- .. code-block:: groovy - implementation 'com.caoccao.javet:javet:0.9.11' // Linux or Windows - implementation 'com.caoccao.javet:javet-macos:0.9.11' // Mac OS (x86_64 Only) + implementation 'com.caoccao.javet:javet:0.9.12' // Linux or Windows + implementation 'com.caoccao.javet:javet-macos:0.9.12' // Mac OS (x86_64 Only) OS Compatibility ================ @@ -54,7 +54,5 @@ Ubuntu 18.04 Yes (`Private Build `_) Other Linux Distributions Not Tested MacOS x86_64 Yes -MacOS arm64 No (`Can Javet Support Mac? <../faq/can_javet_support_mac.rst>`_) +MacOS arm64 No (:doc:`../../faq/environment/can_javet_support_mac`) =========================== ======================================================================================================================= - -[`Home <../../README.rst>`_] [`Javet Tutorial `_] diff --git a/docs/tutorial/basic/interception.html b/docs/tutorial/basic/interception.html new file mode 100644 index 000000000..a5806e0e0 --- /dev/null +++ b/docs/tutorial/basic/interception.html @@ -0,0 +1,454 @@ + + + + + + + + Interception - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Interception

+

Javet provides @V8Property and @V8Function which allow Java applications to intercept JavaScript properties and functions in an automatic way as following.

+
    +

  • Decorate a Java class with @V8Property or @V8Function.

    • +

  • Bind an instance of that Java class to a V8 value object.

    • +

  • Call the properties or functions of that V8 value object in JavaScript.

    • +

  • The calls are intercepted by that instance of the Java class.

    • +
+
+

Sample

+
+

@V8Property and @V8Function

+

@V8Property is for registering getters and setters. Javet is good at guessing the property name, e.g. getName => name, setValue => value.

+

@V8Function is for registering functions. By default, the Java function name is identical to the JavaScript function name, e.g. increaseAndGet => increaseAndGet, add => add.

+

If the default name is not suitable, please tell Javet which one to bind via @V8Property(name = "...") and @V8Function(name = "...").

+
public class TestInterception {
+    private String name;
+    private int value;
+
+    @V8Property
+    public String getName() {
+        return name;
+    }
+
+    @V8Property
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    @V8Property
+    public int getValue() {
+        return value;
+    }
+
+    @V8Property
+    public void setValue(int value) {
+        this.value = value;
+    }
+
+    @V8Function
+    public int increaseAndGet() {
+        return ++value;
+    }
+
+    @V8Function
+    public int add(int delta) {
+        value += delta;
+        return value;
+    }
+}
+
+
+
+
+

Test

+
// Step 1: Create a V8 runtime from V8 host in try-with-resource.
+try (V8Runtime v8Runtime = V8Host.getV8Instance().createV8Runtime()) {
+    // Step 2: Register console.
+    JavetStandardConsoleInterceptor javetStandardConsoleInterceptor = new JavetStandardConsoleInterceptor(v8Runtime);
+    javetStandardConsoleInterceptor.register(v8Runtime.getGlobalObject());
+    // Step 3: Create an interceptor.
+    TestInterception testInterceptor = new TestInterception();
+    // Step 4: Bind the interceptor to a variable.
+    try (V8ValueObject v8ValueObject = v8Runtime.createV8ValueObject()) {
+        v8Runtime.getGlobalObject().set("a", v8ValueObject);
+        v8ValueObject.bind(testInterceptor);
+    }
+
+    // Test property name
+    v8Runtime.getExecutor("console.log(`a.name is initially ${a.name}.`);").executeVoid(); // null
+    // a.name setter => setName(String name)
+    v8Runtime.getExecutor("a.name = 'Javet';").executeVoid();
+    // name is changed
+    System.out.println("Interceptor name is " + testInterceptor.getName() + "."); // Javet
+    // a.name getter => getName()
+    v8Runtime.getExecutor("console.log(`a.name is now ${a.name}.`);").executeVoid(); // Javet
+
+    // Test property value
+    v8Runtime.getExecutor("console.log(`a.value is initially ${a.value}.`);").executeVoid(); // 0
+    // a.value setter => setValue(String value)
+    v8Runtime.getExecutor("a.value = 123;").executeVoid();
+    // value is changed
+    System.out.println("Interceptor value is " + testInterceptor.getValue() + "."); // 123
+    // a.value getter => getValue()
+    v8Runtime.getExecutor("console.log(`a.value is now ${a.value}.`);").executeVoid(); // 123
+
+    // Test functions
+    v8Runtime.getExecutor("console.log(`a.increaseAndGet() is ${a.increaseAndGet()}.`);").executeVoid(); // 124
+    v8Runtime.getExecutor("console.log(`a.add(76) is ${a.add(76)}.`);").executeVoid(); // 200
+
+    // Step 5: Delete the interceptor.
+    v8Runtime.getGlobalObject().delete("a");
+    // Step 6: Unregister console.
+    javetStandardConsoleInterceptor.unregister(v8Runtime.getGlobalObject());
+    // Step 7: Notify V8 to perform GC. (Optional)
+    v8Runtime.lowMemoryNotification();
+}
+
+
+

Please refer to the source code for more detail.

+
+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/tutorial/interception.rst b/docs/tutorial/basic/interception.rst similarity index 94% rename from docs/tutorial/interception.rst rename to docs/tutorial/basic/interception.rst index 383eb7fa8..5d0919f1f 100644 --- a/docs/tutorial/interception.rst +++ b/docs/tutorial/basic/interception.rst @@ -12,8 +12,8 @@ Javet provides ``@V8Property`` and ``@V8Function`` which allow Java applications Sample ====== -``@V8Property`` and ``@V8Function`` ------------------------------------ +@V8Property and @V8Function +--------------------------- ``@V8Property`` is for registering getters and setters. Javet is good at guessing the property name, e.g. getName => name, setValue => value. @@ -107,6 +107,4 @@ Test v8Runtime.lowMemoryNotification(); } -Please refer to `source code <../../src/test/java/com/caoccao/javet/tutorial/TestInterception.java>`_ for more detail. - -[`Home <../../README.rst>`_] [`Javet Tutorial `_] +Please refer to the :extsource3:`source code <../../../src/test/java/com/caoccao/javet/tutorial/TestInterception.java>` for more detail. diff --git a/docs/tutorial/basic/javet_shell.html b/docs/tutorial/basic/javet_shell.html new file mode 100644 index 000000000..cf9ac9374 --- /dev/null +++ b/docs/tutorial/basic/javet_shell.html @@ -0,0 +1,369 @@ + + + + + + + + Javet Shell - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Javet Shell

+

It is very easy to create a node flavored interactive shell application with a few lines of code.

+
// Step 1: Create a V8 runtime from V8 host in try resource.
+try (V8Runtime v8Runtime = V8Host.getV8Instance().createV8Runtime()) {
+    System.out.println("Welcome to CDT Shell!");
+    System.out.println("Input the script or '.exit' to exit.");
+    // Step 2: Create a scanner to take console input line by line.
+    try (Scanner scanner = new Scanner(System.in)) {
+        // Step 3: Create an infinite loop.
+        while (true) {
+            System.out.print("> ");
+            String command = scanner.nextLine();
+            // Step 4: If the command is ".exit", exit the loop.
+            if (".exit".equals(command)) {
+                break;
+            }
+            // Step 5: Execute the command and capture the result.
+            try (V8Value v8Value = v8Runtime.getExecutor(command).execute()) {
+                if (v8Value != null) {
+                    // Step 6: Print the result as string.
+                    System.out.println(v8Value.toString());
+                }
+            } catch (Throwable t) {
+                System.err.println(t.getMessage());
+            }
+        }
+    }
+}
+
+
+

The user experience is very much like the one in node.

+
> let a = 3
+undefined
+> let b = 4
+undefined
+> a + b
+7
+
+
+

Please refer to the source code for more detail.

+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/tutorial/javet_shell.rst b/docs/tutorial/basic/javet_shell.rst similarity index 89% rename from docs/tutorial/javet_shell.rst rename to docs/tutorial/basic/javet_shell.rst index f00ca6b85..4fa51120c 100644 --- a/docs/tutorial/javet_shell.rst +++ b/docs/tutorial/basic/javet_shell.rst @@ -44,6 +44,4 @@ The user experience is very much like the one in node. > a + b 7 -Please refer to `source code <../../src/test/java/com/caoccao/javet/tutorial/cdt/CDTShell.java>`_ for more detail. - -[`Home <../../README.rst>`_] [`Javet Tutorial `_] +Please refer to the :extsource3:`source code <../../../src/test/java/com/caoccao/javet/tutorial/cdt/CDTShell.java>` for more detail. diff --git a/docs/tutorial/basic/node_js_mode_and_v8_mode.html b/docs/tutorial/basic/node_js_mode_and_v8_mode.html new file mode 100644 index 000000000..d661681d0 --- /dev/null +++ b/docs/tutorial/basic/node_js_mode_and_v8_mode.html @@ -0,0 +1,402 @@ + + + + + + + + Node.js Mode and V8 Mode - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Node.js Mode and V8 Mode

+
+

Co-existence

+

Javet support both Node.js mode and V8 mode both of which can co-exist in one JVM. This is an awesome feature with the following highlights.

+
    +

  • Latest V8 features are available in V8 mode.

    • +

  • Node.js ecosystem is available in Node.js mode.

    • +

  • There are 2 versions of V8 runtime in 1 JVM and they don't see each other.

    • +
+
+
+

Usage

+

It's very simple to get into Node.js mode or V8 mode. E.g.

+
+

V8Host

+
// Node.js Mode
+try (V8Runtime v8Runtime = V8Host.getNodeInstance().createV8Runtime()) {
+    // ...
+}
+
+// V8 Mode
+try (V8Runtime v8Runtime = V8Host.getV8Instance().createV8Runtime()) {
+    // ...
+}
+
+
+
+
+

Pool

+
// Node.js Mode
+try (JavetEnginePool<NodeRuntime> javetEnginePool = new JavetEnginePool<NodeRuntime>()) {
+    javetEnginePool.getConfig().setJSRuntimeType(JSRuntimeType.Node);
+    try (IJavetEngine<NodeRuntime> javetEngine = javetEnginePool.getEngine()) {
+        // ...
+    }
+}
+
+// V8 Mode
+try (JavetEnginePool<V8Runtime> javetEnginePool = new JavetEnginePoo<V8Runtime>l()) {
+    javetEnginePool.getConfig().setJSRuntimeType(JSRuntimeType.V8); // Optional, because it defaults to V8.
+    try (IJavetEngine<V8Runtime> javetEngine = javetEnginePool.getEngine()) {
+        // ...
+    }
+}
+
+
+

Note: The default mode in pool is V8 mode. More technical detail is available at Javet Design.

+
+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/tutorial/node_js_mode_and_v8_mode.rst b/docs/tutorial/basic/node_js_mode_and_v8_mode.rst similarity index 92% rename from docs/tutorial/node_js_mode_and_v8_mode.rst rename to docs/tutorial/basic/node_js_mode_and_v8_mode.rst index 7e2997051..8c5f05236 100644 --- a/docs/tutorial/node_js_mode_and_v8_mode.rst +++ b/docs/tutorial/basic/node_js_mode_and_v8_mode.rst @@ -52,6 +52,4 @@ Pool } } -Note: The default mode in pool is V8 mode. More technical detail is available at `here <../development/design.rst>`_. - -[`Home <../../README.rst>`_] [`Javet Tutorial `_] +Note: The default mode in pool is V8 mode. More technical detail is available at :doc:`../../development/design`. diff --git a/docs/tutorial/basic/polyfill.html b/docs/tutorial/basic/polyfill.html new file mode 100644 index 000000000..8448cc411 --- /dev/null +++ b/docs/tutorial/basic/polyfill.html @@ -0,0 +1,402 @@ + + + + + + + + Polyfill - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Polyfill

+
+

Node.js Mode

+

Yes, you can polyfill Javet with Node.js modules.

+
+

decimal.js

+
public void loadJS() throws JavetException {
+    File decimalJSFile = new File(
+            JavetOSUtils.WORKING_DIRECTORY,
+            "scripts/node/node_modules/decimal.js/decimal.js");
+    if (decimalJSFile.exists() && decimalJSFile.canRead()) {
+        getLogger().logInfo("Loading {0}.", decimalJSFile.getAbsolutePath());
+        V8Runtime v8Runtime = iJavetEngine.getV8Runtime();
+        v8Runtime.getExecutor(decimalJSFile).executeVoid();
+    } else {
+        getLogger().logError("{0} is not found.", decimalJSFile.getAbsolutePath());
+        getLogger().logError("Please make sure Node.js is installed, then visit script/node directory and run npm install.");
+    }
+}
+
+public void test() throws JavetException {
+    V8Runtime v8Runtime = iJavetEngine.getV8Runtime();
+    getLogger().logInfo("1.23 + 2.34 = {0}", v8Runtime.getExecutor(
+            "const a = new Decimal(1.23);" +
+                    "const b = new Decimal(2.34);" +
+                    "a.add(b).toString();").executeString());
+    try (V8ValueFunction v8ValueFunctionDecimal = v8Runtime.getGlobalObject().get("Decimal")) {
+        try (V8ValueObject v8ValueObjectDecimal = v8ValueFunctionDecimal.callAsConstructor("123.45")) {
+            getLogger().logInfo(v8ValueObjectDecimal.toString());
+            if (v8ValueObjectDecimal.hasOwnProperty("constructor")) {
+                try (V8ValueFunction v8ValueFunction = v8ValueObjectDecimal.get("constructor")) {
+                    String name = v8ValueFunction.getString("name");
+                    if ("Decimal".equals(name)) {
+                        BigDecimal bigDecimal = new BigDecimal(v8ValueObjectDecimal.toString());
+                        getLogger().logInfo("BigDecimal: {0}", bigDecimal.toString());
+                    }
+                }
+            }
+        }
+    }
+}
+
+
+

Please refer to the source code for more detail.

+
+
+
+

V8 Mode

+

Polyfilling V8 mode is at another project Javenode which aims at simulating Node.js with Java in Javet V8 mode. Why? Because Javet V8 mode is much more secure than the Node.js mode, but lacks of some basic features, e.g. setTimeout, setInterval, etc. So, these must-have API can be found in Javenode.

+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/tutorial/polyfill.rst b/docs/tutorial/basic/polyfill.rst similarity index 93% rename from docs/tutorial/polyfill.rst rename to docs/tutorial/basic/polyfill.rst index 4b787ccd6..8e86c1612 100644 --- a/docs/tutorial/polyfill.rst +++ b/docs/tutorial/basic/polyfill.rst @@ -48,11 +48,9 @@ decimal.js } } -Please refer to `source code <../../src/test/java/com/caoccao/javet/tutorial/DecimalJavetInV8Mode.java>`_ for more detail. +Please refer to the :extsource3:`source code <../../../src/test/java/com/caoccao/javet/tutorial/DecimalJavetInV8Mode.java>` for more detail. V8 Mode ======= Polyfilling V8 mode is at another project `Javenode `_ which aims at simulating Node.js with Java in Javet V8 mode. Why? Because Javet V8 mode is much more secure than the Node.js mode, but lacks of some basic features, e.g. setTimeout, setInterval, etc. So, these must-have API can be found in Javenode. - -[`Home <../../README.rst>`_] [`Javet Tutorial `_] diff --git a/docs/tutorial/basic/spring_integration.html b/docs/tutorial/basic/spring_integration.html new file mode 100644 index 000000000..40ab17ea7 --- /dev/null +++ b/docs/tutorial/basic/spring_integration.html @@ -0,0 +1,408 @@ + + + + + + + + Spring Integration - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Spring Integration

+

As Javet is a fundamental SDK, it doesn't rely on Spring Framework so that Javet users don't get dependency hell. But, Javet can be integrated with Spring easily.

+
+

Configuration

+
    +

  • Create a Spring configuration.

    • +

  • Declare IJavetEnginePool as @Bean.

    • +
+
@Configuration
+@PropertySource("classpath:javet-engine.properties")
+@ConfigurationProperties(prefix = "javet.engine")
+public class MyJavetEngineConfig {
+
+    @Bean(name = "JavetEnginePoolNode")
+    public IJavetEnginePool getJavetEnginePoolNode() {
+        JavetEngineConfig javetEngineConfigNode = new JavetEngineConfig();
+        javetEngineConfigNode.setAllowEval(...);
+        javetEngineConfigNode.setAutoSendGCNotification(...);
+        javetEngineConfigNode.setDefaultEngineGuardTimeoutMillis(...);
+        javetEngineConfigNode.setEngineGuardCheckIntervalMillis(...);
+        javetEngineConfigNode.setPoolDaemonCheckIntervalMillis(...);
+        javetEngineConfigNode.setPoolIdleTimeoutSeconds(...);
+        javetEngineConfigNode.setPoolMinSize(...);
+        javetEngineConfigNode.setPoolMaxSize(...);
+        javetEngineConfigNode.setPoolShutdownTimeoutSeconds(...);
+        javetEngineConfigNode.setResetEngineTimeoutSeconds(...);
+        javetEngineConfigNode.setJavetLogger(new MyJavetLogger(MyJavetLogger.class.getName()));
+        javetEngineConfigNode.setJSRuntimeType(JSRuntimeType.Node);
+        return new JavetEnginePool<>(javetEngineConfigNode);
+    }
+
+    @Bean(name = "JavetEnginePoolV8")
+    public IJavetEnginePool getJavetEnginePoolV8() {
+        JavetEngineConfig javetEngineConfigV8 = new JavetEngineConfig();
+        javetEngineConfigV8.setAllowEval(...);
+        javetEngineConfigV8.setAutoSendGCNotification(...);
+        javetEngineConfigV8.setDefaultEngineGuardTimeoutMillis(...);
+        javetEngineConfigV8.setEngineGuardCheckIntervalMillis(...);
+        javetEngineConfigV8.setPoolDaemonCheckIntervalMillis(...);
+        javetEngineConfigV8.setPoolIdleTimeoutSeconds(...);
+        javetEngineConfigV8.setPoolMinSize(...);
+        javetEngineConfigV8.setPoolMaxSize(...);
+        javetEngineConfigV8.setPoolShutdownTimeoutSeconds(...);
+        javetEngineConfigV8.setResetEngineTimeoutSeconds(...);
+        javetEngineConfigV8.setJavetLogger(new MyJavetLogger(MyJavetLogger.class.getName()));
+        javetEngineConfigV8.setJSRuntimeType(JSRuntimeType.V8);
+        return new JavetEnginePool<>(javetEngineConfigV8);
+    }
+
+
+
+
+

Injection

+

You may easily inject your engine pool in the Spring way.

+
@Resource
+protected IJavetEnginePool javetEnginePool;
+
+
+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/tutorial/spring_integration.rst b/docs/tutorial/basic/spring_integration.rst similarity index 94% rename from docs/tutorial/spring_integration.rst rename to docs/tutorial/basic/spring_integration.rst index 341ce7848..2b9cdbca7 100644 --- a/docs/tutorial/spring_integration.rst +++ b/docs/tutorial/basic/spring_integration.rst @@ -28,7 +28,7 @@ Configuration javetEngineConfigNode.setPoolIdleTimeoutSeconds(...); javetEngineConfigNode.setPoolMinSize(...); javetEngineConfigNode.setPoolMaxSize(...); - javetEngineConfigNode.setPoolMaxSize(...); + javetEngineConfigNode.setPoolShutdownTimeoutSeconds(...); javetEngineConfigNode.setResetEngineTimeoutSeconds(...); javetEngineConfigNode.setJavetLogger(new MyJavetLogger(MyJavetLogger.class.getName())); javetEngineConfigNode.setJSRuntimeType(JSRuntimeType.Node); @@ -46,7 +46,7 @@ Configuration javetEngineConfigV8.setPoolIdleTimeoutSeconds(...); javetEngineConfigV8.setPoolMinSize(...); javetEngineConfigV8.setPoolMaxSize(...); - javetEngineConfigV8.setPoolMaxSize(...); + javetEngineConfigV8.setPoolShutdownTimeoutSeconds(...); javetEngineConfigV8.setResetEngineTimeoutSeconds(...); javetEngineConfigV8.setJavetLogger(new MyJavetLogger(MyJavetLogger.class.getName())); javetEngineConfigV8.setJSRuntimeType(JSRuntimeType.V8); @@ -62,5 +62,3 @@ You may easily inject your engine pool in the Spring way. @Resource protected IJavetEnginePool javetEnginePool; - -[`Home <../../README.rst>`_] [`Javet Tutorial `_] diff --git a/docs/tutorial/index.html b/docs/tutorial/index.html new file mode 100644 index 000000000..cfd05faff --- /dev/null +++ b/docs/tutorial/index.html @@ -0,0 +1,355 @@ + + + + + + + + Tutorial - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+ +
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/tutorial/index.rst b/docs/tutorial/index.rst index ff312e4d4..6535b252a 100644 --- a/docs/tutorial/index.rst +++ b/docs/tutorial/index.rst @@ -2,25 +2,9 @@ Tutorial ======== -Basic -===== +.. toctree:: + :maxdepth: 2 -* `Installation `_ -* `Hello Javet `_ -* `Engine Pool `_ -* `Interception `_ -* `Javet Shell `_ -* `Node.js Mode and V8 Mode `_ -* `Spring Integration `_ -* `Polyfill `_ - -Advanced -======== - -* `Object Converter `_ -* `Java and JavaScript Interop `_ -* `Interact with Node.js `_ - -Complete tutorial is available at `here <../../src/test/java/com/caoccao/javet/tutorial>`_. - -[`Home <../../README.rst>`_] + basic/index + advanced/index + migration_guides/index diff --git a/docs/tutorial/migration_guides/index.html b/docs/tutorial/migration_guides/index.html new file mode 100644 index 000000000..b687dfc40 --- /dev/null +++ b/docs/tutorial/migration_guides/index.html @@ -0,0 +1,335 @@ + + + + + + + + Migration Guides - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+ +
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/tutorial/migration_guides/index.rst b/docs/tutorial/migration_guides/index.rst new file mode 100644 index 000000000..719198d9d --- /dev/null +++ b/docs/tutorial/migration_guides/index.rst @@ -0,0 +1,8 @@ +================ +Migration Guides +================ + +.. toctree:: + :maxdepth: 1 + + migrate_from_j2v8 diff --git a/docs/tutorial/migration_guides/migrate_from_j2v8.html b/docs/tutorial/migration_guides/migrate_from_j2v8.html new file mode 100644 index 000000000..ef695ea10 --- /dev/null +++ b/docs/tutorial/migration_guides/migrate_from_j2v8.html @@ -0,0 +1,435 @@ + + + + + + + + Migrate from J2V8 - Javet 0.9.12 documentation + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Javet 0.9.12 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+
+
+ +
+ +
+
+
+

Migrate from J2V8

+

How to migrate from J2V8 to Javet is a frequently asked question, especially when people are evaluating Javet. I created Javet in Jan, 2021 for various reasons (What is the Motivation?, History with J2V8). After the first release v0.7.0 was published, I started migrating from J2V8 to Javet. It was quite smooth, though it took a week.

+
+

Why Migrate from J2V8 to Javet?

+
    +

  • Its Linux, Mac OS and Windows releases have been abandoned for years.

    • +

  • Its type hierarchy is inconsistent because primitive types are out of the hierarchy so that tedious if-else sentences have to be repeated all over the code base.

    • +

  • Its function registration API is kind of verbose.

    • +

  • Segfaults take place so frequently and don't get maintainers' attention for years.

    • +

  • Its locking mechanism heavily increases mental pressure in the code base.

    • +

  • Its V8 runtime is not multi-threaded friendly unless application adds a synchronous layer on top of it.

    • +
+
+
+

Migration Guides

+
+

V8 ⟶ V8Runtime

+
    +

  • V8 in J2V8 is V8Runtime in Javet.

    • +

  • V8 in J2V8 carries 2 roles: 1 as the V8 runtime and 1 as the global object (globalThis or global). In Javet, V8Runtime no longer inherits from V8Value so that it literally represents the V8 runtime. V8Runtime.getGlobalObject() is dedicated to the global object.

    • +

  • V8Runtime has much richer API than V8 has. E.g. compileV8Module(), lowMemoryNotification(), terminateExecution().

    • +
+
+
+

Primitive Types

+
    +

  • Primitive types in Javet inherit from V8ValuePrimitive ⟶ V8Value ⟶ V8Data.

    • +

  • The Javet type hierarchy is consistent so that V8Value in all supported API can represent all V8 types. This is hard in J2V8 because Object has to be used to represent all types, however, by using Object the type check during compilation doesn't work at all and that is a rich source of runtime bugs or even segfaults.

    • +
+
+
+

registerJavaMethod() ⟶ @V8Function

+
    +

  • It is quite painful to register many functions in J2V8. Javet makes that a declarative one instead of the imperative one. Just decorate the target function with @V8Function, then call V8ValueObject.bind(javaObject) to bind that Java object, it's done.

    • +

  • In addition, Javet provides @V8Property which allows registering getters and setters in the same manner. That feature has never been delivered by J2V8.

    • +

  • Javet also allows unbinding the registration. Just call V8ValueObject.unbind(javaObject).

    • +
+

Please refer to V8 Function for more details.

+
+
+

V8Locker

+
    +

  • Javet introduced Implicit Mode which allows applications to eliminate V8Locker from the code base and still be able to share the same V8Runtime among multiple threads, because Javet does the synchronization automatically. That frees application developers from the tedious acquire() and release() calls, and gets the rid of the runtime exceptions caused by multiple threads.

    • +

  • Javet also has Explicit Mode for performance sensitive scenarios.

    • +
+

Please refer to Know the Lock for more details.

+
+
+

Type Conversion

+
    +

  • Javet has built-in JavetObjectConverter which covers the majority cases on type conversion so that the arguments of Javet API can be of any type and the converter just does the conversion transparently. That frees application developers from writing tedious type conversion code everywhere.

    • +

  • Javet also provides JavetProxyConverter which allows injecting arbitrary Java objects in V8 and polyfilling Java interfaces with JavaScript functions or objects. Especially the polyfilling feature implies hotfixing business logic without restarting the JVM.

    • +
+

Please refer to Object Converter for more details.

+
+
+

Node.js and V8

+
    +

  • Javet provides both Node.js mode and V8 mode for various usages. Each mode stays at a dedicated classloader so that both modes don't cross each other, and are completely isolated. If the application only uses one mode, it doesn't need to pay extra amount of memory for the other mode because the other mode is not loaded at all. Of course, both modes can be unloaded as well without shutting down the JVM.

    • +

  • In Node.js mode, all node modules can be directly used including the native modules. Please refer to Modularization for more detail.

    • +

  • In V8 mode, it is much more secure than the Node.js mode is, but lacks of some basic ES API, e.g. setTimeout(). Project Javenode is the one that aims at simulating Node.js with Java in Javet V8 mode.

    • +
+

Please refer to Javet Design for more details.

+
+
+

ES6 Module

+
    +

  • Javet supports import { *** } from '***.js' and exposes module resolve event for applications to specify where to locate the modules.

    • +
+

Please refer to Modularization for more detail.

+
+
+
+

Blessing

+

In case this migration guide couldn't cover all your use cases, please contact the maintainer at discord. Wish you a successful migration!

+
+
+ +
+
+ +
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/tutorial/migration_guides/migrate_from_j2v8.rst b/docs/tutorial/migration_guides/migrate_from_j2v8.rst new file mode 100644 index 000000000..6be6232b5 --- /dev/null +++ b/docs/tutorial/migration_guides/migrate_from_j2v8.rst @@ -0,0 +1,77 @@ +================= +Migrate from J2V8 +================= + +How to migrate from J2V8 to Javet is a frequently asked question, especially when people are evaluating Javet. I created Javet in Jan, 2021 for various reasons (:doc:`../../faq/background/what_is_the_motivation`, :doc:`../../faq/background/history_with_j2v8`). After the first release v0.7.0 was published, I started migrating from J2V8 to Javet. It was quite smooth, though it took a week. + +Why Migrate from J2V8 to Javet? +=============================== + +* Its Linux, Mac OS and Windows releases have been abandoned for years. +* Its type hierarchy is inconsistent because primitive types are out of the hierarchy so that tedious ``if-else`` sentences have to be repeated all over the code base. +* Its function registration API is kind of verbose. +* Segfaults take place so frequently and don't get maintainers' attention for years. +* Its locking mechanism heavily increases mental pressure in the code base. +* Its V8 runtime is not multi-threaded friendly unless application adds a synchronous layer on top of it. + +Migration Guides +================ + +V8 ⟶ V8Runtime +--------------- + +* ``V8`` in J2V8 is ``V8Runtime`` in Javet. +* ``V8`` in J2V8 carries 2 roles: 1 as the V8 runtime and 1 as the global object (``globalThis`` or ``global``). In Javet, ``V8Runtime`` no longer inherits from ``V8Value`` so that it literally represents the V8 runtime. ``V8Runtime.getGlobalObject()`` is dedicated to the global object. +* ``V8Runtime`` has much richer API than ``V8`` has. E.g. ``compileV8Module()``, ``lowMemoryNotification()``, ``terminateExecution()``. + +Primitive Types +--------------- + +* Primitive types in Javet inherit from ``V8ValuePrimitive`` ⟶ ``V8Value`` ⟶ ``V8Data``. +* The Javet type hierarchy is consistent so that ``V8Value`` in all supported API can represent all V8 types. This is hard in J2V8 because ``Object`` has to be used to represent all types, however, by using ``Object`` the type check during compilation doesn't work at all and that is a rich source of runtime bugs or even segfaults. + +registerJavaMethod() ⟶ @V8Function +----------------------------------- + +* It is quite painful to register many functions in J2V8. Javet makes that a declarative one instead of the imperative one. Just decorate the target function with ``@V8Function``, then call ``V8ValueObject.bind(javaObject)`` to bind that Java object, it's done. +* In addition, Javet provides ``@V8Property`` which allows registering getters and setters in the same manner. That feature has never been delivered by J2V8. +* Javet also allows unbinding the registration. Just call ``V8ValueObject.unbind(javaObject)``. + +Please refer to :doc:`../../reference/v8_function` for more details. + +V8Locker +-------- + +* Javet introduced **Implicit Mode** which allows applications to eliminate ``V8Locker`` from the code base and still be able to share the same ``V8Runtime`` among multiple threads, because Javet does the synchronization automatically. That frees application developers from the tedious ``acquire()`` and ``release()`` calls, and gets the rid of the runtime exceptions caused by multiple threads. +* Javet also has **Explicit Mode** for performance sensitive scenarios. + +Please refer to :doc:`../../reference/lock` for more details. + +Type Conversion +--------------- + +* Javet has built-in ``JavetObjectConverter`` which covers the majority cases on type conversion so that the arguments of Javet API can be of any type and the converter just does the conversion transparently. That frees application developers from writing tedious type conversion code everywhere. +* Javet also provides ``JavetProxyConverter`` which allows injecting arbitrary Java objects in V8 and polyfilling Java interfaces with JavaScript functions or objects. Especially the polyfilling feature implies hotfixing business logic without restarting the JVM. + +Please refer to :doc:`../advanced/object_converter` for more details. + +Node.js and V8 +-------------- + +* Javet provides both Node.js mode and V8 mode for various usages. Each mode stays at a dedicated classloader so that both modes don't cross each other, and are completely isolated. If the application only uses one mode, it doesn't need to pay extra amount of memory for the other mode because the other mode is not loaded at all. Of course, both modes can be unloaded as well without shutting down the JVM. +* In Node.js mode, all node modules can be directly used including the native modules. Please refer to :doc:`../../reference/modularization` for more detail. +* In V8 mode, it is much more secure than the Node.js mode is, but lacks of some basic ES API, e.g. ``setTimeout()``. Project `Javenode `_ is the one that aims at simulating Node.js with Java in Javet V8 mode. + +Please refer to :doc:`../../development/design` for more details. + +ES6 Module +---------- + +* Javet supports ``import { *** } from '***.js'`` and exposes module resolve event for applications to specify where to locate the modules. + +Please refer to :doc:`../../reference/modularization` for more detail. + +Blessing +======== + +In case this migration guide couldn't cover all your use cases, please contact the maintainer at `discord `_. Wish you a successful migration! diff --git a/pom.xml b/pom.xml index bba95bb9d..575d63c47 100644 --- a/pom.xml +++ b/pom.xml @@ -3,9 +3,9 @@ com.caoccao.javet javet - 0.9.11 + 0.9.12 javet - Javet is Java + V8 (JAVa + V + EighT). It is a way of embedding V8 in Java. + Javet is Java + V8 (JAVa + V + EighT). It is an awesome way of embedding V8 in Java. https://github.com/caoccao/Javet @@ -28,7 +28,7 @@ scm:git:git://github.com/caoccao/Javet.git scm:git:git@github.com:caoccao/caoccao.git https://github.com/caoccao/Javet - javet-0.9.11 + javet-0.9.12 diff --git a/scripts/node/javet-rebuild/rebuild.cmd b/scripts/node/javet-rebuild/rebuild.cmd index e94bda923..c1fca8123 100644 --- a/scripts/node/javet-rebuild/rebuild.cmd +++ b/scripts/node/javet-rebuild/rebuild.cmd @@ -1,5 +1,5 @@ @echo off -SET NODE_LIB_FILE="..\..\..\..\..\..\build\libs\libjavet-node-windows-x86_64.v.0.9.11.lib" +SET NODE_LIB_FILE="..\..\..\..\..\..\build\libs\libjavet-node-windows-x86_64.v.0.9.12.lib" cd %NODE_MODULE_ROOT% call node-gyp clean call node-gyp configure --module_name=%NODE_MODULE_NAME% --module_path=%NODE_MODULE_PATH% --node_lib_file=%NODE_LIB_FILE% diff --git a/scripts/node/javet-rebuild/rebuild.sh b/scripts/node/javet-rebuild/rebuild.sh index bd0883266..9ba202986 100755 --- a/scripts/node/javet-rebuild/rebuild.sh +++ b/scripts/node/javet-rebuild/rebuild.sh @@ -1 +1 @@ -patchelf --add-needed libjavet-node-linux-x86_64.v.0.9.11.so ${NODE_MODULE_FILE} +patchelf --add-needed libjavet-node-linux-x86_64.v.0.9.12.so ${NODE_MODULE_FILE} diff --git a/scripts/python/change_javet_version.py b/scripts/python/change_javet_version.py index 895f21a55..5c1997b31 100644 --- a/scripts/python/change_javet_version.py +++ b/scripts/python/change_javet_version.py @@ -40,6 +40,9 @@ def update(self): self._update( 'build.gradle.kts', '\n', re.compile(r'^version = "(?P\d+\.\d+\.\d+)"$')) + self._update( + 'docs/conf.py', '\n', + re.compile(r'release\s*=\s*\'(?P\d+\.\d+\.\d+)\'$')) self._update( 'docs/tutorial/installation.rst', '\n', re.compile(r'^ (?P\d+\.\d+\.\d+)$'), @@ -110,7 +113,7 @@ def _update(self, relative_file_path: str, line_separator: str, *patterns: list) logging.info(' Updated.') def main(): - change_javet_version = ChangeJavetVersion('0.9.11') + change_javet_version = ChangeJavetVersion('0.9.12') change_javet_version.update() return 0 diff --git a/src/main/java/com/caoccao/javet/annotations/CheckReturnValue.java b/src/main/java/com/caoccao/javet/annotations/CheckReturnValue.java index 09840cc91..779ee06d6 100644 --- a/src/main/java/com/caoccao/javet/annotations/CheckReturnValue.java +++ b/src/main/java/com/caoccao/javet/annotations/CheckReturnValue.java @@ -1,3 +1,19 @@ +/* + * Copyright (c) 2021. 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.annotations; import java.lang.annotation.*; @@ -10,6 +26,6 @@ */ @Documented @Target({ElementType.METHOD, ElementType.CONSTRUCTOR, ElementType.TYPE, ElementType.PACKAGE}) -@Retention(RetentionPolicy.RUNTIME) +@Retention(RetentionPolicy.SOURCE) public @interface CheckReturnValue { } diff --git a/src/main/java/com/caoccao/javet/annotations/V8Property.java b/src/main/java/com/caoccao/javet/annotations/V8Property.java index 8e98bb82c..09d885cc8 100644 --- a/src/main/java/com/caoccao/javet/annotations/V8Property.java +++ b/src/main/java/com/caoccao/javet/annotations/V8Property.java @@ -17,6 +17,8 @@ package com.caoccao.javet.annotations; +import com.caoccao.javet.enums.V8ValueSymbolType; + import java.lang.annotation.*; /** @@ -37,12 +39,12 @@ String name() default ""; /** - * Symbol boolean. + * Symbol V8 value symbol type. * - * @return the boolean + * @return the V8 value symbol type * @since 0.9.11 */ - boolean symbol() default false; + V8ValueSymbolType symbolType() default V8ValueSymbolType.None; /** * This object required. diff --git a/src/main/java/com/caoccao/javet/annotations/package-info.java b/src/main/java/com/caoccao/javet/annotations/package-info.java new file mode 100644 index 000000000..88affd660 --- /dev/null +++ b/src/main/java/com/caoccao/javet/annotations/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Annotations classes for declarative coding and IDE intellisense. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.annotations; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/entities/JavetEntityFunction.java b/src/main/java/com/caoccao/javet/entities/JavetEntityFunction.java index 3cd0b408c..073415fe6 100644 --- a/src/main/java/com/caoccao/javet/entities/JavetEntityFunction.java +++ b/src/main/java/com/caoccao/javet/entities/JavetEntityFunction.java @@ -21,7 +21,8 @@ import com.caoccao.javet.interfaces.IJavetEntityFunction; /** - * The type Javet entity function. + * The type Javet entity function is for converting JS function + * to or from Java object. * * @since 0.9.4 */ diff --git a/src/main/java/com/caoccao/javet/entities/JavetEntityMap.java b/src/main/java/com/caoccao/javet/entities/JavetEntityMap.java index 768f324ac..a8a679e44 100644 --- a/src/main/java/com/caoccao/javet/entities/JavetEntityMap.java +++ b/src/main/java/com/caoccao/javet/entities/JavetEntityMap.java @@ -23,7 +23,8 @@ import java.util.Map; /** - * The type Javet entity map. + * The type Javet entity map is for converting JS map + * to or from Java map. * * @since 0.7.2 */ diff --git a/src/main/java/com/caoccao/javet/entities/JavetEntitySymbol.java b/src/main/java/com/caoccao/javet/entities/JavetEntitySymbol.java index 173446728..800df0623 100644 --- a/src/main/java/com/caoccao/javet/entities/JavetEntitySymbol.java +++ b/src/main/java/com/caoccao/javet/entities/JavetEntitySymbol.java @@ -20,7 +20,8 @@ import java.util.Objects; /** - * The type Javet entity symbol. + * The type Javet entity symbol is for converting JS symbol + * to or from Java symbol. * * @since 0.9.11 */ diff --git a/src/main/java/com/caoccao/javet/entities/package-info.java b/src/main/java/com/caoccao/javet/entities/package-info.java new file mode 100644 index 000000000..8d8848522 --- /dev/null +++ b/src/main/java/com/caoccao/javet/entities/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Built-in entities for default object conversion. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.entities; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/enums/JavetErrorType.java b/src/main/java/com/caoccao/javet/enums/JavetErrorType.java index a9aa067ea..e9b9f354b 100644 --- a/src/main/java/com/caoccao/javet/enums/JavetErrorType.java +++ b/src/main/java/com/caoccao/javet/enums/JavetErrorType.java @@ -18,7 +18,7 @@ package com.caoccao.javet.enums; /** - * The enum Javet error type. + * The enum Javet error type is for categorizing the errors. * * @since 0.8.5 */ diff --git a/src/main/java/com/caoccao/javet/enums/JavetPromiseRejectEvent.java b/src/main/java/com/caoccao/javet/enums/JavetPromiseRejectEvent.java index 7eafd4676..f1132f711 100644 --- a/src/main/java/com/caoccao/javet/enums/JavetPromiseRejectEvent.java +++ b/src/main/java/com/caoccao/javet/enums/JavetPromiseRejectEvent.java @@ -17,10 +17,25 @@ package com.caoccao.javet.enums; +/** + * The enum Javet promise reject event represents the corresponding event in V8. + */ public enum JavetPromiseRejectEvent { + /** + * PromiseRejectWithNoHandler. + */ PromiseRejectWithNoHandler(0, "PromiseRejectWithNoHandler"), + /** + * PromiseHandlerAddedAfterReject. + */ PromiseHandlerAddedAfterReject(1, "PromiseHandlerAddedAfterReject"), + /** + * PromiseResolveAfterResolved. + */ PromiseResolveAfterResolved(2, "PromiseResolveAfterResolved"), + /** + * PromiseRejectAfterResolved. + */ PromiseRejectAfterResolved(3, "PromiseRejectAfterResolved"); private static final JavetPromiseRejectEvent[] EVENTS = new JavetPromiseRejectEvent[]{ @@ -37,17 +52,33 @@ public enum JavetPromiseRejectEvent { this.name = name; } - public static JavetPromiseRejectEvent parse(int event) { - if (event >= 0 && event < EVENTS.length) { - return EVENTS[event]; + /** + * Parse javet promise reject event by code. + * + * @param code the event code + * @return the javet promise reject event + */ + public static JavetPromiseRejectEvent parse(int code) { + if (code >= 0 && code < EVENTS.length) { + return EVENTS[code]; } return null; } + /** + * Gets event code. + * + * @return the event code + */ public int getCode() { return code; } + /** + * Gets event name. + * + * @return the event name + */ public String getName() { return name; } diff --git a/src/main/java/com/caoccao/javet/enums/V8ValueReferenceType.java b/src/main/java/com/caoccao/javet/enums/V8ValueReferenceType.java index dcf1d4a03..6d3592947 100644 --- a/src/main/java/com/caoccao/javet/enums/V8ValueReferenceType.java +++ b/src/main/java/com/caoccao/javet/enums/V8ValueReferenceType.java @@ -17,6 +17,8 @@ package com.caoccao.javet.enums; +import java.util.stream.Stream; + public enum V8ValueReferenceType { Invalid(0, "Invalid"), Object(1, "Object"), @@ -38,24 +40,23 @@ public enum V8ValueReferenceType { Module(21, "Module"), DataView(30, "DataView"), ArrayBuffer(31, "ArrayBuffer"), - Int8Array(32, "Int8Array"), // -128 to 127 1 8-bit two's complement signed integer byte int8_t - Uint8Array(33, "Uint8Array"), // 0 to 255 1 8-bit unsigned integer octet uint8_t - Uint8ClampedArray(34, "Uint8ClampedArray"), // 0 to 255 1 8-bit unsigned integer (clamped) octet uint8_t - Int16Array(35, "Int16Array"), // -32768 to 32767 2 16-bit two's complement signed integer short int16_t - Uint16Array(36, "Uint16Array"), // 0 to 65535 2 16-bit unsigned integer unsigned short uint16_t - Int32Array(37, "Int32Array"), // -2147483648 to 2147483647 4 32-bit two's complement signed integer long int32_t - Uint32Array(38, "Uint32Array"), // 0 to 4294967295 4 32-bit unsigned integer unsigned long uint32_t - Float32Array(39, "Float32Array"), // 1.2×10^-38 to 3.4×10^38 4 32-bit IEEE floating point number (7 significant digits e.g., 1.234567) unrestricted float float - Float64Array(40, "Float64Array"), // 5.0×10^-324 to 1.8×10^308 8 64-bit IEEE floating point number (16 significant digits e.g., 1.23456789012345) unrestricted double double - BigInt64Array(41, "BigInt64Array"), // -2^63 to 2^63-1 8 64-bit two's complement signed integer bigint int64_t (signed long long) - BigUint64Array(42, "BigUint64Array"); // 0 to 2^64-1 8 64-bit unsigned integer bigint uint64_t (unsigned long long) + SharedArrayBuffer(32, "SharedArrayBuffer"), + Int8Array(33, "Int8Array"), // -128 to 127 1 8-bit two's complement signed integer byte int8_t + Uint8Array(34, "Uint8Array"), // 0 to 255 1 8-bit unsigned integer octet uint8_t + Uint8ClampedArray(35, "Uint8ClampedArray"), // 0 to 255 1 8-bit unsigned integer (clamped) octet uint8_t + Int16Array(36, "Int16Array"), // -32768 to 32767 2 16-bit two's complement signed integer short int16_t + Uint16Array(37, "Uint16Array"), // 0 to 65535 2 16-bit unsigned integer unsigned short uint16_t + Int32Array(38, "Int32Array"), // -2147483648 to 2147483647 4 32-bit two's complement signed integer long int32_t + Uint32Array(39, "Uint32Array"), // 0 to 4294967295 4 32-bit unsigned integer unsigned long uint32_t + Float32Array(40, "Float32Array"), // 1.2×10^-38 to 3.4×10^38 4 32-bit IEEE floating point number (7 significant digits e.g., 1.234567) unrestricted float float + Float64Array(41, "Float64Array"), // 5.0×10^-324 to 1.8×10^308 8 64-bit IEEE floating point number (16 significant digits e.g., 1.23456789012345) unrestricted double double + BigInt64Array(42, "BigInt64Array"), // -2^63 to 2^63-1 8 64-bit two's complement signed integer bigint int64_t (signed long long) + BigUint64Array(43, "BigUint64Array"); // 0 to 2^64-1 8 64-bit unsigned integer bigint uint64_t (unsigned long long) - private static final V8ValueReferenceType[] ALL_TYPES = new V8ValueReferenceType[43]; + private static final V8ValueReferenceType[] ALL_TYPES = new V8ValueReferenceType[44]; static { - for (V8ValueReferenceType type : values()) { - ALL_TYPES[type.getId()] = type; - } + Stream.of(values()).forEach(t -> ALL_TYPES[t.getId()] = t); } private final int id; diff --git a/src/main/java/com/caoccao/javet/enums/V8ValueSymbolType.java b/src/main/java/com/caoccao/javet/enums/V8ValueSymbolType.java new file mode 100644 index 000000000..c2fc61776 --- /dev/null +++ b/src/main/java/com/caoccao/javet/enums/V8ValueSymbolType.java @@ -0,0 +1,7 @@ +package com.caoccao.javet.enums; + +public enum V8ValueSymbolType { + None, + BuiltIn, + Custom, +} diff --git a/src/main/java/com/caoccao/javet/enums/package-info.java b/src/main/java/com/caoccao/javet/enums/package-info.java new file mode 100644 index 000000000..cdf1a1066 --- /dev/null +++ b/src/main/java/com/caoccao/javet/enums/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Enums for various API. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.enums; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/exceptions/JavetError.java b/src/main/java/com/caoccao/javet/exceptions/JavetError.java index 5eca06a36..4186ac891 100644 --- a/src/main/java/com/caoccao/javet/exceptions/JavetError.java +++ b/src/main/java/com/caoccao/javet/exceptions/JavetError.java @@ -44,6 +44,7 @@ public class JavetError { public static final String PARAMETER_OS = "OS"; public static final String PARAMETER_FEATURE = "feature"; + public static final String PARAMETER_SYMBOL = "symbol"; public static final String PARAMETER_COUNT = "count"; public static final String PARAMETER_CONTINUABLE = "continuable"; @@ -90,6 +91,8 @@ public class JavetError { 501, JavetErrorType.Converter, "Failed to convert values with error message ${message}"); public static final JavetError ConverterCircularStructure = new JavetError( 502, JavetErrorType.Converter, "Circular structure is detected with max depth ${maxDepth} reached"); + public static final JavetError ConverterSymbolNotBuiltIn = new JavetError( + 503, JavetErrorType.Converter, "${symbol} is not a built-in symbol"); public static final JavetError ModuleNameEmpty = new JavetError( 601, JavetErrorType.Module, "Module name is empty"); diff --git a/src/main/java/com/caoccao/javet/exceptions/package-info.java b/src/main/java/com/caoccao/javet/exceptions/package-info.java new file mode 100644 index 000000000..355cf89de --- /dev/null +++ b/src/main/java/com/caoccao/javet/exceptions/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Exceptions and errors for error handling. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.exceptions; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/interception/logging/BaseJavetConsoleInterceptor.java b/src/main/java/com/caoccao/javet/interception/logging/BaseJavetConsoleInterceptor.java index 33b61e406..b50431b89 100644 --- a/src/main/java/com/caoccao/javet/interception/logging/BaseJavetConsoleInterceptor.java +++ b/src/main/java/com/caoccao/javet/interception/logging/BaseJavetConsoleInterceptor.java @@ -205,12 +205,12 @@ public boolean register(IV8ValueObject... iV8ValueObjects) throws JavetException } /** - * Register. + * Register a JS function by name. * * @param iV8ValueObject the V8 value object - * @param jsFunctionName the js function name - * @param javaFunctionName the java function name - * @throws JavetException the javet exception + * @param jsFunctionName the JS function name + * @param javaFunctionName the Java function name + * @throws JavetException the Javet exception * @since 0.7.0 */ protected void register(IV8ValueObject iV8ValueObject, String jsFunctionName, String javaFunctionName) diff --git a/src/main/java/com/caoccao/javet/interception/logging/package-info.java b/src/main/java/com/caoccao/javet/interception/logging/package-info.java new file mode 100644 index 000000000..785bff276 --- /dev/null +++ b/src/main/java/com/caoccao/javet/interception/logging/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Built-in interceptors for JS logging function console.log(), etc... + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.interception.logging; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/interception/package-info.java b/src/main/java/com/caoccao/javet/interception/package-info.java new file mode 100644 index 000000000..d18320118 --- /dev/null +++ b/src/main/java/com/caoccao/javet/interception/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Built-in interceptors. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.interception; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/interfaces/IJavetInterceptor.java b/src/main/java/com/caoccao/javet/interfaces/IJavetInterceptor.java index fb182c203..a32d1127f 100644 --- a/src/main/java/com/caoccao/javet/interfaces/IJavetInterceptor.java +++ b/src/main/java/com/caoccao/javet/interfaces/IJavetInterceptor.java @@ -27,20 +27,20 @@ */ public interface IJavetInterceptor { /** - * Register boolean. + * Register the interceptor to the given V8 value object. * * @param iV8ValueObjects the V8 value objects - * @return the boolean + * @return true: success, false: failure * @throws JavetException the javet exception * @since 0.7.0 */ boolean register(IV8ValueObject... iV8ValueObjects) throws JavetException; /** - * Unregister boolean. + * Unregister the interceptor from the given V8 value object. * * @param iV8ValueObjects the V8 value objects - * @return the boolean + * @return true: success, false: failure * @throws JavetException the javet exception * @since 0.7.0 */ diff --git a/src/main/java/com/caoccao/javet/interfaces/IJavetSupplier.java b/src/main/java/com/caoccao/javet/interfaces/IJavetSupplier.java new file mode 100644 index 000000000..f9f6545e8 --- /dev/null +++ b/src/main/java/com/caoccao/javet/interfaces/IJavetSupplier.java @@ -0,0 +1,25 @@ +/* + * Copyright 2021. 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.interfaces; + +import com.caoccao.javet.exceptions.JavetException; + +@FunctionalInterface +public interface IJavetSupplier { + T get() throws JavetException, E; +} diff --git a/src/main/java/com/caoccao/javet/interfaces/package-info.java b/src/main/java/com/caoccao/javet/interfaces/package-info.java new file mode 100644 index 000000000..8bf480ef7 --- /dev/null +++ b/src/main/java/com/caoccao/javet/interfaces/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Interfaces required by various internal and external API. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.interfaces; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/interop/IV8Native.java b/src/main/java/com/caoccao/javet/interop/IV8Native.java index 6f51d47a4..d6ea15742 100644 --- a/src/main/java/com/caoccao/javet/interop/IV8Native.java +++ b/src/main/java/com/caoccao/javet/interop/IV8Native.java @@ -52,6 +52,8 @@ Object compile( boolean delete(long v8RuntimeHandle, long v8ValueHandle, int v8ValueType, Object key); + boolean deletePrivateProperty(long v8RuntimeHandle, long v8ValueHandle, int v8ValueType, String key); + boolean equals(long v8RuntimeHandle, long v8ValueHandle1, long v8ValueHandle2); Object execute( @@ -77,6 +79,8 @@ Object execute( Object getOwnPropertyNames(long v8RuntimeHandle, long v8ValueHandle, int v8ValueType); + Object getPrivateProperty(long v8RuntimeHandle, long v8ValueHandle, int v8ValueType, String propertyName); + Object getProperty(long v8RuntimeHandle, long v8ValueHandle, int v8ValueType, Object key); Object getPropertyNames(long v8RuntimeHandle, long v8ValueHandle, int v8ValueType); @@ -93,6 +97,8 @@ Object execute( boolean hasOwnProperty(long v8RuntimeHandle, long v8ValueHandle, int type, Object key); + boolean hasPrivateProperty(long v8RuntimeHandle, long v8ValueHandle, int type, String propertyName); + void idleNotificationDeadline(long v8RuntimeHandle, long deadlineInMillis); Object invoke( @@ -181,6 +187,8 @@ boolean setAccessor( */ void setFlags(String flags); + boolean setPrivateProperty(long v8RuntimeHandle, long v8ValueHandle, int v8ValueType, String key, Object value); + boolean setProperty(long v8RuntimeHandle, long v8ValueHandle, int v8ValueType, Object key, Object value); boolean setPrototype(long v8RuntimeHandle, long v8ValueHandle, int v8ValueType, long v8ValueHandlePrototype); diff --git a/src/main/java/com/caoccao/javet/interop/JavetLibLoader.java b/src/main/java/com/caoccao/javet/interop/JavetLibLoader.java index 51a14f6fd..f4d48a1bb 100644 --- a/src/main/java/com/caoccao/javet/interop/JavetLibLoader.java +++ b/src/main/java/com/caoccao/javet/interop/JavetLibLoader.java @@ -33,7 +33,7 @@ import java.util.Objects; public final class JavetLibLoader { - static final String LIB_VERSION = "0.9.11"; + static final String LIB_VERSION = "0.9.12"; private static final int BUFFER_LENGTH = 4096; private static final String CHMOD = "chmod"; private static final String LIB_FILE_EXTENSION_LINUX = "so"; diff --git a/src/main/java/com/caoccao/javet/interop/V8Native.java b/src/main/java/com/caoccao/javet/interop/V8Native.java index 551ebbf62..e7ad609b2 100644 --- a/src/main/java/com/caoccao/javet/interop/V8Native.java +++ b/src/main/java/com/caoccao/javet/interop/V8Native.java @@ -23,9 +23,9 @@ *

* Guidelines: * 1. Please keep V8Native as small, simple as possible so that the C++ implementation is minimized. - * 2. Please make sure V8Native doesn't not reference any other types so that JNI code generation is quick and clean. + * 2. Please make sure V8Native does not reference any other types so that JNI code generation is quick and clean. * 3. Please keep the methods in ascending order so that the generated .h file keeps the same order. - * 4. Please don't not inject any other non-public native code. + * 4. Please do not inject any other non-public native code. */ class V8Native implements IV8Native { V8Native() { @@ -80,6 +80,9 @@ public native Object compile( @Override public native boolean delete(long v8RuntimeHandle, long v8ValueHandle, int v8ValueType, Object key); + @Override + public native boolean deletePrivateProperty(long v8RuntimeHandle, long v8ValueHandle, int v8ValueType, String key); + @Override public native boolean equals(long v8RuntimeHandle, long v8ValueHandle1, long v8ValueHandle2); @@ -116,6 +119,10 @@ public native Object execute( @Override public native Object getOwnPropertyNames(long v8RuntimeHandle, long v8ValueHandle, int v8ValueType); + @Override + public native Object getPrivateProperty( + long v8RuntimeHandle, long v8ValueHandle, int v8ValueType, String propertyName); + @Override public native Object getProperty(long v8RuntimeHandle, long v8ValueHandle, int v8ValueType, Object key); @@ -140,6 +147,9 @@ public native Object execute( @Override public native boolean hasOwnProperty(long v8RuntimeHandle, long v8ValueHandle, int type, Object key); + @Override + public native boolean hasPrivateProperty(long v8RuntimeHandle, long v8ValueHandle, int type, String propertyName); + @Override public native void idleNotificationDeadline(long v8RuntimeHandle, long deadlineInMillis); @@ -264,6 +274,10 @@ public native boolean setAccessor( @Override public native void setFlags(String flags); + @Override + public native boolean setPrivateProperty( + long v8RuntimeHandle, long v8ValueHandle, int v8ValueType, String key, Object value); + @Override public native boolean setProperty(long v8RuntimeHandle, long v8ValueHandle, int v8ValueType, Object key, Object value); diff --git a/src/main/java/com/caoccao/javet/interop/V8Runtime.java b/src/main/java/com/caoccao/javet/interop/V8Runtime.java index c1de0bc4c..0b518ad2e 100644 --- a/src/main/java/com/caoccao/javet/interop/V8Runtime.java +++ b/src/main/java/com/caoccao/javet/interop/V8Runtime.java @@ -17,6 +17,7 @@ package com.caoccao.javet.interop; +import com.caoccao.javet.annotations.CheckReturnValue; import com.caoccao.javet.enums.*; import com.caoccao.javet.exceptions.JavetError; import com.caoccao.javet.exceptions.JavetException; @@ -45,7 +46,9 @@ import java.text.MessageFormat; import java.time.ZonedDateTime; import java.util.*; -import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.locks.Lock; +import java.util.concurrent.locks.ReadWriteLock; +import java.util.concurrent.locks.ReentrantReadWriteLock; import java.util.stream.IntStream; @SuppressWarnings("unchecked") @@ -64,6 +67,7 @@ public class V8Runtime implements IJavetClosable, IV8Creatable, IV8Convertible { protected V8ValueLong[] cachedV8ValueLongs; protected V8ValueNull cachedV8ValueNull; protected V8ValueUndefined cachedV8ValueUndefined; + protected ReadWriteLock callbackContextLock; /** * The Callback context map. *

@@ -81,9 +85,11 @@ public class V8Runtime implements IJavetClosable, IV8Creatable, IV8Convertible { protected IJavetLogger logger; protected boolean pooled; protected IJavetPromiseRejectCallback promiseRejectCallback; + protected ReadWriteLock referenceLock; protected Map referenceMap; protected V8Host v8Host; protected V8Inspector v8Inspector; + protected ReadWriteLock v8ModuleLock; protected Map v8ModuleMap; protected IV8ModuleResolver v8ModuleResolver; protected IV8Native v8Native; @@ -91,20 +97,23 @@ public class V8Runtime implements IJavetClosable, IV8Creatable, IV8Convertible { V8Runtime(V8Host v8Host, long handle, boolean pooled, IV8Native v8Native, String globalName) { assert handle != 0; bindingContextWeakHashMap = Collections.synchronizedMap(new WeakHashMap<>()); - callbackContextMap = new ConcurrentHashMap<>(); + callbackContextLock = new ReentrantReadWriteLock(); + callbackContextMap = new HashMap<>(); converter = DEFAULT_CONVERTER; gcScheduled = false; this.globalName = globalName; this.handle = handle; logger = new JavetDefaultLogger(getClass().getName()); - v8ModuleMap = Collections.synchronizedMap(new HashMap<>()); this.pooled = pooled; promiseRejectCallback = new JavetPromiseRejectCallback(logger); - referenceMap = new ConcurrentHashMap<>(); + referenceLock = new ReentrantReadWriteLock(); + referenceMap = new HashMap<>(); this.v8Host = v8Host; + v8Inspector = null; this.v8Native = v8Native; + v8ModuleLock = new ReentrantReadWriteLock(); + v8ModuleMap = new HashMap<>(); v8ModuleResolver = null; - v8Inspector = null; initializeV8ValueCache(); } @@ -114,11 +123,23 @@ public void add(IV8ValueSet iV8ValueKeySet, V8Value value) throws JavetException } public void addReference(IV8ValueReference iV8ValueReference) { - referenceMap.put(iV8ValueReference.getHandle(), iV8ValueReference); + Lock readLock = referenceLock.readLock(); + try { + readLock.lock(); + referenceMap.put(iV8ValueReference.getHandle(), iV8ValueReference); + } finally { + readLock.unlock(); + } } public void addV8Module(IV8Module iV8Module) { - v8ModuleMap.put(iV8Module.getResourceName(), iV8Module); + Lock readLock = v8ModuleLock.readLock(); + try { + readLock.lock(); + v8ModuleMap.put(iV8Module.getResourceName(), iV8Module); + } finally { + readLock.unlock(); + } } public void allowEval(boolean allow) { @@ -129,6 +150,7 @@ public void await() { v8Native.await(handle); } + @CheckReturnValue public T call( IV8ValueObject iV8ValueObject, IV8ValueObject receiver, boolean returnResult, V8Value... v8Values) throws JavetException { @@ -137,6 +159,7 @@ public T call( handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), receiver, returnResult, v8Values)); } + @CheckReturnValue public T callAsConstructor( IV8ValueObject iV8ValueObject, V8Value... v8Values) throws JavetException { decorateV8Values(v8Values); @@ -149,6 +172,7 @@ public void clearWeak(IV8ValueReference iV8ValueReference) throws JavetException v8Native.clearWeak(handle, iV8ValueReference.getHandle(), iV8ValueReference.getType().getId()); } + @CheckReturnValue public T cloneV8Value(IV8ValueReference iV8ValueReference) throws JavetException { return decorateV8Value((T) v8Native.cloneV8Value( handle, iV8ValueReference.getHandle(), iV8ValueReference.getType().getId())); @@ -168,6 +192,7 @@ public void close(boolean forceClose) throws JavetException { } } + @CheckReturnValue public V8Script compileScript(String scriptString, V8ScriptOrigin v8ScriptOrigin, boolean resultRequired) throws JavetException { v8ScriptOrigin.setModule(false); @@ -177,6 +202,7 @@ public V8Script compileScript(String scriptString, V8ScriptOrigin v8ScriptOrigin v8ScriptOrigin.getScriptId(), v8ScriptOrigin.isWasm(), v8ScriptOrigin.isModule())); } + @CheckReturnValue public V8Module compileV8Module(String scriptString, V8ScriptOrigin v8ScriptOrigin, boolean resultRequired) throws JavetException { v8ScriptOrigin.setModule(true); @@ -197,16 +223,24 @@ public V8Module compileV8Module(String scriptString, V8ScriptOrigin v8ScriptOrig } public boolean containsV8Module(String resourceName) { - return v8ModuleMap.containsKey(resourceName); + Lock readLock = v8ModuleLock.readLock(); + try { + readLock.lock(); + return v8ModuleMap.containsKey(resourceName); + } finally { + readLock.unlock(); + } } @Override + @CheckReturnValue public V8ValueArray createV8ValueArray() throws JavetException { return decorateV8Value((V8ValueArray) v8Native.createV8Value( handle, V8ValueReferenceType.Array.getId(), null)); } @Override + @CheckReturnValue public V8ValueArrayBuffer createV8ValueArrayBuffer(int length) throws JavetException { return decorateV8Value((V8ValueArrayBuffer) v8Native.createV8Value( handle, V8ValueReferenceType.ArrayBuffer.getId(), createV8ValueInteger(length))); @@ -221,6 +255,7 @@ public V8ValueBoolean createV8ValueBoolean(boolean booleanValue) throws JavetExc } @Override + @CheckReturnValue public V8ValueDataView createV8ValueDataView(V8ValueArrayBuffer v8ValueArrayBuffer) throws JavetException { Objects.requireNonNull(v8ValueArrayBuffer); try (V8ValueFunction v8ValueFunction = getGlobalObject().get(PROPERTY_DATA_VIEW)) { @@ -234,15 +269,23 @@ public V8ValueDouble createV8ValueDouble(double doubleValue) throws JavetExcepti } @Override + @CheckReturnValue public V8ValueFunction createV8ValueFunction(JavetCallbackContext javetCallbackContext) throws JavetException { Objects.requireNonNull(javetCallbackContext); V8ValueFunction v8ValueFunction = decorateV8Value((V8ValueFunction) v8Native.createV8Value( handle, V8ValueReferenceType.Function.getId(), javetCallbackContext)); - callbackContextMap.put(javetCallbackContext.getHandle(), javetCallbackContext); + Lock writeLock = callbackContextLock.writeLock(); + try { + writeLock.lock(); + callbackContextMap.put(javetCallbackContext.getHandle(), javetCallbackContext); + } finally { + writeLock.unlock(); + } return v8ValueFunction; } @Override + @CheckReturnValue public V8ValueFunction createV8ValueFunction(String codeString) throws JavetException { return getExecutor(codeString).execute(); } @@ -256,6 +299,7 @@ public V8ValueInteger createV8ValueInteger(int integerValue) throws JavetExcepti } @Override + @CheckReturnValue 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]; @@ -264,6 +308,7 @@ public V8ValueLong createV8ValueLong(long longValue) throws JavetException { } @Override + @CheckReturnValue public V8ValueMap createV8ValueMap() throws JavetException { return decorateV8Value((V8ValueMap) v8Native.createV8Value( handle, V8ValueReferenceType.Map.getId(), null)); @@ -275,24 +320,28 @@ public V8ValueNull createV8ValueNull() { } @Override + @CheckReturnValue public V8ValueObject createV8ValueObject() throws JavetException { return decorateV8Value((V8ValueObject) v8Native.createV8Value( handle, V8ValueReferenceType.Object.getId(), null)); } @Override + @CheckReturnValue public V8ValuePromise createV8ValuePromise() throws JavetException { return decorateV8Value((V8ValuePromise) v8Native.createV8Value( handle, V8ValueReferenceType.Promise.getId(), null)); } @Override + @CheckReturnValue public V8ValueProxy createV8ValueProxy(V8ValueObject v8ValueObject) throws JavetException { return decorateV8Value((V8ValueProxy) v8Native.createV8Value( handle, V8ValueReferenceType.Proxy.getId(), v8ValueObject)); } @Override + @CheckReturnValue public V8ValueSet createV8ValueSet() throws JavetException { return decorateV8Value((V8ValueSet) v8Native.createV8Value( handle, V8ValueReferenceType.Set.getId(), null)); @@ -304,6 +353,7 @@ public V8ValueString createV8ValueString(String str) throws JavetException { } @Override + @CheckReturnValue public V8ValueSymbol createV8ValueSymbol(String description, boolean global) throws JavetException { Objects.requireNonNull(description); assert description.length() > 0; @@ -318,6 +368,7 @@ public V8ValueSymbol createV8ValueSymbol(String description, boolean global) thr } @Override + @CheckReturnValue public V8ValueTypedArray createV8ValueTypedArray(V8ValueReferenceType type, int length) throws JavetException { try (V8ValueFunction v8ValueFunction = getGlobalObject().get(type.getName())) { return v8ValueFunction.callAsConstructor(length); @@ -339,6 +390,7 @@ public V8ValueZonedDateTime createV8ValueZonedDateTime(ZonedDateTime zonedDateTi return decorateV8Value(new V8ValueZonedDateTime(zonedDateTime)); } + @CheckReturnValue public T decorateV8Value(T v8Value) throws JavetException { if (v8Value != null) { if (v8Value.getV8Runtime() == null) { @@ -366,11 +418,17 @@ public boolean delete(IV8ValueObject iV8ValueObject, V8Value key) throws JavetEx return v8Native.delete(handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key); } + public boolean deletePrivateProperty(IV8ValueObject iV8ValueObject, String propertyName) throws JavetException { + return v8Native.deletePrivateProperty( + handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), propertyName); + } + public boolean equals(IV8ValueReference iV8ValueReference1, IV8ValueReference iV8ValueReference2) throws JavetException { return v8Native.equals(handle, iV8ValueReference1.getHandle(), iV8ValueReference2.getHandle()); } + @CheckReturnValue public T execute( String scriptString, V8ScriptOrigin v8ScriptOrigin, boolean resultRequired) throws JavetException { return decorateV8Value((T) v8Native.execute( @@ -379,6 +437,7 @@ public T execute( v8ScriptOrigin.getScriptId(), v8ScriptOrigin.isWasm(), v8ScriptOrigin.isModule())); } + @CheckReturnValue public T get( IV8ValueObject iV8ValueObject, V8Value key) throws JavetException { return decorateV8Value((T) v8Native.get( @@ -390,11 +449,23 @@ public Map, BindingContext> getBindingContextWeakHashMap() { } public JavetCallbackContext getCallbackContext(long handle) { - return callbackContextMap.get(handle); + Lock readLock = callbackContextLock.readLock(); + try { + readLock.lock(); + return callbackContextMap.get(handle); + } finally { + readLock.unlock(); + } } public int getCallbackContextCount() { - return callbackContextMap.size(); + Lock readLock = callbackContextLock.readLock(); + try { + readLock.lock(); + return callbackContextMap.size(); + } finally { + readLock.unlock(); + } } public IJavetConverter getConverter() { @@ -430,6 +501,7 @@ public int getIdentityHash(IV8ValueReference iV8ValueReference) throws JavetExce return v8Native.getIdentityHash(handle, iV8ValueReference.getHandle(), iV8ValueReference.getType().getId()); } + @CheckReturnValue public IV8ValueArray getInternalProperties(IV8ValueFunction iV8ValueFunction) throws JavetException { return decorateV8Value((V8ValueArray) v8Native.getInternalProperties( handle, iV8ValueFunction.getHandle(), iV8ValueFunction.getType().getId())); @@ -461,16 +533,25 @@ public IJavetLogger getLogger() { return logger; } + @CheckReturnValue public IV8ValueArray getOwnPropertyNames( IV8ValueObject iV8ValueObject) throws JavetException { return decorateV8Value((V8ValueArray) v8Native.getOwnPropertyNames( handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId())); } + @CheckReturnValue + public T getPrivateProperty(IV8ValueObject iV8ValueObject, String propertyName) + throws JavetException { + return decorateV8Value((T) v8Native.getPrivateProperty( + handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), propertyName)); + } + public IJavetPromiseRejectCallback getPromiseRejectCallback() { return promiseRejectCallback; } + @CheckReturnValue public T getProperty( IV8ValueObject iV8ValueObject, V8Value key) throws JavetException { decorateV8Value(key); @@ -478,19 +559,27 @@ public T getProperty( handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key)); } + @CheckReturnValue public IV8ValueArray getPropertyNames( IV8ValueObject iV8ValueObject) throws JavetException { return decorateV8Value((V8ValueArray) v8Native.getPropertyNames( handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId())); } + @CheckReturnValue public T getPrototype(IV8ValueObject iV8ValueObject) throws JavetException { return decorateV8Value((T) v8Native.getPrototype( handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId())); } public int getReferenceCount() { - return referenceMap.size(); + Lock readLock = referenceLock.readLock(); + try { + readLock.lock(); + return referenceMap.size(); + } finally { + readLock.unlock(); + } } public int getSize(IV8ValueKeyContainer iV8ValueKeyContainer) throws JavetException { @@ -513,22 +602,39 @@ public V8Inspector getV8Inspector(String name) { return v8Inspector; } + @CheckReturnValue public V8Locker getV8Locker() throws JavetException { return new V8Locker(this, v8Native); } + @CheckReturnValue public IV8Module getV8Module(String resourceName, IV8Module v8ModuleReferrer) throws JavetException { - decorateV8Value(v8ModuleReferrer); - if (containsV8Module(resourceName)) { - return v8ModuleMap.get(resourceName); - } else if (v8ModuleResolver != null) { - return v8ModuleResolver.resolve(this, resourceName, v8ModuleReferrer); + if (resourceName != null && resourceName.length() > 0) { + decorateV8Value(v8ModuleReferrer); + Lock readLock = v8ModuleLock.readLock(); + try { + readLock.lock(); + if (v8ModuleMap.containsKey(resourceName)) { + return v8ModuleMap.get(resourceName); + } + } finally { + readLock.unlock(); + } + if (v8ModuleResolver != null) { + return v8ModuleResolver.resolve(this, resourceName, v8ModuleReferrer); + } } return null; } public int getV8ModuleCount() { - return v8ModuleMap.size(); + Lock readLock = v8ModuleLock.readLock(); + try { + readLock.lock(); + return v8ModuleMap.size(); + } finally { + readLock.unlock(); + } } public IV8ModuleResolver getV8ModuleResolver() { @@ -549,6 +655,11 @@ public boolean hasOwnProperty(IV8ValueObject iV8ValueObject, V8Value key) throws return v8Native.hasOwnProperty(handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), key); } + public boolean hasPrivateProperty(IV8ValueObject iV8ValueObject, String propertyName) throws JavetException { + return v8Native.hasPrivateProperty( + handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), propertyName); + } + /** * Idle notification deadline. *

@@ -584,6 +695,7 @@ protected void initializeV8ValueCache() { } } + @CheckReturnValue public T invoke( IV8ValueObject iV8ValueObject, String functionName, boolean returnResult, V8Value... v8Values) throws JavetException { @@ -626,16 +738,20 @@ public void lowMemoryNotification() { } } + @CheckReturnValue public T moduleEvaluate( IV8Module iV8Module, boolean resultRequired) throws JavetException { return decorateV8Value((T) v8Native.moduleEvaluate( handle, iV8Module.getHandle(), iV8Module.getType().getId(), resultRequired)); } + @CheckReturnValue public V8ValueError moduleGetException(IV8Module iV8Module) throws JavetException { - return decorateV8Value((V8ValueError) v8Native.moduleGetException(handle, iV8Module.getHandle(), iV8Module.getType().getId())); + return decorateV8Value((V8ValueError) v8Native.moduleGetException( + handle, iV8Module.getHandle(), iV8Module.getType().getId())); } + @CheckReturnValue public V8ValueObject moduleGetNamespace(IV8Module iV8Module) throws JavetException { return decorateV8Value((V8ValueObject) v8Native.moduleGetNamespace( handle, iV8Module.getHandle(), iV8Module.getType().getId())); @@ -656,17 +772,20 @@ public boolean moduleInstantiate(IV8Module iV8Module) throws JavetException { return v8Native.moduleInstantiate(handle, iV8Module.getHandle(), iV8Module.getType().getId()); } + @CheckReturnValue public T promiseCatch( IV8ValuePromise iV8ValuePromise, IV8ValueFunction functionHandle) throws JavetException { return decorateV8Value((T) v8Native.promiseCatch( handle, iV8ValuePromise.getHandle(), iV8ValuePromise.getType().getId(), functionHandle.getHandle())); } + @CheckReturnValue public V8ValuePromise promiseGetPromise(V8ValuePromise v8ValuePromise) throws JavetException { return decorateV8Value((V8ValuePromise) v8Native.promiseGetPromise( handle, v8ValuePromise.getHandle(), v8ValuePromise.getType().getId())); } + @CheckReturnValue public T promiseGetResult(IV8ValuePromise iV8ValuePromise) throws JavetException { return decorateV8Value((T) v8Native.promiseGetResult( handle, iV8ValuePromise.getHandle(), iV8ValuePromise.getType().getId())); @@ -694,6 +813,7 @@ public boolean promiseResolve(V8ValuePromise v8ValuePromise, V8Value v8Value) { handle, v8ValuePromise.getHandle(), v8ValuePromise.getType().getId(), v8Value); } + @CheckReturnValue public T promiseThen( IV8ValuePromise iV8ValuePromise, IV8ValueFunction functionFulfilledHandle, IV8ValueFunction functionRejectedHandle) throws JavetException { @@ -703,11 +823,13 @@ public T promiseThen( functionRejectedHandle == null ? 0L : functionRejectedHandle.getHandle())); } + @CheckReturnValue public V8ValueObject proxyGetHandler(IV8ValueProxy iV8ValueProxy) throws JavetException { return decorateV8Value((V8ValueObject) v8Native.proxyGetHandler( handle, iV8ValueProxy.getHandle(), iV8ValueProxy.getType().getId())); } + @CheckReturnValue public V8ValueObject proxyGetTarget(IV8ValueProxy iV8ValueProxy) throws JavetException { return decorateV8Value((V8ValueObject) v8Native.proxyGetTarget( handle, iV8ValueProxy.getHandle(), iV8ValueProxy.getType().getId())); @@ -740,18 +862,30 @@ protected void removeAllReferences() throws JavetException { } public void removeCallbackContext(long handle) { - callbackContextMap.remove(handle); + Lock writeLock = callbackContextLock.writeLock(); + try { + writeLock.lock(); + callbackContextMap.remove(handle); + } finally { + writeLock.unlock(); + } } protected void removeCallbackContexts() { - if (!callbackContextMap.isEmpty()) { - final int callbackContextCount = callbackContextMap.size(); - for (long handle : callbackContextMap.keySet()) { - removeJNIGlobalRef(handle); + Lock writeLock = callbackContextLock.writeLock(); + try { + writeLock.lock(); + if (!callbackContextMap.isEmpty()) { + final int callbackContextCount = callbackContextMap.size(); + for (long handle : callbackContextMap.keySet()) { + removeJNIGlobalRef(handle); + } + logger.logWarn("{0} V8 callback context object(s) not recycled.", + Integer.toString(callbackContextCount)); + callbackContextMap.clear(); } - logger.logWarn("{0} V8 callback context object(s) not recycled.", - Integer.toString(callbackContextCount)); - callbackContextMap.clear(); + } finally { + writeLock.unlock(); } } @@ -764,7 +898,9 @@ public void removeJNIGlobalRef(long handle) { @SuppressWarnings("RedundantThrows") public void removeReference(IV8ValueReference iV8ValueReference) throws JavetException { final long referenceHandle = iV8ValueReference.getHandle(); - synchronized (referenceMap) { + Lock writeLock = referenceLock.writeLock(); + try { + writeLock.lock(); if (referenceMap.containsKey(referenceHandle)) { final int referenceType = iV8ValueReference.getType().getId(); if (referenceType == V8ValueReferenceType.Module.getId()) { @@ -773,6 +909,8 @@ public void removeReference(IV8ValueReference iV8ValueReference) throws JavetExc v8Native.removeReferenceHandle(referenceHandle, referenceType); referenceMap.remove(referenceHandle); } + } finally { + writeLock.unlock(); } if (gcScheduled) { lowMemoryNotification(); @@ -781,36 +919,49 @@ public void removeReference(IV8ValueReference iV8ValueReference) throws JavetExc } protected void removeReferences() throws JavetException { - 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; + Lock writeLock = referenceLock.writeLock(); + try { + writeLock.lock(); + 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); } - 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)); + 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(); } - referenceMap.clear(); + } finally { + writeLock.unlock(); } } public void removeV8Module(String resourceName, boolean forceClose) throws JavetException { - IV8Module iV8Module = v8ModuleMap.remove(resourceName); + IV8Module iV8Module; + Lock writeLock = v8ModuleLock.writeLock(); + try { + writeLock.lock(); + iV8Module = v8ModuleMap.remove(resourceName); + } finally { + writeLock.unlock(); + } if (forceClose && iV8Module != null) { iV8Module.close(true); } @@ -833,15 +984,21 @@ public void removeV8Modules() throws JavetException { } public void removeV8Modules(boolean forceClose) throws JavetException { - 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); + Lock writeLock = v8ModuleLock.writeLock(); + try { + writeLock.lock(); + 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(); } - v8ModuleMap.clear(); + } finally { + writeLock.unlock(); } } @@ -888,6 +1045,7 @@ public boolean sameValue(IV8ValueObject iV8ValueObject1, IV8ValueObject iV8Value return v8Native.sameValue(handle, iV8ValueObject1.getHandle(), iV8ValueObject2.getHandle()); } + @CheckReturnValue public T scriptRun( IV8Script iV8Script, boolean resultRequired) throws JavetException { return decorateV8Value((T) v8Native.scriptRun( @@ -908,11 +1066,17 @@ public boolean setAccessor( assert (propertyName instanceof V8ValueString || propertyName instanceof V8ValueSymbol); boolean isAccessorSet = v8Native.setAccessor(handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), propertyName, javetCallbackContextGetter, javetCallbackContextSetter); - if (javetCallbackContextGetter != null && javetCallbackContextGetter.isValid()) { - callbackContextMap.put(javetCallbackContextGetter.getHandle(), javetCallbackContextGetter); - } - if (javetCallbackContextSetter != null && javetCallbackContextSetter.isValid()) { - callbackContextMap.put(javetCallbackContextSetter.getHandle(), javetCallbackContextSetter); + Lock writeLock = callbackContextLock.writeLock(); + try { + writeLock.lock(); + if (javetCallbackContextGetter != null && javetCallbackContextGetter.isValid()) { + callbackContextMap.put(javetCallbackContextGetter.getHandle(), javetCallbackContextGetter); + } + if (javetCallbackContextSetter != null && javetCallbackContextSetter.isValid()) { + callbackContextMap.put(javetCallbackContextSetter.getHandle(), javetCallbackContextSetter); + } + } finally { + writeLock.unlock(); } return isAccessorSet; } @@ -934,6 +1098,13 @@ public void setLogger(IJavetLogger logger) { this.logger = logger; } + public boolean setPrivateProperty(IV8ValueObject iV8ValueObject, String propertyName, V8Value propertyValue) + throws JavetException { + decorateV8Value(propertyValue); + return v8Native.setPrivateProperty( + handle, iV8ValueObject.getHandle(), iV8ValueObject.getType().getId(), propertyName, propertyValue); + } + public void setPromiseRejectCallback(IJavetPromiseRejectCallback promiseRejectCallback) { Objects.requireNonNull(promiseRejectCallback); this.promiseRejectCallback = promiseRejectCallback; @@ -996,6 +1167,7 @@ public String toString(IV8ValueReference iV8ValueReference) throws JavetExceptio } @Override + @CheckReturnValue public V toV8Value(T object) throws JavetException { return converter.toV8Value(this, object); } diff --git a/src/main/java/com/caoccao/javet/interop/binding/MethodDescriptor.java b/src/main/java/com/caoccao/javet/interop/binding/MethodDescriptor.java index 4ad9ec6af..f4a20f91b 100644 --- a/src/main/java/com/caoccao/javet/interop/binding/MethodDescriptor.java +++ b/src/main/java/com/caoccao/javet/interop/binding/MethodDescriptor.java @@ -17,6 +17,8 @@ package com.caoccao.javet.interop.binding; +import com.caoccao.javet.enums.V8ValueSymbolType; + import java.lang.reflect.Method; /** @@ -32,11 +34,11 @@ public class MethodDescriptor { */ protected Method method; /** - * The Symbol. + * The Symbol type. * * @since 0.9.11 */ - protected boolean symbol; + protected V8ValueSymbolType symbolType; /** * The This object required. * @@ -52,7 +54,7 @@ public class MethodDescriptor { * @since 0.9.2 */ public MethodDescriptor(Method method, boolean thisObjectRequired) { - this(method, thisObjectRequired, false); + this(method, thisObjectRequired, V8ValueSymbolType.None); } /** @@ -60,12 +62,12 @@ public MethodDescriptor(Method method, boolean thisObjectRequired) { * * @param method the method * @param thisObjectRequired the this object required - * @param symbol the symbol + * @param symbolType the symbol type * @since 0.9.11 */ - public MethodDescriptor(Method method, boolean thisObjectRequired, boolean symbol) { + public MethodDescriptor(Method method, boolean thisObjectRequired, V8ValueSymbolType symbolType) { this.method = method; - this.symbol = symbol; + this.symbolType = symbolType; this.thisObjectRequired = thisObjectRequired; } @@ -80,13 +82,13 @@ public Method getMethod() { } /** - * Is symbol. + * Gets symbol type. * - * @return the boolean + * @return the symbol type * @since 0.9.11 */ - public boolean isSymbol() { - return symbol; + public V8ValueSymbolType getSymbolType() { + return symbolType; } /** diff --git a/src/main/java/com/caoccao/javet/interop/binding/package-info.java b/src/main/java/com/caoccao/javet/interop/binding/package-info.java new file mode 100644 index 000000000..1ba16e812 --- /dev/null +++ b/src/main/java/com/caoccao/javet/interop/binding/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Callback data structure for binding context and method descriptor. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.interop.binding; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/interop/callback/package-info.java b/src/main/java/com/caoccao/javet/interop/callback/package-info.java new file mode 100644 index 000000000..a1dc2fef3 --- /dev/null +++ b/src/main/java/com/caoccao/javet/interop/callback/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Callback bridge between JVM and C++ via JNI. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.interop.callback; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/interop/converters/JavetObjectConverter.java b/src/main/java/com/caoccao/javet/interop/converters/JavetObjectConverter.java index 337c13834..c057f78d4 100644 --- a/src/main/java/com/caoccao/javet/interop/converters/JavetObjectConverter.java +++ b/src/main/java/com/caoccao/javet/interop/converters/JavetObjectConverter.java @@ -32,7 +32,13 @@ import com.caoccao.javet.values.V8Value; import com.caoccao.javet.values.reference.*; +import java.lang.reflect.Constructor; +import java.lang.reflect.Executable; +import java.lang.reflect.Method; +import java.lang.reflect.Modifier; import java.util.*; +import java.util.concurrent.locks.Lock; +import java.util.concurrent.locks.ReentrantReadWriteLock; /** * The type Javet object converter. @@ -43,24 +49,71 @@ public class JavetObjectConverter extends JavetPrimitiveConverter { /** - * The constant PROPERTY_CONSTRUCTOR. + * The constant EXECUTABLE_INDEX_DEFAULT_CONSTRUCTOR. * - * @since 0.7.2 + * @since 0.9.12 + */ + protected static final int EXECUTABLE_INDEX_DEFAULT_CONSTRUCTOR = 0; + /** + * The constant EXECUTABLE_INDEX_FROM_MAP. + * + * @since 0.9.12 + */ + protected static final int EXECUTABLE_INDEX_FROM_MAP = 1; + /** + * The constant EXECUTABLE_INDEX_TO_MAP. + * + * @since 0.9.12 + */ + protected static final int EXECUTABLE_INDEX_TO_MAP = 2; + /** + * The constant METHOD_NAME_FROM_MAP. + * + * @since 0.9.12 + */ + protected static final String METHOD_NAME_FROM_MAP = "fromMap"; + /** + * The constant METHOD_NAME_TO_MAP. + * + * @since 0.9.12 + */ + protected static final String METHOD_NAME_TO_MAP = "toMap"; + /** + * The constant PRIVATE_PROPERTY_CUSTOM_OBJECT_CLASS_NAME. + * + * @since 0.9.6 + */ + protected static final String PRIVATE_PROPERTY_CUSTOM_OBJECT_CLASS_NAME = "JavetObjectConverter#customObjectClassName"; + /** + * The constant PRIVATE_PROPERTY_PROXY_TARGET. + * + * @since 0.9.6 */ - protected static final String PROPERTY_CONSTRUCTOR = "constructor"; + protected static final String PRIVATE_PROPERTY_PROXY_TARGET = "Javet#proxyTarget"; /** * The constant PROPERTY_NAME. * * @since 0.7.2 */ protected static final String PROPERTY_NAME = "name"; - /** - * The constant PROXY_TARGET. + * The constant PUBLIC_PROPERTY_CONSTRUCTOR. * - * @since 0.9.6 + * @since 0.7.2 */ - protected static final String PROXY_TARGET = "target"; + protected static final String PUBLIC_PROPERTY_CONSTRUCTOR = "constructor"; + /** + * The Custom object lock. + * + * @since 0.9.12 + */ + protected ReentrantReadWriteLock customObjectLock; + /** + * The Custom object map. + * + * @since 0.9.12 + */ + protected Map customObjectMap; /** * Instantiates a new Javet object converter. @@ -69,6 +122,8 @@ public class JavetObjectConverter extends JavetPrimitiveConverter { */ public JavetObjectConverter() { super(); + customObjectLock = new ReentrantReadWriteLock(); + customObjectMap = new HashMap<>(); } /** @@ -91,6 +146,66 @@ protected Map createEntityMap() { return new JavetEntityMap(); } + /** + * Register custom object. + * + * @param customObjectClass the custom object class + * @return true : success, false: failure + * @since 0.9.12 + */ + public boolean registerCustomObject(Class customObjectClass) { + return registerCustomObject(customObjectClass, METHOD_NAME_FROM_MAP, METHOD_NAME_TO_MAP); + } + + /** + * Register custom object. + * + * @param customObjectClass the custom object class + * @param methodNameFromMap the method name from map + * @param methodNameToMap the method name to map + * @return true : success, false: failure + * @since 0.9.12 + */ + public boolean registerCustomObject(Class customObjectClass, String methodNameFromMap, String methodNameToMap) { + if (customObjectClass == null + || methodNameFromMap == null || methodNameToMap == null + || methodNameFromMap.length() == 0 || methodNameToMap.length() == 0 + || methodNameFromMap.equals(methodNameToMap)) { + return false; + } + Lock readLock = customObjectLock.readLock(); + try { + readLock.lock(); + if (customObjectMap.containsKey(customObjectClass)) { + return false; + } + } finally { + readLock.unlock(); + } + try { + Constructor defaultConstructor = customObjectClass.getConstructor(); + Method methodFromMap = customObjectClass.getMethod(methodNameFromMap, Map.class); + if (Modifier.isStatic(methodFromMap.getModifiers())) { + return false; + } + Method methodToMap = customObjectClass.getMethod(methodNameToMap); + if (Modifier.isStatic(methodToMap.getModifiers())) { + return false; + } + Executable[] executables = new Executable[]{defaultConstructor, methodFromMap, methodToMap}; + Lock writeLock = customObjectLock.writeLock(); + try { + writeLock.lock(); + customObjectMap.put(customObjectClass.getName(), executables); + } finally { + writeLock.unlock(); + } + } catch (Throwable t) { + // Do nothing. + } + return false; + } + @Override protected Object toObject(V8Value v8Value, final int depth) throws JavetException { Object returnObject = super.toObject(v8Value, depth); @@ -160,7 +275,7 @@ protected Object toObject(V8Value v8Value, final int depth) throws JavetExceptio if (v8Value instanceof V8ValueProxy) { V8ValueProxy v8ValueProxy = (V8ValueProxy) v8Value; try (IV8ValueObject iV8ValueObjectHandler = v8ValueProxy.getHandler()) { - Long handle = iV8ValueObjectHandler.getLong(PROXY_TARGET); + Long handle = iV8ValueObjectHandler.getPrivatePropertyLong(PRIVATE_PROPERTY_PROXY_TARGET); if (handle != null) { JavetCallbackContext javetCallbackContext = v8ValueProxy.getV8Runtime().getCallbackContext(handle); if (javetCallbackContext != null) { @@ -178,8 +293,8 @@ protected Object toObject(V8Value v8Value, final int depth) throws JavetExceptio Map map = new HashMap<>(); v8ValueObject.forEach((V8Value key, V8Value value) -> { String keyString = key.toString(); - if (PROPERTY_CONSTRUCTOR.equals(keyString)) { - map.put(PROPERTY_CONSTRUCTOR, ((V8ValueObject) value).getString(PROPERTY_NAME)); + if (PUBLIC_PROPERTY_CONSTRUCTOR.equals(keyString)) { + map.put(PUBLIC_PROPERTY_CONSTRUCTOR, ((V8ValueObject) value).getString(PROPERTY_NAME)); } else { Object object = toObject(value, depth + 1); if (!(config.isSkipFunctionInObject() && object instanceof JavetEntityFunction)) { @@ -187,6 +302,35 @@ protected Object toObject(V8Value v8Value, final int depth) throws JavetExceptio } } }); + if (!customObjectMap.isEmpty() + && v8ValueObject.hasPrivateProperty(PRIVATE_PROPERTY_CUSTOM_OBJECT_CLASS_NAME)) { + String customObjectClassName = + v8ValueObject.getPrivatePropertyString(PRIVATE_PROPERTY_CUSTOM_OBJECT_CLASS_NAME); + Lock readLock = customObjectLock.readLock(); + Constructor defaultConstructor = null; + Method methodFromMap = null; + try { + readLock.lock(); + Executable[] executables = customObjectMap.get(customObjectClassName); + if (executables != null) { + defaultConstructor = (Constructor) executables[EXECUTABLE_INDEX_DEFAULT_CONSTRUCTOR]; + methodFromMap = (Method) executables[EXECUTABLE_INDEX_FROM_MAP]; + } + } catch (Throwable t) { + // Do nothing + } finally { + readLock.unlock(); + } + if (defaultConstructor != null) { + try { + Object customObject = defaultConstructor.newInstance(); + methodFromMap.invoke(customObject, map); + return customObject; + } catch (Throwable t) { + // Do nothing + } + } + } return map; } return v8Value; @@ -218,7 +362,7 @@ protected T toV8Value( new JavetUniversalProxyHandler<>(v8Runtime, (Map) object); List javetCallbackContexts = iV8ValueObjectHandler.bind(javetUniversalProxyHandler); - iV8ValueObjectHandler.set(PROXY_TARGET, javetCallbackContexts.get(0).getHandle()); + iV8ValueObjectHandler.setPrivateProperty(PRIVATE_PROPERTY_PROXY_TARGET, javetCallbackContexts.get(0).getHandle()); } v8Value = v8ValueProxy; } else { @@ -240,7 +384,7 @@ protected T toV8Value( new JavetUniversalProxyHandler<>(v8Runtime, (Set) object); List javetCallbackContexts = iV8ValueObjectHandler.bind(javetUniversalProxyHandler); - iV8ValueObjectHandler.set(PROXY_TARGET, javetCallbackContexts.get(0).getHandle()); + iV8ValueObjectHandler.setPrivateProperty(PRIVATE_PROPERTY_PROXY_TARGET, javetCallbackContexts.get(0).getHandle()); } v8Value = v8ValueProxy; } else { @@ -329,7 +473,49 @@ protected T toV8Value( } } v8Value = v8ValueArray; + } else if (!customObjectMap.isEmpty()) { + String customObjectClassName = object.getClass().getName(); + Lock readLock = customObjectLock.readLock(); + Method methodToMap = null; + try { + readLock.lock(); + Executable[] executables = customObjectMap.get(customObjectClassName); + if (executables != null) { + methodToMap = (Method) executables[EXECUTABLE_INDEX_TO_MAP]; + } + } finally { + readLock.unlock(); + } + if (methodToMap != null) { + try { + Map map = (Map) methodToMap.invoke(object); + v8Value = toV8Value(v8Runtime, map); + ((V8ValueObject) v8Value).setPrivateProperty( + PRIVATE_PROPERTY_CUSTOM_OBJECT_CLASS_NAME, customObjectClassName); + } catch (Throwable t) { + } + } } return (T) v8Runtime.decorateV8Value(v8Value); } + + /** + * Unregister custom object. + * + * @param customObjectClass the custom object class + * @return true : success, false: failure + * @since 0.9.12 + */ + public boolean unregisterCustomObject(Class customObjectClass) { + if (customObjectClass == null) { + return false; + } + Lock writeLock = customObjectLock.writeLock(); + try { + writeLock.lock(); + return customObjectMap.remove(customObjectClass) != null; + } finally { + writeLock.unlock(); + } + } } diff --git a/src/main/java/com/caoccao/javet/interop/converters/JavetProxyConverter.java b/src/main/java/com/caoccao/javet/interop/converters/JavetProxyConverter.java index b7205d076..b563f67f7 100644 --- a/src/main/java/com/caoccao/javet/interop/converters/JavetProxyConverter.java +++ b/src/main/java/com/caoccao/javet/interop/converters/JavetProxyConverter.java @@ -80,7 +80,7 @@ protected T toV8Value( JavetUniversalProxyHandler javetUniversalProxyHandler = new JavetUniversalProxyHandler<>(v8Runtime, object); List javetCallbackContexts = iV8ValueObjectHandler.bind(javetUniversalProxyHandler); - iV8ValueObjectHandler.set(PROXY_TARGET, javetCallbackContexts.get(0).getHandle()); + iV8ValueObjectHandler.setPrivateProperty(PRIVATE_PROPERTY_PROXY_TARGET, javetCallbackContexts.get(0).getHandle()); } v8Value = v8ValueProxy; return (T) v8Runtime.decorateV8Value(v8Value); diff --git a/src/main/java/com/caoccao/javet/interop/converters/package-info.java b/src/main/java/com/caoccao/javet/interop/converters/package-info.java new file mode 100644 index 000000000..c39fc9a05 --- /dev/null +++ b/src/main/java/com/caoccao/javet/interop/converters/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Built-in converters, interface and config. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.interop.converters; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/interop/engine/package-info.java b/src/main/java/com/caoccao/javet/interop/engine/package-info.java new file mode 100644 index 000000000..ca9ccc3b6 --- /dev/null +++ b/src/main/java/com/caoccao/javet/interop/engine/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Engine pool, config and guard. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.interop.engine; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/interop/executors/package-info.java b/src/main/java/com/caoccao/javet/interop/executors/package-info.java new file mode 100644 index 000000000..0cd6df65b --- /dev/null +++ b/src/main/java/com/caoccao/javet/interop/executors/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Executors and interface. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.interop.executors; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/interop/package-info.java b/src/main/java/com/caoccao/javet/interop/package-info.java new file mode 100644 index 000000000..48c06d8d6 --- /dev/null +++ b/src/main/java/com/caoccao/javet/interop/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Interoperation between JVM and C++ via JNI. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.interop; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/interop/proxy/package-info.java b/src/main/java/com/caoccao/javet/interop/proxy/package-info.java new file mode 100644 index 000000000..fe66d863e --- /dev/null +++ b/src/main/java/com/caoccao/javet/interop/proxy/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Dynamic proxy handlers for polyfilling Java interfaces with JS functions or objects. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.interop.proxy; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/node/modules/package-info.java b/src/main/java/com/caoccao/javet/node/modules/package-info.java new file mode 100644 index 000000000..af209a21e --- /dev/null +++ b/src/main/java/com/caoccao/javet/node/modules/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Reference classes for Node.js built-in modules. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.node.modules; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/utils/package-info.java b/src/main/java/com/caoccao/javet/utils/package-info.java new file mode 100644 index 000000000..fec80a012 --- /dev/null +++ b/src/main/java/com/caoccao/javet/utils/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Built-in utilities. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.utils; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/utils/receivers/package-info.java b/src/main/java/com/caoccao/javet/utils/receivers/package-info.java new file mode 100644 index 000000000..15edfacff --- /dev/null +++ b/src/main/java/com/caoccao/javet/utils/receivers/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Built-in callback receivers. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.utils.receivers; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/values/package-info.java b/src/main/java/com/caoccao/javet/values/package-info.java new file mode 100644 index 000000000..c788d59ac --- /dev/null +++ b/src/main/java/com/caoccao/javet/values/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Classes for V8 values. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.values; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/values/primitive/package-info.java b/src/main/java/com/caoccao/javet/values/primitive/package-info.java new file mode 100644 index 000000000..34afea0d2 --- /dev/null +++ b/src/main/java/com/caoccao/javet/values/primitive/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Classes for V8 primitive values. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.values.primitive; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/values/reference/IV8ValueObject.java b/src/main/java/com/caoccao/javet/values/reference/IV8ValueObject.java index 429812a1a..66ef80ff3 100644 --- a/src/main/java/com/caoccao/javet/values/reference/IV8ValueObject.java +++ b/src/main/java/com/caoccao/javet/values/reference/IV8ValueObject.java @@ -32,6 +32,7 @@ import java.time.ZonedDateTime; import java.util.List; +import java.util.Objects; /** * The interface V8 value object. @@ -80,6 +81,8 @@ public interface IV8ValueObject extends IV8ValueReference { * @since 0.8.9 */ default boolean bindFunction(String functionName, String codeString) throws JavetException { + Objects.requireNonNull(functionName); + Objects.requireNonNull(codeString); try (V8ValueFunction v8ValueFunction = getV8Runtime().createV8ValueFunction(codeString)) { return set(functionName, v8ValueFunction); } @@ -114,6 +117,7 @@ default boolean bindProperty( String propertyName, JavetCallbackContext javetCallbackContextGetter, JavetCallbackContext javetCallbackContextSetter) throws JavetException { + Objects.requireNonNull(propertyName); return bindProperty( getV8Runtime().createV8ValueString(propertyName), javetCallbackContextGetter, @@ -201,6 +205,16 @@ default boolean deleteNull() throws JavetException { return delete(getV8Runtime().createV8ValueNull()); } + /** + * Delete private property boolean. + * + * @param propertyName the property name + * @return the boolean + * @throws JavetException the javet exception + * @since 0.9.12 + */ + boolean deletePrivateProperty(String propertyName) throws JavetException; + /** * Delete undefined boolean. * @@ -417,6 +431,167 @@ default > R getPrimitive(Object key) throws Jav return null; } + /** + * Gets private property. + * + * @param the type parameter + * @param propertyName the property name + * @return the private property + * @throws JavetException the javet exception + * @since 0.9.12 + */ + @CheckReturnValue + T getPrivateProperty(String propertyName) throws JavetException; + + /** + * Gets private property boolean. + * + * @param propertyName the property name + * @return the private property boolean + * @throws JavetException the javet exception + * @since 0.9.12 + */ + default Boolean getPrivatePropertyBoolean(String propertyName) throws JavetException { + return getPrivatePropertyPrimitive(propertyName); + } + + /** + * Gets private property double. + * + * @param propertyName the property name + * @return the private property double + * @throws JavetException the javet exception + * @since 0.9.12 + */ + default Double getPrivatePropertyDouble(String propertyName) throws JavetException { + return getPrivatePropertyPrimitive(propertyName); + } + + /** + * Gets private property float. + * + * @param propertyName the property name + * @return the private property float + * @throws JavetException the javet exception + * @since 0.9.12 + */ + default Float getPrivatePropertyFloat(String propertyName) throws JavetException { + Double result = getPrivatePropertyDouble(propertyName); + return result == null ? null : result.floatValue(); + } + + /** + * Gets private property integer. + * + * @param propertyName the property name + * @return the private property integer + * @throws JavetException the javet exception + * @since 0.9.12 + */ + default Integer getPrivatePropertyInteger(String propertyName) throws JavetException { + return getPrivatePropertyPrimitive(propertyName); + } + + /** + * Gets private property long. + * + * @param propertyName the property name + * @return the private property long + * @throws JavetException the javet exception + * @since 0.9.12 + */ + default Long getPrivatePropertyLong(String propertyName) throws JavetException { + return getPrivatePropertyPrimitive(propertyName); + } + + /** + * Gets private property null. + * + * @param propertyName the property name + * @return the private property null + * @throws JavetException the javet exception + * @since 0.9.12 + */ + default V8ValueNull getPrivatePropertyNull(String propertyName) throws JavetException { + return getPrivateProperty(propertyName); + } + + /** + * Gets private property object. + * + * @param the type parameter + * @param propertyName the property name + * @return the private property object + * @throws JavetException the javet exception + * @since 0.9.12 + */ + default T getPrivatePropertyObject(String propertyName) throws JavetException { + try { + return getV8Runtime().toObject(getPrivateProperty(propertyName), true); + } catch (JavetException e) { + throw e; + } catch (Throwable t) { + return null; + } + } + + /** + * Gets private property primitive. + * + * @param the type parameter + * @param the type parameter + * @param propertyName the property name + * @return the private property primitive + * @throws JavetException the javet exception + * @since 0.9.12 + */ + default > R getPrivatePropertyPrimitive(String propertyName) + throws JavetException { + try (V8Value v8Value = getPrivateProperty(propertyName)) { + return ((T) v8Value).getValue(); + } catch (JavetException e) { + throw e; + } catch (Throwable ignored) { + } + return null; + } + + /** + * Gets private property string. + * + * @param propertyName the property name + * @return the private property string + * @throws JavetException the javet exception + * @since 0.9.12 + */ + default String getPrivatePropertyString(String propertyName) throws JavetException { + return getPrivatePropertyPrimitive(propertyName); + } + + /** + * Gets private property undefined. + * + * @param propertyName the property name + * @return the private property undefined + * @throws JavetException the javet exception + * @since 0.9.12 + */ + default V8ValueUndefined getPrivatePropertyUndefined(String propertyName) throws JavetException { + return getPrivateProperty(propertyName); + } + + /** + * Gets private property zoned date time. + * + * @param propertyName the property name + * @return the private property zoned date time + * @throws JavetException the javet exception + * @since 0.9.12 + */ + default ZonedDateTime getPrivatePropertyZonedDateTime(String propertyName) throws JavetException { + return getPrivatePropertyPrimitive(propertyName); + } + /** * Gets property. * @@ -434,9 +609,10 @@ default > R getPrimitive(Object key) throws Jav * * @param key the key * @return the property boolean + * @throws JavetException the javet exception * @since 0.7.0 */ - default Boolean getPropertyBoolean(Object key) { + default Boolean getPropertyBoolean(Object key) throws JavetException { return getPropertyPrimitive(key); } @@ -445,9 +621,10 @@ default Boolean getPropertyBoolean(Object key) { * * @param key the key * @return the property double + * @throws JavetException the javet exception * @since 0.7.0 */ - default Double getPropertyDouble(Object key) { + default Double getPropertyDouble(Object key) throws JavetException { return getPropertyPrimitive(key); } @@ -456,9 +633,10 @@ default Double getPropertyDouble(Object key) { * * @param key the key * @return the property float + * @throws JavetException the javet exception * @since 0.7.0 */ - default Float getPropertyFloat(Object key) { + default Float getPropertyFloat(Object key) throws JavetException { Double result = getPropertyDouble(key); return result == null ? null : result.floatValue(); } @@ -468,9 +646,10 @@ default Float getPropertyFloat(Object key) { * * @param key the key * @return the property integer + * @throws JavetException the javet exception * @since 0.7.0 */ - default Integer getPropertyInteger(Object key) { + default Integer getPropertyInteger(Object key) throws JavetException { return getPropertyPrimitive(key); } @@ -479,9 +658,10 @@ default Integer getPropertyInteger(Object key) { * * @param key the key * @return the property long + * @throws JavetException the javet exception * @since 0.7.0 */ - default Long getPropertyLong(Object key) { + default Long getPropertyLong(Object key) throws JavetException { return getPropertyPrimitive(key); } @@ -520,11 +700,14 @@ default T getPropertyObject(Object key) throws JavetException { * @param the type parameter * @param key the key * @return the property primitive + * @throws JavetException the javet exception * @since 0.7.0 */ - default > R getPropertyPrimitive(Object key) { + default > R getPropertyPrimitive(Object key) throws JavetException { try (V8Value v8Value = getProperty(key)) { return ((T) v8Value).getValue(); + } catch (JavetException e) { + throw e; } catch (Throwable ignored) { } return null; @@ -535,9 +718,10 @@ default > R getPropertyPrimitive(Object key) { * * @param key the key * @return the property string + * @throws JavetException the javet exception * @since 0.7.0 */ - default String getPropertyString(Object key) { + default String getPropertyString(Object key) throws JavetException { return getPropertyPrimitive(key); } @@ -546,9 +730,10 @@ default String getPropertyString(Object key) { * * @param key the key * @return the property zoned date time + * @throws JavetException the javet exception * @since 0.7.0 */ - default ZonedDateTime getPropertyZonedDateTime(Object key) { + default ZonedDateTime getPropertyZonedDateTime(Object key) throws JavetException { return getPropertyPrimitive(key); } @@ -630,6 +815,16 @@ default boolean hasNull() throws JavetException { */ boolean hasOwnProperty(Object key) throws JavetException; + /** + * Has private property boolean. + * + * @param propertyName the property name + * @return the boolean + * @throws JavetException the javet exception + * @since 0.9.12 + */ + boolean hasPrivateProperty(String propertyName) throws JavetException; + /** * Has undefined property key. * @@ -872,6 +1067,41 @@ default boolean setNull(Object key) throws JavetException { return set(key, getV8Runtime().createV8ValueNull()); } + /** + * Sets private property. + * + * @param propertyName the property name + * @param propertyValue the property value + * @return true : set, false: not set + * @throws JavetException the javet exception + * @since 0.9.12 + */ + boolean setPrivateProperty(String propertyName, Object propertyValue) throws JavetException; + + /** + * Sets private property null. + * + * @param propertyKey the property key + * @return true : set, false: not set + * @throws JavetException the javet exception + * @since 0.9.12 + */ + default boolean setPrivatePropertyNull(String propertyKey) throws JavetException { + return setPrivateProperty(propertyKey, getV8Runtime().createV8ValueNull()); + } + + /** + * Sets private property undefined. + * + * @param propertyKey the property key + * @return true : set, false: not set + * @throws JavetException the javet exception + * @since 0.9.12 + */ + default boolean setPrivatePropertyUndefined(String propertyKey) throws JavetException { + return setPrivateProperty(propertyKey, getV8Runtime().createV8ValueUndefined()); + } + /** * Sets property. * @@ -887,7 +1117,7 @@ default boolean setNull(Object key) throws JavetException { * Sets property null. * * @param key the key - * @return the property null + * @return true : set, false: not set * @throws JavetException the javet exception * @since 0.7.0 */ @@ -978,6 +1208,7 @@ default boolean setUndefined(Object key) throws JavetException { * @since 0.9.11 */ default boolean unbindProperty(String propertyName) throws JavetException { + Objects.requireNonNull(propertyName); return unbindProperty(getV8Runtime().createV8ValueString(propertyName)); } diff --git a/src/main/java/com/caoccao/javet/values/reference/V8ValueObject.java b/src/main/java/com/caoccao/javet/values/reference/V8ValueObject.java index e3b395572..f18912fb8 100644 --- a/src/main/java/com/caoccao/javet/values/reference/V8ValueObject.java +++ b/src/main/java/com/caoccao/javet/values/reference/V8ValueObject.java @@ -19,6 +19,7 @@ import com.caoccao.javet.annotations.*; import com.caoccao.javet.enums.V8ValueReferenceType; +import com.caoccao.javet.enums.V8ValueSymbolType; import com.caoccao.javet.exceptions.JavetError; import com.caoccao.javet.exceptions.JavetException; import com.caoccao.javet.interfaces.IJavetBiConsumer; @@ -33,6 +34,7 @@ import com.caoccao.javet.values.V8Value; import com.caoccao.javet.values.primitive.V8ValueString; import com.caoccao.javet.values.reference.builtin.V8ValueBuiltInJson; +import com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol; import com.caoccao.javet.values.virtual.V8VirtualValue; import com.caoccao.javet.values.virtual.V8VirtualValueList; @@ -103,10 +105,20 @@ public List bind(Object callbackReceiver) throws JavetExce setterMethodDescriptor.getMethod(), setterMethodDescriptor.isThisObjectRequired()); javetCallbackContexts.add(javetCallbackContextSetter); } - if (getterMethodDescriptor.isSymbol()) { + if (getterMethodDescriptor.getSymbolType() == V8ValueSymbolType.Custom) { try (V8ValueSymbol v8ValueSymbol = v8Runtime.createV8ValueSymbol(propertyName, true)) { bindProperty(v8ValueSymbol, javetCallbackContextGetter, javetCallbackContextSetter); } + } else if (getterMethodDescriptor.getSymbolType() == V8ValueSymbolType.BuiltIn) { + try (V8ValueBuiltInSymbol v8ValueBuiltInSymbol = v8Runtime.getGlobalObject().getBuiltInSymbol(); + V8ValueSymbol v8ValueSymbol = v8ValueBuiltInSymbol.getBuiltInSymbol(propertyName)) { + if (v8ValueSymbol == null) { + throw new JavetException( + JavetError.ConverterSymbolNotBuiltIn, + SimpleMap.of(JavetError.PARAMETER_SYMBOL, propertyName)); + } + bindProperty(v8ValueSymbol, javetCallbackContextGetter, javetCallbackContextSetter); + } } else { bindProperty(propertyName, javetCallbackContextGetter, javetCallbackContextSetter); } @@ -151,6 +163,8 @@ public List bind(Object callbackReceiver) throws JavetExce @Override public boolean bindFunction(String functionName, JavetCallbackContext javetCallbackContext) throws JavetException { + Objects.requireNonNull(functionName); + Objects.requireNonNull(javetCallbackContext); try (V8ValueFunction v8ValueFunction = getV8Runtime().createV8ValueFunction(javetCallbackContext)) { return set(functionName, v8ValueFunction); } @@ -161,6 +175,7 @@ public boolean bindProperty( V8ValueString propertyName, JavetCallbackContext javetCallbackContextGetter, JavetCallbackContext javetCallbackContextSetter) throws JavetException { + Objects.requireNonNull(propertyName); Objects.requireNonNull(javetCallbackContextGetter); checkV8Runtime(); return v8Runtime.setAccessor( @@ -172,6 +187,7 @@ public boolean bindProperty( V8ValueSymbol propertyName, JavetCallbackContext javetCallbackContextGetter, JavetCallbackContext javetCallbackContextSetter) throws JavetException { + Objects.requireNonNull(propertyName); Objects.requireNonNull(javetCallbackContextGetter); checkV8Runtime(); return v8Runtime.setAccessor( @@ -180,12 +196,20 @@ public boolean bindProperty( @Override public boolean delete(Object key) throws JavetException { + Objects.requireNonNull(key); checkV8Runtime(); try (V8VirtualValue virtualKey = new V8VirtualValue(v8Runtime, key)) { return v8Runtime.delete(this, virtualKey.get()); } } + @Override + public boolean deletePrivateProperty(String propertyName) throws JavetException { + Objects.requireNonNull(propertyName); + checkV8Runtime(); + return v8Runtime.deletePrivateProperty(this, propertyName); + } + @Override public int forEach( IJavetUniConsumer consumer) throws JavetException, E { @@ -233,6 +257,7 @@ public int for @Override @CheckReturnValue public T get(Object key) throws JavetException { + Objects.requireNonNull(key); checkV8Runtime(); try (V8VirtualValue virtualKey = new V8VirtualValue(v8Runtime, key)) { return v8Runtime.get(this, virtualKey.get()); @@ -240,6 +265,7 @@ public T get(Object key) throws JavetException { } protected BindingContext getBindingContext(Class callbackReceiverClass) throws JavetException { + Objects.requireNonNull(callbackReceiverClass); Map, BindingContext> bindingContextWeakHashMap = v8Runtime.getBindingContextWeakHashMap(); BindingContext bindingContext = bindingContextWeakHashMap.get(callbackReceiverClass); if (bindingContext == null) { @@ -272,14 +298,14 @@ protected BindingContext getBindingContext(Class callbackReceiverClass) throw if (!propertyGetterMap.containsKey(propertyName)) { propertyGetterMap.put( propertyName, - new MethodDescriptor(method, v8Property.thisObjectRequired(), v8Property.symbol())); + new MethodDescriptor(method, v8Property.thisObjectRequired(), v8Property.symbolType())); } } else if (method.getParameterCount() == expectedSetterParameterCount) { // Duplicated property name will be dropped. if (!propertySetterMap.containsKey(propertyName)) { propertySetterMap.put( propertyName, - new MethodDescriptor(method, v8Property.thisObjectRequired(), v8Property.symbol())); + new MethodDescriptor(method, v8Property.thisObjectRequired(), v8Property.symbolType())); } } else { throw new JavetException(JavetError.CallbackSignatureParameterSizeMismatch, @@ -353,9 +379,17 @@ public IV8ValueArray getOwnPropertyNames() throws JavetException { return v8Runtime.getOwnPropertyNames(this); } + @Override + public T getPrivateProperty(String propertyName) throws JavetException { + Objects.requireNonNull(propertyName); + checkV8Runtime(); + return v8Runtime.getPrivateProperty(this, propertyName); + } + @Override @CheckReturnValue public T getProperty(Object key) throws JavetException { + Objects.requireNonNull(key); checkV8Runtime(); try (V8VirtualValue virtualKey = new V8VirtualValue(v8Runtime, key)) { return v8Runtime.getProperty(this, virtualKey.get()); @@ -381,6 +415,7 @@ public V8ValueReferenceType getType() { @Override public boolean has(Object value) throws JavetException { + Objects.requireNonNull(value); checkV8Runtime(); try (V8VirtualValue virtualValue = new V8VirtualValue(v8Runtime, value)) { return v8Runtime.has(this, virtualValue.get()); @@ -389,16 +424,25 @@ public boolean has(Object value) throws JavetException { @Override public boolean hasOwnProperty(Object key) throws JavetException { + Objects.requireNonNull(key); checkV8Runtime(); try (V8VirtualValue virtualKey = new V8VirtualValue(v8Runtime, key)) { return v8Runtime.hasOwnProperty(this, virtualKey.get()); } } + @Override + public boolean hasPrivateProperty(String propertyName) throws JavetException { + Objects.requireNonNull(propertyName); + checkV8Runtime(); + return v8Runtime.hasPrivateProperty(this, Objects.requireNonNull(propertyName)); + } + @Override @CheckReturnValue public T invokeExtended(String functionName, boolean returnResult, Object... objects) throws JavetException { + Objects.requireNonNull(functionName); checkV8Runtime(); try (V8VirtualValueList virtualValueList = new V8VirtualValueList(v8Runtime, objects)) { return v8Runtime.invoke(this, functionName, returnResult, virtualValueList.get()); @@ -409,8 +453,8 @@ public T invokeExtended(String functionName, boolean returnR @CheckReturnValue public T invokeExtended(String functionName, boolean returnResult, V8Value... v8Values) throws JavetException { + Objects.requireNonNull(functionName); checkV8Runtime(); - v8Runtime.decorateV8Values(v8Values); return v8Runtime.invoke(this, functionName, returnResult, v8Values); } @@ -431,6 +475,7 @@ public boolean sameValue(V8Value v8Value) throws JavetException { @Override public boolean set(Object key, Object value) throws JavetException { + Objects.requireNonNull(key); checkV8Runtime(); try (V8VirtualValue virtualKey = new V8VirtualValue(v8Runtime, key); V8VirtualValue virtualValue = new V8VirtualValue(v8Runtime, value)) { @@ -438,8 +483,18 @@ public boolean set(Object key, Object value) throws JavetException { } } + @Override + public boolean setPrivateProperty(String propertyName, Object propertyValue) throws JavetException { + Objects.requireNonNull(propertyName); + checkV8Runtime(); + try (V8VirtualValue virtualValue = new V8VirtualValue(v8Runtime, propertyValue)) { + return v8Runtime.setPrivateProperty(this, propertyName, virtualValue.get()); + } + } + @Override public boolean setProperty(Object key, Object value) throws JavetException { + Objects.requireNonNull(key); checkV8Runtime(); try (V8VirtualValue virtualKey = new V8VirtualValue(v8Runtime, key); V8VirtualValue virtualValue = new V8VirtualValue(v8Runtime, value)) { @@ -449,6 +504,7 @@ public boolean setProperty(Object key, Object value) throws JavetException { @Override public boolean setPrototype(IV8ValueObject v8ValueObject) throws JavetException { + Objects.requireNonNull(v8ValueObject); return set(PROPERTY_PROTOTYPE, v8ValueObject); } @@ -507,12 +563,24 @@ public int unbind(Object callbackReceiver) throws JavetException { callbackReceiver, getterMethodDescriptor.getMethod().getName())) { continue; } - if (getterMethodDescriptor.isSymbol()) { + if (getterMethodDescriptor.getSymbolType() == V8ValueSymbolType.Custom) { try (V8ValueSymbol v8ValueSymbol = v8Runtime.createV8ValueSymbol(propertyName, true)) { if (unbindProperty(v8ValueSymbol)) { ++unbindCount; } } + } else if (getterMethodDescriptor.getSymbolType() == V8ValueSymbolType.BuiltIn) { + try (V8ValueBuiltInSymbol v8ValueBuiltInSymbol = v8Runtime.getGlobalObject().getBuiltInSymbol(); + V8ValueSymbol v8ValueSymbol = v8ValueBuiltInSymbol.getBuiltInSymbol(propertyName)) { + if (v8ValueSymbol == null) { + throw new JavetException( + JavetError.ConverterSymbolNotBuiltIn, + SimpleMap.of(JavetError.PARAMETER_SYMBOL, propertyName)); + } + if (unbindProperty(v8ValueSymbol)) { + ++unbindCount; + } + } } else { if (unbindProperty(propertyName)) { ++unbindCount; @@ -560,6 +628,7 @@ public boolean unbindFunction(String functionName) throws JavetException { @Override public boolean unbindProperty(V8ValueString propertyName) throws JavetException { + Objects.requireNonNull(propertyName); checkV8Runtime(); return v8Runtime.setAccessor( this, propertyName, null, null); @@ -567,6 +636,7 @@ public boolean unbindProperty(V8ValueString propertyName) throws JavetException @Override public boolean unbindProperty(V8ValueSymbol propertyName) throws JavetException { + Objects.requireNonNull(propertyName); checkV8Runtime(); return v8Runtime.setAccessor( this, propertyName, null, null); diff --git a/src/main/java/com/caoccao/javet/values/reference/V8ValueSharedArrayBuffer.java b/src/main/java/com/caoccao/javet/values/reference/V8ValueSharedArrayBuffer.java new file mode 100644 index 000000000..ee2ca1428 --- /dev/null +++ b/src/main/java/com/caoccao/javet/values/reference/V8ValueSharedArrayBuffer.java @@ -0,0 +1,33 @@ +/* + * Copyright (c) 2021. caoccao.com Sam Cao + * All rights reserved. + * + * 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.values.reference; + +import com.caoccao.javet.enums.V8ValueReferenceType; + +import java.nio.ByteBuffer; + +public class V8ValueSharedArrayBuffer extends V8ValueArrayBuffer { + V8ValueSharedArrayBuffer(long handle, ByteBuffer byteBuffer) { + super(handle, byteBuffer); + } + + @Override + public V8ValueReferenceType getType() { + return V8ValueReferenceType.SharedArrayBuffer; + } +} diff --git a/src/main/java/com/caoccao/javet/values/reference/builtin/V8ValueBuiltInSymbol.java b/src/main/java/com/caoccao/javet/values/reference/builtin/V8ValueBuiltInSymbol.java index 00f9abf2e..f29af44a9 100644 --- a/src/main/java/com/caoccao/javet/values/reference/builtin/V8ValueBuiltInSymbol.java +++ b/src/main/java/com/caoccao/javet/values/reference/builtin/V8ValueBuiltInSymbol.java @@ -19,9 +19,13 @@ import com.caoccao.javet.annotations.CheckReturnValue; import com.caoccao.javet.exceptions.JavetException; +import com.caoccao.javet.interfaces.IJavetSupplier; import com.caoccao.javet.values.reference.V8ValueFunction; import com.caoccao.javet.values.reference.V8ValueSymbol; +import java.util.HashMap; +import java.util.Map; + @SuppressWarnings("unchecked") public class V8ValueBuiltInSymbol extends V8ValueFunction { @@ -40,9 +44,26 @@ public class V8ValueBuiltInSymbol extends V8ValueFunction { public static final String PROPERTY_UNSCOPABLES = "unscopables"; public static final String FUNCTION_FOR = "for"; public static final String FUNCTION_KEY_FOR = "keyFor"; + public static final String PREFIX_PROPERTY = "PROPERTY_"; + + protected Map> builtInSymbolMap; public V8ValueBuiltInSymbol(long handle) { super(handle); + builtInSymbolMap = new HashMap<>(); + builtInSymbolMap.put(PROPERTY_ASYNC_ITERATOR, this::getAsyncIterator); + builtInSymbolMap.put(PROPERTY_HAS_INSTANCE, this::getHasInstance); + builtInSymbolMap.put(PROPERTY_IS_CONCAT_SPREADABLE, this::getIsConcatSpreadable); + builtInSymbolMap.put(PROPERTY_ITERATOR, this::getIterator); + builtInSymbolMap.put(PROPERTY_MATCH, this::getMatch); + builtInSymbolMap.put(PROPERTY_MATCH_ALL, this::getMatchAll); + builtInSymbolMap.put(PROPERTY_REPLACE, this::getReplace); + builtInSymbolMap.put(PROPERTY_SEARCH, this::getSearch); + builtInSymbolMap.put(PROPERTY_SPECIES, this::getSpecies); + builtInSymbolMap.put(PROPERTY_SPLIT, this::getSplit); + builtInSymbolMap.put(PROPERTY_TO_PRIMITIVE, this::getToPrimitive); + builtInSymbolMap.put(PROPERTY_TO_STRING_TAG, this::getToStringTag); + builtInSymbolMap.put(PROPERTY_UNSCOPABLES, this::getUnscopables); } @CheckReturnValue @@ -55,6 +76,18 @@ public V8ValueSymbol getAsyncIterator() throws JavetException { return get(PROPERTY_ASYNC_ITERATOR); } + @CheckReturnValue + public V8ValueSymbol getBuiltInSymbol(String description) throws JavetException { + IJavetSupplier iJavetSupplier = builtInSymbolMap.get(description); + if (iJavetSupplier != null) { + try { + return iJavetSupplier.get(); + } catch (Throwable e) { + } + } + return null; + } + @CheckReturnValue public V8ValueSymbol getHasInstance() throws JavetException { return get(PROPERTY_HAS_INSTANCE); diff --git a/src/main/java/com/caoccao/javet/values/reference/builtin/package-info.java b/src/main/java/com/caoccao/javet/values/reference/builtin/package-info.java new file mode 100644 index 000000000..02142010f --- /dev/null +++ b/src/main/java/com/caoccao/javet/values/reference/builtin/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Classes for V8 built-in reference values. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.values.reference.builtin; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/values/reference/package-info.java b/src/main/java/com/caoccao/javet/values/reference/package-info.java new file mode 100644 index 000000000..7e26d4d67 --- /dev/null +++ b/src/main/java/com/caoccao/javet/values/reference/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Classes for V8 reference values. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.values.reference; \ No newline at end of file diff --git a/src/main/java/com/caoccao/javet/values/virtual/V8VirtualValue.java b/src/main/java/com/caoccao/javet/values/virtual/V8VirtualValue.java index 882923c31..a095863bb 100644 --- a/src/main/java/com/caoccao/javet/values/virtual/V8VirtualValue.java +++ b/src/main/java/com/caoccao/javet/values/virtual/V8VirtualValue.java @@ -23,6 +23,8 @@ import com.caoccao.javet.utils.JavetResourceUtils; import com.caoccao.javet.values.V8Value; +import java.util.Objects; + /** * The type V8 virtual value. * @@ -54,6 +56,7 @@ public class V8VirtualValue implements IJavetClosable { * @since 0.8.5 */ public V8VirtualValue(V8Runtime v8Runtime, Object object) throws JavetException { + Objects.requireNonNull(v8Runtime); if (object instanceof V8Value) { converted = false; value = (V8Value) object; diff --git a/src/main/java/com/caoccao/javet/values/virtual/V8VirtualValueList.java b/src/main/java/com/caoccao/javet/values/virtual/V8VirtualValueList.java index 48f0b8ca9..ca10e390d 100644 --- a/src/main/java/com/caoccao/javet/values/virtual/V8VirtualValueList.java +++ b/src/main/java/com/caoccao/javet/values/virtual/V8VirtualValueList.java @@ -25,6 +25,7 @@ import java.util.ArrayList; import java.util.List; +import java.util.Objects; /** * The type V8 virtual value list. @@ -55,6 +56,7 @@ public class V8VirtualValueList implements IJavetClosable { * @since 0.8.5 */ public V8VirtualValueList(V8Runtime v8Runtime, Object... objects) throws JavetException { + Objects.requireNonNull(v8Runtime); if (objects == null || objects.length == 0) { toBeClosedValues = null; values = null; diff --git a/src/main/java/com/caoccao/javet/values/virtual/package-info.java b/src/main/java/com/caoccao/javet/values/virtual/package-info.java new file mode 100644 index 000000000..34d9bb0e4 --- /dev/null +++ b/src/main/java/com/caoccao/javet/values/virtual/package-info.java @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2021. 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. + */ + +/** + * Classes for V8 virtual reference values. + * + * @since 0.7.0 + * @author Sam Cao + */ +package com.caoccao.javet.values.virtual; \ No newline at end of file diff --git a/src/test/java/com/caoccao/javet/interop/converters/TestJavetObjectConverter.java b/src/test/java/com/caoccao/javet/interop/converters/TestJavetObjectConverter.java index c04a92be4..aa6c469c5 100644 --- a/src/test/java/com/caoccao/javet/interop/converters/TestJavetObjectConverter.java +++ b/src/test/java/com/caoccao/javet/interop/converters/TestJavetObjectConverter.java @@ -142,6 +142,30 @@ public void testCircularStructure() throws JavetException { } } + @Test + public void testCustomObject() throws JavetException { + IJavetConverter originalConverter = v8Runtime.getConverter(); + JavetObjectConverter converter = new JavetObjectConverter(); + converter.registerCustomObject(CustomObject.class); + v8Runtime.setConverter(converter); + CustomObject[] customObjects = new CustomObject[]{ + new CustomObject("x", 1), + new CustomObject("y", 2), + }; + v8Runtime.getGlobalObject().set("a", customObjects); + assertEquals(2, v8Runtime.getExecutor("a.length").executeInteger()); + List v8CustomObjects = v8Runtime.getGlobalObject().getObject("a"); + assertNotNull(v8CustomObjects); + assertEquals(2, v8CustomObjects.size()); + for (int i = 0; i < customObjects.length; i++) { + assertEquals(customObjects[i].getName(), v8Runtime.getExecutor("a[" + i + "].name").executeString()); + assertEquals(customObjects[i].getValue(), v8Runtime.getExecutor("a[" + i + "].value").executeInteger()); + assertEquals(customObjects[i].getName(), v8CustomObjects.get(i).getName()); + assertEquals(customObjects[i].getValue(), v8CustomObjects.get(i).getValue()); + } + v8Runtime.setConverter(originalConverter); + } + @Test public void testMap() throws JavetException { IJavetConverter converter = new JavetObjectConverter(); @@ -336,4 +360,48 @@ public void testTypedArrayShortArray() throws JavetException { assertArrayEquals(shorts, newShorts); } } + + static final class CustomObject { + private String name; + private int value; + + public CustomObject(String name, int value) { + this.name = name; + this.value = value; + } + + public CustomObject() { + this(null, 0); + } + + public void fromMap(Map map) { + setName((String) map.get("name")); + setValue((Integer) map.get("value")); + } + + public String getName() { + return name; + } + + public int getValue() { + return value; + } + + public void setName(String name) { + this.name = name; + } + + public void setValue(int value) { + this.value = value; + } + + public Map toMap() { + return new HashMap() { + { + put("name", getName()); + put("value", getValue()); + } + }; + } + } } diff --git a/src/test/java/com/caoccao/javet/mock/MockAnnotationBasedCallbackReceiver.java b/src/test/java/com/caoccao/javet/mock/MockAnnotationBasedCallbackReceiver.java index f37df14e6..f0938a0ac 100644 --- a/src/test/java/com/caoccao/javet/mock/MockAnnotationBasedCallbackReceiver.java +++ b/src/test/java/com/caoccao/javet/mock/MockAnnotationBasedCallbackReceiver.java @@ -21,6 +21,7 @@ import com.caoccao.javet.annotations.V8Function; import com.caoccao.javet.annotations.V8Property; import com.caoccao.javet.annotations.V8RuntimeSetter; +import com.caoccao.javet.enums.V8ValueSymbolType; import com.caoccao.javet.exceptions.JavetException; import com.caoccao.javet.interop.V8Runtime; import com.caoccao.javet.values.reference.V8ValueArray; @@ -119,7 +120,7 @@ public String getStringValueWithThis(V8ValueObject thisObject) throws JavetExcep return thisObject.getString("stringValue"); } - @V8Property(symbol = true) + @V8Property(symbolType = V8ValueSymbolType.Custom) public String getSymbolValue() { count.incrementAndGet(); return symbolValue; @@ -214,7 +215,7 @@ public void setStringValueWithThis(V8ValueObject thisObject, String stringValue) thisObject.set("stringValue", stringValue); } - @V8Property(symbol = true) + @V8Property(symbolType = V8ValueSymbolType.Custom) public void setSymbolValue(String symbolValue) { count.incrementAndGet(); this.symbolValue = symbolValue; @@ -225,4 +226,10 @@ public void setSymbolValue(String symbolValue) { public void setV8Runtime(V8Runtime v8Runtime) { this.v8Runtime = v8Runtime; } + + @V8Property(name = "toPrimitive", symbolType = V8ValueSymbolType.BuiltIn) + public Integer toPrimitive() { + count.incrementAndGet(); + return 1000; + } } diff --git a/src/test/java/com/caoccao/javet/values/reference/TestV8ValueFunction.java b/src/test/java/com/caoccao/javet/values/reference/TestV8ValueFunction.java index 095f49022..3118b9027 100644 --- a/src/test/java/com/caoccao/javet/values/reference/TestV8ValueFunction.java +++ b/src/test/java/com/caoccao/javet/values/reference/TestV8ValueFunction.java @@ -48,7 +48,7 @@ public void testAnnotationBasedFunctions() throws JavetException { new MockAnnotationBasedCallbackReceiver(); List javetCallbackContexts = v8ValueObject.bind(mockAnnotationBasedCallbackReceiver); - assertEquals(22, javetCallbackContexts.size()); + assertEquals(23, javetCallbackContexts.size()); assertEquals(0, mockAnnotationBasedCallbackReceiver.getCount()); assertEquals("test", v8Runtime.getExecutor("a.echo('test')").executeString()); assertEquals(1, mockAnnotationBasedCallbackReceiver.getCount()); @@ -110,7 +110,7 @@ public void testAnnotationBasedFunctions() throws JavetException { assertEquals(1, v8Runtime.getExecutor("a.primitiveAddShort(1, undefined)").executeInteger()); assertEquals(String.valueOf((char) 1), v8Runtime.getExecutor("a.primitiveIncreaseChar(null)").executeString()); assertEquals(String.valueOf((char) 1), v8Runtime.getExecutor("a.primitiveIncreaseChar(undefined)").executeString()); - assertEquals(19, v8ValueObject.unbind(mockAnnotationBasedCallbackReceiver)); + assertEquals(20, v8ValueObject.unbind(mockAnnotationBasedCallbackReceiver)); try { v8Runtime.getExecutor("a.echo('test')").executeVoid(); fail("Failed to throw an exception"); @@ -129,7 +129,7 @@ public void testAnnotationBasedFunctionsAndProperties() throws JavetException { new MockAnnotationBasedCallbackReceiver(); List javetCallbackContexts = v8ValueObject.bind(mockAnnotationBasedCallbackReceiver); - assertEquals(22, javetCallbackContexts.size()); + assertEquals(23, javetCallbackContexts.size()); assertEquals(0, mockAnnotationBasedCallbackReceiver.getCount()); assertEquals(123, v8Runtime.getExecutor("a.integerValue").executeInteger()); assertEquals(1, mockAnnotationBasedCallbackReceiver.getCount()); diff --git a/src/test/java/com/caoccao/javet/values/reference/TestV8ValueObject.java b/src/test/java/com/caoccao/javet/values/reference/TestV8ValueObject.java index 280474b64..daeaf3910 100644 --- a/src/test/java/com/caoccao/javet/values/reference/TestV8ValueObject.java +++ b/src/test/java/com/caoccao/javet/values/reference/TestV8ValueObject.java @@ -45,7 +45,7 @@ public void testAnnotationBasedProperties() throws JavetException { new MockAnnotationBasedCallbackReceiver(); List javetCallbackContexts = v8ValueObject.bind(mockAnnotationBasedCallbackReceiver); - assertEquals(22, javetCallbackContexts.size()); + assertEquals(23, javetCallbackContexts.size()); assertEquals(0, mockAnnotationBasedCallbackReceiver.getCount()); assertEquals(123, v8Runtime.getExecutor("a.integerValue").executeInteger()); assertEquals(1, mockAnnotationBasedCallbackReceiver.getCount()); @@ -71,9 +71,11 @@ public void testAnnotationBasedProperties() throws JavetException { assertEquals(13, mockAnnotationBasedCallbackReceiver.getCount()); assertEquals("abc", v8Runtime.getExecutor("a[Symbol.for('symbolValue')]").executeString()); assertEquals(14, mockAnnotationBasedCallbackReceiver.getCount()); - assertEquals(19, v8ValueObject.unbind(mockAnnotationBasedCallbackReceiver)); + assertEquals(1000, v8Runtime.getExecutor("a[Symbol.toPrimitive]").executeInteger()); + assertEquals(15, mockAnnotationBasedCallbackReceiver.getCount()); + assertEquals(20, v8ValueObject.unbind(mockAnnotationBasedCallbackReceiver)); assertNull(v8Runtime.getExecutor("a['stringValue']").executeString()); - assertEquals(14, mockAnnotationBasedCallbackReceiver.getCount()); + assertEquals(15, mockAnnotationBasedCallbackReceiver.getCount()); } v8Runtime.lowMemoryNotification(); } @@ -223,7 +225,23 @@ public void testGetPropertyNames() throws JavetException { } @Test - public void testGetSetDelete() throws JavetException { + public void testGetSetDeletePrivate() throws JavetException { + try (V8ValueObject v8ValueObject = v8Runtime.createV8ValueObject()) { + assertFalse(v8ValueObject.hasPrivateProperty("x")); + assertTrue(v8ValueObject.getPrivateProperty("x").isUndefined()); + assertTrue(v8ValueObject.setPrivateProperty("x", 1)); + assertTrue(v8ValueObject.hasPrivateProperty("x")); + assertEquals(1, v8ValueObject.getPrivatePropertyInteger("x")); + try (IV8ValueArray iV8ValueArray = v8ValueObject.getOwnPropertyNames()) { + assertEquals("[]", iV8ValueArray.toJsonString()); + } + assertTrue(v8ValueObject.deletePrivateProperty("x")); + assertTrue(v8ValueObject.getPrivateProperty("x").isUndefined()); + } + } + + @Test + public void testGetSetDeletePublic() throws JavetException { try (V8ValueObject v8ValueObject = v8Runtime.getExecutor("const a = {}; a;").execute()) { assertTrue(v8ValueObject.set("a", 1)); assertTrue(v8ValueObject.set("b", "2"));