/
githubmirror
/
node
Обзор
Документация
Войти
/
githubmirror
/
node
Код
Запросы
0
Пакеты
0
Релизы
0
Аналитика
Безопасность
main
deps/v8/src/api/api.cc
12 700 строк
491 KB
Chengzhong Wu
deps: V8: backport a05321ebd98e
07 июл 2026, 20:59
07 июл 2026, 20:59
39d9e8c
Код
Авторство
О чём код?
// Copyright 2012 the V8 project authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. #include "src/api/api.h" #include <algorithm> // For min #include <cmath> // For isnan. #include <limits> #include <optional> #include <sstream> #include <string> #include <string_view> #include <utility> // For move #include <vector> #include "include/v8-array-buffer.h" #include "include/v8-callbacks.h" #include "include/v8-cppgc.h" #include "include/v8-date.h" #include "include/v8-embedder-state-scope.h" #include "include/v8-extension.h" #include "include/v8-external-memory-accounter.h" #include "include/v8-fast-api-calls.h" #include "include/v8-function.h" #include "include/v8-json.h" #include "include/v8-locker.h" #include "include/v8-primitive-object.h" #include "include/v8-profiler.h" #include "include/v8-source-location.h" #include "include/v8-template.h" #include "include/v8-unwinder-state.h" #include "include/v8-util.h" #include "include/v8-wasm.h" #include "src/api/api-arguments.h" #include "src/api/api-inl.h" #include "src/api/api-natives.h" #include "src/base/bit-field.h" #include "src/base/hashing.h" #include "src/base/logging.h" #include "src/base/numerics/safe_conversions.h" #include "src/base/platform/memory.h" #include "src/base/platform/platform.h" #include "src/base/platform/time.h" #include "src/base/template-utils.h" #include "src/base/utils/random-number-generator.h" #include "src/base/vector.h" #include "src/builtins/accessors.h" #include "src/builtins/builtins-utils.h" #include "src/codegen/compilation-cache.h" #include "src/codegen/compiler.h" #include "src/codegen/cpu-features.h" #include "src/codegen/script-details.h" #include "src/common/assert-scope.h" #include "src/common/globals.h" #include "src/compiler-dispatcher/lazy-compile-dispatcher.h" #include "src/date/date.h" #include "src/debug/debug.h" #include "src/deoptimizer/deoptimizer.h" #include "src/execution/embedder-state.h" #include "src/execution/execution.h" #include "src/execution/frames-inl.h" #include "src/execution/isolate-inl.h" #include "src/execution/messages.h" #include "src/execution/microtask-queue.h" #include "src/execution/simulator.h" #include "src/execution/v8threads.h" #include "src/execution/vm-state-inl.h" #include "src/handles/global-handles.h" #include "src/handles/persistent-handles.h" #include "src/handles/shared-object-conveyor-handles.h" #include "src/handles/traced-handles-inl.h" #include "src/heap/heap-inl.h" #include "src/heap/heap-layout-inl.h" #include "src/heap/heap-write-barrier.h" #include "src/heap/safepoint.h" #include "src/heap/visit-object.h" #include "src/init/bootstrapper.h" #include "src/init/icu_util.h" #include "src/init/startup-data-util.h" #include "src/init/v8.h" #include "src/json/json-parser.h" #include "src/json/json-stringifier.h" #include "src/logging/counters-scopes.h" #include "src/logging/metrics.h" #include "src/logging/runtime-call-stats-scope.h" #include "src/logging/tracing-flags.h" #include "src/numbers/conversions-inl.h" #include "src/objects/api-callbacks.h" #include "src/objects/backing-store.h" #include "src/objects/contexts.h" #include "src/objects/cpp-heap-object-wrapper-inl.h" #include "src/objects/embedder-data-array-inl.h" #include "src/objects/embedder-data-slot-inl.h" #include "src/objects/hash-table-inl.h" #include "src/objects/heap-object.h" #include "src/objects/instance-type-inl.h" #include "src/objects/instance-type.h" #include "src/objects/js-array-buffer-inl.h" #include "src/objects/js-array-inl.h" #include "src/objects/js-collection-inl.h" #include "src/objects/js-objects.h" #include "src/objects/js-promise-inl.h" #include "src/objects/js-regexp-inl.h" #include "src/objects/js-weak-refs-inl.h" #include "src/objects/module-inl.h" #include "src/objects/objects-inl.h" #include "src/objects/oddball.h" #include "src/objects/ordered-hash-table-inl.h" #include "src/objects/primitive-heap-object.h" #include "src/objects/property-descriptor.h" #include "src/objects/property-details.h" #include "src/objects/property.h" #include "src/objects/prototype.h" #include "src/objects/shared-function-info.h" #include "src/objects/slots.h" #include "src/objects/smi.h" #include "src/objects/string.h" #include "src/objects/synthetic-module-inl.h" #include "src/objects/templates.h" #include "src/objects/value-serializer.h" #include "src/parsing/parse-info.h" #include "src/parsing/parser.h" #include "src/parsing/pending-compilation-error-handler.h" #include "src/parsing/scanner-character-streams.h" #include "src/profiler/cpu-profiler.h" #include "src/profiler/heap-profiler.h" #include "src/profiler/heap-snapshot-generator-inl.h" #include "src/profiler/profile-generator-inl.h" #include "src/profiler/tick-sample.h" #include "src/regexp/regexp-utils.h" #include "src/roots/static-roots.h" #include "src/runtime/runtime.h" #include "src/sandbox/external-pointer.h" #include "src/sandbox/isolate.h" #include "src/sandbox/sandbox.h" #include "src/snapshot/code-serializer.h" #include "src/snapshot/embedded/embedded-data.h" #include "src/snapshot/snapshot.h" #include "src/strings/char-predicates-inl.h" #include "src/strings/string-hasher.h" #include "src/strings/unicode-inl.h" #include "src/tracing/trace-event.h" #include "src/utils/detachable-vector.h" #include "src/utils/identity-map.h" #include "src/utils/version.h" #if V8_ENABLE_WEBASSEMBLY #include "src/debug/debug-wasm-objects.h" #include "src/trap-handler/trap-handler.h" #include "src/wasm/streaming-decoder.h" #include "src/wasm/value-type.h" #include "src/wasm/wasm-engine.h" #include "src/wasm/wasm-js.h" #include "src/wasm/wasm-limits.h" #include "src/wasm/wasm-objects-inl.h" #include "src/wasm/wasm-result.h" #include "src/wasm/wasm-serialization.h" #endif // V8_ENABLE_WEBASSEMBLY #ifdef V8_INTL_SUPPORT #include "src/objects/intl-objects.h" #endif // V8_INTL_SUPPORT #include "src/strings/string-hasher-inl.h" #if V8_OS_LINUX || V8_OS_DARWIN || V8_OS_FREEBSD #include <signal.h> #include <unistd.h> #if V8_ENABLE_WEBASSEMBLY #include "include/v8-wasm-trap-handler-posix.h" #include "src/trap-handler/handler-inside-posix.h" #endif // V8_ENABLE_WEBASSEMBLY #endif // V8_OS_LINUX || V8_OS_DARWIN || V8_OS_FREEBSD #if V8_OS_WIN #include "include/v8-wasm-trap-handler-win.h" #include "src/trap-handler/handler-inside-win.h" #if defined(V8_OS_WIN64) #include "src/base/platform/wrappers.h" #include "src/diagnostics/unwinding-info-win64.h" #endif // V8_OS_WIN64 #endif // V8_OS_WIN #if defined(V8_ENABLE_ETW_STACK_WALKING) #include "src/diagnostics/etw-jit-win.h" #endif // V8_ENABLE_ETW_STACK_WALKING #if defined(V8_ENABLE_SANDBOX) && defined(V8_ENABLE_MEMORY_CORRUPTION_API) #include "src/strings/owning-external-string-resource.h" #endif // defined(V8_ENABLE_SANDBOX) && // defined(V8_ENABLE_MEMORY_CORRUPTION_API) namespace v8 { static_assert(static_cast<uint32_t>(Intercepted::kNo) == i::kInterceptedNo); static_assert(static_cast<uint32_t>(Intercepted::kYes) == i::kInterceptedYes); static_assert(sizeof(Intercepted) == i::kInterceptedSize); i::ExternalPointerTag ToExternalPointerTag(v8::EmbedderDataTypeTag api_tag) { uint16_t tag_value = static_cast<uint16_t>(i::kFirstEmbedderDataTag) + static_cast<uint16_t>(api_tag); Utils::ApiCheck(tag_value <= i::kLastEmbedderDataTag, "ToExternalPointerTag", "The provided tag is outside the allowed range"); return static_cast<i::ExternalPointerTag>(tag_value); } static OOMErrorCallback g_oom_error_callback = nullptr; using RCCId = i::RuntimeCallCounterId; static ScriptOrigin GetScriptOriginForScript( i::Isolate* i_isolate, i::DirectHandle<i::Script> script) { i::DirectHandle<i::Object> scriptName(script->GetNameOrSourceURL(), i_isolate); i::DirectHandle<i::Object> source_map_url(script->source_mapping_url(), i_isolate); i::DirectHandle<i::Object> host_defined_options( script->host_defined_options(), i_isolate); ScriptOriginOptions options(script->origin_options()); bool is_wasm = false; #if V8_ENABLE_WEBASSEMBLY is_wasm = script->type() == i::Script::Type::kWasm; #endif // V8_ENABLE_WEBASSEMBLY v8::ScriptOrigin origin( Utils::ToLocal(scriptName), script->line_offset(), script->column_offset(), options.IsSharedCrossOrigin(), script->id(), Utils::ToLocal(source_map_url), options.IsOpaque(), is_wasm, options.IsModule(), Utils::ToLocal(host_defined_options)); return origin; } // --- E x c e p t i o n B e h a v i o r --- // When V8 cannot allocate memory FatalProcessOutOfMemory is called. The default // OOM error handler is called and execution is stopped. void i::V8::FatalProcessOutOfMemory(i::Isolate* i_isolate, const char* location, const OOMDetails& details) { i::HeapStats heap_stats; if (i_isolate == nullptr) { i_isolate = Isolate::TryGetCurrent(); } if (i_isolate == nullptr) { // If the Isolate is not available for the current thread we cannot retrieve // memory information from the Isolate. Write easy-to-recognize values on // the stack. memset(&heap_stats, 0xBADC0DE, sizeof(heap_stats)); // Give the embedder a chance to handle the condition. If it doesn't, // just crash. if (g_oom_error_callback) g_oom_error_callback(location, details); base::FatalOOM(base::OOMType::kProcess, location); UNREACHABLE(); } memset(heap_stats.last_few_messages, 0, Heap::kTraceRingBufferSize + 1); if (i_isolate->heap()->HasBeenSetUp()) { i_isolate->heap()->RecordStats(&heap_stats); i_isolate->heap()->ReportStatsAsCrashKeys(heap_stats); if (i_isolate->thread_id() == ThreadId::Current()) { i_isolate->ReportStackAsCrashKey(); } if (!v8_flags.correctness_fuzzer_suppressions) { char* first_newline = strchr(heap_stats.last_few_messages, '\n'); if (first_newline == nullptr || first_newline[1] == '\0') first_newline = heap_stats.last_few_messages; base::OS::PrintError("\n<--- Last few GCs --->\n%s\n", first_newline); } } Utils::ReportOOMFailure(i_isolate, location, details); if (g_oom_error_callback) g_oom_error_callback(location, details); // If the fatal error handler returns, we stop execution. FATAL("API fatal error handler returned after process out of memory"); } void Utils::ReportApiFailure(const char* location, const char* message) { i::Isolate* i_isolate = i::Isolate::TryGetCurrent(); FatalErrorCallback callback = nullptr; if (i_isolate != nullptr) { callback = i_isolate->exception_behavior(); } if (callback == nullptr) { base::OS::PrintError("\n#\n# Fatal error in %s\n# %s\n#\n\n", location, message); base::OS::Abort(); } else { callback(location, message); } i_isolate->SignalFatalError(); } void Utils::ReportOOMFailure(i::Isolate* i_isolate, const char* location, const OOMDetails& details) { if (auto oom_callback = i_isolate->oom_behavior()) { oom_callback(location, details, i_isolate->oom_callback_data()); } else { // TODO(wfh): Remove this fallback once Blink is setting OOM handler. See // crbug.com/614440. FatalErrorCallback fatal_callback = i_isolate->exception_behavior(); if (fatal_callback == nullptr) { base::OOMType type = details.is_heap_oom ? base::OOMType::kJavaScript : base::OOMType::kProcess; base::FatalOOM(type, location); UNREACHABLE(); } else { fatal_callback(location, details.is_heap_oom ? "Allocation failed - JavaScript heap out of memory" : "Allocation failed - process out of memory"); } } i_isolate->SignalFatalError(); } void V8::SetSnapshotDataBlob(StartupData* snapshot_blob) { i::V8::SetSnapshotBlob(snapshot_blob); } namespace { #ifdef V8_ENABLE_SANDBOX // ArrayBufferAllocator to use when the sandbox is enabled in which case all // ArrayBuffer backing stores need to be allocated inside the sandbox. class ArrayBufferAllocator : public v8::ArrayBuffer::Allocator { public: explicit ArrayBufferAllocator(i::IsolateGroup* group) : sandbox_(group->sandbox()), allocator_(group->GetSandboxedArrayBufferAllocator()) {} void* Allocate(size_t length) override { return allocator_->Allocate(length); } void* AllocateUninitialized(size_t length) override { return Allocate(length); } void Free(void* data, size_t length) override { return allocator_->Free(data); } PageAllocator* GetPageAllocator() override { return sandbox_->page_allocator(); } private: i::Sandbox* sandbox_ = nullptr; i::SandboxedArrayBufferAllocatorBase* allocator_ = nullptr; }; #else class ArrayBufferAllocator : public v8::ArrayBuffer::Allocator { public: void* Allocate(size_t length) override { return base::Calloc(length, 1); } void* AllocateUninitialized(size_t length) override { return base::Malloc(length); } void Free(void* data, size_t) override { base::Free(data); } PageAllocator* GetPageAllocator() override { return i::GetPlatformPageAllocator(); } }; #endif // V8_ENABLE_SANDBOX } // namespace SnapshotCreator::SnapshotCreator(Isolate* v8_isolate, const intptr_t* external_references, const StartupData* existing_snapshot, bool owns_isolate) : impl_(new i::SnapshotCreatorImpl( reinterpret_cast<i::Isolate*>(v8_isolate), external_references, existing_snapshot, owns_isolate)) {} SnapshotCreator::SnapshotCreator(const intptr_t* external_references, const StartupData* existing_snapshot) : SnapshotCreator(nullptr, external_references, existing_snapshot) {} SnapshotCreator::SnapshotCreator(const v8::Isolate::CreateParams& params) : impl_(new i::SnapshotCreatorImpl(params)) {} SnapshotCreator::SnapshotCreator(v8::Isolate* isolate, const v8::Isolate::CreateParams& params) : impl_(new i::SnapshotCreatorImpl(reinterpret_cast<i::Isolate*>(isolate), params)) {} SnapshotCreator::~SnapshotCreator() { DCHECK_NOT_NULL(impl_); delete impl_; } Isolate* SnapshotCreator::GetIsolate() { return reinterpret_cast<v8::Isolate*>(impl_->isolate()); } void SnapshotCreator::SetDefaultContext( Local<Context> context, SerializeInternalFieldsCallback internal_fields_serializer, SerializeContextDataCallback context_data_serializer, SerializeAPIWrapperCallback api_wrapper_serializer) { impl_->SetDefaultContext( Utils::OpenDirectHandle(*context), i::SerializeEmbedderFieldsCallback(internal_fields_serializer, context_data_serializer, api_wrapper_serializer)); } size_t SnapshotCreator::AddContext( Local<Context> context, SerializeInternalFieldsCallback internal_fields_serializer, SerializeContextDataCallback context_data_serializer, SerializeAPIWrapperCallback api_wrapper_serializer) { return impl_->AddContext( Utils::OpenDirectHandle(*context), i::SerializeEmbedderFieldsCallback(internal_fields_serializer, context_data_serializer, api_wrapper_serializer)); } size_t SnapshotCreator::AddData(i::Address object) { return impl_->AddData(object); } size_t SnapshotCreator::AddData(Local<Context> context, i::Address object) { return impl_->AddData(Utils::OpenDirectHandle(*context), object); } StartupData SnapshotCreator::CreateBlob( SnapshotCreator::FunctionCodeHandling function_code_handling) { return impl_->CreateBlob(function_code_handling); } bool StartupData::CanBeRehashed() const { DCHECK(i::Snapshot::VerifyChecksum(this)); return i::Snapshot::ExtractRehashability(this); } bool StartupData::IsValid() const { return i::Snapshot::VersionIsValid(this); } void V8::SetDcheckErrorHandler(DcheckErrorCallback that) { v8::base::SetDcheckFunction(that); } void V8::SetFatalErrorHandler(V8FatalErrorCallback that) { v8::base::SetFatalFunction(that); } void V8::SetFlagsFromString(const char* str) { SetFlagsFromString(str, strlen(str)); } void V8::SetFlagsFromString(const char* str, size_t length) { i::FlagList::SetFlagsFromString(str, length); } void V8::SetFlagsFromCommandLine(int* argc, char** argv, bool remove_flags) { using HelpOptions = i::FlagList::HelpOptions; i::FlagList::SetFlagsFromCommandLine(argc, argv, remove_flags, HelpOptions(HelpOptions::kDontExit)); } RegisteredExtension* RegisteredExtension::first_extension_ = nullptr; RegisteredExtension::RegisteredExtension(std::unique_ptr<Extension> extension) : extension_(std::move(extension)) {} // static void RegisteredExtension::Register(std::unique_ptr<Extension> extension) { RegisteredExtension* new_extension = new RegisteredExtension(std::move(extension)); new_extension->next_ = first_extension_; first_extension_ = new_extension; } // static void RegisteredExtension::UnregisterAll() { RegisteredExtension* re = first_extension_; while (re != nullptr) { RegisteredExtension* next = re->next(); delete re; re = next; } first_extension_ = nullptr; } namespace { #if defined(V8_ENABLE_SANDBOX) && defined(V8_ENABLE_MEMORY_CORRUPTION_API) // An implementation that holds all extension resources as copies in the // ExternalStringsCage; for use in testing/fuzzing memory_corruption_api enabled // builds to avoid filing issues for OOB reads due to corruptions of lengths // stored on heap. class ExtensionResource : public i::OwningExternalOneByteStringResource { public: using i::OwningExternalOneByteStringResource:: OwningExternalOneByteStringResource; void Dispose() override { // Don't delete here - our lifetime is managed by the Extension object. } }; #else // defined(V8_ENABLE_SANDBOX) && defined(V8_ENABLE_MEMORY_CORRUPTION_API) // An implementation that simply wraps the specified view. class ExtensionResource : public String::ExternalOneByteStringResource { public: explicit ExtensionResource(std::string_view string) : string_(string) {} const char* data() const override { return string_.data(); } size_t length() const override { return string_.length(); } void Dispose() override {} private: const std::string_view string_; }; #endif // defined(V8_ENABLE_SANDBOX) && // defined(V8_ENABLE_MEMORY_CORRUPTION_API) } // anonymous namespace void RegisterExtension(std::unique_ptr<Extension> extension) { RegisteredExtension::Register(std::move(extension)); } Extension::Extension(const char* name, const char* source, int dep_count, const char** deps, int source_length) : name_(name), dep_count_(dep_count), deps_(deps), auto_enable_(false) { CHECK_IMPLIES(source == nullptr, source_length <= 0); std::string_view source_view; if (source) { source_view = source_length >= 0 ? std::string_view(source, source_length) : std::string_view(source); } source_ = new ExtensionResource(source_view); } void ResourceConstraints::ConfigureDefaultsFromHeapSize( size_t initial_heap_size_in_bytes, size_t maximum_heap_size_in_bytes) { CHECK_LE(initial_heap_size_in_bytes, maximum_heap_size_in_bytes); if (maximum_heap_size_in_bytes == 0) { return; } size_t young_generation, old_generation; i::Heap::GenerationSizesFromHeapSize(0, maximum_heap_size_in_bytes, &young_generation, &old_generation); set_max_young_generation_size_in_bytes( std::max(young_generation, i::Heap::MinYoungGenerationSize())); set_max_old_generation_size_in_bytes( std::max(old_generation, i::Heap::MinOldGenerationSize())); if (initial_heap_size_in_bytes > 0) { i::Heap::GenerationSizesFromHeapSize(0, initial_heap_size_in_bytes, &young_generation, &old_generation); // We do not set lower bounds for the initial sizes. set_initial_young_generation_size_in_bytes(young_generation); set_initial_old_generation_size_in_bytes(old_generation); } if (i::kPlatformRequiresCodeRange) { set_code_range_size_in_bytes( std::min(i::kMaximalCodeRangeSize, maximum_heap_size_in_bytes)); } } void ResourceConstraints::ConfigureDefaults(uint64_t physical_memory, uint64_t virtual_memory_limit) { physical_memory_size_ = physical_memory; size_t old_generation = i::Heap::OldGenerationSizeFromPhysicalMemory(physical_memory); size_t young_generation = i::Heap::YoungGenerationSizeFromPhysicalMemory(physical_memory); set_max_young_generation_size_in_bytes(young_generation); set_max_old_generation_size_in_bytes(old_generation); if (virtual_memory_limit > 0 && i::kPlatformRequiresCodeRange) { set_code_range_size_in_bytes( std::min(i::kMaximalCodeRangeSize, static_cast<size_t>(virtual_memory_limit / 8))); } } #ifdef ENABLE_SLOW_DCHECKS namespace api_internal { void StackAllocated<true>::VerifyOnStack() const { if (internal::StackAllocatedCheck::Get()) { SLOW_DCHECK(::heap::base::Stack::IsOnStack(this)); } } } // namespace api_internal #endif namespace internal { // static v8::Isolate* Internals::GetCurrentIsolate() { return v8::Isolate::GetCurrent(); } void VerifyHandleIsNonEmpty(bool is_empty) { Utils::ApiCheck(!is_empty, "v8::ReturnValue", "SetNonEmpty() called with empty handle."); } i::Address* GlobalizeTracedReference( i::Isolate* i_isolate, i::Address value, internal::Address* slot, TracedReferenceStoreMode store_mode, TracedReferenceHandling reference_handling) { return i_isolate->traced_handles() ->Create(value, slot, store_mode, reference_handling) .location(); } void MoveTracedReference(internal::Address** from, internal::Address** to) { TracedHandles::Move(from, to); } void CopyTracedReference(const internal::Address* const* from, internal::Address** to) { TracedHandles::Copy(from, to); } void DisposeTracedReference(internal::Address* location) { TracedHandles::Destroy(location); } #if V8_STATIC_ROOTS_BOOL // Check static root constants exposed in v8-internal.h. namespace { constexpr InstanceTypeChecker::TaggedAddressRange kStringMapRange = *InstanceTypeChecker::UniqueMapRangeOfInstanceTypeRange(FIRST_STRING_TYPE, LAST_STRING_TYPE); } // namespace #define EXPORTED_STATIC_ROOTS_PTR_MAPPING(V) \ V(UndefinedValue, i::StaticReadOnlyRoot::kUndefinedValue) \ V(NullValue, i::StaticReadOnlyRoot::kNullValue) \ V(TrueValue, i::StaticReadOnlyRoot::kTrueValue) \ V(FalseValue, i::StaticReadOnlyRoot::kFalseValue) \ V(EmptyString, i::StaticReadOnlyRoot::kempty_string) \ V(TheHoleValue, i::StaticReadOnlyRoot::kTheHoleValue) \ V(StringMapLowerBound, kStringMapRange.first) \ V(StringMapUpperBound, kStringMapRange.second) static_assert(std::is_same_v<Internals::Tagged_t, Tagged_t>); // Ensure they have the correct value. #define CHECK_STATIC_ROOT(name, value) \ static_assert(Internals::StaticReadOnlyRoot::k##name == value); EXPORTED_STATIC_ROOTS_PTR_MAPPING(CHECK_STATIC_ROOT) #undef CHECK_STATIC_ROOT #define PLUS_ONE(...) +1 static constexpr int kNumberOfCheckedStaticRoots = 0 EXPORTED_STATIC_ROOTS_PTR_MAPPING(PLUS_ONE); #undef EXPORTED_STATIC_ROOTS_PTR_MAPPING static_assert(Internals::StaticReadOnlyRoot::kNumberOfExportedStaticRoots == kNumberOfCheckedStaticRoots); #endif // V8_STATIC_ROOTS_BOOL } // namespace internal namespace api_internal { i::Address* GlobalizeReference(i::Isolate* i_isolate, i::Address value) { ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Persistent_New); i::IndirectHandle<i::Object> result = i_isolate->global_handles()->Create(value); #ifdef VERIFY_HEAP if (i::v8_flags.verify_heap) { i::Object::ObjectVerify(i::Tagged<i::Object>(value), i_isolate); } #endif // VERIFY_HEAP return result.location(); } i::Address* CopyGlobalReference(i::Address* from) { i::IndirectHandle<i::Object> result = i::GlobalHandles::CopyGlobal(from); return result.location(); } void MoveGlobalReference(internal::Address** from, internal::Address** to) { i::GlobalHandles::MoveGlobal(from, to); } void MakeWeak(i::Address* location, void* parameter, WeakCallbackInfo<void>::Callback weak_callback, WeakCallbackType type) { i::GlobalHandles::MakeWeak(location, parameter, weak_callback, type); } void MakeWeak(i::Address** location_addr) { i::GlobalHandles::MakeWeak(location_addr); } void* ClearWeak(i::Address* location) { return i::GlobalHandles::ClearWeakness(location); } void AnnotateStrongRetainer(i::Address* location, const char* label) { i::GlobalHandles::AnnotateStrongRetainer(location, label); } void DisposeGlobal(i::Address* location) { i::GlobalHandles::Destroy(location); } i::Address* Eternalize(Isolate* v8_isolate, Value* value) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i::Tagged<i::Object> object = *Utils::OpenDirectHandle(value); int index = -1; i_isolate->eternal_handles()->Create(i_isolate, object, &index); return i_isolate->eternal_handles()->Get(index).location(); } void FromJustIsNothing() { Utils::ApiCheck(false, "v8::FromJust", "Maybe value is Nothing"); } void ToLocalEmpty() { Utils::ApiCheck(false, "v8::ToLocalChecked", "Empty MaybeLocal"); } void InternalFieldOutOfBounds(int index) { Utils::ApiCheck(0 <= index && index < kInternalFieldsInWeakCallback, "WeakCallbackInfo::GetInternalField", "Internal field out of bounds"); } } // namespace api_internal // --- H a n d l e s --- #ifdef V8_ENABLE_CHECKS void HandleScope::DoInitializeAsserts(Isolate* v8_isolate) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); // We do not want to check the correct usage of the Locker class all over the // place, so we do it only here: Without a HandleScope, an embedder can do // almost nothing, so it is enough to check in this central place. // We make an exception if the serializer is enabled, which means that the // Isolate is exclusively used to create a snapshot. Utils::ApiCheck(!i_isolate->was_locker_ever_used() || i_isolate->thread_manager()->IsLockedByCurrentThread() || i_isolate->serializer_enabled(), "HandleScope::HandleScope", "Entering the V8 API without proper locking in place"); } void HandleScope::AssertScopeLevelsMatch() { auto i_isolate = reinterpret_cast<internal::Isolate*>(isolate_); CHECK_EQ(scope_level_, i_isolate->handle_scope_data()->level); } void HandleScope::DoCloseScopeAsserts(int before, internal::Address* limit, internal::HandleScopeData* current) { #ifdef ENABLE_LOCAL_HANDLE_ZAPPING internal::HandleScope::ZapRange(current->next, limit); #endif MSAN_ALLOCATED_UNINITIALIZED_MEMORY( current->next, static_cast<size_t>(reinterpret_cast<internal::Address>(limit) - reinterpret_cast<internal::Address>(current->next))); if (internal::v8_flags.check_handle_count) { int after = NumberOfHandles(isolate_); DCHECK_LT(after - before, internal::HandleScope::kCheckHandleThreshold); DCHECK_LT(before, internal::HandleScope::kCheckHandleThreshold); USE(after); } } #endif // V8_ENABLE_CHECKS void* HandleScope::operator new(size_t) { base::OS::Abort(); } void* HandleScope::operator new[](size_t) { base::OS::Abort(); } void HandleScope::operator delete(void*, size_t) { base::OS::Abort(); } void HandleScope::operator delete[](void*, size_t) { base::OS::Abort(); } int HandleScope::NumberOfHandles(Isolate* v8_isolate) { return i::HandleScope::NumberOfHandles( reinterpret_cast<i::Isolate*>(v8_isolate)); } i::Address* HandleScope::Extend(Isolate* isolate) { return i::HandleScope::Extend(reinterpret_cast<i::Isolate*>(isolate)); } void HandleScope::DeleteExtensions(Isolate* v8_isolate) { using I = internal::Internals; internal::HandleScopeData* current = I::GetHandleScopeData(v8_isolate); reinterpret_cast<internal::Isolate*>(v8_isolate) ->handle_scope_implementer() ->DeleteExtensions(current->limit); } #ifdef V8_ENABLE_DIRECT_HANDLE i::Address* HandleScope::CreateHandleForCurrentIsolate(i::Address value) { i::Isolate* i_isolate = i::Isolate::Current(); return i::HandleScope::CreateHandle(i_isolate, value); } #endif // V8_ENABLE_DIRECT_HANDLE EscapableHandleScopeBase::EscapableHandleScopeBase(Isolate* v8_isolate) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); escape_slot_ = CreateHandle( v8_isolate, i::ReadOnlyRoots(i_isolate).the_hole_value().ptr()); Initialize(v8_isolate); } i::Address* EscapableHandleScopeBase::EscapeSlot(i::Address* escape_value) { DCHECK_NOT_NULL(escape_value); DCHECK(i::IsTheHole(i::Tagged<i::Object>(*escape_slot_), reinterpret_cast<i::Isolate*>(GetIsolate()))); *escape_slot_ = *escape_value; return escape_slot_; } SealHandleScope::SealHandleScope(Isolate* v8_isolate) : i_isolate_(reinterpret_cast<i::Isolate*>(v8_isolate)) { i::HandleScopeData* current = i_isolate_->handle_scope_data(); prev_limit_ = current->limit; current->limit = current->next; prev_sealed_level_ = current->sealed_level; current->sealed_level = current->level; } SealHandleScope::~SealHandleScope() { i::HandleScopeData* current = i_isolate_->handle_scope_data(); DCHECK_EQ(current->next, current->limit); current->limit = prev_limit_; DCHECK_EQ(current->level, current->sealed_level); current->sealed_level = prev_sealed_level_; } bool Data::IsModule() const { return i::IsModule(*Utils::OpenDirectHandle(this)); } bool Data::IsModuleRequest() const { return i::IsModuleRequest(*Utils::OpenDirectHandle(this)); } bool Data::IsFixedArray() const { return i::IsFixedArray(*Utils::OpenDirectHandle(this)); } bool Data::IsValue() const { i::DisallowGarbageCollection no_gc; i::Tagged<i::Object> self = *Utils::OpenDirectHandle(this); if (i::IsSmi(self)) return true; i::Tagged<i::HeapObject> heap_object = i::Cast<i::HeapObject>(self); DCHECK(!IsTheHole(heap_object)); if (i::IsSymbol(heap_object)) { return !i::Cast<i::Symbol>(heap_object)->is_any_private(); } return IsPrimitiveHeapObject(heap_object) || IsJSReceiver(heap_object); } bool Data::IsPrivate() const { return i::IsPrivateSymbol(*Utils::OpenDirectHandle(this)); } bool Data::IsObjectTemplate() const { return i::IsObjectTemplateInfo(*Utils::OpenDirectHandle(this)); } bool Data::IsFunctionTemplate() const { return i::IsFunctionTemplateInfo(*Utils::OpenDirectHandle(this)); } bool Data::IsDictionaryTemplate() const { return i::IsDictionaryTemplateInfo(*Utils::OpenDirectHandle(this)); } bool Data::IsContext() const { return i::IsContext(*Utils::OpenDirectHandle(this)); } bool Data::IsCppHeapExternal() const { return IsCppHeapExternalObject(*Utils::OpenDirectHandle(this)); } void Context::Enter() { i::DisallowGarbageCollection no_gc; i::Tagged<i::NativeContext> env = *Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::HandleScopeImplementer* impl = i_isolate->handle_scope_implementer(); impl->EnterContext(env); impl->SaveContext(i_isolate->context()); i_isolate->set_context(env); } void Context::Exit() { auto env = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::HandleScopeImplementer* impl = i_isolate->handle_scope_implementer(); if (!Utils::ApiCheck(impl->LastEnteredContextWas(*env), "v8::Context::Exit()", "Cannot exit non-entered context")) { return; } impl->LeaveContext(); i_isolate->set_context(impl->RestoreContext()); } Context::BackupIncumbentScope::BackupIncumbentScope( Local<Context> backup_incumbent_context) : backup_incumbent_context_(backup_incumbent_context) { DCHECK(!backup_incumbent_context_.IsEmpty()); i::Isolate* i_isolate = i::Isolate::Current(); js_stack_comparable_address_ = i::SimulatorStack::RegisterJSStackComparableAddress(i_isolate); prev_ = i_isolate->top_backup_incumbent_scope(); i_isolate->set_top_backup_incumbent_scope(this); // Enforce slow incumbent computation in order to make it find this // BackupIncumbentScope. i_isolate->clear_topmost_script_having_context(); } Context::BackupIncumbentScope::~BackupIncumbentScope() { i::Isolate* i_isolate = i::Isolate::Current(); i::SimulatorStack::UnregisterJSStackComparableAddress(i_isolate); i_isolate->set_top_backup_incumbent_scope(prev_); } static_assert(i::Internals::kEmbedderDataSlotSize == i::kEmbedderDataSlotSize); static_assert(i::Internals::kEmbedderDataSlotExternalPointerOffset == i::EmbedderDataSlot::kExternalPointerOffset); static i::DirectHandle<i::EmbedderDataArray> EmbedderDataFor( Context* context, int index, bool can_grow, const char* location) { auto env = Utils::OpenDirectHandle(context); i::Isolate* i_isolate = i::Isolate::Current(); i::DisallowJavascriptExecutionDebugOnly no_execution(i_isolate); i::DisallowExceptionsDebugOnly no_exceptions(i_isolate); bool ok = Utils::ApiCheck(i::IsNativeContext(*env), location, "Not a native context") && Utils::ApiCheck(index >= 0, location, "Negative index"); if (!ok) return {}; // TODO(ishell): remove cast once embedder_data slot has a proper type. i::DirectHandle<i::EmbedderDataArray> data( i::Cast<i::EmbedderDataArray>(env->embedder_data()), i_isolate); if (index < data->length()) return data; if (!Utils::ApiCheck(can_grow && index < i::EmbedderDataArray::kMaxLength, location, "Index too large")) { return {}; } data = i::EmbedderDataArray::EnsureCapacity(i_isolate, data, index); env->set_embedder_data(*data); return data; } uint32_t Context::GetNumberOfEmbedderDataFields() { auto context = Utils::OpenDirectHandle(this); i::DisallowJavascriptExecutionDebugOnly no_execution; i::DisallowExceptionsDebugOnly no_exceptions; Utils::ApiCheck(i::IsNativeContext(*context), "Context::GetNumberOfEmbedderDataFields", "Not a native context"); // TODO(ishell): remove cast once embedder_data slot has a proper type. return static_cast<uint32_t>( i::Cast<i::EmbedderDataArray>(context->embedder_data())->length()); } v8::Local<v8::Value> Context::SlowGetEmbedderData(int index) { const char* location = "v8::Context::GetEmbedderData()"; i::DirectHandle<i::EmbedderDataArray> data = EmbedderDataFor(this, index, false, location); if (data.is_null()) return {}; i::Isolate* i_isolate = i::Isolate::Current(); return Utils::ToLocal(i::direct_handle( i::EmbedderDataSlot(*data, index).load_tagged(), i_isolate)); } void Context::SetEmbedderData(int index, v8::Local<Value> value) { const char* location = "v8::Context::SetEmbedderData()"; i::DirectHandle<i::EmbedderDataArray> data = EmbedderDataFor(this, index, true, location); if (data.is_null()) return; auto val = Utils::OpenDirectHandle(*value); i::EmbedderDataSlot::store_tagged(*data, index, *val); DCHECK_EQ(*Utils::OpenDirectHandle(*value), *Utils::OpenDirectHandle(*GetEmbedderData(index))); } v8::Local<v8::Data> Context::SlowGetEmbedderDataV2(int index) { const char* location = "v8::Context::GetEmbedderDataV2()"; i::DirectHandle<i::EmbedderDataArray> data = EmbedderDataFor(this, index, false, location); if (data.is_null()) return {}; i::Isolate* i_isolate = i::Isolate::Current(); return Utils::ToLocal(i::direct_handle( i::EmbedderDataSlot(*data, index).load_tagged(), i_isolate)); } void Context::SetEmbedderDataV2(int index, v8::Local<Data> value) { const char* location = "v8::Context::SetEmbedderDataV2()"; i::DirectHandle<i::EmbedderDataArray> data = EmbedderDataFor(this, index, true, location); if (data.is_null()) return; auto val = Utils::OpenDirectHandle(*value); i::EmbedderDataSlot::store_tagged(*data, index, *val); DCHECK_EQ(*Utils::OpenDirectHandle(*value), *Utils::OpenDirectHandle(*GetEmbedderDataV2(index))); } void* Context::SlowGetAlignedPointerFromEmbedderData(int index, EmbedderDataTypeTag tag) { const char* location = "v8::Context::GetAlignedPointerFromEmbedderData()"; i::Isolate* i_isolate = i::Isolate::Current(); i::HandleScope handle_scope(i_isolate); i::DirectHandle<i::EmbedderDataArray> data = EmbedderDataFor(this, index, false, location); if (data.is_null()) return nullptr; void* result; Utils::ApiCheck( i::EmbedderDataSlot(*data, index) .ToAlignedPointer(i_isolate, &result, ToExternalPointerTag(tag)), location, "Pointer is not aligned"); return result; } void Context::SetAlignedPointerInEmbedderData(int index, void* value, EmbedderDataTypeTag tag) { const char* location = "v8::Context::SetAlignedPointerInEmbedderData()"; i::Isolate* i_isolate = i::Isolate::Current(); i::DirectHandle<i::EmbedderDataArray> data = EmbedderDataFor(this, index, true, location); bool ok = i::EmbedderDataSlot(*data, index) .store_aligned_pointer(i_isolate, *data, value, ToExternalPointerTag(tag)); Utils::ApiCheck(ok, location, "Pointer is not aligned"); DCHECK_EQ(value, GetAlignedPointerFromEmbedderData(index, tag)); } // --- T e m p l a t e --- void Template::Set(v8::Local<Name> name, v8::Local<Data> value, v8::PropertyAttribute attribute) { auto templ = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::HandleScope scope(i_isolate); auto value_obj = Utils::OpenDirectHandle(*value); Utils::ApiCheck(!IsJSReceiver(*value_obj) || IsTemplateInfo(*value_obj), "v8::Template::Set", "Invalid value, must be a primitive or a Template"); // The template cache only performs shallow clones, if we set an // ObjectTemplate as a property value then we can not cache the receiver // template. if (i::IsObjectTemplateInfo(*value_obj)) { templ->set_is_cacheable(false); } i::ApiNatives::AddDataProperty(i_isolate, templ, Utils::OpenDirectHandle(*name), value_obj, static_cast<i::PropertyAttributes>(attribute)); } void Template::SetPrivate(v8::Local<Private> name, v8::Local<Data> value, v8::PropertyAttribute attribute) { Set(Local<Name>::Cast(name), value, attribute); } void Template::SetAccessorProperty(v8::Local<v8::Name> name, v8::Local<FunctionTemplate> getter, v8::Local<FunctionTemplate> setter, v8::PropertyAttribute attribute) { auto templ = Utils::OpenDirectHandle(this); auto i_isolate = i::Isolate::Current(); i::DirectHandle<i::FunctionTemplateInfo> i_getter; if (!getter.IsEmpty()) { i_getter = Utils::OpenDirectHandle(*getter); Utils::ApiCheck(i_getter->has_callback(i_isolate), "v8::Template::SetAccessorProperty", "Getter must have a call handler"); } i::DirectHandle<i::FunctionTemplateInfo> i_setter; if (!setter.IsEmpty()) { i_setter = Utils::OpenDirectHandle(*setter); Utils::ApiCheck(i_setter->has_callback(i_isolate), "v8::Template::SetAccessorProperty", "Setter must have a call handler"); } EnterV8NoScriptNoExceptionScope api_scope(i_isolate); DCHECK(!name.IsEmpty()); DCHECK(!getter.IsEmpty() || !setter.IsEmpty()); i::HandleScope scope(i_isolate); i::ApiNatives::AddAccessorProperty( i_isolate, templ, Utils::OpenDirectHandle(*name), i_getter, i_setter, static_cast<i::PropertyAttributes>(attribute)); } // --- F u n c t i o n T e m p l a t e --- Local<ObjectTemplate> FunctionTemplate::PrototypeTemplate() { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::HeapObject> heap_obj(self->GetPrototypeTemplate(), i_isolate); if (i::IsUndefined(*heap_obj, i_isolate)) { // Do not cache prototype objects. constexpr bool do_not_cache = true; i::DirectHandle<i::ObjectTemplateInfo> proto_template = i_isolate->factory()->NewObjectTemplateInfo({}, do_not_cache); i::FunctionTemplateInfo::SetPrototypeTemplate(i_isolate, self, proto_template); return Utils::ToLocal(proto_template); } return ToApiHandle<ObjectTemplate>(heap_obj); } void FunctionTemplate::SetPrototypeProviderTemplate( Local<FunctionTemplate> prototype_provider) { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::FunctionTemplateInfo> result = Utils::OpenDirectHandle(*prototype_provider); Utils::ApiCheck(i::IsUndefined(self->GetPrototypeTemplate(), i_isolate), "v8::FunctionTemplate::SetPrototypeProviderTemplate", "Protoype must be undefined"); Utils::ApiCheck(i::IsUndefined(self->GetParentTemplate(), i_isolate), "v8::FunctionTemplate::SetPrototypeProviderTemplate", "Prototype provider must be empty"); i::FunctionTemplateInfo::SetPrototypeProviderTemplate(i_isolate, self, result); } namespace { static void EnsureNotPublished(i::DirectHandle<i::FunctionTemplateInfo> info, const char* func) { DCHECK_IMPLIES(info->instantiated(), info->published()); Utils::ApiCheck(!info->published(), func, "FunctionTemplate already instantiated"); } i::DirectHandle<i::FunctionTemplateInfo> FunctionTemplateNew( i::Isolate* i_isolate, FunctionCallback callback, v8::Local<Data> data, v8::Local<Signature> signature, int length, ConstructorBehavior behavior, bool do_not_cache, v8::Local<Private> cached_property_name = v8::Local<Private>(), SideEffectType side_effect_type = SideEffectType::kHasSideEffect, const MemorySpan<const CFunction>& c_function_overloads = {}) { i::DirectHandle<i::FunctionTemplateInfo> obj = i_isolate->factory()->NewFunctionTemplateInfo(length, do_not_cache); { // Disallow GC until all fields of obj have acceptable types. i::DisallowGarbageCollection no_gc; i::Tagged<i::FunctionTemplateInfo> raw = *obj; if (!signature.IsEmpty()) { raw->set_signature(*Utils::OpenDirectHandle(*signature)); } if (!cached_property_name.IsEmpty()) { raw->set_cached_property_name( *Utils::OpenDirectHandle(*cached_property_name)); } if (behavior == ConstructorBehavior::kThrow) { raw->set_remove_prototype(true); } } if (callback != nullptr) { Utils::ToLocal(obj)->SetCallHandler(callback, data, side_effect_type, c_function_overloads); } return obj; } } // namespace void FunctionTemplate::Inherit(v8::Local<FunctionTemplate> value) { auto info = Utils::OpenDirectHandle(this); EnsureNotPublished(info, "v8::FunctionTemplate::Inherit"); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); Utils::ApiCheck( i::IsUndefined(info->GetPrototypeProviderTemplate(), i_isolate), "v8::FunctionTemplate::Inherit", "Protoype provider must be empty"); i::FunctionTemplateInfo::SetParentTemplate(i_isolate, info, Utils::OpenDirectHandle(*value)); } Local<FunctionTemplate> FunctionTemplate::New( Isolate* v8_isolate, FunctionCallback callback, v8::Local<Value> data, v8::Local<Signature> signature, int length, ConstructorBehavior behavior, SideEffectType side_effect_type, const CFunction* c_function, uint16_t instance_type, uint16_t allowed_receiver_instance_type_range_start, uint16_t allowed_receiver_instance_type_range_end) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); // Changes to the environment cannot be captured in the snapshot. Expect no // function templates when the isolate is created for serialization. ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_FunctionTemplate_New); if (!Utils::ApiCheck( !c_function || behavior == ConstructorBehavior::kThrow, "FunctionTemplate::New", "Fast API calls are not supported for constructor functions")) { return {}; } EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::FunctionTemplateInfo> templ = FunctionTemplateNew( i_isolate, callback, data, signature, length, behavior, false, Local<Private>(), side_effect_type, c_function ? MemorySpan<const CFunction>{c_function, 1} : MemorySpan<const CFunction>{}); if (instance_type) { if (!Utils::ApiCheck( base::IsInRange(static_cast<int>(instance_type), i::Internals::kFirstEmbedderJSApiObjectType, i::Internals::kLastEmbedderJSApiObjectType), "FunctionTemplate::New", "instance_type is outside the range of valid JSApiObject types")) { return {}; } templ->SetInstanceType(instance_type); } if (allowed_receiver_instance_type_range_start || allowed_receiver_instance_type_range_end) { if (!Utils::ApiCheck(i::Internals::kFirstEmbedderJSApiObjectType <= allowed_receiver_instance_type_range_start && allowed_receiver_instance_type_range_start <= allowed_receiver_instance_type_range_end && allowed_receiver_instance_type_range_end <= i::Internals::kLastEmbedderJSApiObjectType, "FunctionTemplate::New", "allowed receiver instance type range is outside the " "range of valid JSApiObject types")) { return {}; } templ->SetAllowedReceiverInstanceTypeRange( allowed_receiver_instance_type_range_start, allowed_receiver_instance_type_range_end); } return Utils::ToLocal(templ); } Local<FunctionTemplate> FunctionTemplate::NewWithCFunctionOverloads( Isolate* v8_isolate, FunctionCallback callback, v8::Local<Value> data, v8::Local<Signature> signature, int length, ConstructorBehavior behavior, SideEffectType side_effect_type, const MemorySpan<const CFunction>& c_function_overloads) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_FunctionTemplate_New); // Check that all overloads of the fast API callback have different numbers of // parameters. Since the number of overloads is supposed to be small, just // comparing them with each other should be fine. for (size_t i = 0; i < c_function_overloads.size(); ++i) { for (size_t j = i + 1; j < c_function_overloads.size(); ++j) { CHECK_NE(c_function_overloads.data()[i].ArgumentCount(), c_function_overloads.data()[j].ArgumentCount()); } } if (!Utils::ApiCheck( c_function_overloads.empty() || behavior == ConstructorBehavior::kThrow, "FunctionTemplate::NewWithCFunctionOverloads", "Fast API calls are not supported for constructor functions")) { return {}; } EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::FunctionTemplateInfo> templ = FunctionTemplateNew( i_isolate, callback, data, signature, length, behavior, false, Local<Private>(), side_effect_type, c_function_overloads); return Utils::ToLocal(templ); } Local<FunctionTemplate> FunctionTemplate::NewWithCache( Isolate* v8_isolate, FunctionCallback callback, Local<Private> cache_property, Local<Value> data, Local<Signature> signature, int length, SideEffectType side_effect_type) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_FunctionTemplate_NewWithCache); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::FunctionTemplateInfo> templ = FunctionTemplateNew( i_isolate, callback, data, signature, length, ConstructorBehavior::kAllow, false, cache_property, side_effect_type); return Utils::ToLocal(templ); } Local<Signature> Signature::New(Isolate* v8_isolate, Local<FunctionTemplate> receiver) { return Local<Signature>::Cast(receiver); } #define SET_FIELD_WRAPPED(i_isolate, obj, setter, cdata, tag) \ do { \ i::DirectHandle<i::UnionOf<i::Smi, i::Foreign>> foreign = \ FromCData<tag>(i_isolate, cdata); \ (obj)->setter(*foreign); \ } while (false) void FunctionTemplate::SetCallHandler( FunctionCallback callback, v8::Local<Data> data, SideEffectType side_effect_type, const MemorySpan<const CFunction>& c_function_overloads) { auto info = Utils::OpenDirectHandle(this); EnsureNotPublished(info, "v8::FunctionTemplate::SetCallHandler"); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::HandleScope scope(i_isolate); info->set_has_side_effects(side_effect_type != SideEffectType::kHasNoSideEffect); info->set_callback(i_isolate, reinterpret_cast<i::Address>(callback)); if (data.IsEmpty()) { data = v8::Undefined(reinterpret_cast<v8::Isolate*>(i_isolate)); } // "Release" callback and callback data fields. info->set_callback_data(*Utils::OpenDirectHandle(*data), kReleaseStore); if (!c_function_overloads.empty()) { // Stores the data for a sequence of CFunction overloads into a single // FixedArray, as [address_0, signature_0, ... address_n-1, signature_n-1]. i::DirectHandle<i::FixedArray> function_overloads = i_isolate->factory()->NewFixedArray(static_cast<int>( c_function_overloads.size() * i::FunctionTemplateInfo::kFunctionOverloadEntrySize)); int function_count = static_cast<int>(c_function_overloads.size()); for (int i = 0; i < function_count; i++) { const CFunction& c_function = c_function_overloads.data()[i]; i::DirectHandle<i::Object> address = FromCData<internal::kCFunctionTag>( i_isolate, c_function.GetAddress()); function_overloads->set( i::FunctionTemplateInfo::kFunctionOverloadEntrySize * i, *address); i::DirectHandle<i::Object> signature = FromCData<internal::kCFunctionInfoTag>(i_isolate, c_function.GetTypeInfo()); function_overloads->set( i::FunctionTemplateInfo::kFunctionOverloadEntrySize * i + 1, *signature); } i::FunctionTemplateInfo::SetCFunctionOverloads(i_isolate, info, function_overloads); } } namespace { template <typename Getter, typename Setter> i::DirectHandle<i::AccessorInfo> MakeAccessorInfo(i::Isolate* i_isolate, v8::Local<Name> name, Getter getter, Setter setter, v8::Local<Value> data, bool replace_on_access) { i::DirectHandle<i::AccessorInfo> obj = i_isolate->factory()->NewAccessorInfo(); obj->set_getter(i_isolate, reinterpret_cast<i::Address>(getter)); DCHECK_IMPLIES(replace_on_access, setter == nullptr); if (setter == nullptr) { #if (__GNUC__ >= 8) || defined(__clang__) #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wcast-function-type" #endif // Cast from 'void (*)(v8::Local<v8::Name>, v8::Local<v8::Value>, const // v8::PropertyCallbackInfo<v8::Boolean> &)' to 'void // (*)(v8::Local<v8::Name>, v8::Local<v8::Value>, const // v8::PropertyCallbackInfo<void> &)'. setter = reinterpret_cast<Setter>(&i::Accessors::ReconfigureToDataProperty); #if (__GNUC__ >= 8) || defined(__clang__) #pragma GCC diagnostic pop #endif } obj->set_setter(i_isolate, reinterpret_cast<i::Address>(setter)); auto accessor_name = Utils::OpenDirectHandle(*name); if (!IsUniqueName(*accessor_name)) { accessor_name = i_isolate->factory()->InternalizeString( i::Cast<i::String>(accessor_name)); } i::DisallowGarbageCollection no_gc; i::Tagged<i::AccessorInfo> raw_obj = *obj; if (data.IsEmpty()) { raw_obj->set_data(i::ReadOnlyRoots(i_isolate).undefined_value()); } else { raw_obj->set_data(*Utils::OpenDirectHandle(*data)); } raw_obj->set_name(*accessor_name); raw_obj->set_replace_on_access(replace_on_access); raw_obj->set_initial_property_attributes(i::NONE); return obj; } } // namespace Local<ObjectTemplate> FunctionTemplate::InstanceTemplate() { auto constructor = Utils::OpenDirectHandle(this, true); if (!Utils::ApiCheck(!constructor.is_null(), "v8::FunctionTemplate::InstanceTemplate()", "Reading from empty handle")) { return {}; } i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); auto maybe_templ = constructor->GetInstanceTemplate(); if (!i::IsUndefined(maybe_templ, i_isolate)) { return Utils::ToLocal(i::direct_handle( i::Cast<i::ObjectTemplateInfo>(maybe_templ), i_isolate)); } constexpr bool do_not_cache = false; i::DirectHandle<i::ObjectTemplateInfo> templ = i_isolate->factory()->NewObjectTemplateInfo(constructor, do_not_cache); i::FunctionTemplateInfo::SetInstanceTemplate(i_isolate, constructor, templ); return Utils::ToLocal(templ); } void FunctionTemplate::SetLength(int length) { auto info = Utils::OpenDirectHandle(this); EnsureNotPublished(info, "v8::FunctionTemplate::SetLength"); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); info->set_length(length); } void FunctionTemplate::SetClassName(Local<String> name) { auto info = Utils::OpenDirectHandle(this); EnsureNotPublished(info, "v8::FunctionTemplate::SetClassName"); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); info->set_class_name(*Utils::OpenDirectHandle(*name)); } void FunctionTemplate::SetInterfaceName(Local<String> name) { auto info = Utils::OpenDirectHandle(this); EnsureNotPublished(info, "v8::FunctionTemplate::SetInterfaceName"); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); info->set_interface_name(*Utils::OpenDirectHandle(*name)); } void FunctionTemplate::SetExceptionContext(ExceptionContext context) { auto info = Utils::OpenDirectHandle(this); EnsureNotPublished(info, "v8::FunctionTemplate::SetExceptionContext"); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); info->set_exception_context(static_cast<uint32_t>(context)); } void FunctionTemplate::SetAcceptAnyReceiver(bool value) { auto info = Utils::OpenDirectHandle(this); EnsureNotPublished(info, "v8::FunctionTemplate::SetAcceptAnyReceiver"); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); info->set_accept_any_receiver(value); } void FunctionTemplate::ReadOnlyPrototype() { auto info = Utils::OpenDirectHandle(this); EnsureNotPublished(info, "v8::FunctionTemplate::ReadOnlyPrototype"); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); info->set_read_only_prototype(true); } void FunctionTemplate::RemovePrototype() { auto info = Utils::OpenDirectHandle(this); EnsureNotPublished(info, "v8::FunctionTemplate::RemovePrototype"); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); info->set_remove_prototype(true); } // --- O b j e c t T e m p l a t e --- Local<ObjectTemplate> ObjectTemplate::New( Isolate* v8_isolate, v8::Local<FunctionTemplate> constructor) { auto i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_ObjectTemplate_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); constexpr bool do_not_cache = false; i::DirectHandle<i::ObjectTemplateInfo> obj = i_isolate->factory()->NewObjectTemplateInfo( Utils::OpenDirectHandle(*constructor, true), do_not_cache); return Utils::ToLocal(obj); } namespace { // Ensure that the object template has a constructor. If no // constructor is available we create one. i::DirectHandle<i::FunctionTemplateInfo> EnsureConstructor( i::Isolate* i_isolate, ObjectTemplate* object_template) { i::Tagged<i::Object> obj = Utils::OpenDirectHandle(object_template)->constructor(); if (!IsUndefined(obj, i_isolate)) { i::Tagged<i::FunctionTemplateInfo> info = i::Cast<i::FunctionTemplateInfo>(obj); return i::DirectHandle<i::FunctionTemplateInfo>(info, i_isolate); } Local<FunctionTemplate> templ = FunctionTemplate::New(reinterpret_cast<Isolate*>(i_isolate)); auto constructor = Utils::OpenDirectHandle(*templ); i::FunctionTemplateInfo::SetInstanceTemplate( i_isolate, constructor, Utils::OpenDirectHandle(object_template)); Utils::OpenDirectHandle(object_template)->set_constructor(*constructor); return constructor; } template <typename Getter, typename Setter, typename Data, typename Template> void TemplateSetAccessor(Template* template_obj, v8::Local<Name> name, Getter getter, Setter setter, Data data, PropertyAttribute attribute, bool replace_on_access, SideEffectType getter_side_effect_type, SideEffectType setter_side_effect_type) { auto info = Utils::OpenDirectHandle(template_obj); auto i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::HandleScope scope(i_isolate); i::DirectHandle<i::AccessorInfo> accessor_info = MakeAccessorInfo( i_isolate, name, getter, setter, data, replace_on_access); { i::DisallowGarbageCollection no_gc; i::Tagged<i::AccessorInfo> raw = *accessor_info; raw->set_initial_property_attributes( static_cast<i::PropertyAttributes>(attribute)); raw->set_getter_side_effect_type(getter_side_effect_type); raw->set_setter_side_effect_type(setter_side_effect_type); } i::ApiNatives::AddNativeDataProperty(i_isolate, info, accessor_info); } } // namespace void Template::SetNativeDataProperty(v8::Local<Name> name, AccessorNameGetterCallback getter, AccessorNameSetterCallback setter, v8::Local<Value> data, PropertyAttribute attribute, SideEffectType getter_side_effect_type, SideEffectType setter_side_effect_type) { TemplateSetAccessor(this, name, getter, setter, data, attribute, false, getter_side_effect_type, setter_side_effect_type); } void Template::SetLazyDataProperty(v8::Local<Name> name, AccessorNameGetterCallback getter, v8::Local<Value> data, PropertyAttribute attribute, SideEffectType getter_side_effect_type, SideEffectType setter_side_effect_type) { TemplateSetAccessor( this, name, getter, static_cast<AccessorNameSetterCallback>(nullptr), data, attribute, true, getter_side_effect_type, setter_side_effect_type); } void Template::SetIntrinsicDataProperty(Local<Name> name, Intrinsic intrinsic, PropertyAttribute attribute) { auto templ = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::HandleScope scope(i_isolate); i::ApiNatives::AddDataProperty(i_isolate, templ, Utils::OpenDirectHandle(*name), intrinsic, static_cast<i::PropertyAttributes>(attribute)); } namespace { enum class PropertyType { kNamed, kIndexed }; template <PropertyType property_type, typename Getter, typename Setter, typename Query, typename Descriptor, typename Deleter, typename Enumerator, typename Definer> i::DirectHandle<i::InterceptorInfo> CreateInterceptorInfo( i::Isolate* i_isolate, Getter getter, Setter setter, Query query, Descriptor descriptor, Deleter deleter, Enumerator enumerator, Definer definer, Local<Value> data, base::Flags<PropertyHandlerFlags> flags) { // TODO(saelo): instead of an in-sandbox struct with a lot of external // pointers (with different tags), consider creating an object in trusted // space instead. That way, only a single reference going out of the sandbox // would be required. auto obj = i_isolate->factory()->NewInterceptorInfo(); obj->set_is_named(property_type == PropertyType::kNamed); #define SET_CALLBACK_FIELD(Name, name) \ if (name != nullptr) { \ if constexpr (property_type == PropertyType::kNamed) { \ obj->set_named_##name(i_isolate, reinterpret_cast<i::Address>(name)); \ } else { \ obj->set_indexed_##name(i_isolate, reinterpret_cast<i::Address>(name)); \ } \ } INTERCEPTOR_INFO_CALLBACK_LIST(SET_CALLBACK_FIELD) #undef SET_CALLBACK_FIELD obj->set_can_intercept_symbols( !(flags & PropertyHandlerFlags::kOnlyInterceptStrings)); obj->set_non_masking(flags & PropertyHandlerFlags::kNonMasking); obj->set_has_no_side_effect(flags & PropertyHandlerFlags::kHasNoSideEffect); obj->set_has_dont_delete_property( flags & PropertyHandlerFlags::kHasDontDeleteProperty); if (data.IsEmpty()) { data = v8::Undefined(reinterpret_cast<v8::Isolate*>(i_isolate)); } obj->set_data(*Utils::OpenDirectHandle(*data)); return obj; } template <typename Getter, typename Setter, typename Query, typename Descriptor, typename Deleter, typename Enumerator, typename Definer> i::DirectHandle<i::InterceptorInfo> CreateNamedInterceptorInfo( i::Isolate* i_isolate, Getter getter, Setter setter, Query query, Descriptor descriptor, Deleter remover, Enumerator enumerator, Definer definer, Local<Value> data, base::Flags<PropertyHandlerFlags> flags) { auto interceptor = CreateInterceptorInfo<PropertyType::kNamed>( i_isolate, getter, setter, query, descriptor, remover, enumerator, definer, data, flags); return interceptor; } template <typename Getter, typename Setter, typename Query, typename Descriptor, typename Deleter, typename Enumerator, typename Definer> i::DirectHandle<i::InterceptorInfo> CreateIndexedInterceptorInfo( i::Isolate* i_isolate, Getter getter, Setter setter, Query query, Descriptor descriptor, Deleter remover, Enumerator enumerator, Definer definer, Local<Value> data, base::Flags<PropertyHandlerFlags> flags) { auto interceptor = CreateInterceptorInfo<PropertyType::kIndexed>( i_isolate, getter, setter, query, descriptor, remover, enumerator, definer, data, flags); return interceptor; } template <typename Getter, typename Setter, typename Query, typename Descriptor, typename Deleter, typename Enumerator, typename Definer> void ObjectTemplateSetNamedPropertyHandler( ObjectTemplate* templ, Getter getter, Setter setter, Query query, Descriptor descriptor, Deleter remover, Enumerator enumerator, Definer definer, Local<Value> data, PropertyHandlerFlags flags) { i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::HandleScope scope(i_isolate); auto cons = EnsureConstructor(i_isolate, templ); EnsureNotPublished(cons, "ObjectTemplateSetNamedPropertyHandler"); auto obj = CreateNamedInterceptorInfo(i_isolate, getter, setter, query, descriptor, remover, enumerator, definer, data, flags); i::FunctionTemplateInfo::SetNamedPropertyHandler(i_isolate, cons, obj); } } // namespace void ObjectTemplate::SetHandler( const NamedPropertyHandlerConfiguration& config) { ObjectTemplateSetNamedPropertyHandler( this, config.getter, config.setter, config.query, config.descriptor, config.deleter, config.enumerator, config.definer, config.data, config.flags); } void ObjectTemplate::MarkAsUndetectable() { i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::HandleScope scope(i_isolate); auto cons = EnsureConstructor(i_isolate, this); EnsureNotPublished(cons, "v8::ObjectTemplate::MarkAsUndetectable"); cons->set_undetectable(true); } void ObjectTemplate::SetAccessCheckCallback(AccessCheckCallback callback, Local<Value> data) { i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::HandleScope scope(i_isolate); auto cons = EnsureConstructor(i_isolate, this); EnsureNotPublished(cons, "v8::ObjectTemplate::SetAccessCheckCallback"); i::DirectHandle<i::Struct> struct_info = i_isolate->factory()->NewStruct( i::ACCESS_CHECK_INFO_TYPE, i::AllocationType::kOld); auto info = i::Cast<i::AccessCheckInfo>(struct_info); SET_FIELD_WRAPPED(i_isolate, info, set_callback, callback, internal::kApiAccessCheckCallbackTag); info->set_named_interceptor(i::Smi::zero()); info->set_indexed_interceptor(i::Smi::zero()); if (data.IsEmpty()) { data = v8::Undefined(reinterpret_cast<v8::Isolate*>(i_isolate)); } info->set_data(*Utils::OpenDirectHandle(*data)); i::FunctionTemplateInfo::SetAccessCheckInfo(i_isolate, cons, info); cons->set_needs_access_check(true); } void ObjectTemplate::SetAccessCheckCallbackAndHandler( AccessCheckCallback callback, const NamedPropertyHandlerConfiguration& named_handler, const IndexedPropertyHandlerConfiguration& indexed_handler, Local<Value> data) { i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::HandleScope scope(i_isolate); auto cons = EnsureConstructor(i_isolate, this); EnsureNotPublished(cons, "v8::ObjectTemplate::SetAccessCheckCallbackWithHandler"); i::DirectHandle<i::Struct> struct_info = i_isolate->factory()->NewStruct( i::ACCESS_CHECK_INFO_TYPE, i::AllocationType::kOld); auto info = i::Cast<i::AccessCheckInfo>(struct_info); SET_FIELD_WRAPPED(i_isolate, info, set_callback, callback, internal::kApiAccessCheckCallbackTag); auto named_interceptor = CreateNamedInterceptorInfo( i_isolate, named_handler.getter, named_handler.setter, named_handler.query, named_handler.descriptor, named_handler.deleter, named_handler.enumerator, named_handler.definer, named_handler.data, named_handler.flags); info->set_named_interceptor(*named_interceptor); auto indexed_interceptor = CreateIndexedInterceptorInfo( i_isolate, indexed_handler.getter, indexed_handler.setter, indexed_handler.query, indexed_handler.descriptor, indexed_handler.deleter, indexed_handler.enumerator, indexed_handler.definer, indexed_handler.data, indexed_handler.flags); info->set_indexed_interceptor(*indexed_interceptor); if (data.IsEmpty()) { data = v8::Undefined(reinterpret_cast<v8::Isolate*>(i_isolate)); } info->set_data(*Utils::OpenDirectHandle(*data)); i::FunctionTemplateInfo::SetAccessCheckInfo(i_isolate, cons, info); cons->set_needs_access_check(true); } void ObjectTemplate::SetHandler( const IndexedPropertyHandlerConfiguration& config) { i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::HandleScope scope(i_isolate); auto cons = EnsureConstructor(i_isolate, this); EnsureNotPublished(cons, "v8::ObjectTemplate::SetHandler"); auto obj = CreateIndexedInterceptorInfo( i_isolate, config.getter, config.setter, config.query, config.descriptor, config.deleter, config.enumerator, config.definer, config.data, config.flags); i::FunctionTemplateInfo::SetIndexedPropertyHandler(i_isolate, cons, obj); } void ObjectTemplate::SetCallAsFunctionHandler(FunctionCallback callback, Local<Value> data) { i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::HandleScope scope(i_isolate); auto cons = EnsureConstructor(i_isolate, this); EnsureNotPublished(cons, "v8::ObjectTemplate::SetCallAsFunctionHandler"); DCHECK_NOT_NULL(callback); // This template is just a container for callback and data values and thus // it's not supposed to be instantiated. Don't cache it. constexpr bool do_not_cache = true; constexpr int length = 0; i::DirectHandle<i::FunctionTemplateInfo> templ = i_isolate->factory()->NewFunctionTemplateInfo(length, do_not_cache); templ->set_is_object_template_call_handler(true); Utils::ToLocal(templ)->SetCallHandler(callback, data); i::FunctionTemplateInfo::SetInstanceCallHandler(i_isolate, cons, templ); } int ObjectTemplate::InternalFieldCount() const { return Utils::OpenDirectHandle(this)->embedder_field_count(); } void ObjectTemplate::SetInternalFieldCount(int value) { i::Isolate* i_isolate = i::Isolate::Current(); if (!Utils::ApiCheck(i::Smi::IsValid(value), "v8::ObjectTemplate::SetInternalFieldCount()", "Invalid embedder field count")) { return; } EnterV8NoScriptNoExceptionScope api_scope(i_isolate); if (value > 0) { // The embedder field count is set by the constructor function's // construct code, so we ensure that there is a constructor // function to do the setting. EnsureConstructor(i_isolate, this); } Utils::OpenDirectHandle(this)->set_embedder_field_count(value); } bool ObjectTemplate::IsImmutableProto() const { return Utils::OpenDirectHandle(this)->immutable_proto(); } void ObjectTemplate::SetImmutableProto() { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); self->set_immutable_proto(true); } bool ObjectTemplate::IsCodeLike() const { return Utils::OpenDirectHandle(this)->code_like(); } void ObjectTemplate::SetCodeLike() { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); self->set_code_like(true); } Local<DictionaryTemplate> DictionaryTemplate::New( Isolate* isolate, MemorySpan<const std::string_view> names) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_DictionaryTemplate_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); return Utils::ToLocal(i::DictionaryTemplateInfo::Create(i_isolate, names)); } Local<Object> DictionaryTemplate::NewInstance( Local<Context> context, MemorySpan<MaybeLocal<Value>> property_values) { i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope( i_isolate, RCCId::kAPI_DictionaryTemplate_NewInstance); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); auto self = Utils::OpenDirectHandle(this); return ToApiHandle<Object>(i::DictionaryTemplateInfo::NewInstance( Utils::OpenDirectHandle(*context), self, property_values)); } // --- S c r i p t s --- // Internally, UnboundScript and UnboundModuleScript are SharedFunctionInfos, // and Script is a JSFunction. ScriptCompiler::CachedData::CachedData(const uint8_t* data_, int length_, BufferPolicy buffer_policy_) : data(data_), length(length_), rejected(false), buffer_policy(buffer_policy_) {} ScriptCompiler::CachedData::~CachedData() { if (buffer_policy == BufferOwned) { delete[] data; } } ScriptCompiler::CachedData::CompatibilityCheckResult ScriptCompiler::CachedData::CompatibilityCheck(Isolate* isolate) { i::AlignedCachedData aligned(data, length); i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(isolate); i::SerializedCodeSanityCheckResult result; i::SerializedCodeData scd = i::SerializedCodeData::FromCachedDataWithoutSource( i_isolate->AsLocalIsolate(), &aligned, &result); return static_cast<ScriptCompiler::CachedData::CompatibilityCheckResult>( result); } ScriptCompiler::StreamedSource::StreamedSource( std::unique_ptr<ExternalSourceStream> stream, Encoding encoding) : impl_(new i::ScriptStreamingData(std::move(stream), encoding)) {} ScriptCompiler::StreamedSource::~StreamedSource() = default; Local<Script> UnboundScript::BindToCurrentContext() { auto function_info = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::JSFunction> function = i::Factory::JSFunctionBuilder{i_isolate, function_info, i_isolate->native_context()} .Build(); return ToApiHandle<Script>(function); } int UnboundScript::GetId() const { return ScriptId(); } int UnboundScript::ScriptId() const { auto function_info = Utils::OpenDirectHandle(this); ApiRuntimeCallStatsScope rcs_scope(i::Isolate::Current(), RCCId::kAPI_UnboundScript_ScriptId); return i::Cast<i::Script>(function_info->script())->id(); } int UnboundScript::GetLineNumber(int code_pos) { auto obj = Utils::OpenDirectHandle(this); if (!i::IsScript(obj->script())) return -1; i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_UnboundScript_GetLineNumber); i::DirectHandle<i::Script> script(i::Cast<i::Script>(obj->script()), i_isolate); return i::Script::GetLineNumber(script, code_pos); } int UnboundScript::GetColumnNumber(int code_pos) { auto obj = Utils::OpenDirectHandle(this); if (!i::IsScript(obj->script())) return -1; i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_UnboundScript_GetColumnNumber); i::DirectHandle<i::Script> script(i::Cast<i::Script>(obj->script()), i_isolate); return i::Script::GetColumnNumber(script, code_pos); } Local<Value> UnboundScript::GetScriptName() { auto obj = Utils::OpenDirectHandle(this); if (!i::IsScript(obj->script())) return {}; i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_UnboundScript_GetName); i::Tagged<i::Object> name = i::Cast<i::Script>(obj->script())->name(); return Utils::ToLocal(i::direct_handle(name, i_isolate)); } Local<Value> UnboundScript::GetSourceURL() { auto obj = Utils::OpenDirectHandle(this); if (!i::IsScript(obj->script())) return {}; i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_UnboundScript_GetSourceURL); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::Tagged<i::Object> url = i::Cast<i::Script>(obj->script())->source_url(); return Utils::ToLocal(i::direct_handle(url, i_isolate)); } Local<Value> UnboundScript::GetSourceMappingURL() { auto obj = Utils::OpenDirectHandle(this); if (!i::IsScript(obj->script())) return {}; i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope( i_isolate, RCCId::kAPI_UnboundScript_GetSourceMappingURL); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::Tagged<i::Object> url = i::Cast<i::Script>(obj->script())->source_mapping_url(); return Utils::ToLocal(i::direct_handle(url, i_isolate)); } Local<Value> UnboundModuleScript::GetSourceURL() { auto obj = Utils::OpenDirectHandle(this); if (!i::IsScript(obj->script())) return {}; i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope( i_isolate, RCCId::kAPI_UnboundModuleScript_GetSourceURL); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::Tagged<i::Object> url = i::Cast<i::Script>(obj->script())->source_url(); return Utils::ToLocal(i::direct_handle(url, i_isolate)); } int UnboundModuleScript::ScriptId() const { ApiRuntimeCallStatsScope rcs_scope(i::Isolate::Current(), RCCId::kAPI_UnboundModuleScript_ScriptId); auto obj = Utils::OpenDirectHandle(this); if (!i::IsScript(obj->script())) return kNoScriptId; return i::Cast<i::Script>(obj->script())->id(); } Local<Value> UnboundModuleScript::GetSourceMappingURL() { auto obj = Utils::OpenDirectHandle(this); if (!i::IsScript(obj->script())) return {}; i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope( i_isolate, RCCId::kAPI_UnboundModuleScript_GetSourceMappingURL); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::Tagged<i::Object> url = i::Cast<i::Script>(obj->script())->source_mapping_url(); return Utils::ToLocal(i::direct_handle(url, i_isolate)); } MaybeLocal<Value> Script::Run(Local<Context> context) { return Run(context, Local<Data>()); } MaybeLocal<Value> Script::Run(Local<Context> context, Local<Data> host_defined_options) { auto i_isolate = i::Isolate::Current(); TRACE_EVENT_CALL_STATS_SCOPED(i_isolate, "v8", "V8.Execute"); EnterV8Scope<InternalEscapableScope> api_scope{i_isolate, context, RCCId::kAPI_Script_Run}; i::TimerEventScope<i::TimerEventExecute> timer_scope(i_isolate); i::NestedTimedHistogramScope execute_timer(i_isolate->counters()->execute(), i_isolate); i::AggregatingHistogramTimerScope histogram_timer( i_isolate->counters()->compile_lazy()); #if defined(V8_ENABLE_ETW_STACK_WALKING) // In case ETW has been activated, tasks to log existing code are // created. But in case the task runner does not run those before // starting to execute code (as it happens in d8, that will run // first the code from prompt), then that code will not have // JIT instrumentation on time. // // To avoid this, on running scripts check first if JIT code log is // pending and generate immediately. if (i::v8_flags.enable_etw_stack_walking || i::v8_flags.enable_etw_by_custom_filter_only) { i::ETWJITInterface::MaybeSetHandlerNow(i_isolate); } #endif // V8_ENABLE_ETW_STACK_WALKING auto fun = i::Cast<i::JSFunction>(Utils::OpenDirectHandle(this)); i::DirectHandle<i::Object> receiver = i_isolate->global_proxy(); // TODO(cbruni, chromium:1244145): Remove once migrated to the context. i::DirectHandle<i::Object> options( i::Cast<i::Script>(fun->shared()->script())->host_defined_options(), i_isolate); return api_scope.EscapeMaybe( i::Execution::CallScript(i_isolate, fun, receiver, options)); } Local<Value> ScriptOrModule::GetResourceName() { auto obj = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); return ToApiHandle<Value>(i::direct_handle(obj->resource_name(), i_isolate)); } Local<Data> ScriptOrModule::HostDefinedOptions() { auto obj = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); return ToApiHandle<Data>( i::direct_handle(obj->host_defined_options(), i_isolate)); } Local<UnboundScript> Script::GetUnboundScript() { i::DisallowGarbageCollection no_gc; auto obj = Utils::OpenDirectHandle(this); i::DirectHandle<i::SharedFunctionInfo> sfi(obj->shared(), i::Isolate::Current()); DCHECK(!i::HeapLayout::InReadOnlySpace(*sfi)); return ToApiHandle<UnboundScript>(sfi); } int Script::ScriptId() const { i::DisallowGarbageCollection no_gc; auto obj = Utils::OpenDirectHandle(this); auto sfi = obj->shared(); DCHECK(!i::HeapLayout::InReadOnlySpace(sfi)); auto script = sfi->script(); CHECK(IsScript(sfi->script())); return i::Cast<i::Script>(script)->id(); } Local<Value> Script::GetResourceName() { i::DisallowGarbageCollection no_gc; auto func = Utils::OpenDirectHandle(this); i::Tagged<i::SharedFunctionInfo> sfi = func->shared(); CHECK(IsScript(sfi->script())); i::Isolate* i_isolate = i::Isolate::Current(); return ToApiHandle<Value>( i::direct_handle(i::Cast<i::Script>(sfi->script())->name(), i_isolate)); } std::vector<int> Script::GetProducedCompileHints() const { i::DisallowGarbageCollection no_gc; auto func = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); i::Tagged<i::SharedFunctionInfo> sfi = func->shared(); CHECK(IsScript(sfi->script())); i::Tagged<i::Script> script = i::Cast<i::Script>(sfi->script()); i::Tagged<i::Object> maybe_array_list = script->compiled_lazy_function_positions(); std::vector<int> result; if (!IsUndefined(maybe_array_list, i_isolate)) { i::Tagged<i::ArrayList> array_list = i::Cast<i::ArrayList>(maybe_array_list); result.reserve(array_list->length()); for (int i = 0; i < array_list->length(); ++i) { i::Tagged<i::Object> item = array_list->get(i); CHECK(IsSmi(item)); result.push_back(i::Smi::ToInt(item)); } } return result; } Local<CompileHintsCollector> Script::GetCompileHintsCollector() const { i::DisallowGarbageCollection no_gc; auto func = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); i::Tagged<i::SharedFunctionInfo> sfi = func->shared(); CHECK(IsScript(sfi->script())); i::DirectHandle<i::Script> script(i::Cast<i::Script>(sfi->script()), i_isolate); return ToApiHandle<CompileHintsCollector>(script); } std::vector<int> CompileHintsCollector::GetCompileHints( Isolate* v8_isolate) const { i::DisallowGarbageCollection no_gc; auto script = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i::Tagged<i::Object> maybe_array_list = script->compiled_lazy_function_positions(); std::vector<int> result; if (!IsUndefined(maybe_array_list, i_isolate)) { i::Tagged<i::ArrayList> array_list = i::Cast<i::ArrayList>(maybe_array_list); result.reserve(array_list->length()); for (int i = 0; i < array_list->length(); ++i) { i::Tagged<i::Object> item = array_list->get(i); CHECK(IsSmi(item)); result.push_back(i::Smi::ToInt(item)); } } return result; } // static Local<PrimitiveArray> PrimitiveArray::New(Isolate* v8_isolate, int length) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); Utils::ApiCheck(length >= 0, "v8::PrimitiveArray::New", "length must be equal or greater than zero"); i::DirectHandle<i::FixedArray> array = i_isolate->factory()->NewFixedArray(length); return ToApiHandle<PrimitiveArray>(array); } int PrimitiveArray::Length() const { return Utils::OpenDirectHandle(this)->length(); } void PrimitiveArray::Set(Isolate* v8_isolate, int index, Local<Primitive> item) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); auto array = Utils::OpenDirectHandle(this); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); Utils::ApiCheck(index >= 0 && index < array->length(), "v8::PrimitiveArray::Set", "index must be greater than or equal to 0 and less than the " "array length"); array->set(index, *Utils::OpenDirectHandle(*item)); } Local<Primitive> PrimitiveArray::Get(Isolate* v8_isolate, int index) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); auto array = Utils::OpenDirectHandle(this); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); Utils::ApiCheck(index >= 0 && index < array->length(), "v8::PrimitiveArray::Get", "index must be greater than or equal to 0 and less than the " "array length"); return ToApiHandle<Primitive>(i::direct_handle(array->get(index), i_isolate)); } void v8::PrimitiveArray::CheckCast(v8::Data* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck( i::IsFixedArray(*obj), "v8::PrimitiveArray::Cast", "Value is not a PrimitiveArray; this is a temporary issue, v8::Data and " "v8::PrimitiveArray will not be compatible in the future"); } int FixedArray::Length() const { return Utils::OpenDirectHandle(this)->length(); } Local<Data> FixedArray::Get(int i) const { auto self = Utils::OpenDirectHandle(this); auto i_isolate = i::Isolate::Current(); #if V8_ENABLE_CHECKS Utils::ApiCheck(i < self->length(), "v8::FixedArray::Get", "index out of bounds"); #endif return ToApiHandle<Data>(i::direct_handle(self->get(i), i_isolate)); } Local<String> ModuleRequest::GetSpecifier() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); return ToApiHandle<String>(i::direct_handle(self->specifier(), i_isolate)); } ModuleImportPhase ModuleRequest::GetPhase() const { auto self = Utils::OpenDirectHandle(this); return self->phase(); } int ModuleRequest::GetSourceOffset() const { return Utils::OpenDirectHandle(this)->position(); } Local<FixedArray> ModuleRequest::GetImportAttributes() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); return ToApiHandle<FixedArray>( i::direct_handle(self->import_attributes(), i_isolate)); } Local<Value> Module::GetResourceName() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); i::DisallowGarbageCollection no_gc; i::DirectHandle<i::SyntheticModule> synthetic_module; if (i::TryCast<i::SyntheticModule>(self, &synthetic_module)) { return ToApiHandle<Value>( i::direct_handle(synthetic_module->name(), i_isolate)); } i::DirectHandle<i::SharedFunctionInfo> sfi( i::Cast<i::SourceTextModule>(self)->GetSharedFunctionInfo(), i_isolate); CHECK(IsScript(sfi->script())); return ToApiHandle<Value>( i::direct_handle(i::Cast<i::Script>(sfi->script())->name(), i_isolate)); } Module::Status Module::GetStatus() const { auto self = Utils::OpenDirectHandle(this); switch (self->status()) { case i::Module::kUnlinked: case i::Module::kPreLinking: return kUninstantiated; case i::Module::kLinking: return kInstantiating; case i::Module::kLinked: return kInstantiated; case i::Module::kEvaluating: return kEvaluating; case i::Module::kEvaluatingAsync: // TODO(syg): Expose kEvaluatingAsync in API as well. case i::Module::kEvaluated: return kEvaluated; case i::Module::kErrored: return kErrored; } UNREACHABLE(); } Local<Value> Module::GetException() const { Utils::ApiCheck(GetStatus() == kErrored, "v8::Module::GetException", "Module status must be kErrored"); auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); return ToApiHandle<Value>(i::direct_handle(self->GetException(), i_isolate)); } Local<FixedArray> Module::GetModuleRequests() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); i::DisallowJavascriptExecutionDebugOnly no_execution(i_isolate); i::DisallowExceptionsDebugOnly no_exceptions(i_isolate); if (i::IsSyntheticModule(*self)) { // Synthetic modules are leaf nodes in the module graph. They have no // ModuleRequests. return ToApiHandle<FixedArray>(i_isolate->factory()->empty_fixed_array()); } else { return ToApiHandle<FixedArray>(i::direct_handle( i::Cast<i::SourceTextModule>(self)->info()->module_requests(), i_isolate)); } } Location Module::SourceOffsetToLocation(int offset) const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::HandleScope scope(i_isolate); Utils::ApiCheck( i::IsSourceTextModule(*self), "v8::Module::SourceOffsetToLocation", "v8::Module::SourceOffsetToLocation must be used on an SourceTextModule"); i::DirectHandle<i::Script> script( i::Cast<i::SourceTextModule>(self)->GetScript(), i_isolate); i::Script::PositionInfo info; i::Script::GetPositionInfo(script, offset, &info); return v8::Location(info.line, info.column); } Local<Value> Module::GetModuleNamespace() { Utils::ApiCheck( GetStatus() >= kInstantiated, "v8::Module::GetModuleNamespace", "v8::Module::GetModuleNamespace must be used on an instantiated module"); auto self = Utils::OpenHandle(this); auto i_isolate = i::Isolate::Current(); i::DisallowJavascriptExecutionDebugOnly no_execution(i_isolate); i::DisallowExceptionsDebugOnly no_exceptions(i_isolate); i::DirectHandle<i::JSModuleNamespace> module_namespace = i::Module::GetModuleNamespace(i_isolate, self); return ToApiHandle<Value>(module_namespace); } Local<UnboundModuleScript> Module::GetUnboundModuleScript() { auto self = Utils::OpenDirectHandle(this); Utils::ApiCheck( i::IsSourceTextModule(*self), "v8::Module::GetUnboundModuleScript", "v8::Module::GetUnboundModuleScript must be used on an SourceTextModule"); auto i_isolate = i::Isolate::Current(); i::DisallowJavascriptExecutionDebugOnly no_execution(i_isolate); i::DisallowExceptionsDebugOnly no_exceptions(i_isolate); return ToApiHandle<UnboundModuleScript>(i::direct_handle( i::Cast<i::SourceTextModule>(self)->GetSharedFunctionInfo(), i_isolate)); } int Module::ScriptId() const { i::Tagged<i::Module> self = *Utils::OpenDirectHandle(this); Utils::ApiCheck(i::IsSourceTextModule(self), "v8::Module::ScriptId", "v8::Module::ScriptId must be used on an SourceTextModule"); i::DisallowJavascriptExecutionDebugOnly no_execution; i::DisallowExceptionsDebugOnly no_exceptions; return i::Cast<i::SourceTextModule>(self)->GetScript()->id(); } bool Module::HasTopLevelAwait() const { i::Tagged<i::Module> self = *Utils::OpenDirectHandle(this); if (!i::IsSourceTextModule(self)) return false; return i::Cast<i::SourceTextModule>(self)->has_toplevel_await(); } bool Module::IsGraphAsync() const { Utils::ApiCheck( GetStatus() >= kInstantiated, "v8::Module::IsGraphAsync", "v8::Module::IsGraphAsync must be used on an instantiated module"); i::Tagged<i::Module> self = *Utils::OpenDirectHandle(this); auto i_isolate = i::Isolate::Current(); i::DisallowJavascriptExecutionDebugOnly no_execution(i_isolate); i::DisallowExceptionsDebugOnly no_exceptions(i_isolate); return self->IsGraphAsync(i_isolate); } bool Module::IsSourceTextModule() const { auto self = Utils::OpenDirectHandle(this); i::DisallowJavascriptExecutionDebugOnly no_execution; i::DisallowExceptionsDebugOnly no_exceptions; return i::IsSourceTextModule(*self); } bool Module::IsSyntheticModule() const { auto self = Utils::OpenDirectHandle(this); i::DisallowJavascriptExecutionDebugOnly no_execution; i::DisallowExceptionsDebugOnly no_exceptions; return i::IsSyntheticModule(*self); } int Module::GetIdentityHash() const { auto self = Utils::OpenDirectHandle(this); i::DisallowJavascriptExecutionDebugOnly no_execution; i::DisallowExceptionsDebugOnly no_exceptions; return self->hash(); } Maybe<bool> Module::InstantiateModule( Local<Context> context, ResolveModuleByIndexCallback module_callback, ResolveSourceByIndexCallback source_callback) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Module_InstantiateModule}; i::Module::UserResolveCallbacks callbacks; callbacks.module_callback_by_index = module_callback; callbacks.source_callback_by_index = source_callback; if (!i::Module::Instantiate(i_isolate, Utils::OpenHandle(this), context, callbacks)) { return {}; } return Just(true); } Maybe<bool> Module::InstantiateModule(Local<Context> context, ResolveModuleCallback module_callback, ResolveSourceCallback source_callback) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Module_InstantiateModule}; i::Module::UserResolveCallbacks callbacks; callbacks.module_callback = module_callback; callbacks.source_callback = source_callback; if (!i::Module::Instantiate(i_isolate, Utils::OpenHandle(this), context, callbacks)) { return {}; } return Just(true); } MaybeLocal<Value> Module::Evaluate(Local<Context> context) { auto i_isolate = i::Isolate::Current(); TRACE_EVENT_CALL_STATS_SCOPED(i_isolate, "v8", "V8.Execute"); EnterV8Scope<InternalEscapableScope> api_scope{i_isolate, context, RCCId::kAPI_Module_Evaluate}; i::TimerEventScope<i::TimerEventExecute> timer_scope(i_isolate); i::NestedTimedHistogramScope execute_timer(i_isolate->counters()->execute(), i_isolate); i::AggregatingHistogramTimerScope timer( i_isolate->counters()->compile_lazy()); auto self = Utils::OpenHandle(this); Utils::ApiCheck(self->status() >= i::Module::kLinked, "Module::Evaluate", "Expected instantiated module"); return api_scope.EscapeMaybe(i::Module::Evaluate(i_isolate, self)); } Local<Module> Module::CreateSyntheticModule( Isolate* v8_isolate, Local<String> module_name, const MemorySpan<const Local<String>>& export_names, v8::Module::SyntheticModuleEvaluationSteps evaluation_steps) { auto i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); auto i_module_name = Utils::OpenDirectHandle(*module_name); i::DirectHandle<i::FixedArray> i_export_names = i_isolate->factory()->NewFixedArray( static_cast<int>(export_names.size())); for (int i = 0; i < i_export_names->length(); ++i) { i::DirectHandle<i::String> str = i_isolate->factory()->InternalizeString( Utils::OpenDirectHandle(*export_names[i])); i_export_names->set(i, *str); } return v8::Utils::ToLocal( i::DirectHandle<i::Module>(i_isolate->factory()->NewSyntheticModule( i_module_name, i_export_names, evaluation_steps))); } Maybe<bool> Module::SetSyntheticModuleExport(Isolate* v8_isolate, Local<String> export_name, Local<v8::Value> export_value) { auto i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); auto i_export_name = Utils::OpenDirectHandle(*export_name); auto i_export_value = Utils::OpenDirectHandle(*export_value); auto self = Utils::OpenDirectHandle(this); Utils::ApiCheck(i::IsSyntheticModule(*self), "v8::Module::SyntheticModuleSetExport", "v8::Module::SyntheticModuleSetExport must only be called on " "a SyntheticModule"); EnterV8NoScriptScope<> api_scope{i_isolate, v8_isolate->GetCurrentContext(), RCCId::kAPI_Module_SetSyntheticModuleExport}; if (i::SyntheticModule::SetExport(i_isolate, i::Cast<i::SyntheticModule>(self), i_export_name, i_export_value) .IsNothing()) { return {}; } return Just(true); } std::pair<LocalVector<Module>, LocalVector<Message>> Module::GetStalledTopLevelAwaitMessages(Isolate* isolate) { auto i_isolate = reinterpret_cast<i::Isolate*>(isolate); auto self = Utils::OpenDirectHandle(this); Utils::ApiCheck(i::IsSourceTextModule(*self), "v8::Module::GetStalledTopLevelAwaitMessages", "v8::Module::GetStalledTopLevelAwaitMessages must only be " "called on a SourceTextModule"); std::pair<i::DirectHandleVector<i::SourceTextModule>, i::DirectHandleVector<i::JSMessageObject>> stalled_awaits = i::Cast<i::SourceTextModule>(self)->GetStalledTopLevelAwaitMessages( i_isolate); LocalVector<Module> modules(isolate); if (size_t stalled_awaits_count = stalled_awaits.first.size(); stalled_awaits_count > 0) { modules.reserve(stalled_awaits_count); for (auto module : stalled_awaits.first) modules.push_back(ToApiHandle<Module>(module)); } LocalVector<Message> messages(isolate); if (size_t stalled_awaits_count = stalled_awaits.second.size(); stalled_awaits_count > 0) { messages.reserve(stalled_awaits_count); for (auto message : stalled_awaits.second) messages.push_back(ToApiHandle<Message>(message)); } return {modules, messages}; } namespace { i::ScriptDetails GetScriptDetails( i::Isolate* i_isolate, Local<Value> resource_name, int resource_line_offset, int resource_column_offset, Local<Value> source_map_url, Local<Data> host_defined_options, ScriptOriginOptions origin_options) { i::ScriptDetails script_details(Utils::OpenHandle(*(resource_name), true), origin_options); script_details.line_offset = resource_line_offset; script_details.column_offset = resource_column_offset; script_details.host_defined_options = host_defined_options.IsEmpty() ? i_isolate->factory()->empty_fixed_array() : Utils::OpenHandle(*(host_defined_options)); if (!source_map_url.IsEmpty()) { script_details.source_map_url = Utils::OpenHandle(*(source_map_url)); } return script_details; } } // namespace MaybeLocal<UnboundScript> ScriptCompiler::CompileUnboundInternal( Isolate* v8_isolate, Source* source, CompileOptions options, NoCacheReason no_cache_reason) { auto i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); TRACE_EVENT_CALL_STATS_SCOPED(i_isolate, "v8", "V8.ScriptCompiler"); EnterV8NoScriptScope<InternalEscapableScope> api_scope{ i_isolate, v8_isolate->GetCurrentContext(), RCCId::kAPI_ScriptCompiler_CompileUnbound}; auto str = Utils::OpenHandle(*(source->source_string)); i::DirectHandle<i::SharedFunctionInfo> result; TRACE_EVENT0(TRACE_DISABLED_BY_DEFAULT("v8.compile"), "V8.CompileScript"); i::ScriptDetails script_details = GetScriptDetails( i_isolate, source->resource_name, source->resource_line_offset, source->resource_column_offset, source->source_map_url, source->host_defined_options, source->resource_options); i::MaybeDirectHandle<i::SharedFunctionInfo> maybe_function_info; if (options & kConsumeCodeCache) { if (source->consume_cache_task) { // Take ownership of the internal deserialization task and clear it off // the consume task on the source. DCHECK_NOT_NULL(source->consume_cache_task->impl_); std::unique_ptr<i::BackgroundDeserializeTask> deserialize_task = std::move(source->consume_cache_task->impl_); maybe_function_info = i::Compiler::GetSharedFunctionInfoForScriptWithDeserializeTask( i_isolate, str, script_details, deserialize_task.get(), options, no_cache_reason, i::NOT_NATIVES_CODE, &source->compilation_details); source->cached_data->rejected = deserialize_task->rejected(); } else { DCHECK(source->cached_data); // AlignedCachedData takes care of pointer-aligning the data. auto cached_data = std::make_unique<i::AlignedCachedData>( source->cached_data->data, source->cached_data->length); maybe_function_info = i::Compiler::GetSharedFunctionInfoForScriptWithCachedData( i_isolate, str, script_details, cached_data.get(), options, no_cache_reason, i::NOT_NATIVES_CODE, &source->compilation_details); source->cached_data->rejected = cached_data->rejected(); } } else if (options & kConsumeCompileHints) { maybe_function_info = i::Compiler::GetSharedFunctionInfoForScriptWithCompileHints( i_isolate, str, script_details, source->compile_hint_callback, source->compile_hint_callback_data, options, no_cache_reason, i::NOT_NATIVES_CODE, &source->compilation_details); } else { // Compile without any cache. maybe_function_info = i::Compiler::GetSharedFunctionInfoForScript( i_isolate, str, script_details, options, no_cache_reason, i::NOT_NATIVES_CODE, &source->compilation_details); } if (!maybe_function_info.ToHandle(&result)) return {}; DCHECK(!i::HeapLayout::InReadOnlySpace(*result)); return api_scope.Escape(ToApiHandle<UnboundScript>(result)); } MaybeLocal<UnboundScript> ScriptCompiler::CompileUnboundScript( Isolate* v8_isolate, Source* source, CompileOptions options, NoCacheReason no_cache_reason) { Utils::ApiCheck( !source->GetResourceOptions().IsModule(), "v8::ScriptCompiler::CompileUnboundScript", "v8::ScriptCompiler::CompileModule must be used to compile modules"); return CompileUnboundInternal(v8_isolate, source, options, no_cache_reason); } MaybeLocal<Script> ScriptCompiler::Compile(Local<Context> context, Source* source, CompileOptions options, NoCacheReason no_cache_reason) { Utils::ApiCheck( !source->GetResourceOptions().IsModule(), "v8::ScriptCompiler::Compile", "v8::ScriptCompiler::CompileModule must be used to compile modules"); v8::Isolate* isolate = v8::Isolate::GetCurrent(); MaybeLocal<UnboundScript> maybe = CompileUnboundInternal(isolate, source, options, no_cache_reason); Local<UnboundScript> result; if (!maybe.ToLocal(&result)) return {}; v8::Context::Scope scope(context); return result->BindToCurrentContext(); } MaybeLocal<Module> ScriptCompiler::CompileModule( Isolate* v8_isolate, Source* source, CompileOptions options, NoCacheReason no_cache_reason) { Utils::ApiCheck(v8::ScriptCompiler::CompileOptionsIsValid(options), "v8::ScriptCompiler::CompileModule", "Invalid CompileOptions"); Utils::ApiCheck(source->GetResourceOptions().IsModule(), "v8::ScriptCompiler::CompileModule", "Invalid ScriptOrigin: is_module must be true"); MaybeLocal<UnboundScript> maybe = CompileUnboundInternal(v8_isolate, source, options, no_cache_reason); Local<UnboundScript> unbound; if (!maybe.ToLocal(&unbound)) return {}; auto shared = Utils::OpenDirectHandle(*unbound); i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); return ToApiHandle<Module>(i_isolate->factory()->NewSourceTextModule(shared)); } // static V8_WARN_UNUSED_RESULT MaybeLocal<Function> ScriptCompiler::CompileFunction( Local<Context> v8_context, Source* source, size_t arguments_count, Local<String> arguments[], size_t context_extension_count, Local<Object> context_extensions[], CompileOptions options, NoCacheReason no_cache_reason) { PrepareForExecutionScope api_scope{ v8_context, RCCId::kAPI_ScriptCompiler_CompileFunction}; i::Isolate* i_isolate = api_scope.i_isolate(); TRACE_EVENT_CALL_STATS_SCOPED(i_isolate, "v8", "V8.ScriptCompiler"); DCHECK(options == CompileOptions::kConsumeCodeCache || options == CompileOptions::kEagerCompile || options == CompileOptions::kNoCompileOptions); i::DirectHandle<i::Context> context = Utils::OpenDirectHandle(*v8_context); DCHECK(IsNativeContext(*context)); i::Handle<i::FixedArray> arguments_list = i_isolate->factory()->NewFixedArray(static_cast<int>(arguments_count)); for (int i = 0; i < static_cast<int>(arguments_count); i++) { auto argument = Utils::OpenDirectHandle(*arguments[i]); if (!i::String::IsIdentifier(i_isolate, argument)) return {}; arguments_list->set(i, *argument); } for (size_t i = 0; i < context_extension_count; ++i) { i::DirectHandle<i::JSReceiver> extension = Utils::OpenDirectHandle(*context_extensions[i]); if (!IsJSObject(*extension)) return {}; context = i_isolate->factory()->NewWithContext( context, i::ScopeInfo::CreateForWithScope( i_isolate, IsNativeContext(*context) ? i::Handle<i::ScopeInfo>::null() : i::Handle<i::ScopeInfo>(context->scope_info(), i_isolate)), extension); } i::ScriptDetails script_details = GetScriptDetails( i_isolate, source->resource_name, source->resource_line_offset, source->resource_column_offset, source->source_map_url, source->host_defined_options, source->resource_options); script_details.wrapped_arguments = arguments_list; std::unique_ptr<i::AlignedCachedData> cached_data; if (options & kConsumeCodeCache) { DCHECK(source->cached_data); // ScriptData takes care of pointer-aligning the data. cached_data.reset(new i::AlignedCachedData(source->cached_data->data, source->cached_data->length)); } i::DirectHandle<i::JSFunction> result; bool has_exception = !i::Compiler::GetWrappedFunction( i_isolate, Utils::OpenHandle(*source->source_string), context, script_details, cached_data.get(), options, no_cache_reason) .ToHandle(&result); if (options & kConsumeCodeCache) { source->cached_data->rejected = cached_data->rejected(); } if (has_exception) return {}; return api_scope.Escape(Utils::CallableToLocal(result)); } void ScriptCompiler::ScriptStreamingTask::Run() { data_->task->Run(); } ScriptCompiler::ScriptStreamingTask* ScriptCompiler::StartStreaming( Isolate* v8_isolate, StreamedSource* source, v8::ScriptType type, CompileOptions options, CompileHintCallback compile_hint_callback, void* compile_hint_callback_data) { Utils::ApiCheck(v8::ScriptCompiler::CompileOptionsIsValid(options), "v8::ScriptCompiler::StartStreaming", "Invalid CompileOptions"); if (!i::v8_flags.script_streaming) return nullptr; i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i::ScriptStreamingData* data = source->impl(); std::unique_ptr<i::BackgroundCompileTask> task = std::make_unique<i::BackgroundCompileTask>( data, i_isolate, type, options, &source->compilation_details(), compile_hint_callback, compile_hint_callback_data); data->task = std::move(task); return new ScriptCompiler::ScriptStreamingTask(data); } ScriptCompiler::ConsumeCodeCacheTask::ConsumeCodeCacheTask( std::unique_ptr<i::BackgroundDeserializeTask> impl) : impl_(std::move(impl)) {} ScriptCompiler::ConsumeCodeCacheTask::~ConsumeCodeCacheTask() = default; void ScriptCompiler::ConsumeCodeCacheTask::Run() { impl_->Run(); } void ScriptCompiler::ConsumeCodeCacheTask::SourceTextAvailable( Isolate* v8_isolate, Local<String> source_text, const ScriptOrigin& origin) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i::DisallowJavascriptExecutionDebugOnly no_execution(i_isolate); i::DisallowExceptionsDebugOnly no_exceptions(i_isolate); auto str = Utils::OpenHandle(*source_text); i::ScriptDetails script_details = GetScriptDetails(i_isolate, origin.ResourceName(), origin.LineOffset(), origin.ColumnOffset(), origin.SourceMapUrl(), origin.GetHostDefinedOptions(), origin.Options()); impl_->SourceTextAvailable(i_isolate, str, script_details); } bool ScriptCompiler::ConsumeCodeCacheTask::ShouldMergeWithExistingScript() const { if (!i::v8_flags .merge_background_deserialized_script_with_compilation_cache) { return false; } return impl_->ShouldMergeWithExistingScript(); } void ScriptCompiler::ConsumeCodeCacheTask::MergeWithExistingScript() { DCHECK( i::v8_flags.merge_background_deserialized_script_with_compilation_cache); impl_->MergeWithExistingScript(); } ScriptCompiler::ConsumeCodeCacheTask* ScriptCompiler::StartConsumingCodeCache( Isolate* v8_isolate, std::unique_ptr<CachedData> cached_data) { if (!i::v8_flags.concurrent_cache_deserialization) return nullptr; i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i::DisallowJavascriptExecutionDebugOnly no_execution(i_isolate); i::DisallowExceptionsDebugOnly no_exceptions(i_isolate); return new ScriptCompiler::ConsumeCodeCacheTask( std::make_unique<i::BackgroundDeserializeTask>(i_isolate, std::move(cached_data))); } ScriptCompiler::ConsumeCodeCacheTask* ScriptCompiler::StartConsumingCodeCacheOnBackground( Isolate* v8_isolate, std::unique_ptr<CachedData> cached_data) { if (!i::v8_flags.concurrent_cache_deserialization) return nullptr; i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); return new ScriptCompiler::ConsumeCodeCacheTask( std::make_unique<i::BackgroundDeserializeTask>(i_isolate, std::move(cached_data))); } namespace { i::MaybeDirectHandle<i::SharedFunctionInfo> CompileStreamedSource( i::Isolate* i_isolate, ScriptCompiler::StreamedSource* v8_source, Local<String> full_source_string, const ScriptOrigin& origin) { auto str = Utils::OpenHandle(*full_source_string); i::ScriptDetails script_details = GetScriptDetails(i_isolate, origin.ResourceName(), origin.LineOffset(), origin.ColumnOffset(), origin.SourceMapUrl(), origin.GetHostDefinedOptions(), origin.Options()); i::ScriptStreamingData* data = v8_source->impl(); i::IsCompiledScope is_compiled_scope; return i::Compiler::GetSharedFunctionInfoForStreamedScript( i_isolate, str, script_details, data, &is_compiled_scope, &v8_source->compilation_details()); } } // namespace MaybeLocal<Script> ScriptCompiler::Compile(Local<Context> context, StreamedSource* v8_source, Local<String> full_source_string, const ScriptOrigin& origin) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_ScriptCompiler_Compile}; i::Isolate* i_isolate = api_scope.i_isolate(); TRACE_EVENT_CALL_STATS_SCOPED(i_isolate, "v8", "V8.ScriptCompiler"); TRACE_EVENT0(TRACE_DISABLED_BY_DEFAULT("v8.compile"), "V8.CompileStreamedScript"); i::DirectHandle<i::SharedFunctionInfo> sfi; if (!CompileStreamedSource(i_isolate, v8_source, full_source_string, origin) .ToHandle(&sfi)) { i_isolate->ReportPendingMessages(); return {}; } Local<UnboundScript> generic = ToApiHandle<UnboundScript>(sfi); if (generic.IsEmpty()) return {}; return api_scope.Escape(generic->BindToCurrentContext()); } MaybeLocal<Module> ScriptCompiler::CompileModule( Local<Context> context, StreamedSource* v8_source, Local<String> full_source_string, const ScriptOrigin& origin) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_ScriptCompiler_Compile}; i::Isolate* i_isolate = api_scope.i_isolate(); TRACE_EVENT_CALL_STATS_SCOPED(i_isolate, "v8", "V8.ScriptCompiler"); TRACE_EVENT0(TRACE_DISABLED_BY_DEFAULT("v8.compile"), "V8.CompileStreamedModule"); i::DirectHandle<i::SharedFunctionInfo> sfi; if (!CompileStreamedSource(i_isolate, v8_source, full_source_string, origin) .ToHandle(&sfi)) { i_isolate->ReportPendingMessages(); return {}; } return api_scope.Escape( ToApiHandle<Module>(i_isolate->factory()->NewSourceTextModule(sfi))); } uint32_t ScriptCompiler::CachedDataVersionTag() { return static_cast<uint32_t>(base::hash_combine(internal::Version::Hash(), internal::FlagList::Hash())); } ScriptCompiler::CachedData* ScriptCompiler::CreateCodeCache( Local<UnboundScript> unbound_script) { auto shared = Utils::OpenHandle(*unbound_script); i::Isolate* i_isolate = i::Isolate::Current(); Utils::ApiCheck(!i_isolate->serializer_enabled(), "ScriptCompiler::CreateCodeCache", "Cannot create code cache while creating a snapshot"); i::DisallowJavascriptExecutionDebugOnly no_execution(i_isolate); i::DisallowExceptionsDebugOnly no_exceptions(i_isolate); DCHECK(shared->is_toplevel()); return i::CodeSerializer::Serialize(i_isolate, shared); } // static ScriptCompiler::CachedData* ScriptCompiler::CreateCodeCache( Local<UnboundModuleScript> unbound_module_script) { i::Handle<i::SharedFunctionInfo> shared = Utils::OpenHandle(*unbound_module_script); i::Isolate* i_isolate = i::Isolate::Current(); Utils::ApiCheck(!i_isolate->serializer_enabled(), "ScriptCompiler::CreateCodeCache", "Cannot create code cache while creating a snapshot"); i::DisallowJavascriptExecutionDebugOnly no_execution(i_isolate); i::DisallowExceptionsDebugOnly no_exceptions(i_isolate); DCHECK(shared->is_toplevel()); return i::CodeSerializer::Serialize(i_isolate, shared); } ScriptCompiler::CachedData* ScriptCompiler::CreateCodeCacheForFunction( Local<Function> function) { auto js_function = i::Cast<i::JSFunction>(Utils::OpenDirectHandle(*function)); i::Isolate* i_isolate = i::Isolate::Current(); Utils::ApiCheck(!i_isolate->serializer_enabled(), "ScriptCompiler::CreateCodeCacheForFunction", "Cannot create code cache while creating a snapshot"); i::Handle<i::SharedFunctionInfo> shared(js_function->shared(), i_isolate); i::DisallowJavascriptExecutionDebugOnly no_execution(i_isolate); i::DisallowExceptionsDebugOnly no_exceptions(i_isolate); Utils::ApiCheck(shared->is_wrapped(), "v8::ScriptCompiler::CreateCodeCacheForFunction", "Expected SharedFunctionInfo with wrapped source code"); return i::CodeSerializer::Serialize(i_isolate, shared); } MaybeLocal<Script> Script::Compile(Local<Context> context, Local<String> source, ScriptOrigin* origin) { if (origin) { ScriptCompiler::Source script_source(source, *origin); return ScriptCompiler::Compile(context, &script_source); } ScriptCompiler::Source script_source(source); return ScriptCompiler::Compile(context, &script_source); } // --- E x c e p t i o n s --- namespace { using TryCatchIsVerboseField = v8::base::BitField<bool, 0, 1, uint8_t>; using TryCatchCanContinueField = TryCatchIsVerboseField::Next<bool, 1>; using TryCatchCaptureMessageField = TryCatchCanContinueField::Next<bool, 1>; using TryCatchRethrowField = TryCatchCaptureMessageField::Next<bool, 1>; } // namespace v8::TryCatch::TryCatch(v8::Isolate* v8_isolate) : i_isolate_(reinterpret_cast<i::Isolate*>(v8_isolate)), next_(i_isolate_->try_catch_handler()), flags_(TryCatchIsVerboseField::encode(false) | TryCatchCanContinueField::encode(true) | TryCatchCaptureMessageField::encode(true) | TryCatchRethrowField::encode(false)) { ResetInternal(); // Special handling for simulators which have a separate JS stack. js_stack_comparable_address_ = static_cast<internal::Address>( i::SimulatorStack::RegisterJSStackComparableAddress(i_isolate_)); i_isolate_->RegisterTryCatchHandler(this); } namespace { i::Tagged<i::Object> ToObject(void* object) { return i::Tagged<i::Object>(reinterpret_cast<i::Address>(object)); } } // namespace v8::TryCatch::~TryCatch() { if (HasCaught()) { if (rethrow() || (V8_UNLIKELY(HasTerminated()) && !i_isolate_->thread_local_top()->CallDepthIsZero())) { if (capture_message()) { // If an exception was caught and rethrow_ is indicated, the saved // message, script, and location need to be restored to Isolate TLS // for reuse. capture_message_ needs to be disabled so that Throw() // does not create a new message. i_isolate_->thread_local_top()->rethrowing_message_ = true; i_isolate_->set_pending_message(ToObject(message_obj_)); } i_isolate_->UnregisterTryCatchHandler(this); i_isolate_->clear_internal_exception(); i_isolate_->Throw(ToObject(exception_)); return; } Reset(); } i_isolate_->UnregisterTryCatchHandler(this); DCHECK_IMPLIES(rethrow(), !i_isolate_->thread_local_top()->rethrowing_message_); } void* v8::TryCatch::operator new(size_t) { base::OS::Abort(); } void* v8::TryCatch::operator new[](size_t) { base::OS::Abort(); } void v8::TryCatch::operator delete(void*, size_t) { base::OS::Abort(); } void v8::TryCatch::operator delete[](void*, size_t) { base::OS::Abort(); } bool v8::TryCatch::HasCaught() const { return !IsTheHole(ToObject(exception_), i_isolate_); } bool v8::TryCatch::HasTerminated() const { return ToObject(exception_) == i::ReadOnlyRoots(i_isolate_).termination_exception(); } v8::Local<v8::Value> v8::TryCatch::ReThrow() { if (!HasCaught()) return {}; set_rethrow(true); return v8::Undefined(reinterpret_cast<v8::Isolate*>(i_isolate_)); } v8::Local<Value> v8::TryCatch::Exception() const { if (!HasCaught()) return {}; if (HasTerminated()) { return v8::Utils::ToLocal(i_isolate_->factory()->null_value()); } return v8::Utils::ToLocal(i::direct_handle(ToObject(exception_), i_isolate_)); } MaybeLocal<Value> v8::TryCatch::StackTrace(Local<Context> context, Local<Value> exception) { auto i_exception = Utils::OpenDirectHandle(*exception); if (!IsJSObject(*i_exception)) return {}; PrepareForExecutionScope api_scope{context, RCCId::kAPI_TryCatch_StackTrace}; i::Isolate* i_isolate = api_scope.i_isolate(); auto obj = i::Cast<i::JSObject>(i_exception); i::DirectHandle<i::String> name = i_isolate->factory()->stack_string(); Maybe<bool> maybe = i::JSReceiver::HasProperty(i_isolate, obj, name); if (maybe != Just(true)) return {}; return api_scope.EscapeMaybe( i::JSReceiver::GetProperty(i_isolate, obj, name)); } MaybeLocal<Value> v8::TryCatch::StackTrace(Local<Context> context) const { if (!HasCaught()) return {}; return StackTrace(context, Exception()); } v8::Local<v8::Message> v8::TryCatch::Message() const { i::Tagged<i::Object> message = ToObject(message_obj_); DCHECK(IsJSMessageObject(message) || IsTheHole(message, i_isolate_)); if (HasCaught() && !IsTheHole(message, i_isolate_)) { return v8::Utils::MessageToLocal(i::direct_handle(message, i_isolate_)); } else { return {}; } } void v8::TryCatch::Reset() { if (rethrow()) return; if (V8_UNLIKELY(i_isolate_->is_execution_terminating()) && !i_isolate_->thread_local_top()->CallDepthIsZero()) { return; } i_isolate_->clear_internal_exception(); i_isolate_->clear_pending_message(); ResetInternal(); } void v8::TryCatch::ResetInternal() { i::Tagged<i::Object> the_hole = i::ReadOnlyRoots(i_isolate_).the_hole_value(); exception_ = reinterpret_cast<void*>(the_hole.ptr()); message_obj_ = reinterpret_cast<void*>(the_hole.ptr()); } bool v8::TryCatch::CanContinue() const { return TryCatchCanContinueField::decode(flags_); } void v8::TryCatch::SetVerbose(bool value) { flags_ = TryCatchIsVerboseField::update(flags_, value); } bool v8::TryCatch::IsVerbose() const { return TryCatchIsVerboseField::decode(flags_); } void v8::TryCatch::SetCaptureMessage(bool value) { flags_ = TryCatchCaptureMessageField::update(flags_, value); } bool v8::TryCatch::capture_message() const { return TryCatchCaptureMessageField::decode(flags_); } void v8::TryCatch::set_can_continue(bool value) { flags_ = TryCatchCanContinueField::update(flags_, value); } bool v8::TryCatch::rethrow() const { return TryCatchRethrowField::decode(flags_); } void v8::TryCatch::set_rethrow(bool value) { flags_ = TryCatchRethrowField::update(flags_, value); } // --- M e s s a g e --- Local<String> Message::Get() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); InternalEscapableScope scope(i_isolate); Local<String> result = Utils::ToLocal(i::MessageHandler::GetMessage(i_isolate, self)); return scope.Escape(result); } ScriptOrigin Message::GetScriptOrigin() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::Script> script(self->script(), i_isolate); return GetScriptOriginForScript(i_isolate, script); } void ScriptOrigin::VerifyHostDefinedOptions() const { // TODO(cbruni, chromium:1244145): Remove checks once we allow arbitrary // host-defined options. if (host_defined_options_.IsEmpty()) return; Utils::ApiCheck(host_defined_options_->IsFixedArray(), "ScriptOrigin()", "Host-defined options has to be a PrimitiveArray"); auto options = Utils::OpenDirectHandle(*host_defined_options_.As<FixedArray>()); for (int i = 0; i < options->length(); i++) { Utils::ApiCheck(i::IsPrimitive(options->get(i)), "ScriptOrigin()", "PrimitiveArray can only contain primtive values"); } } v8::Local<Value> Message::GetScriptResourceName() const { i::DisallowJavascriptExecutionDebugOnly no_execution; i::DisallowExceptionsDebugOnly no_exceptions; return GetScriptOrigin().ResourceName(); } v8::Local<v8::StackTrace> Message::GetStackTrace() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); InternalEscapableScope scope(i_isolate); i::DirectHandle<i::Object> stack_trace(self->stack_trace(), i_isolate); if (!IsStackTraceInfo(*stack_trace)) return {}; return scope.Escape( Utils::StackTraceToLocal(i::Cast<i::StackTraceInfo>(stack_trace))); } Maybe<int> Message::GetLineNumber(Local<Context> context) const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); HandleScope handle_scope(reinterpret_cast<Isolate*>(i_isolate)); i::JSMessageObject::EnsureSourcePositionsAvailable(i_isolate, self); return Just(self->GetLineNumber()); } int Message::GetStartPosition() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); HandleScope handle_scope(reinterpret_cast<Isolate*>(i_isolate)); i::JSMessageObject::EnsureSourcePositionsAvailable(i_isolate, self); return self->GetStartPosition(); } int Message::GetEndPosition() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); HandleScope handle_scope(reinterpret_cast<Isolate*>(i_isolate)); i::JSMessageObject::EnsureSourcePositionsAvailable(i_isolate, self); return self->GetEndPosition(); } int Message::ErrorLevel() const { auto self = Utils::OpenDirectHandle(this); i::DisallowJavascriptExecutionDebugOnly no_execution; i::DisallowExceptionsDebugOnly no_exceptions; return self->error_level(); } int Message::GetStartColumn() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); HandleScope handle_scope(reinterpret_cast<Isolate*>(i_isolate)); i::JSMessageObject::EnsureSourcePositionsAvailable(i_isolate, self); return self->GetColumnNumber(); } int Message::GetWasmFunctionIndex() const { #if V8_ENABLE_WEBASSEMBLY auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); HandleScope handle_scope(reinterpret_cast<Isolate*>(i_isolate)); i::JSMessageObject::EnsureSourcePositionsAvailable(i_isolate, self); int start_position = self->GetColumnNumber(); if (start_position == -1) return Message::kNoWasmFunctionIndexInfo; i::DirectHandle<i::Script> script(self->script(), i_isolate); if (script->type() != i::Script::Type::kWasm) { return Message::kNoWasmFunctionIndexInfo; } auto debug_script = ToApiHandle<debug::Script>(script); return Local<debug::WasmScript>::Cast(debug_script) ->GetContainingFunction(start_position); #else return Message::kNoWasmFunctionIndexInfo; #endif // V8_ENABLE_WEBASSEMBLY } Maybe<int> Message::GetStartColumn(Local<Context> context) const { return Just(GetStartColumn()); } int Message::GetEndColumn() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); HandleScope handle_scope(reinterpret_cast<Isolate*>(i_isolate)); i::JSMessageObject::EnsureSourcePositionsAvailable(i_isolate, self); const int column_number = self->GetColumnNumber(); if (column_number == -1) return -1; const int start = self->GetStartPosition(); const int end = self->GetEndPosition(); return column_number + (end - start); } Maybe<int> Message::GetEndColumn(Local<Context> context) const { return Just(GetEndColumn()); } bool Message::IsSharedCrossOrigin() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); return self->script()->origin_options().IsSharedCrossOrigin(); } bool Message::IsOpaque() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); return self->script()->origin_options().IsOpaque(); } MaybeLocal<String> Message::GetSource(Local<Context> context) const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); InternalEscapableScope handle_scope(i_isolate); return handle_scope.Escape( Utils::ToLocal(i::direct_handle(self->GetSource(), i_isolate))); } MaybeLocal<String> Message::GetSourceLine(Local<Context> context) const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); InternalEscapableScope handle_scope(i_isolate); i::JSMessageObject::EnsureSourcePositionsAvailable(i_isolate, self); return handle_scope.Escape(Utils::ToLocal(self->GetSourceLine())); } void Message::PrintCurrentStackTrace( Isolate* v8_isolate, std::ostream& out, PrintCurrentStackTraceFilterCallback should_include_frame_callback) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i_isolate->PrintCurrentStackTrace(out, should_include_frame_callback); } // --- S t a c k T r a c e --- int StackTrace::GetID() const { auto self = Utils::OpenDirectHandle(this); return self->id(); } Local<StackFrame> StackTrace::GetFrame(Isolate* v8_isolate, uint32_t index) const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); return Utils::StackFrameToLocal( i::direct_handle(self->get(index), i_isolate)); } int StackTrace::GetFrameCount() const { auto self = Utils::OpenDirectHandle(this); return self->length(); } Local<StackTrace> StackTrace::CurrentStackTrace(Isolate* v8_isolate, int frame_limit, StackTraceOptions options) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::StackTraceInfo> stack_trace = i_isolate->CaptureDetailedStackTrace(frame_limit, options); return Utils::StackTraceToLocal(stack_trace); } Local<String> StackTrace::CurrentScriptNameOrSourceURL(Isolate* v8_isolate) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::String> name_or_source_url = i_isolate->CurrentScriptNameOrSourceURL(); return Utils::ToLocal(name_or_source_url); } int StackTrace::CurrentScriptId(Isolate* v8_isolate) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); return i_isolate->CurrentScriptId(); } v8::MemorySpan<v8::StackTrace::ScriptIdAndContext> StackTrace::CurrentScriptIdsAndContexts( Isolate* v8_isolate, v8::MemorySpan<StackTrace::ScriptIdAndContext> frame_data) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); size_t written = i_isolate->CurrentScriptIdsAndContexts(frame_data); return {frame_data.data(), written}; } // --- S t a c k F r a m e --- Location StackFrame::GetLocation() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); i::DirectHandle<i::Script> script(self->script(), i_isolate); i::Script::PositionInfo info; CHECK(i::Script::GetPositionInfo( script, i::StackFrameInfo::GetSourcePosition(self), &info)); if (script->HasSourceURLComment()) { info.line -= script->line_offset(); if (info.line == 0) { info.column -= script->column_offset(); } } return {info.line, info.column}; } int StackFrame::GetSourcePosition() const { auto self = Utils::OpenHandle(this); return i::StackFrameInfo::GetSourcePosition(self); } int StackFrame::GetScriptId() const { return Utils::OpenDirectHandle(this)->script()->id(); } Local<String> StackFrame::GetScriptName() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); i::DirectHandle<i::Object> name(self->script()->name(), i_isolate); if (!IsString(*name)) return {}; return Utils::ToLocal(i::Cast<i::String>(name)); } Local<String> StackFrame::GetScriptNameOrSourceURL() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); i::DirectHandle<i::Object> name_or_source_url( self->script()->GetNameOrSourceURL(), i_isolate); if (!IsString(*name_or_source_url)) return {}; return Utils::ToLocal(i::Cast<i::String>(name_or_source_url)); } Local<String> StackFrame::GetScriptSource() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); if (!self->script()->HasValidSource()) return {}; i::DirectHandle<i::PrimitiveHeapObject> source(self->script()->source(), i_isolate); if (!IsString(*source)) return {}; return Utils::ToLocal(i::Cast<i::String>(source)); } Local<String> StackFrame::GetScriptSourceMappingURL() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); i::DirectHandle<i::Object> source_mapping_url( self->script()->source_mapping_url(), i_isolate); if (!IsString(*source_mapping_url)) return {}; return Utils::ToLocal(i::Cast<i::String>(source_mapping_url)); } Local<String> StackFrame::GetFunctionName() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); i::DirectHandle<i::String> name(self->function_name(), i_isolate); if (name->length() == 0) return {}; return Utils::ToLocal(name); } bool StackFrame::IsEval() const { auto self = Utils::OpenDirectHandle(this); return self->script()->compilation_type() == i::Script::CompilationType::kEval; } bool StackFrame::IsConstructor() const { return Utils::OpenDirectHandle(this)->is_constructor(); } bool StackFrame::IsWasm() const { return !IsUserJavaScript(); } bool StackFrame::IsUserJavaScript() const { return Utils::OpenDirectHandle(this)->script()->IsUserJavaScript(); } // --- J S O N --- MaybeLocal<Value> JSON::Parse(Local<Context> context, Local<String> json_string, std::optional<ScriptOrigin> origin) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_JSON_Parse}; i::Isolate* i_isolate = api_scope.i_isolate(); auto string = Utils::OpenHandle(*json_string); i::Handle<i::String> source = i::String::Flatten(i_isolate, string); i::Handle<i::Object> undefined = i_isolate->factory()->undefined_value(); std::optional<i::ScriptDetails> script_details; if (origin.has_value()) { const ScriptOrigin& script_origin = origin.value(); script_details.emplace(GetScriptDetails( i_isolate, script_origin.ResourceName(), script_origin.LineOffset(), script_origin.ColumnOffset(), script_origin.SourceMapUrl(), script_origin.GetHostDefinedOptions(), script_origin.Options())); } auto maybe_result = i::String::IsOneByteRepresentationUnderneath(*source) ? i::JsonParser<uint8_t>::Parse( i_isolate, source, undefined, script_details) : i::JsonParser<uint16_t>::Parse( i_isolate, source, undefined, script_details); return api_scope.EscapeMaybe(maybe_result); } MaybeLocal<String> JSON::Stringify(Local<Context> context, Local<Value> json_object, Local<String> gap) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_JSON_Stringify}; i::Isolate* i_isolate = api_scope.i_isolate(); i::Handle<i::JSAny> object; if (!Utils::ApiCheck( i::TryCast<i::JSAny>(Utils::OpenHandle(*json_object), &object), "JSON::Stringify", "Invalid object, must be a JSON-serializable object.")) { return {}; } i::Handle<i::Undefined> replacer = i_isolate->factory()->undefined_value(); i::Handle<i::String> gap_string = gap.IsEmpty() ? i_isolate->factory()->empty_string() : Utils::OpenHandle(*gap); i::DirectHandle<i::Object> maybe; if (!i::JsonStringify(i_isolate, object, replacer, gap_string) .ToHandle(&maybe)) { return {}; } return api_scope.EscapeMaybe(i::Object::ToString(i_isolate, maybe)); } // --- V a l u e S e r i a l i z a t i o n --- SharedValueConveyor::SharedValueConveyor(SharedValueConveyor&& other) noexcept : private_(std::move(other.private_)) {} SharedValueConveyor::~SharedValueConveyor() = default; SharedValueConveyor& SharedValueConveyor::operator=( SharedValueConveyor&& other) noexcept { private_ = std::move(other.private_); return *this; } SharedValueConveyor::SharedValueConveyor(Isolate* v8_isolate) : private_(std::make_unique<i::SharedObjectConveyorHandles>( reinterpret_cast<i::Isolate*>(v8_isolate))) {} Maybe<bool> ValueSerializer::Delegate::WriteHostObject(Isolate* v8_isolate, Local<Object> object) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); THROW_NEW_ERROR(i_isolate, NewError(i_isolate->error_function(), i::MessageTemplate::kDataCloneError, Utils::OpenDirectHandle(*object))); } bool ValueSerializer::Delegate::HasCustomHostObject(Isolate* v8_isolate) { return false; } Maybe<bool> ValueSerializer::Delegate::IsHostObject(Isolate* v8_isolate, Local<Object> object) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); auto js_object = i::Cast<i::JSObject>(Utils::OpenDirectHandle(*object)); return Just<bool>( i::JSObject::GetEmbedderFieldCount(js_object->map(i_isolate))); } Maybe<uint32_t> ValueSerializer::Delegate::GetSharedArrayBufferId( Isolate* v8_isolate, Local<SharedArrayBuffer> shared_array_buffer) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i_isolate->Throw(*i_isolate->factory()->NewError( i_isolate->error_function(), i::MessageTemplate::kDataCloneError, Utils::OpenDirectHandle(*shared_array_buffer))); return {}; } Maybe<uint32_t> ValueSerializer::Delegate::GetWasmModuleTransferId( Isolate* v8_isolate, Local<WasmModuleObject> module) { return {}; } bool ValueSerializer::Delegate::AdoptSharedValueConveyor( Isolate* v8_isolate, SharedValueConveyor&& conveyor) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i_isolate->Throw(*i_isolate->factory()->NewError( i_isolate->error_function(), i::MessageTemplate::kDataCloneError, i_isolate->factory()->NewStringFromAsciiChecked("shared value"))); return false; } void* ValueSerializer::Delegate::ReallocateBufferMemory(void* old_buffer, size_t size, size_t* actual_size) { *actual_size = size; return base::Realloc(old_buffer, size); } void ValueSerializer::Delegate::FreeBufferMemory(void* buffer) { return base::Free(buffer); } struct ValueSerializer::PrivateData { explicit PrivateData(i::Isolate* i, ValueSerializer::Delegate* delegate) : isolate(i), serializer(i, delegate) {} i::Isolate* isolate; i::ValueSerializer serializer; }; ValueSerializer::ValueSerializer(Isolate* v8_isolate) : ValueSerializer(v8_isolate, nullptr) {} ValueSerializer::ValueSerializer(Isolate* v8_isolate, Delegate* delegate) : private_(new PrivateData(reinterpret_cast<i::Isolate*>(v8_isolate), delegate)) {} ValueSerializer::~ValueSerializer() { delete private_; } void ValueSerializer::WriteHeader() { private_->serializer.WriteHeader(); } void ValueSerializer::SetTreatArrayBufferViewsAsHostObjects(bool mode) { private_->serializer.SetTreatArrayBufferViewsAsHostObjects(mode); } Maybe<bool> ValueSerializer::WriteValue(Local<Context> context, Local<Value> value) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_ValueSerializer_WriteValue}; auto object = Utils::OpenHandle(*value); return private_->serializer.WriteObject(object); } std::pair<uint8_t*, size_t> ValueSerializer::Release() { return private_->serializer.Release(); } void ValueSerializer::TransferArrayBuffer(uint32_t transfer_id, Local<ArrayBuffer> array_buffer) { private_->serializer.TransferArrayBuffer( transfer_id, Utils::OpenDirectHandle(*array_buffer)); } void ValueSerializer::WriteUint32(uint32_t value) { private_->serializer.WriteUint32(value); } void ValueSerializer::WriteUint64(uint64_t value) { private_->serializer.WriteUint64(value); } void ValueSerializer::WriteDouble(double value) { private_->serializer.WriteDouble(value); } void ValueSerializer::WriteRawBytes(const void* source, size_t length) { private_->serializer.WriteRawBytes(source, length); } MaybeLocal<Object> ValueDeserializer::Delegate::ReadHostObject( Isolate* v8_isolate) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i_isolate->Throw(*i_isolate->factory()->NewError( i_isolate->error_function(), i::MessageTemplate::kDataCloneDeserializationError)); return {}; } MaybeLocal<WasmModuleObject> ValueDeserializer::Delegate::GetWasmModuleFromId( Isolate* v8_isolate, uint32_t id) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i_isolate->Throw(*i_isolate->factory()->NewError( i_isolate->error_function(), i::MessageTemplate::kDataCloneDeserializationError)); return {}; } MaybeLocal<SharedArrayBuffer> ValueDeserializer::Delegate::GetSharedArrayBufferFromId(Isolate* v8_isolate, uint32_t id) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i_isolate->Throw(*i_isolate->factory()->NewError( i_isolate->error_function(), i::MessageTemplate::kDataCloneDeserializationError)); return {}; } const SharedValueConveyor* ValueDeserializer::Delegate::GetSharedValueConveyor( Isolate* v8_isolate) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i_isolate->Throw(*i_isolate->factory()->NewError( i_isolate->error_function(), i::MessageTemplate::kDataCloneDeserializationError)); return nullptr; } struct ValueDeserializer::PrivateData { PrivateData(i::Isolate* i_isolate, base::Vector<const uint8_t> data, Delegate* delegate) : isolate(i_isolate), deserializer(i_isolate, data, delegate) {} i::Isolate* isolate; i::ValueDeserializer deserializer; bool supports_legacy_wire_format = false; }; ValueDeserializer::ValueDeserializer(Isolate* v8_isolate, const uint8_t* data, size_t size) : ValueDeserializer(v8_isolate, data, size, nullptr) {} ValueDeserializer::ValueDeserializer(Isolate* v8_isolate, const uint8_t* data, size_t size, Delegate* delegate) { private_ = new PrivateData(reinterpret_cast<i::Isolate*>(v8_isolate), base::Vector<const uint8_t>(data, size), delegate); } ValueDeserializer::~ValueDeserializer() { delete private_; } Maybe<bool> ValueDeserializer::ReadHeader(Local<Context> context) { auto i_isolate = i::Isolate::Current(); EnterV8NoScriptScope<> api_scope{i_isolate, context, RCCId::kAPI_ValueDeserializer_ReadHeader}; bool read_header = false; if (!private_->deserializer.ReadHeader().To(&read_header)) return {}; DCHECK(read_header); static const uint32_t kMinimumNonLegacyVersion = 13; if (GetWireFormatVersion() < kMinimumNonLegacyVersion && !private_->supports_legacy_wire_format) { i_isolate->Throw(*i_isolate->factory()->NewError( i::MessageTemplate::kDataCloneDeserializationVersionError)); return {}; } return Just(true); } void ValueDeserializer::SetSupportsLegacyWireFormat( bool supports_legacy_wire_format) { private_->supports_legacy_wire_format = supports_legacy_wire_format; } uint32_t ValueDeserializer::GetWireFormatVersion() const { return private_->deserializer.GetWireFormatVersion(); } MaybeLocal<Value> ValueDeserializer::ReadValue(Local<Context> context) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_ValueDeserializer_ReadValue}; i::MaybeDirectHandle<i::Object> result = GetWireFormatVersion() > 0 ? private_->deserializer.ReadObjectWrapper() : private_->deserializer.ReadObjectUsingEntireBufferForLegacyFormat(); return api_scope.EscapeMaybe(result); } void ValueDeserializer::TransferArrayBuffer(uint32_t transfer_id, Local<ArrayBuffer> array_buffer) { private_->deserializer.TransferArrayBuffer( transfer_id, Utils::OpenDirectHandle(*array_buffer)); } void ValueDeserializer::TransferSharedArrayBuffer( uint32_t transfer_id, Local<SharedArrayBuffer> shared_array_buffer) { private_->deserializer.TransferArrayBuffer( transfer_id, Utils::OpenDirectHandle(*shared_array_buffer)); } bool ValueDeserializer::ReadUint32(uint32_t* value) { return private_->deserializer.ReadUint32(value); } bool ValueDeserializer::ReadUint64(uint64_t* value) { return private_->deserializer.ReadUint64(value); } bool ValueDeserializer::ReadDouble(double* value) { return private_->deserializer.ReadDouble(value); } bool ValueDeserializer::ReadRawBytes(size_t length, const void** data) { return private_->deserializer.ReadRawBytes(length, data); } // --- D a t a --- bool Value::FullIsUndefined() const { bool result = i::IsUndefined(*Utils::OpenDirectHandle(this)); DCHECK_EQ(result, QuickIsUndefined()); return result; } bool Value::FullIsNull() const { bool result = i::IsNull(*Utils::OpenDirectHandle(this)); DCHECK_EQ(result, QuickIsNull()); return result; } bool Value::FullIsTrue() const { auto object = *Utils::OpenDirectHandle(this); if (i::IsSmi(object)) return false; return i::IsTrue(object); } bool Value::FullIsFalse() const { i::Tagged<i::Object> object = *Utils::OpenDirectHandle(this); if (i::IsSmi(object)) return false; return i::IsFalse(object); } bool Value::IsPrimitive() const { auto object = Utils::OpenDirectHandle(this); return i::IsPrimitive(*object) && !IsPrivateSymbol(*object); } bool Value::IsFunction() const { return IsCallable(*Utils::OpenDirectHandle(this)); } bool Value::IsName() const { return i::IsName(*Utils::OpenDirectHandle(this)); } bool Value::FullIsString() const { bool result = i::IsString(*Utils::OpenDirectHandle(this)); DCHECK_EQ(result, QuickIsString()); return result; } bool Value::IsSymbol() const { return IsPublicSymbol(*Utils::OpenDirectHandle(this)); } bool Value::IsArray() const { return IsJSArray(*Utils::OpenDirectHandle(this)); } bool Value::IsArrayBuffer() const { auto obj = *Utils::OpenDirectHandle(this); if (!IsJSArrayBuffer(obj)) return false; return !i::Cast<i::JSArrayBuffer>(obj)->is_shared(); } bool Value::IsArrayBufferView() const { return IsJSArrayBufferView(*Utils::OpenDirectHandle(this)); } bool Value::IsTypedArray() const { return IsJSTypedArray(*Utils::OpenDirectHandle(this)); } #define VALUE_IS_TYPED_ARRAY(Type, typeName, TYPE, ctype) \ bool Value::Is##Type##Array() const { \ auto obj = *Utils::OpenDirectHandle(this); \ return i::IsJSTypedArray(obj) && \ i::Cast<i::JSTypedArray>(obj)->type() == i::kExternal##Type##Array; \ } TYPED_ARRAYS_BASE(VALUE_IS_TYPED_ARRAY) #undef VALUE_IS_TYPED_ARRAY bool Value::IsFloat16Array() const { auto obj = *Utils::OpenDirectHandle(this); return i::IsJSTypedArray(obj) && i::Cast<i::JSTypedArray>(obj)->type() == i::kExternalFloat16Array && Utils::ApiCheck(i::v8_flags.js_float16array, "Value::IsFloat16Array", "Float16Array is not supported"); } bool Value::IsDataView() const { auto obj = *Utils::OpenDirectHandle(this); return IsJSDataView(obj) || IsJSRabGsabDataView(obj); } bool Value::IsSharedArrayBuffer() const { auto obj = *Utils::OpenDirectHandle(this); if (!IsJSArrayBuffer(obj)) return false; return i::Cast<i::JSArrayBuffer>(obj)->is_shared(); } bool Value::IsObject() const { return i::IsJSReceiver(*Utils::OpenDirectHandle(this)); } bool Value::IsNumber() const { return i::IsNumber(*Utils::OpenDirectHandle(this)); } bool Value::IsBigInt() const { return i::IsBigInt(*Utils::OpenDirectHandle(this)); } bool Value::IsProxy() const { return i::IsJSProxy(*Utils::OpenDirectHandle(this)); } #define VALUE_IS_SPECIFIC_TYPE(Type, Check) \ bool Value::Is##Type() const { \ return i::Is##Check(*Utils::OpenDirectHandle(this)); \ } VALUE_IS_SPECIFIC_TYPE(ArgumentsObject, JSArgumentsObject) VALUE_IS_SPECIFIC_TYPE(BigIntObject, BigIntWrapper) VALUE_IS_SPECIFIC_TYPE(BooleanObject, BooleanWrapper) VALUE_IS_SPECIFIC_TYPE(NumberObject, NumberWrapper) VALUE_IS_SPECIFIC_TYPE(StringObject, StringWrapper) VALUE_IS_SPECIFIC_TYPE(SymbolObject, SymbolWrapper) VALUE_IS_SPECIFIC_TYPE(Date, JSDate) VALUE_IS_SPECIFIC_TYPE(Map, JSMap) VALUE_IS_SPECIFIC_TYPE(Set, JSSet) #if V8_ENABLE_WEBASSEMBLY VALUE_IS_SPECIFIC_TYPE(WasmMemoryMapDescriptor, WasmMemoryMapDescriptor) VALUE_IS_SPECIFIC_TYPE(WasmMemoryObject, WasmMemoryObject) VALUE_IS_SPECIFIC_TYPE(WasmModuleObject, WasmModuleObject) VALUE_IS_SPECIFIC_TYPE(WasmNull, WasmNull) #else bool Value::IsWasmMemoryMapDescriptor() const { return false; } bool Value::IsWasmMemoryObject() const { return false; } bool Value::IsWasmModuleObject() const { return false; } bool Value::IsWasmNull() const { return false; } #endif // V8_ENABLE_WEBASSEMBLY VALUE_IS_SPECIFIC_TYPE(WeakMap, JSWeakMap) VALUE_IS_SPECIFIC_TYPE(WeakSet, JSWeakSet) VALUE_IS_SPECIFIC_TYPE(WeakRef, JSWeakRef) #undef VALUE_IS_SPECIFIC_TYPE bool Value::IsBoolean() const { return i::IsBoolean(*Utils::OpenDirectHandle(this)); } bool Value::IsExternal() const { i::Tagged<i::Object> obj = *Utils::OpenDirectHandle(this); return IsJSExternalObject(obj); } bool Value::IsInt32() const { i::Tagged<i::Object> obj = *Utils::OpenDirectHandle(this); if (i::IsSmi(obj)) return true; if (i::IsNumber(obj)) { return i::IsInt32Double(i::Object::NumberValue(i::Cast<i::Number>(obj))); } return false; } bool Value::IsUint32() const { auto obj = *Utils::OpenDirectHandle(this); if (i::IsSmi(obj)) return i::Smi::ToInt(obj) >= 0; if (i::IsNumber(obj)) { double value = i::Object::NumberValue(i::Cast<i::Number>(obj)); return !i::IsMinusZero(value) && value >= 0 && value <= i::kMaxUInt32 && value == i::FastUI2D(i::FastD2UI(value)); } return false; } bool Value::IsNativeError() const { return IsJSError(*Utils::OpenDirectHandle(this)); } bool Value::IsRegExp() const { return IsJSRegExp(*Utils::OpenDirectHandle(this)); } bool Value::IsAsyncFunction() const { auto obj = *Utils::OpenDirectHandle(this); if (!IsJSFunction(obj)) return false; auto func = i::Cast<i::JSFunction>(obj); return i::IsAsyncFunction(func->shared()->kind()); } bool Value::IsGeneratorFunction() const { auto obj = *Utils::OpenDirectHandle(this); if (!IsJSFunction(obj)) return false; auto func = i::Cast<i::JSFunction>(obj); i::DisallowJavascriptExecutionDebugOnly no_execution; i::DisallowExceptionsDebugOnly no_exceptions; return i::IsGeneratorFunction(func->shared()->kind()); } bool Value::IsGeneratorObject() const { return IsJSGeneratorObject(*Utils::OpenDirectHandle(this)); } bool Value::IsMapIterator() const { return IsJSMapIterator(*Utils::OpenDirectHandle(this)); } bool Value::IsSetIterator() const { return IsJSSetIterator(*Utils::OpenDirectHandle(this)); } bool Value::IsPromise() const { return IsJSPromise(*Utils::OpenDirectHandle(this)); } bool Value::IsModuleNamespaceObject() const { return IsJSModuleNamespace(*Utils::OpenDirectHandle(this)); } MaybeLocal<String> Value::ToString(Local<Context> context) const { auto obj = Utils::OpenDirectHandle(this); if (i::IsString(*obj)) return ToApiHandle<String>(obj); PrepareForExecutionScope api_scope{context, RCCId::kAPI_Object_ToString}; i::Isolate* i_isolate = api_scope.i_isolate(); return api_scope.EscapeMaybe(i::Object::ToString(i_isolate, obj)); } MaybeLocal<String> Value::ToDetailString(Local<Context> context) const { i::DirectHandle<i::Object> obj = Utils::OpenDirectHandle(this); if (i::IsString(*obj)) return ToApiHandle<String>(obj); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); return Utils::ToLocal(i::Object::NoSideEffectsToString(i_isolate, obj)); } MaybeLocal<Object> Value::ToObject(Local<Context> context) const { auto obj = Utils::OpenDirectHandle(this); if (i::IsJSReceiver(*obj)) return ToApiHandle<Object>(obj); PrepareForExecutionScope api_scope{context, RCCId::kAPI_Object_ToObject}; i::Isolate* i_isolate = api_scope.i_isolate(); return api_scope.EscapeMaybe(i::Object::ToObject(i_isolate, obj)); } MaybeLocal<BigInt> Value::ToBigInt(Local<Context> context) const { auto obj = Utils::OpenDirectHandle(this); if (i::IsBigInt(*obj)) return ToApiHandle<BigInt>(obj); PrepareForExecutionScope api_scope{context, RCCId::kAPI_Object_ToBigInt}; i::Isolate* i_isolate = api_scope.i_isolate(); return api_scope.EscapeMaybe(i::BigInt::FromObject(i_isolate, obj)); } bool Value::BooleanValue(Isolate* v8_isolate) const { return i::Object::BooleanValue(*Utils::OpenDirectHandle(this), reinterpret_cast<i::Isolate*>(v8_isolate)); } MaybeLocal<Primitive> Value::ToPrimitive(Local<Context> context) const { auto obj = Utils::OpenDirectHandle(this); if (i::IsPrimitive(*obj)) return ToApiHandle<Primitive>(obj); PrepareForExecutionScope api_scope{context, RCCId::kAPI_Object_ToPrimitive}; i::Isolate* i_isolate = api_scope.i_isolate(); return api_scope.EscapeMaybe( Utils::ToMaybeLocal(i::Object::ToPrimitive(i_isolate, obj)) .As<Primitive>()); } MaybeLocal<Numeric> Value::ToNumeric(Local<Context> context) const { auto obj = Utils::OpenDirectHandle(this); if (i::IsNumeric(*obj)) return ToApiHandle<Numeric>(obj); PrepareForExecutionScope api_scope{context, RCCId::kAPI_Object_ToNumeric}; i::Isolate* i_isolate = api_scope.i_isolate(); return api_scope.EscapeMaybe( Utils::ToMaybeLocal(i::Object::ToNumeric(i_isolate, obj)).As<Numeric>()); } Local<Boolean> Value::ToBoolean(Isolate* v8_isolate) const { auto i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i::DisallowJavascriptExecutionDebugOnly no_execution(i_isolate); i::DisallowExceptionsDebugOnly no_exceptions(i_isolate); return ToApiHandle<Boolean>( i_isolate->factory()->ToBoolean(BooleanValue(v8_isolate))); } MaybeLocal<Number> Value::ToNumber(Local<Context> context) const { auto obj = Utils::OpenDirectHandle(this); if (i::IsNumber(*obj)) return ToApiHandle<Number>(obj); PrepareForExecutionScope api_scope{context, RCCId::kAPI_Object_ToNumber}; i::Isolate* i_isolate = api_scope.i_isolate(); return api_scope.EscapeMaybe( Utils::ToMaybeLocal(i::Object::ToNumber(i_isolate, obj)).As<Number>()); } MaybeLocal<Integer> Value::ToInteger(Local<Context> context) const { auto obj = Utils::OpenDirectHandle(this); if (i::IsSmi(*obj)) return ToApiHandle<Integer>(obj); PrepareForExecutionScope api_scope{context, RCCId::kAPI_Object_ToInteger}; i::Isolate* i_isolate = api_scope.i_isolate(); return api_scope.EscapeMaybe( Utils::ToMaybeLocal(i::Object::ToInteger(i_isolate, obj)).As<Integer>()); } MaybeLocal<Int32> Value::ToInt32(Local<Context> context) const { auto obj = Utils::OpenDirectHandle(this); if (i::IsSmi(*obj)) return ToApiHandle<Int32>(obj); PrepareForExecutionScope api_scope{context, RCCId::kAPI_Object_ToInt32}; i::Isolate* i_isolate = api_scope.i_isolate(); return api_scope.EscapeMaybe( Utils::ToMaybeLocal(i::Object::ToInt32(i_isolate, obj)).As<Int32>()); } MaybeLocal<Uint32> Value::ToUint32(Local<Context> context) const { auto obj = Utils::OpenDirectHandle(this); if (i::IsSmi(*obj)) return ToApiHandle<Uint32>(obj); PrepareForExecutionScope api_scope{context, RCCId::kAPI_Object_ToUint32}; i::Isolate* i_isolate = api_scope.i_isolate(); return api_scope.EscapeMaybe( Utils::ToMaybeLocal(i::Object::ToUint32(i_isolate, obj)).As<Uint32>()); } // Note: This method is deprecated. i::Isolate* i::IsolateFromNeverReadOnlySpaceObject(i::Address obj) { return i::Isolate::Current(); } bool i::ShouldThrowOnError(i::Isolate* i_isolate) { return i::GetShouldThrow(i_isolate, Nothing<i::ShouldThrow>()) == i::ShouldThrow::kThrowOnError; } void i::Internals::CheckInitializedImpl(v8::Isolate* external_isolate) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(external_isolate); Utils::ApiCheck(i_isolate != nullptr && !i_isolate->IsDead(), "i::Internals::CheckInitialized", "Isolate is not initialized or V8 has died"); } void v8::Value::CheckCast(Data* that) { Utils::ApiCheck(that->IsValue(), "v8::Value::Cast", "Data is not a Value"); } void v8::External::CheckCast(v8::Data* that) { Utils::ApiCheck(that->IsValue() && v8::Value::Cast(that)->IsExternal(), "v8::External::Cast", "Value is not an External"); } void v8::Object::CheckCast(Value* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsJSReceiver(*obj), "v8::Object::Cast", "Value is not an Object"); } void v8::Function::CheckCast(Value* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsCallable(*obj), "v8::Function::Cast", "Value is not a Function"); } void v8::Boolean::CheckCast(v8::Data* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsBoolean(*obj), "v8::Boolean::Cast", "Value is not a Boolean"); } void v8::Name::CheckCast(v8::Data* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsName(*obj), "v8::Name::Cast", "Value is not a Name"); } void v8::String::CheckCast(v8::Data* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsString(*obj), "v8::String::Cast", "Value is not a String"); } void v8::Symbol::CheckCast(v8::Data* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsSymbol(*obj), "v8::Symbol::Cast", "Value is not a Symbol"); } void v8::Private::CheckCast(v8::Data* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(IsSymbol(*obj) && i::Cast<i::Symbol>(obj)->is_any_private(), "v8::Private::Cast", "Value is not a Private"); } void v8::FixedArray::CheckCast(v8::Data* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsFixedArray(*obj), "v8::FixedArray::Cast", "Value is not a FixedArray"); } void v8::ModuleRequest::CheckCast(v8::Data* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsModuleRequest(*obj), "v8::ModuleRequest::Cast", "Value is not a ModuleRequest"); } void v8::Module::CheckCast(v8::Data* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsModule(*obj), "v8::Module::Cast", "Value is not a Module"); } void v8::Numeric::CheckCast(v8::Data* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsNumeric(*obj), "v8::Numeric::Cast()", "Value is not a Numeric"); } void v8::Number::CheckCast(v8::Data* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsNumber(*obj), "v8::Number::Cast()", "Value is not a Number"); } void v8::Integer::CheckCast(v8::Data* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsNumber(*obj), "v8::Integer::Cast", "Value is not an Integer"); } void v8::Int32::CheckCast(v8::Data* that) { Utils::ApiCheck(Value::Cast(that)->IsInt32(), "v8::Int32::Cast", "Value is not a 32-bit signed integer"); } void v8::Uint32::CheckCast(v8::Data* that) { Utils::ApiCheck(Value::Cast(that)->IsUint32(), "v8::Uint32::Cast", "Value is not a 32-bit unsigned integer"); } void v8::BigInt::CheckCast(v8::Data* that) { Utils::ApiCheck(Value::Cast(that)->IsBigInt(), "v8::BigInt::Cast", "Value is not a BigInt"); } void v8::Context::CheckCast(v8::Data* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsContext(*obj), "v8::Context::Cast", "Value is not a Context"); } void v8::Array::CheckCast(Value* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsJSArray(*obj), "v8::Array::Cast", "Value is not an Array"); } void v8::Map::CheckCast(Value* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsJSMap(*obj), "v8::Map::Cast", "Value is not a Map"); } void v8::Set::CheckCast(Value* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsJSSet(*obj), "v8_Set_Cast", "Value is not a Set"); } void v8::Promise::CheckCast(Value* that) { Utils::ApiCheck(that->IsPromise(), "v8::Promise::Cast", "Value is not a Promise"); } void v8::Promise::Resolver::CheckCast(Value* that) { Utils::ApiCheck(that->IsPromise(), "v8::Promise::Resolver::Cast", "Value is not a Promise::Resolver"); } void v8::Proxy::CheckCast(Value* that) { Utils::ApiCheck(that->IsProxy(), "v8::Proxy::Cast", "Value is not a Proxy"); } void v8::WasmMemoryObject::CheckCast(Value* that) { Utils::ApiCheck(that->IsWasmMemoryObject(), "v8::WasmMemoryObject::Cast", "Value is not a WasmMemoryObject"); } void v8::WasmMemoryMapDescriptor::CheckCast(Value* that) { Utils::ApiCheck(that->IsWasmMemoryMapDescriptor(), "v8::WasmMemoryMapDescriptor::Cast", "Value is not a WasmMemoryMapDescriptor"); } void v8::WasmModuleObject::CheckCast(Value* that) { Utils::ApiCheck(that->IsWasmModuleObject(), "v8::WasmModuleObject::Cast", "Value is not a WasmModuleObject"); } void v8::CppHeapExternal::CheckCast(v8::Data* that) { Utils::ApiCheck(that->IsCppHeapExternal(), "v8::CppHeapExternal::Cast", "Value is not a CppHeapExternal"); } v8::BackingStore::~BackingStore() { auto i_this = reinterpret_cast<const i::BackingStore*>(this); i_this->~BackingStore(); // manually call internal destructor } void* v8::BackingStore::Data() const { return reinterpret_cast<const i::BackingStore*>(this)->buffer_start(); } size_t v8::BackingStore::ByteLength() const { return reinterpret_cast<const i::BackingStore*>(this)->byte_length(); } size_t v8::BackingStore::MaxByteLength() const { return reinterpret_cast<const i::BackingStore*>(this)->max_byte_length(); } bool v8::BackingStore::IsShared() const { return reinterpret_cast<const i::BackingStore*>(this)->is_shared(); } bool v8::BackingStore::IsImmutable() const { return reinterpret_cast<const i::BackingStore*>(this)->is_immutable(); } bool v8::BackingStore::IsResizableByUserJavaScript() const { return reinterpret_cast<const i::BackingStore*>(this)->is_resizable_by_js(); } // static void v8::BackingStore::EmptyDeleter(void* data, size_t length, void* deleter_data) { DCHECK_NULL(deleter_data); } std::shared_ptr<v8::BackingStore> v8::ArrayBuffer::GetBackingStore() { auto self = Utils::OpenDirectHandle(this); std::shared_ptr<i::BackingStore> backing_store = self->GetBackingStore(); if (!backing_store) { backing_store = i::BackingStore::EmptyBackingStore(i::SharedFlag::kNotShared); } std::shared_ptr<i::BackingStoreBase> bs_base = backing_store; return std::static_pointer_cast<v8::BackingStore>(bs_base); } void* v8::ArrayBuffer::Data() const { return Utils::OpenDirectHandle(this)->backing_store(); } bool v8::ArrayBuffer::IsResizableByUserJavaScript() const { return Utils::OpenDirectHandle(this)->is_resizable_by_js(); } std::shared_ptr<v8::BackingStore> v8::SharedArrayBuffer::GetBackingStore() { auto self = Utils::OpenDirectHandle(this); std::shared_ptr<i::BackingStore> backing_store = self->GetBackingStore(); if (!backing_store) { backing_store = i::BackingStore::EmptyBackingStore(i::SharedFlag::kShared); } std::shared_ptr<i::BackingStoreBase> bs_base = backing_store; return std::static_pointer_cast<v8::BackingStore>(bs_base); } void* v8::SharedArrayBuffer::Data() const { return Utils::OpenDirectHandle(this)->backing_store(); } template <bool is_shared> static size_t CopyArrayBufferBytesImpl(const void* source_buffer, size_t source_start, size_t source_length, void* target_buffer, size_t target_start, size_t target_length, size_t bytes_to_copy) { source_start = std::min(source_start, source_length); target_start = std::min(target_start, target_length); size_t source_size = source_length - source_start; size_t target_size = target_length - target_start; bytes_to_copy = std::min({bytes_to_copy, source_size, target_size}); if (bytes_to_copy == 0) return 0; const char* src = static_cast<const char*>(source_buffer) + source_start; char* dst = static_cast<char*>(target_buffer) + target_start; if (is_shared) { base::Relaxed_Memmove(reinterpret_cast<base::Atomic8*>(dst), reinterpret_cast<const base::Atomic8*>(src), bytes_to_copy); } else { std::memmove(dst, src, bytes_to_copy); } return bytes_to_copy; } size_t v8::SharedArrayBuffer::CopyArrayBufferBytes( size_t source_start, size_t bytes_to_copy, Local<SharedArrayBuffer> target, size_t target_start) const { i::DisallowGarbageCollection no_gc; auto self = Utils::OpenDirectHandle(this); auto that = Utils::OpenDirectHandle(*target); DCHECK(!that->is_immutable()); return CopyArrayBufferBytesImpl<true>(self->backing_store(), source_start, self->GetByteLength(), that->backing_store(), target_start, that->GetByteLength(), bytes_to_copy); } void v8::ArrayBuffer::CheckCast(Value* that) { auto obj = *Utils::OpenDirectHandle(that); Utils::ApiCheck( IsJSArrayBuffer(obj) && !i::Cast<i::JSArrayBuffer>(obj)->is_shared(), "v8::ArrayBuffer::Cast()", "Value is not an ArrayBuffer"); } void v8::ArrayBufferView::CheckCast(Value* that) { auto obj = *Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsJSArrayBufferView(obj), "v8::ArrayBufferView::Cast()", "Value is not an ArrayBufferView"); } void v8::TypedArray::CheckCast(Value* that) { auto obj = *Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsJSTypedArray(obj), "v8::TypedArray::Cast()", "Value is not a TypedArray"); } #define CHECK_TYPED_ARRAY_CAST(Type, typeName, TYPE, ctype) \ void v8::Type##Array::CheckCast(Value* that) { \ auto obj = *Utils::OpenDirectHandle(that); \ Utils::ApiCheck( \ i::IsJSTypedArray(obj) && i::Cast<i::JSTypedArray>(obj)->type() == \ i::kExternal##Type##Array, \ "v8::" #Type "Array::Cast()", "Value is not a " #Type "Array"); \ } TYPED_ARRAYS_BASE(CHECK_TYPED_ARRAY_CAST) #undef CHECK_TYPED_ARRAY_CAST void v8::Float16Array::CheckCast(Value* that) { Utils::ApiCheck(i::v8_flags.js_float16array, "v8::Float16Array::Cast", "Float16Array is not supported"); auto obj = *Utils::OpenDirectHandle(that); Utils::ApiCheck( i::IsJSTypedArray(obj) && i::Cast<i::JSTypedArray>(obj)->type() == i::kExternalFloat16Array, "v8::Float16Array::Cast()", "Value is not a Float16Array"); } void v8::DataView::CheckCast(Value* that) { auto obj = *Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsJSDataView(obj) || IsJSRabGsabDataView(obj), "v8::DataView::Cast()", "Value is not a DataView"); } void v8::SharedArrayBuffer::CheckCast(Value* that) { auto obj = *Utils::OpenDirectHandle(that); Utils::ApiCheck( IsJSArrayBuffer(obj) && i::Cast<i::JSArrayBuffer>(obj)->is_shared(), "v8::SharedArrayBuffer::Cast()", "Value is not a SharedArrayBuffer"); } void v8::Date::CheckCast(v8::Value* that) { auto obj = *Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsJSDate(obj), "v8::Date::Cast()", "Value is not a Date"); } void v8::StringObject::CheckCast(v8::Value* that) { auto obj = *Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsStringWrapper(obj), "v8::StringObject::Cast()", "Value is not a StringObject"); } void v8::SymbolObject::CheckCast(v8::Value* that) { auto obj = *Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsSymbolWrapper(obj), "v8::SymbolObject::Cast()", "Value is not a SymbolObject"); } void v8::NumberObject::CheckCast(v8::Value* that) { auto obj = *Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsNumberWrapper(obj), "v8::NumberObject::Cast()", "Value is not a NumberObject"); } void v8::BigIntObject::CheckCast(v8::Value* that) { auto obj = *Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsBigIntWrapper(obj), "v8::BigIntObject::Cast()", "Value is not a BigIntObject"); } void v8::BooleanObject::CheckCast(v8::Value* that) { auto obj = *Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsBooleanWrapper(obj), "v8::BooleanObject::Cast()", "Value is not a BooleanObject"); } void v8::RegExp::CheckCast(v8::Value* that) { auto obj = *Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsJSRegExp(obj), "v8::RegExp::Cast()", "Value is not a RegExp"); } Maybe<double> Value::NumberValue(Local<Context> context) const { auto obj = Utils::OpenDirectHandle(this); if (i::IsNumber(*obj)) { return Just(i::Object::NumberValue(i::Cast<i::Number>(*obj))); } auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Value_NumberValue}; i::DirectHandle<i::Number> num; if (!i::Object::ToNumber(i_isolate, obj).ToHandle(&num)) return {}; return Just(i::Object::NumberValue(*num)); } Maybe<int64_t> Value::IntegerValue(Local<Context> context) const { auto obj = Utils::OpenDirectHandle(this); if (i::IsNumber(*obj)) { return Just(NumberToInt64(*obj)); } auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Value_IntegerValue}; i::DirectHandle<i::Object> num; if (!i::Object::ToInteger(i_isolate, obj).ToHandle(&num)) return {}; return Just(NumberToInt64(*num)); } Maybe<int32_t> Value::Int32Value(Local<Context> context) const { auto obj = Utils::OpenDirectHandle(this); if (i::IsNumber(*obj)) return Just(NumberToInt32(*obj)); auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Value_Int32Value}; i::DirectHandle<i::Object> num; if (!i::Object::ToInt32(i_isolate, obj).ToHandle(&num)) return {}; return Just(IsSmi(*num) ? i::Smi::ToInt(*num) : static_cast<int32_t>( i::Cast<i::HeapNumber>(*num)->value())); } Maybe<uint32_t> Value::Uint32Value(Local<Context> context) const { auto obj = Utils::OpenDirectHandle(this); if (i::IsNumber(*obj)) return Just(NumberToUint32(*obj)); auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Value_Uint32Value}; i::DirectHandle<i::Object> num; if (!i::Object::ToUint32(i_isolate, obj).ToHandle(&num)) return {}; return Just(IsSmi(*num) ? static_cast<uint32_t>(i::Smi::ToInt(*num)) : static_cast<uint32_t>( i::Cast<i::HeapNumber>(*num)->value())); } MaybeLocal<Uint32> Value::ToArrayIndex(Local<Context> context) const { auto self = Utils::OpenDirectHandle(this); if (i::IsSmi(*self)) { if (i::Smi::ToInt(*self) >= 0) return Utils::Uint32ToLocal(self); return {}; } PrepareForExecutionScope api_scope{context, RCCId::kAPI_Object_ToArrayIndex}; i::Isolate* i_isolate = api_scope.i_isolate(); i::DirectHandle<i::Object> string_obj; if (!i::Object::ToString(i_isolate, self).ToHandle(&string_obj)) return {}; auto str = i::Cast<i::String>(string_obj); uint32_t index; if (!str->AsArrayIndex(&index)) return {}; i::DirectHandle<i::Number> value = index <= static_cast<uint32_t>(i::Smi::kMaxValue) ? direct_handle<i::Number>(i::Smi::FromInt(index), i_isolate) : i_isolate->factory()->NewNumber(index); return api_scope.Escape(Utils::Uint32ToLocal(value)); } Maybe<bool> Value::Equals(Local<Context> context, Local<Value> that) const { i::Isolate* i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Value_Equals}; auto self = Utils::OpenDirectHandle(this); auto other = Utils::OpenDirectHandle(*that); return i::Object::Equals(i_isolate, self, other); } bool Value::StrictEquals(Local<Value> that) const { auto self = Utils::OpenDirectHandle(this); auto other = Utils::OpenDirectHandle(*that); return i::Object::StrictEquals(*self, *other); } bool Value::SameValue(Local<Value> that) const { auto self = Utils::OpenDirectHandle(this); auto other = Utils::OpenDirectHandle(*that); return i::Object::SameValue(*self, *other); } Local<String> Value::TypeOf(v8::Isolate* external_isolate) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(external_isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Value_TypeOf); return Utils::ToLocal( i::Object::TypeOf(i_isolate, Utils::OpenDirectHandle(this))); } Maybe<bool> Value::InstanceOf(v8::Local<v8::Context> context, v8::Local<v8::Object> object) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Value_InstanceOf}; i::DirectHandle<i::JSAny> left; if (!Utils::ApiCheck( i::TryCast<i::JSAny>(Utils::OpenDirectHandle(this), &left), "Value::InstanceOf", "Invalid type, must be a JS primitive or object.")) { return {}; } auto right = Utils::OpenDirectHandle(*object); i::DirectHandle<i::Object> result; if (!i::Object::InstanceOf(i_isolate, left, right).ToHandle(&result)) { return {}; } return Just(i::IsTrue(*result, i_isolate)); } uint32_t Value::GetHash() { i::DisallowGarbageCollection no_gc; auto self = Utils::OpenDirectHandle(this); i::Tagged<i::Object> hash = i::Object::GetHash(*self); if (IsSmi(hash)) return i::Cast<i::Smi>(hash).value(); i::DirectHandle<i::JSReceiver> obj = i::Cast<i::JSReceiver>(self); auto i_isolate = i::Isolate::Current(); i::DisallowJavascriptExecutionDebugOnly no_execution(i_isolate); i::DisallowExceptionsDebugOnly no_exceptions(i_isolate); return obj->GetOrCreateIdentityHash(i_isolate).value(); } Maybe<bool> v8::Object::Set(v8::Local<v8::Context> context, v8::Local<Value> key, v8::Local<Value> value) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Object_Set}; auto self = Utils::OpenDirectHandle(this); auto key_obj = Utils::OpenDirectHandle(*key); auto value_obj = Utils::OpenDirectHandle(*value); if (i::Runtime::SetObjectProperty(i_isolate, self, key_obj, value_obj, i::StoreOrigin::kMaybeKeyed, Just(i::ShouldThrow::kDontThrow)) .is_null()) { return {}; } return Just(true); } Maybe<bool> v8::Object::Set(v8::Local<v8::Context> context, v8::Local<Value> key, v8::Local<Value> value, MaybeLocal<Object> receiver) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Object_Set}; auto self = Utils::OpenDirectHandle(this); auto key_obj = Utils::OpenDirectHandle(*key); auto value_obj = Utils::OpenDirectHandle(*value); i::MaybeDirectHandle<i::JSReceiver> receiver_obj; if (!receiver.IsEmpty()) { receiver_obj = Utils::OpenDirectHandle(*receiver.ToLocalChecked()); } if (i::Runtime::SetObjectProperty(i_isolate, self, key_obj, value_obj, receiver_obj, i::StoreOrigin::kMaybeKeyed, Just(i::ShouldThrow::kDontThrow)) .is_null()) { return {}; } return Just(true); } Maybe<bool> v8::Object::Set(v8::Local<v8::Context> context, uint32_t index, v8::Local<Value> value) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Object_Set}; auto self = Utils::OpenDirectHandle(this); auto value_obj = Utils::OpenHandle(*value); if (i::Object::SetElement(i_isolate, self, index, value_obj, i::ShouldThrow::kDontThrow) .is_null()) { return {}; } return Just(true); } Maybe<bool> v8::Object::CreateDataProperty(v8::Local<v8::Context> context, v8::Local<Name> key, v8::Local<Value> value) { auto i_isolate = i::Isolate::Current(); auto self = Utils::OpenDirectHandle(this); auto key_obj = Utils::OpenDirectHandle(*key); auto value_obj = Utils::OpenDirectHandle(*value); i::PropertyKey lookup_key(i_isolate, key_obj); if (i::IsJSObject(*self)) { EnterV8NoScriptScope<> api_scope{i_isolate, context, RCCId::kAPI_Object_CreateDataProperty}; return i::JSObject::CreateDataProperty( i_isolate, i::Cast<i::JSObject>(self), lookup_key, value_obj, Just(i::kDontThrow)); } // JSProxy or WasmObject or other non-JSObject. EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Object_CreateDataProperty}; return i::JSReceiver::CreateDataProperty(i_isolate, self, lookup_key, value_obj, Just(i::kDontThrow)); } Maybe<bool> v8::Object::CreateDataProperty(v8::Local<v8::Context> context, uint32_t index, v8::Local<Value> value) { auto i_isolate = i::Isolate::Current(); auto self = Utils::OpenDirectHandle(this); auto value_obj = Utils::OpenDirectHandle(*value); i::PropertyKey lookup_key(i_isolate, index); if (i::IsJSObject(*self)) { EnterV8NoScriptScope<> api_scope{i_isolate, context, RCCId::kAPI_Object_CreateDataProperty}; return i::JSObject::CreateDataProperty( i_isolate, i::Cast<i::JSObject>(self), lookup_key, value_obj, Just(i::kDontThrow)); } // JSProxy or WasmObject or other non-JSObject. EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Object_CreateDataProperty}; return i::JSReceiver::CreateDataProperty(i_isolate, self, lookup_key, value_obj, Just(i::kDontThrow)); } struct v8::PropertyDescriptor::PrivateData { PrivateData() : desc() {} i::PropertyDescriptor desc; }; v8::PropertyDescriptor::PropertyDescriptor() : private_(new PrivateData()) {} // DataDescriptor v8::PropertyDescriptor::PropertyDescriptor(v8::Local<v8::Value> value) : private_(new PrivateData()) { private_->desc.set_value( Cast<i::JSAny>(Utils::OpenDirectHandle(*value, true))); } // DataDescriptor with writable field v8::PropertyDescriptor::PropertyDescriptor(v8::Local<v8::Value> value, bool writable) : private_(new PrivateData()) { private_->desc.set_value( Cast<i::JSAny>(Utils::OpenDirectHandle(*value, true))); private_->desc.set_writable(writable); } // AccessorDescriptor v8::PropertyDescriptor::PropertyDescriptor(v8::Local<v8::Value> get, v8::Local<v8::Value> set) : private_(new PrivateData()) { DCHECK(get.IsEmpty() || get->IsUndefined() || get->IsFunction()); DCHECK(set.IsEmpty() || set->IsUndefined() || set->IsFunction()); private_->desc.set_get(Cast<i::JSAny>(Utils::OpenDirectHandle(*get, true))); private_->desc.set_set(Cast<i::JSAny>(Utils::OpenDirectHandle(*set, true))); } v8::PropertyDescriptor::~PropertyDescriptor() { delete private_; } v8::Local<Value> v8::PropertyDescriptor::value() const { DCHECK(private_->desc.has_value()); return Utils::ToLocal(private_->desc.value()); } v8::Local<Value> v8::PropertyDescriptor::get() const { DCHECK(private_->desc.has_get()); return Utils::ToLocal(private_->desc.get()); } v8::Local<Value> v8::PropertyDescriptor::set() const { DCHECK(private_->desc.has_set()); return Utils::ToLocal(private_->desc.set()); } bool v8::PropertyDescriptor::has_value() const { return private_->desc.has_value(); } bool v8::PropertyDescriptor::has_get() const { return private_->desc.has_get(); } bool v8::PropertyDescriptor::has_set() const { return private_->desc.has_set(); } bool v8::PropertyDescriptor::writable() const { DCHECK(private_->desc.has_writable()); return private_->desc.writable(); } bool v8::PropertyDescriptor::has_writable() const { return private_->desc.has_writable(); } void v8::PropertyDescriptor::set_enumerable(bool enumerable) { private_->desc.set_enumerable(enumerable); } bool v8::PropertyDescriptor::enumerable() const { DCHECK(private_->desc.has_enumerable()); return private_->desc.enumerable(); } bool v8::PropertyDescriptor::has_enumerable() const { return private_->desc.has_enumerable(); } void v8::PropertyDescriptor::set_configurable(bool configurable) { private_->desc.set_configurable(configurable); } bool v8::PropertyDescriptor::configurable() const { DCHECK(private_->desc.has_configurable()); return private_->desc.configurable(); } bool v8::PropertyDescriptor::has_configurable() const { return private_->desc.has_configurable(); } Maybe<bool> v8::Object::DefineOwnProperty(v8::Local<v8::Context> context, v8::Local<Name> key, v8::Local<Value> value, v8::PropertyAttribute attributes) { auto i_isolate = i::Isolate::Current(); auto self = Utils::OpenDirectHandle(this); auto key_obj = Utils::OpenDirectHandle(*key); auto value_obj = Utils::OpenDirectHandle(*value); i::PropertyDescriptor desc; desc.set_writable(!(attributes & v8::ReadOnly)); desc.set_enumerable(!(attributes & v8::DontEnum)); desc.set_configurable(!(attributes & v8::DontDelete)); desc.set_value(i::Cast<i::JSAny>(value_obj)); if (i::IsJSObject(*self)) { // If it's not a JSProxy, i::JSReceiver::DefineOwnProperty should never run // a script. EnterV8NoScriptScope<> api_scope{i_isolate, context, RCCId::kAPI_Object_DefineOwnProperty}; return i::JSReceiver::DefineOwnProperty(i_isolate, self, key_obj, &desc, Just(i::kDontThrow)); } // JSProxy or WasmObject or other non-JSObject. EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Object_DefineOwnProperty}; // Even though we said kDontThrow, there might be accessors that do throw. return i::JSReceiver::DefineOwnProperty(i_isolate, self, key_obj, &desc, Just(i::kDontThrow)); } Maybe<bool> v8::Object::DefineProperty(v8::Local<v8::Context> context, v8::Local<Name> key, PropertyDescriptor& descriptor) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Object_DefineOwnProperty}; auto self = Utils::OpenDirectHandle(this); auto key_obj = Utils::OpenDirectHandle(*key); return i::JSReceiver::DefineOwnProperty(i_isolate, self, key_obj, &descriptor.get_private()->desc, Just(i::kDontThrow)); } Maybe<bool> v8::Object::SetPrivate(Local<Context> context, Local<Private> key, Local<Value> value) { auto i_isolate = i::Isolate::Current(); EnterV8NoScriptScope<> api_scope{i_isolate, context, RCCId::kAPI_Object_SetPrivate}; auto self = Utils::OpenDirectHandle(this); auto key_obj = Utils::OpenDirectHandle(reinterpret_cast<Name*>(*key)); auto value_obj = Utils::OpenDirectHandle(*value); if (i::IsJSObject(*self)) { auto js_object = i::Cast<i::JSObject>(self); i::LookupIterator it(i_isolate, js_object, key_obj, js_object); if (i::JSObject::DefineOwnPropertyIgnoreAttributes(&it, value_obj, i::DONT_ENUM) .is_null()) { return {}; } return Just(true); } if (i::IsJSProxy(*self)) { i::PropertyDescriptor desc; desc.set_writable(true); desc.set_enumerable(false); desc.set_configurable(true); desc.set_value(i::Cast<i::JSAny>(value_obj)); return i::JSProxy::SetPrivateSymbol(i_isolate, i::Cast<i::JSProxy>(self), i::Cast<i::Symbol>(key_obj), &desc, Just(i::kDontThrow)); } // Wasm object, or other kind of special object not supported here. return Just(false); } MaybeLocal<Value> v8::Object::Get(Local<v8::Context> context, Local<Value> key) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_Object_Get}; i::Isolate* i_isolate = api_scope.i_isolate(); auto self = Utils::OpenDirectHandle(this); auto key_obj = Utils::OpenDirectHandle(*key); return api_scope.EscapeMaybe( i::Runtime::GetObjectProperty(i_isolate, self, key_obj)); } MaybeLocal<Value> v8::Object::Get(Local<v8::Context> context, Local<Value> key, MaybeLocal<Object> receiver) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_Object_Get}; i::Isolate* i_isolate = api_scope.i_isolate(); auto self = Utils::OpenDirectHandle(this); auto key_obj = Utils::OpenDirectHandle(*key); i::DirectHandle<i::JSReceiver> receiver_obj; if (!receiver.IsEmpty()) { receiver_obj = Utils::OpenDirectHandle(*receiver.ToLocalChecked()); } return api_scope.EscapeMaybe( i::Runtime::GetObjectProperty(i_isolate, self, key_obj, receiver_obj)); } MaybeLocal<Value> v8::Object::Get(Local<Context> context, uint32_t index) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_Object_Get}; i::Isolate* i_isolate = api_scope.i_isolate(); auto self = Utils::OpenDirectHandle(this); return api_scope.EscapeMaybe( i::JSReceiver::GetElement(i_isolate, self, index)); } MaybeLocal<Value> v8::Object::GetPrivate(Local<Context> context, Local<Private> key) { return Get(context, key.UnsafeAs<Value>()); } Maybe<PropertyAttribute> v8::Object::GetPropertyAttributes( Local<Context> context, Local<Value> key) { PropertyAttribute attributes = PropertyAttribute::None; auto result = GetPropertyAttributes(context, key, &attributes); if (result.IsNothing()) return {}; // This will confusingly return None when the property doesn't exist. return Just(attributes); } Maybe<bool> v8::Object::GetPropertyAttributes( Local<Context> context, Local<Value> key, PropertyAttribute* out_attributes) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Object_GetPropertyAttributes}; auto self = Utils::OpenDirectHandle(this); auto key_obj = Utils::OpenDirectHandle(*key); if (!i::IsName(*key_obj)) { if (!i::Object::ToString(i_isolate, key_obj).ToHandle(&key_obj)) return {}; } auto key_name = i::Cast<i::Name>(key_obj); auto result = i::JSReceiver::GetPropertyAttributes(i_isolate, self, key_name); if (result.IsNothing()) return {}; if (result.FromJust() == i::ABSENT) { return Just(false); } *out_attributes = static_cast<PropertyAttribute>(result.FromJust()); return Just(true); } MaybeLocal<Value> v8::Object::GetOwnPropertyDescriptor(Local<Context> context, Local<Name> key) { PrepareForExecutionScope api_scope{ context, RCCId::kAPI_Object_GetOwnPropertyDescriptor}; i::Isolate* i_isolate = api_scope.i_isolate(); auto obj = Utils::OpenDirectHandle(this); auto key_name = Utils::OpenDirectHandle(*key); i::PropertyDescriptor desc; Maybe<bool> found = i::JSReceiver::GetOwnPropertyDescriptor(i_isolate, obj, key_name, &desc); if (found.IsNothing()) return {}; if (!found.FromJust()) { return v8::Undefined(reinterpret_cast<v8::Isolate*>(i_isolate)); } return api_scope.Escape(Utils::ToLocal(desc.ToObject(i_isolate))); } Local<Value> v8::Object::GetPrototypeV2() { auto self = Utils::OpenDirectHandle(this); auto i_isolate = i::Isolate::Current(); i::PrototypeIterator iter(i_isolate, self); if (i::IsJSGlobalProxy(*self)) { // Skip hidden prototype (i.e. JSGlobalObject). iter.Advance(); } DCHECK(!i::IsJSGlobalObject(*i::PrototypeIterator::GetCurrent(iter))); return Utils::ToLocal(i::PrototypeIterator::GetCurrent(iter)); } namespace { Maybe<bool> SetPrototypeImpl(v8::Object* this_, Local<Context> context, Local<Value> value, bool from_javascript) { auto i_isolate = i::Isolate::Current(); auto self = Utils::OpenDirectHandle(this_); auto value_obj = Utils::OpenDirectHandle(*value); // TODO(333672197): turn this to DCHECK once it's no longer possible // to get JSGlobalObject via API. CHECK_IMPLIES(from_javascript, !i::IsJSGlobalObject(*value_obj)); if (i::IsJSObject(*self)) { EnterV8NoScriptNoExceptionScope api_scope(i_isolate); // TODO(333672197): turn this to DCHECK once it's no longer possible // to get JSGlobalObject via API. CHECK_IMPLIES(from_javascript, !i::IsJSGlobalObject(*self)); auto result = i::JSObject::SetPrototype(i_isolate, i::Cast<i::JSObject>(self), value_obj, from_javascript, i::kDontThrow); // Convert Just(false) to Nothing. if (!result.FromJust()) return {}; return result; } if (i::IsJSProxy(*self)) { EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Object_SetPrototype}; // We do not allow exceptions thrown while setting the prototype // to propagate outside. TryCatch try_catch(reinterpret_cast<v8::Isolate*>(i_isolate)); auto result = i::JSProxy::SetPrototype(i_isolate, i::Cast<i::JSProxy>(self), value_obj, from_javascript, i::kThrowOnError); if (result.IsNothing()) return {}; // Convert Just(false) to Just(true). return Just(true); } // Wasm object or other kind of special object not supported here. return {}; } } // namespace Maybe<bool> v8::Object::SetPrototypeV2(Local<Context> context, Local<Value> value) { static constexpr bool from_javascript = true; return SetPrototypeImpl(this, context, value, from_javascript); } Local<Object> v8::Object::FindInstanceInPrototypeChain( v8::Local<FunctionTemplate> tmpl) { auto self = Utils::OpenDirectHandle(this); auto i_isolate = i::Isolate::Current(); i::Tagged<i::FunctionTemplateInfo> tmpl_info = *Utils::OpenDirectHandle(*tmpl); for (i::PrototypeIterator iter(i_isolate, *self, i::kStartAtReceiver); !iter.IsAtEnd(); iter.Advance()) { if (IsJSObject(iter.GetCurrent()) && tmpl_info->IsTemplateFor(iter.GetCurrent<i::JSObject>())) { return Utils::ToLocal( i::direct_handle(iter.GetCurrent<i::JSObject>(), i_isolate)); } } return {}; } MaybeLocal<Array> v8::Object::GetPropertyNames(Local<Context> context) { return GetPropertyNames( context, v8::KeyCollectionMode::kIncludePrototypes, static_cast<v8::PropertyFilter>(ONLY_ENUMERABLE | SKIP_SYMBOLS), v8::IndexFilter::kIncludeIndices); } MaybeLocal<Array> v8::Object::GetPropertyNames( Local<Context> context, KeyCollectionMode mode, PropertyFilter property_filter, IndexFilter index_filter, KeyConversionMode key_conversion) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_Object_GetPropertyNames}; i::Isolate* i_isolate = api_scope.i_isolate(); auto self = Utils::OpenDirectHandle(this); i::DirectHandle<i::FixedArray> value; i::KeyAccumulator accumulator( i_isolate, static_cast<i::KeyCollectionMode>(mode), static_cast<i::PropertyFilter>(property_filter)); accumulator.set_skip_indices(index_filter == IndexFilter::kSkipIndices); if (accumulator.CollectKeys(self, self).IsNothing()) return {}; value = accumulator.GetKeys(static_cast<i::GetKeysConversion>(key_conversion)); DCHECK(self->map()->EnumLength() == i::kInvalidEnumCacheSentinel || self->map()->EnumLength() == 0 || self->map()->instance_descriptors(i_isolate)->enum_cache()->keys() != *value); auto result = i_isolate->factory()->NewJSArrayWithElements(value); return api_scope.Escape(Utils::ToLocal(result)); } MaybeLocal<Array> v8::Object::GetOwnPropertyNames(Local<Context> context) { return GetOwnPropertyNames( context, static_cast<v8::PropertyFilter>(ONLY_ENUMERABLE | SKIP_SYMBOLS)); } MaybeLocal<Array> v8::Object::GetOwnPropertyNames( Local<Context> context, PropertyFilter filter, KeyConversionMode key_conversion) { return GetPropertyNames(context, KeyCollectionMode::kOwnOnly, filter, v8::IndexFilter::kIncludeIndices, key_conversion); } MaybeLocal<String> v8::Object::ObjectProtoToString(Local<Context> context) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_Object_ObjectProtoToString}; i::Isolate* i_isolate = api_scope.i_isolate(); auto self = Utils::OpenDirectHandle(this); return api_scope.EscapeMaybe(i::Cast<i::String>(i::Execution::CallBuiltin( i_isolate, i_isolate->object_to_string(), self, {}))); } Local<String> v8::Object::GetConstructorName() { // TODO(v8:12547): Consider adding GetConstructorName(Local<Context>). auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate; if (i::HeapLayout::InWritableSharedSpace(*self)) { i_isolate = i::Isolate::Current(); } else { i_isolate = i::Isolate::Current(); } i::DirectHandle<i::String> name = i::JSReceiver::GetConstructorName(i_isolate, self); return Utils::ToLocal(name); } Maybe<bool> v8::Object::SetIntegrityLevel(Local<Context> context, IntegrityLevel level) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Object_SetIntegrityLevel}; auto self = Utils::OpenDirectHandle(this); i::JSReceiver::IntegrityLevel i_level = level == IntegrityLevel::kFrozen ? i::FROZEN : i::SEALED; return i::JSReceiver::SetIntegrityLevel(i_isolate, self, i_level, i::kThrowOnError); } Maybe<bool> v8::Object::Delete(Local<Context> context, Local<Value> key) { auto i_isolate = i::Isolate::Current(); auto self = Utils::OpenDirectHandle(this); auto key_obj = Utils::OpenDirectHandle(*key); if (i::IsJSProxy(*self)) { EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Object_Delete}; return i::Runtime::DeleteObjectProperty(i_isolate, self, key_obj, i::LanguageMode::kSloppy); } else { // If it's not a JSProxy, i::Runtime::DeleteObjectProperty should never run // a script. DCHECK(i::IsJSObject(*self) || i::IsWasmObject(*self)); EnterV8NoScriptScope<> api_scope{i_isolate, context, RCCId::kAPI_Object_Delete}; return i::Runtime::DeleteObjectProperty(i_isolate, self, key_obj, i::LanguageMode::kSloppy); } } Maybe<bool> v8::Object::DeletePrivate(Local<Context> context, Local<Private> key) { auto i_isolate = i::Isolate::Current(); // In case of private symbols, i::Runtime::DeleteObjectProperty does not run // any author script. EnterV8NoScriptScope<> api_scope{i_isolate, context, RCCId::kAPI_Object_Delete}; auto self = Utils::OpenDirectHandle(this); auto key_obj = Utils::OpenDirectHandle(*key); return i::Runtime::DeleteObjectProperty(i_isolate, self, key_obj, i::LanguageMode::kSloppy); } Maybe<bool> v8::Object::Has(Local<Context> context, Local<Value> key) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Object_Has}; auto self = Utils::OpenDirectHandle(this); auto key_obj = Utils::OpenDirectHandle(*key); // Check if the given key is an array index. uint32_t index = 0; if (i::Object::ToArrayIndex(*key_obj, &index)) { return i::JSReceiver::HasElement(i_isolate, self, index); } // Convert the key to a name - possibly by calling back into JavaScript. i::DirectHandle<i::Name> name; if (i::Object::ToName(i_isolate, key_obj).ToHandle(&name)) { return i::JSReceiver::HasProperty(i_isolate, self, name); } return {}; } Maybe<bool> v8::Object::HasPrivate(Local<Context> context, Local<Private> key) { return HasOwnProperty(context, key.UnsafeAs<Name>()); } Maybe<bool> v8::Object::Delete(Local<Context> context, uint32_t index) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Object_Delete}; auto self = Utils::OpenDirectHandle(this); return i::JSReceiver::DeleteElement(i_isolate, self, index); } Maybe<bool> v8::Object::Has(Local<Context> context, uint32_t index) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Object_Has}; auto self = Utils::OpenDirectHandle(this); return i::JSReceiver::HasElement(i_isolate, self, index); } template <typename Getter, typename Setter, typename Data> static Maybe<bool> ObjectSetAccessor(Local<Context> context, Object* self, Local<Name> name, Getter getter, Setter setter, Data data, PropertyAttribute attributes, bool replace_on_access, SideEffectType getter_side_effect_type, SideEffectType setter_side_effect_type) { auto i_isolate = i::Isolate::Current(); EnterV8NoScriptScope<> api_scope{i_isolate, context, RCCId::kAPI_Object_SetAccessor}; if (!IsJSObject(*Utils::OpenDirectHandle(self))) return Just(false); auto obj = i::Cast<i::JSObject>(Utils::OpenHandle(self)); i::DirectHandle<i::AccessorInfo> info = MakeAccessorInfo( i_isolate, name, getter, setter, data, replace_on_access); info->set_getter_side_effect_type(getter_side_effect_type); info->set_setter_side_effect_type(setter_side_effect_type); if (info.is_null()) return {}; bool fast = obj->HasFastProperties(); i::DirectHandle<i::Object> result; i::DirectHandle<i::Name> accessor_name(info->name(), i_isolate); i::PropertyAttributes attrs = static_cast<i::PropertyAttributes>(attributes); if (!i::JSObject::SetAccessor(obj, accessor_name, info, attrs) .ToHandle(&result)) { return {}; } if (i::IsUndefined(*result, i_isolate)) return Just(false); if (fast) { i::JSObject::MigrateSlowToFast(obj, 0, "APISetAccessor"); } return Just(true); } void Object::SetAccessorProperty(Local<Name> name, Local<Function> getter, Local<Function> setter, PropertyAttribute attributes) { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::HandleScope scope(i_isolate); if (!IsJSObject(*self)) return; i::DirectHandle<i::JSReceiver> getter_i = v8::Utils::OpenDirectHandle(*getter); i::DirectHandle<i::JSAny> setter_i = v8::Utils::OpenDirectHandle(*setter, true); if (setter_i.is_null()) setter_i = i_isolate->factory()->null_value(); i::PropertyDescriptor desc; desc.set_enumerable(!(attributes & v8::DontEnum)); desc.set_configurable(!(attributes & v8::DontDelete)); desc.set_get(getter_i); desc.set_set(setter_i); auto name_i = v8::Utils::OpenDirectHandle(*name); // DefineOwnProperty might still throw if the receiver is a JSProxy and it // might fail if the receiver is non-extensible or already has this property // as non-configurable. Maybe<bool> success = i::JSReceiver::DefineOwnProperty( i_isolate, self, name_i, &desc, Just(i::kDontThrow)); USE(success); } Maybe<bool> Object::SetNativeDataProperty( v8::Local<v8::Context> context, v8::Local<Name> name, AccessorNameGetterCallback getter, AccessorNameSetterCallback setter, v8::Local<Value> data, PropertyAttribute attributes, SideEffectType getter_side_effect_type, SideEffectType setter_side_effect_type) { return ObjectSetAccessor(context, this, name, getter, setter, data, attributes, false, getter_side_effect_type, setter_side_effect_type); } Maybe<bool> Object::SetLazyDataProperty( v8::Local<v8::Context> context, v8::Local<Name> name, AccessorNameGetterCallback getter, v8::Local<Value> data, PropertyAttribute attributes, SideEffectType getter_side_effect_type, SideEffectType setter_side_effect_type) { return ObjectSetAccessor(context, this, name, getter, static_cast<AccessorNameSetterCallback>(nullptr), data, attributes, true, getter_side_effect_type, setter_side_effect_type); } Maybe<bool> v8::Object::HasOwnProperty(Local<Context> context, Local<Name> key) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Object_HasOwnProperty}; auto self = Utils::OpenDirectHandle(this); auto key_val = Utils::OpenDirectHandle(*key); return i::JSReceiver::HasOwnProperty(i_isolate, self, key_val); } Maybe<bool> v8::Object::HasOwnProperty(Local<Context> context, uint32_t index) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Object_HasOwnProperty}; auto self = Utils::OpenDirectHandle(this); return i::JSReceiver::HasOwnProperty(i_isolate, self, index); } Maybe<bool> v8::Object::HasRealNamedProperty(Local<Context> context, Local<Name> key) { auto i_isolate = i::Isolate::Current(); EnterV8NoScriptScope<> api_scope{i_isolate, context, RCCId::kAPI_Object_HasRealNamedProperty}; auto self = Utils::OpenDirectHandle(this); if (!IsJSObject(*self)) return Just(false); auto key_val = Utils::OpenDirectHandle(*key); return i::JSObject::HasRealNamedProperty(i_isolate, i::Cast<i::JSObject>(self), key_val); } Maybe<bool> v8::Object::HasRealIndexedProperty(Local<Context> context, uint32_t index) { auto i_isolate = i::Isolate::Current(); EnterV8NoScriptScope<> api_scope{i_isolate, context, RCCId::kAPI_Object_HasRealIndexedProperty}; auto self = Utils::OpenDirectHandle(this); if (!IsJSObject(*self)) return Just(false); return i::JSObject::HasRealElementProperty(i_isolate, i::Cast<i::JSObject>(self), index); } Maybe<bool> v8::Object::HasRealNamedCallbackProperty(Local<Context> context, Local<Name> key) { auto i_isolate = i::Isolate::Current(); EnterV8NoScriptScope<> api_scope{ i_isolate, context, RCCId::kAPI_Object_HasRealNamedCallbackProperty}; auto self = Utils::OpenDirectHandle(this); if (!IsJSObject(*self)) return Just(false); auto key_val = Utils::OpenDirectHandle(*key); return i::JSObject::HasRealNamedCallbackProperty( i_isolate, i::Cast<i::JSObject>(self), key_val); } bool v8::Object::HasNamedLookupInterceptor() const { auto self = *Utils::OpenDirectHandle(this); if (!IsJSObject(*self)) return false; return i::Cast<i::JSObject>(self)->HasNamedInterceptor(); } bool v8::Object::HasIndexedLookupInterceptor() const { auto self = *Utils::OpenDirectHandle(this); if (!IsJSObject(*self)) return false; return i::Cast<i::JSObject>(self)->HasIndexedInterceptor(); } MaybeLocal<Value> v8::Object::GetRealNamedPropertyInPrototypeChain( Local<Context> context, Local<Name> key) { PrepareForExecutionScope api_scope{ context, RCCId::kAPI_Object_GetRealNamedPropertyInPrototypeChain}; i::Isolate* i_isolate = api_scope.i_isolate(); auto self = Utils::OpenDirectHandle(this); if (!IsJSObject(*self) && !IsWasmObject(*self)) return {}; auto key_obj = Utils::OpenDirectHandle(*key); i::PrototypeIterator iter(i_isolate, self); if (iter.IsAtEnd()) return {}; i::DirectHandle<i::JSReceiver> proto = i::PrototypeIterator::GetCurrent<i::JSReceiver>(iter); i::PropertyKey lookup_key(i_isolate, key_obj); i::LookupIterator it(i_isolate, self, lookup_key, proto, i::LookupIterator::PROTOTYPE_CHAIN_SKIP_INTERCEPTOR); MaybeLocal<Value> result = Utils::ToMaybeLocal(i::Object::GetProperty(&it)); if (!it.IsFound()) return {}; return api_scope.EscapeMaybe(result); } Maybe<PropertyAttribute> v8::Object::GetRealNamedPropertyAttributesInPrototypeChain( Local<Context> context, Local<Name> key) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{ i_isolate, context, RCCId::kAPI_Object_GetRealNamedPropertyAttributesInPrototypeChain}; auto self = Utils::OpenDirectHandle(this); if (!IsJSObject(*self) && !IsWasmObject(*self)) return {}; auto key_obj = Utils::OpenDirectHandle(*key); i::PrototypeIterator iter(i_isolate, self); if (iter.IsAtEnd()) return {}; i::DirectHandle<i::JSReceiver> proto = i::PrototypeIterator::GetCurrent<i::JSReceiver>(iter); i::PropertyKey lookup_key(i_isolate, key_obj); i::LookupIterator it(i_isolate, self, lookup_key, proto, i::LookupIterator::PROTOTYPE_CHAIN_SKIP_INTERCEPTOR); Maybe<i::PropertyAttributes> result = i::JSReceiver::GetPropertyAttributes(&it); if (result.IsNothing()) return {}; if (!it.IsFound()) return {}; if (result.FromJust() == i::ABSENT) return Just(None); return Just(static_cast<PropertyAttribute>(result.FromJust())); } MaybeLocal<Value> v8::Object::GetRealNamedProperty(Local<Context> context, Local<Name> key) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_Object_GetRealNamedProperty}; i::Isolate* i_isolate = api_scope.i_isolate(); auto self = Utils::OpenDirectHandle(this); auto key_obj = Utils::OpenDirectHandle(*key); i::PropertyKey lookup_key(i_isolate, key_obj); i::LookupIterator it(i_isolate, self, lookup_key, self, i::LookupIterator::PROTOTYPE_CHAIN_SKIP_INTERCEPTOR); MaybeLocal<Value> result = Utils::ToMaybeLocal(i::Object::GetProperty(&it)); if (!it.IsFound()) return {}; return api_scope.EscapeMaybe(result); } Maybe<PropertyAttribute> v8::Object::GetRealNamedPropertyAttributes( Local<Context> context, Local<Name> key) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Object_GetRealNamedPropertyAttributes}; auto self = Utils::OpenDirectHandle(this); auto key_obj = Utils::OpenDirectHandle(*key); i::PropertyKey lookup_key(i_isolate, key_obj); i::LookupIterator it(i_isolate, self, lookup_key, self, i::LookupIterator::PROTOTYPE_CHAIN_SKIP_INTERCEPTOR); auto result = i::JSReceiver::GetPropertyAttributes(&it); if (result.IsNothing()) return {}; if (!it.IsFound()) return {}; if (result.FromJust() == i::ABSENT) { return Just(static_cast<PropertyAttribute>(i::NONE)); } return Just<PropertyAttribute>( static_cast<PropertyAttribute>(result.FromJust())); } Local<v8::Object> v8::Object::Clone(Isolate* isolate) { auto self = i::Cast<i::JSObject>(Utils::OpenDirectHandle(this)); i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::JSObject> result = i_isolate->factory()->CopyJSObject(self); return Utils::ToLocal(result); } Local<v8::Object> v8::Object::Clone() { return Clone(reinterpret_cast<v8::Isolate*>(i::Isolate::Current())); } namespace { V8_INLINE MaybeLocal<v8::Context> GetCreationContextImpl( i::DirectHandle<i::JSReceiver> object, i::Isolate* i_isolate) { i::DirectHandle<i::NativeContext> context; if (object->GetCreationContext(i_isolate).ToHandle(&context)) { return Utils::ToLocal(context); } return {}; } } // namespace MaybeLocal<v8::Context> v8::Object::GetCreationContext(v8::Isolate* isolate) { auto self = Utils::OpenDirectHandle(this); auto i_isolate = reinterpret_cast<i::Isolate*>(isolate); return GetCreationContextImpl(self, i_isolate); } MaybeLocal<v8::Context> v8::Object::GetCreationContext() { auto self = Utils::OpenDirectHandle(this); return GetCreationContextImpl(self, i::Isolate::Current()); } MaybeLocal<v8::Context> v8::Object::GetCreationContext( const PersistentBase<Object>& object) { return object.template value<Object>()->GetCreationContext( Isolate::GetCurrent()); } namespace { V8_INLINE Local<v8::Context> GetCreationContextCheckedImpl( i::DirectHandle<i::JSReceiver> object, i::Isolate* i_isolate) { i::DirectHandle<i::NativeContext> context; Utils::ApiCheck(object->GetCreationContext(i_isolate).ToHandle(&context), "v8::Object::GetCreationContextChecked", "No creation context available"); return Utils::ToLocal(context); } } // namespace Local<v8::Context> v8::Object::GetCreationContextChecked(v8::Isolate* isolate) { auto self = Utils::OpenDirectHandle(this); auto i_isolate = reinterpret_cast<i::Isolate*>(isolate); return GetCreationContextCheckedImpl(self, i_isolate); } Local<v8::Context> v8::Object::GetCreationContextChecked() { auto self = Utils::OpenDirectHandle(this); return GetCreationContextCheckedImpl(self, i::Isolate::Current()); } namespace { V8_INLINE void* GetAlignedPointerFromEmbedderDataInCreationContextImpl( i::DirectHandle<i::JSReceiver> object, i::IsolateForSandbox i_isolate_for_sandbox, int index, EmbedderDataTypeTag tag) { const char* location = "v8::Object::GetAlignedPointerFromEmbedderDataInCreationContext()"; auto maybe_context = object->GetCreationContext(); i::Tagged<i::NativeContext> native_context; if (maybe_context.has_value()) { native_context = maybe_context.value(); } else { // This happens when we're accessing a global property but passed its (now // detached) global proxy as holder. If the global proxy is detached because // of navigation, it won't have a context-specific metamap anymore (it gets // cleared on Detach to avoid leaks). Since we're doing a global proxy // access though, the Isolate's current native context must be the native // context we care about. i::Isolate* isolate = i::Isolate::Current(); i::Tagged<i::Context> context = isolate->context(); CHECK_EQ(context->global_proxy(), *object); native_context = context->native_context(); } // The code below mostly mimics Context::GetAlignedPointerFromEmbedderData() // but it doesn't try to expand the EmbedderDataArray instance. i::DisallowGarbageCollection no_gc; // This macro requires a real Isolate while |i_isolate_for_sandbox| might be // nullptr if the V8 sandbox is not enabled. i::DisallowJavascriptExecutionDebugOnly no_execution; i::DisallowExceptionsDebugOnly no_exceptions; // TODO(ishell): remove cast once embedder_data slot has a proper type. i::Tagged<i::EmbedderDataArray> data = i::Cast<i::EmbedderDataArray>(native_context->embedder_data()); if (V8_LIKELY(static_cast<unsigned>(index) < static_cast<unsigned>(data->length()))) { void* result; Utils::ApiCheck(i::EmbedderDataSlot(data, index) .ToAlignedPointer(i_isolate_for_sandbox, &result, ToExternalPointerTag(tag)), location, "Pointer is not aligned"); return result; } // Bad index, report an API error. Utils::ApiCheck(index >= 0, location, "Negative index"); Utils::ApiCheck(index < i::EmbedderDataArray::kMaxLength, location, "Index too large"); return nullptr; } } // namespace void* v8::Object::GetAlignedPointerFromEmbedderDataInCreationContext( v8::Isolate* isolate, int index, EmbedderDataTypeTag tag) { auto self = Utils::OpenDirectHandle(this); auto i_isolate = reinterpret_cast<i::Isolate*>(isolate); return GetAlignedPointerFromEmbedderDataInCreationContextImpl(self, i_isolate, index, tag); } void* v8::Object::GetAlignedPointerFromEmbedderDataInCreationContext( int index, EmbedderDataTypeTag tag) { auto self = Utils::OpenDirectHandle(this); i::IsolateForSandbox isolate = i::GetCurrentIsolateForSandbox(); return GetAlignedPointerFromEmbedderDataInCreationContextImpl(self, isolate, index, tag); } int v8::Object::GetIdentityHash() { i::DisallowGarbageCollection no_gc; auto self = Utils::OpenDirectHandle(this); auto i_isolate = i::Isolate::Current(); i::DisallowJavascriptExecutionDebugOnly no_execution(i_isolate); i::DisallowExceptionsDebugOnly no_exceptions(i_isolate); return self->GetOrCreateIdentityHash(i_isolate).value(); } bool v8::Object::IsCallable() const { return i::IsCallable(*Utils::OpenDirectHandle(this)); } bool v8::Object::IsConstructor() const { return i::IsConstructor(*Utils::OpenDirectHandle(this)); } bool v8::Object::IsApiWrapper() const { auto self = Utils::OpenDirectHandle(this); // This checks whether an object of a given instance type can serve as API // object. It does not check whether the JS object is wrapped via embedder // fields or Wrap()/Unwrap() API. return IsJSApiWrapperObject(*self); } bool v8::Object::IsUndetectable() const { auto self = Utils::OpenDirectHandle(this); return i::IsUndetectable(*self); } namespace { base::Vector<i::DirectHandle<i::Object>> PrepareArguments(int argc, Local<Value> argv[]) { static_assert(sizeof(v8::Local<v8::Value>) == sizeof(i::DirectHandle<i::Object>)); return {reinterpret_cast<i::DirectHandle<i::Object>*>(argv), static_cast<size_t>(argc)}; } } // namespace MaybeLocal<Value> Object::CallAsFunction(Local<Context> context, Local<Value> recv, int argc, Local<Value> argv[]) { auto i_isolate = i::Isolate::Current(); TRACE_EVENT_CALL_STATS_SCOPED(i_isolate, "v8", "V8.Execute"); EnterV8Scope<InternalEscapableScope> api_scope{ i_isolate, context, RCCId::kAPI_Object_CallAsFunction}; i::TimerEventScope<i::TimerEventExecute> timer_scope(i_isolate); i::NestedTimedHistogramScope execute_timer(i_isolate->counters()->execute(), i_isolate); auto self = Utils::OpenDirectHandle(this); auto recv_obj = Utils::OpenDirectHandle(*recv); auto args = PrepareArguments(argc, argv); return api_scope.EscapeMaybe( Utils::ToMaybeLocal(i::Execution::Call(i_isolate, self, recv_obj, args))); } MaybeLocal<Value> Object::CallAsConstructor(Local<Context> context, int argc, Local<Value> argv[]) { auto i_isolate = i::Isolate::Current(); TRACE_EVENT_CALL_STATS_SCOPED(i_isolate, "v8", "V8.Execute"); EnterV8Scope<InternalEscapableScope> api_scope{ i_isolate, context, RCCId::kAPI_Object_CallAsConstructor}; i::TimerEventScope<i::TimerEventExecute> timer_scope(i_isolate); i::NestedTimedHistogramScope execute_timer(i_isolate->counters()->execute(), i_isolate); auto self = Utils::OpenDirectHandle(this); auto args = PrepareArguments(argc, argv); return api_scope.EscapeMaybe( Utils::ToMaybeLocal(i::Execution::New(i_isolate, self, self, args))); } MaybeLocal<Function> Function::New(Local<Context> context, FunctionCallback callback, Local<Data> data, int length, ConstructorBehavior behavior, SideEffectType side_effect_type) { i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Function_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); auto templ = FunctionTemplateNew(i_isolate, callback, data, Local<Signature>(), length, behavior, true, Local<Private>(), side_effect_type); return Utils::ToLocal(templ)->GetFunction(context); } MaybeLocal<Object> Function::NewInstance(Local<Context> context, int argc, v8::Local<v8::Value> argv[]) const { return NewInstanceWithSideEffectType(context, argc, argv, SideEffectType::kHasSideEffect); } MaybeLocal<Object> Function::NewInstanceWithSideEffectType( Local<Context> context, int argc, v8::Local<v8::Value> argv[], SideEffectType side_effect_type) const { auto i_isolate = i::Isolate::Current(); TRACE_EVENT_CALL_STATS_SCOPED(i_isolate, "v8", "V8.Execute"); EnterV8Scope<InternalEscapableScope> api_scope{ i_isolate, context, RCCId::kAPI_Function_NewInstance}; i::TimerEventScope<i::TimerEventExecute> timer_scope(i_isolate); i::NestedTimedHistogramScope execute_timer(i_isolate->counters()->execute(), i_isolate); auto self = Utils::OpenDirectHandle(this); bool should_set_has_no_side_effect = side_effect_type == SideEffectType::kHasNoSideEffect && i_isolate->should_check_side_effects(); if (should_set_has_no_side_effect) { CHECK(IsJSFunction(*self) && i::Cast<i::JSFunction>(*self)->shared()->IsApiFunction()); i::Tagged<i::FunctionTemplateInfo> func_data = i::Cast<i::JSFunction>(*self)->shared()->api_func_data(); if (func_data->has_callback(i_isolate)) { if (func_data->has_side_effects()) { i_isolate->debug()->IgnoreSideEffectsOnNextCallTo( handle(func_data, i_isolate)); } } } auto args = PrepareArguments(argc, argv); return api_scope.EscapeMaybe( Utils::ToMaybeLocal(i::Execution::New(i_isolate, self, self, args))); } MaybeLocal<v8::Value> Function::Call(v8::Isolate* isolate, Local<Context> context, v8::Local<v8::Value> recv, int argc, v8::Local<v8::Value> argv[]) { auto i_isolate = reinterpret_cast<i::Isolate*>(isolate); TRACE_EVENT_CALL_STATS_SCOPED(i_isolate, "v8", "V8.Execute"); EnterV8Scope<InternalEscapableScope> api_scope{i_isolate, context, RCCId::kAPI_Function_Call}; i::TimerEventScope<i::TimerEventExecute> timer_scope(i_isolate); i::NestedTimedHistogramScope execute_timer(i_isolate->counters()->execute(), i_isolate); auto self = Utils::OpenDirectHandle(this); Utils::ApiCheck(!self.is_null(), "v8::Function::Call", "Function to be called is a null pointer"); auto recv_obj = Utils::OpenDirectHandle(*recv); auto args = PrepareArguments(argc, argv); return api_scope.EscapeMaybe( Utils::ToMaybeLocal(i::Execution::Call(i_isolate, self, recv_obj, args))); } MaybeLocal<v8::Value> Function::Call(Local<Context> context, v8::Local<v8::Value> recv, int argc, v8::Local<v8::Value> argv[]) { return Call(v8::Isolate::GetCurrent(), context, recv, argc, argv); } void Function::SetName(v8::Local<v8::String> name) { auto self = Utils::OpenDirectHandle(this); if (!IsJSFunction(*self)) return; auto func = i::Cast<i::JSFunction>(self); i::DisallowJavascriptExecutionDebugOnly no_execution; i::DisallowExceptionsDebugOnly no_exceptions; func->shared()->SetName(*Utils::OpenDirectHandle(*name)); } Local<Value> Function::GetName() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); if (i::IsJSBoundFunction(*self)) { auto func = i::Cast<i::JSBoundFunction>(self); i::DirectHandle<i::Object> name; ASSIGN_RETURN_ON_EXCEPTION_VALUE( i_isolate, name, i::JSBoundFunction::GetName(i_isolate, func), Local<Value>()); return Utils::ToLocal(name); } if (i::IsJSFunction(*self)) { auto func = i::Cast<i::JSFunction>(self); return Utils::ToLocal(i::direct_handle(func->shared()->Name(), i_isolate)); } return ToApiHandle<Primitive>(i_isolate->factory()->undefined_value()); } Local<Value> Function::GetInferredName() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* isolate = i::Isolate::Current(); if (!IsJSFunction(*self)) { return ToApiHandle<Primitive>(isolate->factory()->undefined_value()); } auto func = i::Cast<i::JSFunction>(self); return Utils::ToLocal( i::direct_handle(func->shared()->inferred_name(), isolate)); } Local<Value> Function::GetDebugName() const { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); if (!IsJSFunction(*self)) { return ToApiHandle<Primitive>(i_isolate->factory()->undefined_value()); } auto func = i::Cast<i::JSFunction>(self); i::DirectHandle<i::String> name = i::JSFunction::GetDebugName(i_isolate, func); return Utils::ToLocal(i::direct_handle(*name, i_isolate)); } ScriptOrigin Function::GetScriptOrigin() const { auto self = Utils::OpenDirectHandle(this); if (!IsJSFunction(*self)) return v8::ScriptOrigin(Local<Value>()); auto func = i::Cast<i::JSFunction>(self); auto shared = func->shared(); if (i::IsScript(shared->script())) { i::DirectHandle<i::Script> script(i::Cast<i::Script>(shared->script()), i::Isolate::Current()); return GetScriptOriginForScript(i::Isolate::Current(), script); } return v8::ScriptOrigin(Local<Value>()); } const int Function::kLineOffsetNotFound = -1; int Function::GetScriptLineNumber() const { auto self = *Utils::OpenDirectHandle(this); if (!IsJSFunction(self)) { return kLineOffsetNotFound; } auto func = i::Cast<i::JSFunction>(self); auto shared = func->shared(); if (i::IsScript(shared->script())) { i::DirectHandle<i::Script> script(i::Cast<i::Script>(shared->script()), i::Isolate::Current()); return i::Script::GetLineNumber(script, shared->StartPosition()); } return kLineOffsetNotFound; } int Function::GetScriptColumnNumber() const { auto self = *Utils::OpenDirectHandle(this); if (!IsJSFunction(self)) { return kLineOffsetNotFound; } auto func = i::Cast<i::JSFunction>(self); auto shared = func->shared(); if (i::IsScript(shared->script())) { i::DirectHandle<i::Script> script(i::Cast<i::Script>(shared->script()), i::Isolate::Current()); return i::Script::GetColumnNumber(script, shared->StartPosition()); } return kLineOffsetNotFound; } Location Function::GetScriptLocation() const { auto self = *Utils::OpenDirectHandle(this); if (!IsJSFunction(self)) { return {-1, -1}; } auto func = i::Cast<i::JSFunction>(self); auto shared = func->shared(); if (i::IsScript(shared->script())) { i::DirectHandle<i::Script> script(i::Cast<i::Script>(shared->script()), i::Isolate::Current()); return {i::Script::GetLineNumber(script, shared->StartPosition()), i::Script::GetColumnNumber(script, shared->StartPosition())}; } return {-1, -1}; } int Function::GetScriptStartPosition() const { auto self = *Utils::OpenDirectHandle(this); if (!IsJSFunction(self)) { return kLineOffsetNotFound; } auto func = i::Cast<i::JSFunction>(self); auto shared = func->shared(); if (i::IsScript(shared->script())) { return shared->StartPosition(); } return kLineOffsetNotFound; } int Function::ScriptId() const { auto self = *Utils::OpenDirectHandle(this); if (!IsJSFunction(self)) return v8::UnboundScript::kNoScriptId; auto func = i::Cast<i::JSFunction>(self); auto script = func->shared()->script(); if (!IsScript(script)) return v8::UnboundScript::kNoScriptId; return i::Cast<i::Script>(script)->id(); } Local<v8::Value> Function::GetBoundFunction() const { auto self = Utils::OpenDirectHandle(this); if (i::IsJSBoundFunction(*self)) { auto bound_function = i::Cast<i::JSBoundFunction>(self); auto bound_target_function = i::direct_handle( bound_function->bound_target_function(), i::Isolate::Current()); return Utils::CallableToLocal(bound_target_function); } return v8::Undefined(reinterpret_cast<v8::Isolate*>(i::Isolate::Current())); } bool Function::Experimental_IsNopFunction() const { auto self = Utils::OpenDirectHandle(this); if (!IsJSFunction(*self)) return false; auto sfi = i::Cast<i::JSFunction>(*self)->shared(); i::Isolate* i_isolate = i::Isolate::Current(); i::IsCompiledScope is_compiled_scope(sfi->is_compiled_scope(i_isolate)); if (!is_compiled_scope.is_compiled() && !i::Compiler::Compile(i_isolate, i::handle(sfi, i_isolate), i::Compiler::CLEAR_EXCEPTION, &is_compiled_scope)) { return false; } DCHECK(is_compiled_scope.is_compiled()); // Since |sfi| can be GC'ed, we get it again. sfi = i::Cast<i::JSFunction>(*self)->shared(); if (!sfi->HasBytecodeArray()) return false; i::Handle<i::BytecodeArray> bytecode_array(sfi->GetBytecodeArray(i_isolate), i_isolate); i::interpreter::BytecodeArrayIterator it(bytecode_array, 0); if (it.current_bytecode() != i::interpreter::Bytecode::kLdaUndefined) { return false; } it.Advance(); DCHECK(!it.done()); if (it.current_bytecode() != i::interpreter::Bytecode::kReturn) return false; it.Advance(); DCHECK(it.done()); return true; } MaybeLocal<String> v8::Function::FunctionProtoToString(Local<Context> context) { PrepareForExecutionScope api_scope{ context, RCCId::kAPI_Function_FunctionProtoToString}; i::Isolate* i_isolate = api_scope.i_isolate(); auto self = Utils::OpenDirectHandle(this); return api_scope.EscapeMaybe(i::Cast<i::String>(i::Execution::CallBuiltin( i_isolate, i_isolate->function_to_string(), self, {}))); } int Name::GetIdentityHash() { return static_cast<int>(Utils::OpenDirectHandle(this)->EnsureHash()); } int String::Length() const { return static_cast<int>(Utils::OpenDirectHandle(this)->length()); } bool String::IsOneByte() const { return Utils::OpenDirectHandle(this)->IsOneByteRepresentation(); } class ContainsOnlyOneByteHelper { public: ContainsOnlyOneByteHelper() : is_one_byte_(true) {} ContainsOnlyOneByteHelper(const ContainsOnlyOneByteHelper&) = delete; ContainsOnlyOneByteHelper& operator=(const ContainsOnlyOneByteHelper&) = delete; bool Check(i::Tagged<i::String> string) { i::Tagged<i::ConsString> cons_string = i::String::VisitFlat(this, string, 0); if (cons_string.is_null()) return is_one_byte_; return CheckCons(cons_string); } void VisitOneByteString(const uint8_t* chars, int length) { // Nothing to do. } void VisitTwoByteString(const uint16_t* chars, int length) { is_one_byte_ = internal::detail::IsOnly8Bit(chars, length); } private: bool CheckCons(i::Tagged<i::ConsString> cons_string) { while (true) { // Check left side if flat. i::Tagged<i::String> left = cons_string->first(); i::Tagged<i::ConsString> left_as_cons = i::String::VisitFlat(this, left, 0); if (!is_one_byte_) return false; // Check right side if flat. i::Tagged<i::String> right = cons_string->second(); i::Tagged<i::ConsString> right_as_cons = i::String::VisitFlat(this, right, 0); if (!is_one_byte_) return false; // Standard recurse/iterate trick. if (!left_as_cons.is_null() && !right_as_cons.is_null()) { if (left->length() < right->length()) { CheckCons(left_as_cons); cons_string = right_as_cons; } else { CheckCons(right_as_cons); cons_string = left_as_cons; } // Check fast return. if (!is_one_byte_) return false; continue; } // Descend left in place. if (!left_as_cons.is_null()) { cons_string = left_as_cons; continue; } // Descend right in place. if (!right_as_cons.is_null()) { cons_string = right_as_cons; continue; } // Terminate. break; } return is_one_byte_; } bool is_one_byte_; }; bool String::ContainsOnlyOneByte() const { auto str = Utils::OpenDirectHandle(this); if (str->IsOneByteRepresentation()) return true; ContainsOnlyOneByteHelper helper; return helper.Check(*str); } size_t String::Utf8LengthV2(Isolate* v8_isolate) const { auto str = Utils::OpenDirectHandle(this); return i::String::Utf8Length(reinterpret_cast<i::Isolate*>(v8_isolate), str); } template <typename CharType> static inline void WriteHelperV2(i::Isolate* i_isolate, const String* string, CharType* buffer, uint32_t offset, uint32_t length, int flags) { ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_String_Write); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); DCHECK_LE(length, string->Length()); DCHECK_LE(offset, string->Length() - length); auto str = Utils::OpenDirectHandle(string); i::String::WriteToFlat(*str, buffer, offset, length); if (flags & String::WriteFlags::kNullTerminate) { buffer[length] = '\0'; } } void String::WriteV2(Isolate* v8_isolate, uint32_t offset, uint32_t length, uint16_t* buffer, int flags) const { WriteHelperV2(reinterpret_cast<i::Isolate*>(v8_isolate), this, buffer, offset, length, flags); } void String::WriteOneByteV2(Isolate* v8_isolate, uint32_t offset, uint32_t length, uint8_t* buffer, int flags) const { WriteHelperV2(reinterpret_cast<i::Isolate*>(v8_isolate), this, buffer, offset, length, flags); } size_t String::WriteUtf8V2(Isolate* v8_isolate, char* buffer, size_t capacity, int flags, size_t* processed_characters_return) const { auto str = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_String_WriteUtf8); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::String::Utf8EncodingFlags i_flags; if (flags & String::WriteFlags::kNullTerminate) { i_flags |= i::String::Utf8EncodingFlag::kNullTerminate; } if (flags & String::WriteFlags::kReplaceInvalidUtf8) { i_flags |= i::String::Utf8EncodingFlag::kReplaceInvalid; } return i::String::WriteUtf8(i_isolate, str, buffer, capacity, i_flags, processed_characters_return); } namespace { bool HasExternalStringResource(i::Tagged<i::String> string) { return i::StringShape(string).IsExternal() || string->HasExternalForwardingIndex(kAcquireLoad); } v8::String::ExternalStringResourceBase* GetExternalResourceFromForwardingTable( i::Tagged<i::String> string, uint32_t raw_hash, bool* is_one_byte) { DCHECK(i::String::IsExternalForwardingIndex(raw_hash)); const int index = i::String::ForwardingIndexValueBits::decode(raw_hash); // Note that with a shared heap the main and worker isolates all share the // same forwarding table. auto resource = i::Isolate::Current()->string_forwarding_table()->GetExternalResource( index, is_one_byte); DCHECK_NOT_NULL(resource); return resource; } } // namespace bool v8::String::IsExternal() const { return HasExternalStringResource(*Utils::OpenDirectHandle(this)); } bool v8::String::IsExternalTwoByte() const { auto str = Utils::OpenDirectHandle(this); if (i::StringShape(*str).IsExternalTwoByte()) return true; uint32_t raw_hash_field = str->raw_hash_field(kAcquireLoad); if (i::String::IsExternalForwardingIndex(raw_hash_field)) { bool is_one_byte; GetExternalResourceFromForwardingTable(*str, raw_hash_field, &is_one_byte); return !is_one_byte; } return false; } bool v8::String::IsExternalOneByte() const { auto str = Utils::OpenDirectHandle(this); if (i::StringShape(*str).IsExternalOneByte()) return true; uint32_t raw_hash_field = str->raw_hash_field(kAcquireLoad); if (i::String::IsExternalForwardingIndex(raw_hash_field)) { bool is_one_byte; GetExternalResourceFromForwardingTable(*str, raw_hash_field, &is_one_byte); return is_one_byte; } return false; } Local<v8::String> v8::String::InternalizeString(Isolate* v8_isolate) { auto* isolate = reinterpret_cast<i::Isolate*>(v8_isolate); auto str = Utils::OpenDirectHandle(this); return Utils::ToLocal(isolate->factory()->InternalizeString(str)); } void v8::String::VerifyExternalStringResource( v8::String::ExternalStringResource* value) const { i::DisallowGarbageCollection no_gc; i::Tagged<i::String> str = *Utils::OpenDirectHandle(this); const v8::String::ExternalStringResource* expected = nullptr; if (i::IsThinString(str)) { str = i::Cast<i::ThinString>(str)->actual(); } if (i::StringShape(str).IsExternalTwoByte()) { const void* resource = i::Cast<i::ExternalTwoByteString>(str)->resource(); expected = reinterpret_cast<const ExternalStringResource*>(resource); } else { uint32_t raw_hash_field = str->raw_hash_field(kAcquireLoad); if (i::String::IsExternalForwardingIndex(raw_hash_field)) { bool is_one_byte; auto resource = GetExternalResourceFromForwardingTable( str, raw_hash_field, &is_one_byte); if (!is_one_byte) { expected = reinterpret_cast<const ExternalStringResource*>(resource); } } } CHECK_EQ(expected, value); } void v8::String::VerifyExternalStringResourceBase( v8::String::ExternalStringResourceBase* value, Encoding encoding) const { i::DisallowGarbageCollection no_gc; i::Tagged<i::String> str = *Utils::OpenDirectHandle(this); const v8::String::ExternalStringResourceBase* expected; Encoding expectedEncoding; if (i::IsThinString(str)) { str = i::Cast<i::ThinString>(str)->actual(); } if (i::StringShape(str).IsExternalOneByte()) { const void* resource = i::Cast<i::ExternalOneByteString>(str)->resource(); expected = reinterpret_cast<const ExternalStringResourceBase*>(resource); expectedEncoding = ONE_BYTE_ENCODING; } else if (i::StringShape(str).IsExternalTwoByte()) { const void* resource = i::Cast<i::ExternalTwoByteString>(str)->resource(); expected = reinterpret_cast<const ExternalStringResourceBase*>(resource); expectedEncoding = TWO_BYTE_ENCODING; } else { uint32_t raw_hash_field = str->raw_hash_field(kAcquireLoad); if (i::String::IsExternalForwardingIndex(raw_hash_field)) { bool is_one_byte; expected = GetExternalResourceFromForwardingTable(str, raw_hash_field, &is_one_byte); expectedEncoding = is_one_byte ? ONE_BYTE_ENCODING : TWO_BYTE_ENCODING; } else { expected = nullptr; expectedEncoding = str->IsOneByteRepresentation() ? ONE_BYTE_ENCODING : TWO_BYTE_ENCODING; } } CHECK_EQ(expected, value); CHECK_EQ(expectedEncoding, encoding); } String::ExternalStringResource* String::GetExternalStringResourceSlow() const { i::DisallowGarbageCollection no_gc; i::Tagged<i::String> str = *Utils::OpenDirectHandle(this); if (i::IsThinString(str)) { str = i::Cast<i::ThinString>(str)->actual(); } if (i::StringShape(str).IsExternalTwoByte()) { Isolate* isolate = i::Internals::GetCurrentIsolateForSandbox(); i::Address value = i::Internals::ReadExternalPointerField<i::kExternalStringResourceTag>( isolate, str.ptr(), i::Internals::kStringResourceOffset); return reinterpret_cast<String::ExternalStringResource*>(value); } else { uint32_t raw_hash_field = str->raw_hash_field(kAcquireLoad); if (i::String::IsExternalForwardingIndex(raw_hash_field)) { bool is_one_byte; auto resource = GetExternalResourceFromForwardingTable( str, raw_hash_field, &is_one_byte); if (!is_one_byte) { return reinterpret_cast<ExternalStringResource*>(resource); } } } return nullptr; } void String::ExternalStringResource::UpdateDataCache() { DCHECK(IsCacheable()); cached_data_ = data(); } void String::ExternalStringResource::CheckCachedDataInvariants() const { DCHECK(IsCacheable() && cached_data_ != nullptr); } void String::ExternalOneByteStringResource::UpdateDataCache() { DCHECK(IsCacheable()); cached_data_ = data(); } void String::ExternalOneByteStringResource::CheckCachedDataInvariants() const { DCHECK(IsCacheable() && cached_data_ != nullptr); } String::ExternalStringResourceBase* String::GetExternalStringResourceBaseSlow( String::Encoding* encoding_out) const { i::DisallowGarbageCollection no_gc; ExternalStringResourceBase* resource = nullptr; i::Tagged<i::String> str = *Utils::OpenDirectHandle(this); if (i::IsThinString(str)) { str = i::Cast<i::ThinString>(str)->actual(); } internal::Address string = str.ptr(); int type = i::Internals::GetInstanceType(string) & i::Internals::kStringRepresentationAndEncodingMask; *encoding_out = static_cast<Encoding>(type & i::Internals::kStringEncodingMask); if (i::StringShape(str).IsExternalOneByte() || i::StringShape(str).IsExternalTwoByte()) { Isolate* isolate = i::Internals::GetCurrentIsolateForSandbox(); i::Address value = i::Internals::ReadExternalPointerField<i::kExternalStringResourceTag>( isolate, string, i::Internals::kStringResourceOffset); resource = reinterpret_cast<ExternalStringResourceBase*>(value); } else { uint32_t raw_hash_field = str->raw_hash_field(); if (i::String::IsExternalForwardingIndex(raw_hash_field)) { bool is_one_byte; resource = GetExternalResourceFromForwardingTable(str, raw_hash_field, &is_one_byte); *encoding_out = is_one_byte ? Encoding::ONE_BYTE_ENCODING : Encoding::TWO_BYTE_ENCODING; } } return resource; } const v8::String::ExternalOneByteStringResource* v8::String::GetExternalOneByteStringResource() const { i::DisallowGarbageCollection no_gc; i::Tagged<i::String> str = *Utils::OpenDirectHandle(this); if (i::StringShape(str).IsExternalOneByte()) { return i::Cast<i::ExternalOneByteString>(str)->resource(); } else if (i::IsThinString(str)) { str = i::Cast<i::ThinString>(str)->actual(); if (i::StringShape(str).IsExternalOneByte()) { return i::Cast<i::ExternalOneByteString>(str)->resource(); } } uint32_t raw_hash_field = str->raw_hash_field(kAcquireLoad); if (i::String::IsExternalForwardingIndex(raw_hash_field)) { bool is_one_byte; auto resource = GetExternalResourceFromForwardingTable(str, raw_hash_field, &is_one_byte); if (is_one_byte) { return reinterpret_cast<ExternalOneByteStringResource*>(resource); } } return nullptr; } Local<Value> Symbol::Description(Isolate* v8_isolate) const { auto sym = Utils::OpenDirectHandle(this); i::Isolate* isolate = reinterpret_cast<i::Isolate*>(v8_isolate); return Utils::ToLocal(i::direct_handle(sym->description(), isolate)); } Local<Value> Private::Name() const { const Symbol* sym = reinterpret_cast<const Symbol*>(this); // v8::Private symbols are created by API and are therefore writable, so we // can always recover an Isolate. i::Isolate* i_isolate = i::Isolate::Current(); return sym->Description(reinterpret_cast<Isolate*>(i_isolate)); } double Number::Value() const { return i::Object::NumberValue(*Utils::OpenDirectHandle(this)); } bool Boolean::Value() const { return i::IsTrue(*Utils::OpenDirectHandle(this)); } int64_t Integer::Value() const { auto obj = *Utils::OpenDirectHandle(this); if (i::IsSmi(obj)) { return i::Smi::ToInt(obj); } else { return static_cast<int64_t>(i::Object::NumberValue(obj)); } } int32_t Int32::Value() const { auto obj = *Utils::OpenDirectHandle(this); if (i::IsSmi(obj)) { return i::Smi::ToInt(obj); } else { return static_cast<int32_t>(i::Object::NumberValue(obj)); } } uint32_t Uint32::Value() const { auto obj = *Utils::OpenDirectHandle(this); if (i::IsSmi(obj)) { return i::Smi::ToInt(obj); } else { return static_cast<uint32_t>(i::Object::NumberValue(obj)); } } int v8::Object::InternalFieldCount() const { auto self = *Utils::OpenDirectHandle(this); if (!IsJSObject(self)) return 0; return i::Cast<i::JSObject>(self)->GetEmbedderFieldCount(); } static V8_INLINE bool InternalFieldOK(i::DirectHandle<i::JSReceiver> obj, int index, const char* location) { return Utils::ApiCheck( IsJSObject(*obj) && (index < i::Cast<i::JSObject>(*obj)->GetEmbedderFieldCount()), location, "Internal field out of bounds"); } Local<Data> v8::Object::SlowGetInternalField(int index) { auto obj = Utils::OpenDirectHandle(this); const char* location = "v8::Object::GetInternalField()"; if (!InternalFieldOK(obj, index, location)) return {}; i::Isolate* isolate = i::Isolate::Current(); return ToApiHandle<Data>(i::direct_handle( i::Cast<i::JSObject>(*obj)->GetEmbedderField(index), isolate)); } void v8::Object::SetInternalField(int index, v8::Local<Data> value) { auto obj = Utils::OpenDirectHandle(this); const char* location = "v8::Object::SetInternalField()"; if (!InternalFieldOK(obj, index, location)) return; auto val = Utils::OpenDirectHandle(*value); i::Cast<i::JSObject>(obj)->SetEmbedderField(index, *val); } void* v8::Object::SlowGetAlignedPointerFromInternalField( v8::Isolate* isolate, int index, EmbedderDataTypeTag tag) { auto obj = Utils::OpenDirectHandle(this); const char* location = "v8::Object::GetAlignedPointerFromInternalField()"; if (!InternalFieldOK(obj, index, location)) return nullptr; void* result; Utils::ApiCheck(i::EmbedderDataSlot(i::Cast<i::JSObject>(*obj), index) .ToAlignedPointer(reinterpret_cast<i::Isolate*>(isolate), &result, ToExternalPointerTag(tag)), location, "Unaligned pointer"); return result; } void* v8::Object::SlowGetAlignedPointerFromInternalField( int index, EmbedderDataTypeTag tag) { auto obj = Utils::OpenDirectHandle(this); const char* location = "v8::Object::GetAlignedPointerFromInternalField()"; if (!InternalFieldOK(obj, index, location)) return nullptr; void* result; Utils::ApiCheck(i::EmbedderDataSlot(i::Cast<i::JSObject>(*obj), index) .ToAlignedPointer(i::Isolate::Current(), &result, ToExternalPointerTag(tag)), location, "Unaligned pointer"); return result; } void v8::Object::SetAlignedPointerInInternalField(int index, void* value, EmbedderDataTypeTag tag) { auto obj = Utils::OpenDirectHandle(this); const char* location = "v8::Object::SetAlignedPointerInInternalField()"; if (!InternalFieldOK(obj, index, location)) return; i::DisallowGarbageCollection no_gc; Utils::ApiCheck(i::EmbedderDataSlot(i::Cast<i::JSObject>(*obj), index) .store_aligned_pointer(i::Isolate::Current(), *obj, value, ToExternalPointerTag(tag)), location, "Unaligned pointer"); DCHECK_EQ(value, GetAlignedPointerFromInternalField(index, tag)); } // static void* v8::Object::Unwrap(v8::Isolate* isolate, i::Address wrapper_obj, CppHeapPointerTagRange tag_range) { DCHECK_LE(tag_range.first, tag_range.last); return i::CppHeapObjectWrapper( i::Cast<i::JSObject>(i::Tagged<i::Object>(wrapper_obj))) .GetCppHeapWrappable(reinterpret_cast<i::Isolate*>(isolate), tag_range); } // static void v8::Object::Wrap(v8::Isolate* isolate, i::Address wrapper_obj, CppHeapPointerTag tag, void* wrappable) { return i::CppHeapObjectWrapper( i::Cast<i::JSObject>(i::Tagged<i::Object>(wrapper_obj))) .SetCppHeapWrappable(reinterpret_cast<i::Isolate*>(isolate), wrappable, tag); } namespace { // Checks that given prototype is a valid hidden prototype of JSGlobalProxy. // It must be either JSGlobalObject or remote object. void CheckPrototypeIsGlobalObjectOrRemoteObject( i::Tagged<i::JSPrototype> prototype) { CHECK(i::IsJSSpecialObject(prototype)); auto prototype_obj = i::Cast<i::JSSpecialObject>(prototype); CHECK(i::IsJSGlobalObject(prototype_obj) || i::IsNull(prototype_obj->map()->map()->native_context_or_null())); } } // namespace // static void v8::Object::WrapGlobal(v8::Isolate* isolate, const v8::Local<v8::Object>& wrapper, Wrappable* wrappable, CppHeapPointerTag tag) { auto global_proxy = i::Cast<i::JSObject>( i::Tagged<i::Object>(internal::ValueHelper::ValueAsAddress(*wrapper))); CHECK(i::IsJSGlobalProxy(global_proxy)); auto prototype = global_proxy->map()->prototype(); CheckPrototypeIsGlobalObjectOrRemoteObject(prototype); i::CppHeapObjectWrapper(global_proxy) .SetCppHeapWrappable(reinterpret_cast<i::Isolate*>(isolate), wrappable, tag); i::CppHeapObjectWrapper(i::Cast<i::JSObject>(prototype)) .SetCppHeapWrappable(reinterpret_cast<i::Isolate*>(isolate), wrappable, tag); } // static bool v8::Object::CheckGlobalWrappable(v8::Isolate* isolate, const v8::Local<v8::Object>& wrapper, CppHeapPointerTagRange tag_range) { auto global_proxy = i::Cast<i::JSObject>( i::Tagged<i::Object>(internal::ValueHelper::ValueAsAddress(*wrapper))); Utils::ApiCheck(i::IsJSGlobalProxy(global_proxy), "v8::Object::CheckGlobalWrappable", "Bad object provided, expecting JSGlobalProxy"); auto prototype = global_proxy->map()->prototype(); CheckPrototypeIsGlobalObjectOrRemoteObject(prototype); void* global_proxy_wrappable = i::CppHeapObjectWrapper(global_proxy) .GetCppHeapWrappable(reinterpret_cast<i::Isolate*>(isolate), tag_range); void* hidden_prototype_wrappable = i::CppHeapObjectWrapper(i::Cast<i::JSObject>(prototype)) .GetCppHeapWrappable(reinterpret_cast<i::Isolate*>(isolate), tag_range); Utils::ApiCheck( global_proxy_wrappable == hidden_prototype_wrappable, "v8::Object::CheckGlobalWrappable", "Global object's wrappable is not equal hidden prototype's wrappable"); return true; } // --- E n v i r o n m e n t --- void v8::V8::InitializePlatform(Platform* platform) { i::V8::InitializePlatform(platform); } void v8::V8::DisposePlatform() { i::V8::DisposePlatform(); } bool v8::V8::Initialize(const int build_config) { const bool kEmbedderPointerCompression = (build_config & kPointerCompression) != 0; if (kEmbedderPointerCompression != COMPRESS_POINTERS_BOOL) { FATAL( "Embedder-vs-V8 build configuration mismatch. On embedder side " "pointer compression is %s while on V8 side it's %s.", kEmbedderPointerCompression ? "ENABLED" : "DISABLED", COMPRESS_POINTERS_BOOL ? "ENABLED" : "DISABLED"); } const int kEmbedderSmiValueSize = (build_config & k31BitSmis) ? 31 : 32; if (kEmbedderSmiValueSize != internal::kSmiValueSize) { FATAL( "Embedder-vs-V8 build configuration mismatch. On embedder side " "Smi value size is %d while on V8 side it's %d.", kEmbedderSmiValueSize, internal::kSmiValueSize); } const bool kEmbedderSandbox = (build_config & kSandbox) != 0; if (kEmbedderSandbox != V8_ENABLE_SANDBOX_BOOL) { FATAL( "Embedder-vs-V8 build configuration mismatch. On embedder side " "sandbox is %s while on V8 side it's %s.", kEmbedderSandbox ? "ENABLED" : "DISABLED", V8_ENABLE_SANDBOX_BOOL ? "ENABLED" : "DISABLED"); } const bool kEmbedderTargetOsIsAndroid = (build_config & kTargetOsIsAndroid) != 0; #ifdef V8_TARGET_OS_ANDROID const bool kV8TargetOsIsAndroid = true; #else const bool kV8TargetOsIsAndroid = false; #endif if (kEmbedderTargetOsIsAndroid != kV8TargetOsIsAndroid) { FATAL( "Embedder-vs-V8 build configuration mismatch. On embedder side " "target OS is %s while on V8 side it's %s.", kEmbedderTargetOsIsAndroid ? "Android" : "not Android", kV8TargetOsIsAndroid ? "Android" : "not Android"); } const bool kEmbedderEnableChecks = (build_config & kEnableChecks) != 0; #ifdef V8_ENABLE_CHECKS const bool kV8EnableChecks = true; #else const bool kV8EnableChecks = false; #endif if (kEmbedderEnableChecks != kV8EnableChecks) { FATAL( "Embedder-vs-V8 build configuration mismatch. On embedder side " "V8_ENABLE_CHECKS is %s while on V8 side it's %s.", kEmbedderEnableChecks ? "ENABLED" : "DISABLED", kV8EnableChecks ? "ENABLED" : "DISABLED"); } // TODO(ishell, 455600234): check that V8_TARGET_ARCH_ARM64/PPC64 on embedder // side matches the ones on V8 side. i::V8::Initialize(); if (!cppgc::IsInitialized()) { // cppgc::InitializeProcess() has to becalled after V8::Initialize(). // V8::Initialize() triggers OS::Platform initialization code that is needed // by the default page allocator on Fuchsia to allocate memory correctly. cppgc::InitializeProcess(i::V8::GetCurrentPlatform()->GetPageAllocator()); } return true; } #if V8_OS_LINUX || V8_OS_DARWIN bool TryHandleWebAssemblyTrapPosix(int sig_code, siginfo_t* info, void* context) { #if V8_ENABLE_WEBASSEMBLY && V8_TRAP_HANDLER_SUPPORTED return i::trap_handler::TryHandleSignal(sig_code, info, context); #else return false; #endif } #endif #if V8_OS_WIN bool TryHandleWebAssemblyTrapWindows(EXCEPTION_POINTERS* exception) { #if V8_ENABLE_WEBASSEMBLY && V8_TRAP_HANDLER_SUPPORTED return i::trap_handler::TryHandleWasmTrap(exception); #else return false; #endif } #endif size_t V8::GetWasmMemoryReservationSizeInBytes(WasmMemoryType type, size_t byte_capacity) { #if V8_ENABLE_WEBASSEMBLY bool is_memory64 = type == WasmMemoryType::kMemory64; uint64_t max_byte_capacity = is_memory64 ? i::wasm::max_mem64_bytes() : i::wasm::max_mem32_bytes(); if (byte_capacity > max_byte_capacity) { byte_capacity = static_cast<size_t>(max_byte_capacity); } #if V8_TRAP_HANDLER_SUPPORTED if (!is_memory64 || i::v8_flags.wasm_memory64_trap_handling) { return i::BackingStore::GetWasmReservationSize( /* has_guard_regions */ true, byte_capacity, /* is_wasm_memory64 */ is_memory64); } #endif // V8_TRAP_HANDLER_SUPPORTED #endif // V8_ENABLE_WEBASSEMBLY return byte_capacity; } bool V8::EnableWebAssemblyTrapHandler(bool use_v8_signal_handler) { #if V8_ENABLE_WEBASSEMBLY return i::trap_handler::EnableTrapHandler(use_v8_signal_handler); #else return false; #endif } #if defined(V8_OS_WIN) void V8::SetUnhandledExceptionCallback( UnhandledExceptionCallback unhandled_exception_callback) { #if defined(V8_OS_WIN64) i::win64_unwindinfo::SetUnhandledExceptionCallback( unhandled_exception_callback); #else // Not implemented, port needed. #endif // V8_OS_WIN64 } #endif // V8_OS_WIN void v8::V8::SetFatalMemoryErrorCallback( v8::OOMErrorCallback oom_error_callback) { g_oom_error_callback = oom_error_callback; } void v8::V8::SetEntropySource(EntropySource entropy_source) { base::RandomNumberGenerator::SetEntropySource(entropy_source); } void v8::V8::SetReturnAddressLocationResolver( ReturnAddressLocationResolver return_address_resolver) { i::StackFrame::SetReturnAddressLocationResolver(return_address_resolver); } bool v8::V8::Dispose() { i::V8::Dispose(); return true; } SharedMemoryStatistics::SharedMemoryStatistics() : read_only_space_size_(0), read_only_space_used_size_(0), read_only_space_physical_size_(0) {} HeapStatistics::HeapStatistics() : total_heap_size_(0), total_heap_size_executable_(0), total_physical_size_(0), total_available_size_(0), used_heap_size_(0), heap_size_limit_(0), malloced_memory_(0), external_memory_(0), peak_malloced_memory_(0), does_zap_garbage_(false), number_of_native_contexts_(0), number_of_detached_contexts_(0), total_allocated_bytes_(0) {} HeapSpaceStatistics::HeapSpaceStatistics() : space_name_(nullptr), space_size_(0), space_used_size_(0), space_available_size_(0), physical_space_size_(0) {} HeapObjectStatistics::HeapObjectStatistics() : object_type_(nullptr), object_sub_type_(nullptr), object_count_(0), object_size_(0) {} HeapCodeStatistics::HeapCodeStatistics() : code_and_metadata_size_(0), bytecode_and_metadata_size_(0), external_script_source_size_(0), cpu_profiler_metadata_size_(0) {} bool v8::V8::InitializeICU(const char* icu_data_file) { return i::InitializeICU(icu_data_file); } bool v8::V8::InitializeICUDefaultLocation(const char* exec_path, const char* icu_data_file) { return i::InitializeICUDefaultLocation(exec_path, icu_data_file); } void v8::V8::InitializeExternalStartupData(const char* directory_path) { i::InitializeExternalStartupData(directory_path); } // static void v8::V8::InitializeExternalStartupDataFromFile(const char* snapshot_blob) { i::InitializeExternalStartupDataFromFile(snapshot_blob); } const char* v8::V8::GetVersion() { return i::Version::GetVersion(); } #ifdef V8_ENABLE_SANDBOX VirtualAddressSpace* v8::V8::GetSandboxAddressSpace() { Utils::ApiCheck(i::Sandbox::current()->is_initialized(), "v8::V8::GetSandboxAddressSpace", "The sandbox must be initialized first"); return i::Sandbox::current()->address_space(); } size_t v8::V8::GetSandboxSizeInBytes() { Utils::ApiCheck(i::Sandbox::current()->is_initialized(), "v8::V8::GetSandboxSizeInBytes", "The sandbox must be initialized first."); return i::Sandbox::current()->size(); } size_t v8::V8::GetSandboxReservationSizeInBytes() { Utils::ApiCheck(i::Sandbox::current()->is_initialized(), "v8::V8::GetSandboxReservationSizeInBytes", "The sandbox must be initialized first"); return i::Sandbox::current()->reservation_size(); } bool v8::V8::IsSandboxConfiguredSecurely() { Utils::ApiCheck(i::Sandbox::current()->is_initialized(), "v8::V8::IsSandoxConfiguredSecurely", "The sandbox must be initialized first"); // The sandbox is (only) configured insecurely if it is a partially reserved // sandbox, since in that case unrelated memory mappings may end up inside // the sandbox address space where they could be corrupted by an attacker. return !i::Sandbox::current()->is_partially_reserved(); } #endif // V8_ENABLE_SANDBOX void V8::GetSharedMemoryStatistics(SharedMemoryStatistics* statistics) { i::ReadOnlyHeap::PopulateReadOnlySpaceStatistics(statistics); } template <typename ObjectType> struct InvokeBootstrapper; template <> struct InvokeBootstrapper<i::NativeContext> { i::DirectHandle<i::NativeContext> Invoke( i::Isolate* i_isolate, i::MaybeDirectHandle<i::JSGlobalProxy> maybe_global_proxy, v8::Local<v8::ObjectTemplate> global_proxy_template, v8::ExtensionConfiguration* extensions, size_t context_snapshot_index, i::DeserializeEmbedderFieldsCallback embedder_fields_deserializer, v8::MicrotaskQueue* microtask_queue) { return i_isolate->bootstrapper()->CreateEnvironment( maybe_global_proxy, global_proxy_template, extensions, context_snapshot_index, embedder_fields_deserializer, microtask_queue); } }; template <> struct InvokeBootstrapper<i::JSGlobalProxy> { i::DirectHandle<i::JSGlobalProxy> Invoke( i::Isolate* i_isolate, i::MaybeDirectHandle<i::JSGlobalProxy> maybe_global_proxy, v8::Local<v8::ObjectTemplate> global_proxy_template, v8::ExtensionConfiguration* extensions, size_t context_snapshot_index, i::DeserializeEmbedderFieldsCallback embedder_fields_deserializer, v8::MicrotaskQueue* microtask_queue) { USE(extensions); USE(context_snapshot_index); return i_isolate->bootstrapper()->NewRemoteContext(maybe_global_proxy, global_proxy_template); } }; template <typename ObjectType> static i::DirectHandle<ObjectType> CreateEnvironment( i::Isolate* i_isolate, v8::ExtensionConfiguration* extensions, v8::MaybeLocal<ObjectTemplate> maybe_global_template, v8::MaybeLocal<Value> maybe_global_proxy, size_t context_snapshot_index, i::DeserializeEmbedderFieldsCallback embedder_fields_deserializer, v8::MicrotaskQueue* microtask_queue) { i::DirectHandle<ObjectType> result; { // Do some part of the EnterV8Scope, but without a context yet. DCHECK_IMPLIES(i::v8_flags.strict_termination_checks, !i_isolate->is_execution_terminating()); i::VMState<v8::OTHER> vm_state(i_isolate); i::DisallowExceptionsDebugOnly no_exceptions(i_isolate); v8::Local<ObjectTemplate> proxy_template; i::DirectHandle<i::FunctionTemplateInfo> proxy_constructor; i::DirectHandle<i::FunctionTemplateInfo> global_constructor; i::DirectHandle<i::UnionOf<i::Undefined, i::InterceptorInfo>> named_interceptor(i_isolate->factory()->undefined_value()); i::DirectHandle<i::UnionOf<i::Undefined, i::InterceptorInfo>> indexed_interceptor(i_isolate->factory()->undefined_value()); if (!maybe_global_template.IsEmpty()) { v8::Local<v8::ObjectTemplate> global_template = maybe_global_template.ToLocalChecked(); // Make sure that the global_template has a constructor. global_constructor = EnsureConstructor(i_isolate, *global_template); // Create a fresh template for the global proxy object. proxy_template = ObjectTemplate::New(reinterpret_cast<v8::Isolate*>(i_isolate)); proxy_constructor = EnsureConstructor(i_isolate, *proxy_template); // Set the global template to be the prototype template of // global proxy template. i::FunctionTemplateInfo::SetPrototypeTemplate( i_isolate, proxy_constructor, Utils::OpenDirectHandle(*global_template)); proxy_template->SetInternalFieldCount( global_template->InternalFieldCount()); // Migrate security handlers from global_template to // proxy_template. Temporarily removing access check // information from the global template. if (!IsUndefined(global_constructor->GetAccessCheckInfo(), i_isolate)) { i::FunctionTemplateInfo::SetAccessCheckInfo( i_isolate, proxy_constructor, direct_handle(global_constructor->GetAccessCheckInfo(), i_isolate)); proxy_constructor->set_needs_access_check( global_constructor->needs_access_check()); global_constructor->set_needs_access_check(false); i::FunctionTemplateInfo::SetAccessCheckInfo( i_isolate, global_constructor, i_isolate->factory()->undefined_value()); } // Same for other interceptors. If the global constructor has // interceptors, we need to replace them temporarily with noop // interceptors, so the map is correctly marked as having interceptors, // but we don't invoke any. if (!IsUndefined(global_constructor->GetNamedPropertyHandler(), i_isolate)) { named_interceptor = direct_handle( global_constructor->GetNamedPropertyHandler(), i_isolate); i::FunctionTemplateInfo::SetNamedPropertyHandler( i_isolate, global_constructor, i_isolate->factory()->noop_interceptor_info()); } if (!IsUndefined(global_constructor->GetIndexedPropertyHandler(), i_isolate)) { indexed_interceptor = direct_handle( global_constructor->GetIndexedPropertyHandler(), i_isolate); i::FunctionTemplateInfo::SetIndexedPropertyHandler( i_isolate, global_constructor, i_isolate->factory()->noop_interceptor_info()); } } i::MaybeDirectHandle<i::JSGlobalProxy> maybe_proxy; if (!maybe_global_proxy.IsEmpty()) { maybe_proxy = i::Cast<i::JSGlobalProxy>( Utils::OpenDirectHandle(*maybe_global_proxy.ToLocalChecked())); } // Create the environment. InvokeBootstrapper<ObjectType> invoke; result = invoke.Invoke(i_isolate, maybe_proxy, proxy_template, extensions, context_snapshot_index, embedder_fields_deserializer, microtask_queue); // Restore the access check info and interceptors on the global template. if (!maybe_global_template.IsEmpty()) { DCHECK(!global_constructor.is_null()); DCHECK(!proxy_constructor.is_null()); i::FunctionTemplateInfo::SetAccessCheckInfo( i_isolate, global_constructor, i::direct_handle(proxy_constructor->GetAccessCheckInfo(), i_isolate)); global_constructor->set_needs_access_check( proxy_constructor->needs_access_check()); i::FunctionTemplateInfo::SetNamedPropertyHandler( i_isolate, global_constructor, named_interceptor); i::FunctionTemplateInfo::SetIndexedPropertyHandler( i_isolate, global_constructor, indexed_interceptor); } } // Leave V8. return result; } Local<Context> NewContext( v8::Isolate* external_isolate, v8::ExtensionConfiguration* extensions, v8::MaybeLocal<ObjectTemplate> global_template, v8::MaybeLocal<Value> global_object, size_t context_snapshot_index, i::DeserializeEmbedderFieldsCallback embedder_fields_deserializer, v8::MicrotaskQueue* microtask_queue) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(external_isolate); // TODO(jkummerow): This is for crbug.com/713699. Remove it if it doesn't // fail. // Sanity-check that the isolate is initialized and usable. CHECK(IsCode(i_isolate->builtins()->code(i::Builtin::kIllegal))); TRACE_EVENT_CALL_STATS_SCOPED(i_isolate, "v8", "V8.NewContext"); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Context_New); i::HandleScope scope(i_isolate); ExtensionConfiguration no_extensions; if (extensions == nullptr) extensions = &no_extensions; i::DirectHandle<i::NativeContext> env = CreateEnvironment<i::NativeContext>( i_isolate, extensions, global_template, global_object, context_snapshot_index, embedder_fields_deserializer, microtask_queue); if (env.is_null()) return {}; return Utils::ToLocal(scope.CloseAndEscape(env)); } Local<Context> v8::Context::New( v8::Isolate* external_isolate, v8::ExtensionConfiguration* extensions, v8::MaybeLocal<ObjectTemplate> global_template, v8::MaybeLocal<Value> global_object, v8::DeserializeInternalFieldsCallback internal_fields_deserializer, v8::MicrotaskQueue* microtask_queue, v8::DeserializeContextDataCallback context_callback_deserializer, v8::DeserializeAPIWrapperCallback api_wrapper_deserializer) { return NewContext( external_isolate, extensions, global_template, global_object, 0, i::DeserializeEmbedderFieldsCallback(internal_fields_deserializer, context_callback_deserializer, api_wrapper_deserializer), microtask_queue); } MaybeLocal<Context> v8::Context::FromSnapshot( v8::Isolate* external_isolate, size_t context_snapshot_index, v8::DeserializeInternalFieldsCallback internal_fields_deserializer, v8::ExtensionConfiguration* extensions, MaybeLocal<Value> global_object, v8::MicrotaskQueue* microtask_queue, v8::DeserializeContextDataCallback context_callback_deserializer, v8::DeserializeAPIWrapperCallback api_wrapper_deserializer) { size_t index_including_default_context = context_snapshot_index + 1; if (!i::Snapshot::HasContextSnapshot( reinterpret_cast<i::Isolate*>(external_isolate), index_including_default_context)) { return {}; } return NewContext( external_isolate, extensions, MaybeLocal<ObjectTemplate>(), global_object, index_including_default_context, i::DeserializeEmbedderFieldsCallback(internal_fields_deserializer, context_callback_deserializer, api_wrapper_deserializer), microtask_queue); } MaybeLocal<Object> v8::Context::NewRemoteContext( v8::Isolate* external_isolate, v8::Local<ObjectTemplate> global_template, v8::MaybeLocal<v8::Value> global_object) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(external_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Context_NewRemoteContext); i::HandleScope scope(i_isolate); i::DirectHandle<i::FunctionTemplateInfo> global_constructor = EnsureConstructor(i_isolate, *global_template); Utils::ApiCheck(global_constructor->needs_access_check(), "v8::Context::NewRemoteContext", "Global template needs to have access checks enabled"); i::DirectHandle<i::AccessCheckInfo> access_check_info( i::Cast<i::AccessCheckInfo>(global_constructor->GetAccessCheckInfo()), i_isolate); Utils::ApiCheck( access_check_info->named_interceptor() != i::Tagged<i::Object>(), "v8::Context::NewRemoteContext", "Global template needs to have access check handlers"); i::DirectHandle<i::JSObject> global_proxy = CreateEnvironment<i::JSGlobalProxy>( i_isolate, nullptr, global_template, global_object, 0, i::DeserializeEmbedderFieldsCallback(), nullptr); if (global_proxy.is_null()) { if (i_isolate->has_exception()) i_isolate->clear_exception(); return {}; } return Utils::ToLocal(scope.CloseAndEscape(global_proxy)); } void v8::Context::SetSecurityToken(Local<Value> token) { auto env = Utils::OpenDirectHandle(this); auto token_handle = Utils::OpenDirectHandle(*token); env->set_security_token(*token_handle); } void v8::Context::UseDefaultSecurityToken() { auto env = Utils::OpenDirectHandle(this); env->set_security_token(env->global_object()); } Local<Value> v8::Context::GetSecurityToken() { auto env = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); i::Tagged<i::Object> security_token = env->security_token(); return Utils::ToLocal(i::direct_handle(security_token, i_isolate)); } namespace { bool MayContainObjectsToFreeze(i::InstanceType obj_type) { if (i::InstanceTypeChecker::IsString(obj_type)) return false; // SharedFunctionInfo is cross-context so it shouldn't be frozen. if (i::InstanceTypeChecker::IsSharedFunctionInfo(obj_type)) return false; // All TemplateInfo objects are cross-context so they shouldn't be frozen. if (i::InstanceTypeChecker::IsTemplateInfo(obj_type)) return false; return true; } bool RequiresEmbedderSupportToFreeze(i::InstanceType obj_type) { DCHECK(i::InstanceTypeChecker::IsJSReceiver(obj_type)); return (i::InstanceTypeChecker::IsJSApiObject(obj_type) || i::InstanceTypeChecker::IsJSExternalObject(obj_type) || i::InstanceTypeChecker::IsJSAPIObjectWithEmbedderSlots(obj_type) || i::InstanceTypeChecker::IsCppHeapExternalObject(obj_type)); } bool IsJSReceiverSafeToFreeze(i::InstanceType obj_type) { DCHECK(i::InstanceTypeChecker::IsJSReceiver(obj_type)); switch (obj_type) { case i::JS_OBJECT_TYPE: case i::JS_GLOBAL_OBJECT_TYPE: case i::JS_GLOBAL_PROXY_TYPE: case i::JS_PRIMITIVE_WRAPPER_TYPE: case i::JS_FUNCTION_TYPE: /* Function types */ case i::BIGINT64_TYPED_ARRAY_CONSTRUCTOR_TYPE: case i::BIGUINT64_TYPED_ARRAY_CONSTRUCTOR_TYPE: case i::FLOAT16_TYPED_ARRAY_CONSTRUCTOR_TYPE: case i::FLOAT32_TYPED_ARRAY_CONSTRUCTOR_TYPE: case i::FLOAT64_TYPED_ARRAY_CONSTRUCTOR_TYPE: case i::INT16_TYPED_ARRAY_CONSTRUCTOR_TYPE: case i::INT32_TYPED_ARRAY_CONSTRUCTOR_TYPE: case i::INT8_TYPED_ARRAY_CONSTRUCTOR_TYPE: case i::UINT16_TYPED_ARRAY_CONSTRUCTOR_TYPE: case i::UINT32_TYPED_ARRAY_CONSTRUCTOR_TYPE: case i::UINT8_CLAMPED_TYPED_ARRAY_CONSTRUCTOR_TYPE: case i::UINT8_TYPED_ARRAY_CONSTRUCTOR_TYPE: case i::JS_ARRAY_CONSTRUCTOR_TYPE: case i::JS_PROMISE_CONSTRUCTOR_TYPE: case i::JS_REG_EXP_CONSTRUCTOR_TYPE: case i::JS_CLASS_CONSTRUCTOR_TYPE: /* Prototype Types */ case i::JS_ARRAY_ITERATOR_PROTOTYPE_TYPE: case i::JS_ITERATOR_PROTOTYPE_TYPE: case i::JS_MAP_ITERATOR_PROTOTYPE_TYPE: case i::JS_OBJECT_PROTOTYPE_TYPE: case i::JS_PROMISE_PROTOTYPE_TYPE: case i::JS_REG_EXP_PROTOTYPE_TYPE: case i::JS_SET_ITERATOR_PROTOTYPE_TYPE: case i::JS_SET_PROTOTYPE_TYPE: case i::JS_STRING_ITERATOR_PROTOTYPE_TYPE: case i::JS_TYPED_ARRAY_PROTOTYPE_TYPE: /* */ case i::JS_ARRAY_TYPE: return true; #if V8_ENABLE_WEBASSEMBLY case i::WASM_ARRAY_TYPE: case i::WASM_STRUCT_TYPE: case i::WASM_TAG_OBJECT_TYPE: #endif // V8_ENABLE_WEBASSEMBLY case i::JS_PROXY_TYPE: return true; // These types are known not to freeze. case i::JS_MAP_KEY_ITERATOR_TYPE: case i::JS_MAP_KEY_VALUE_ITERATOR_TYPE: case i::JS_MAP_VALUE_ITERATOR_TYPE: case i::JS_SET_KEY_VALUE_ITERATOR_TYPE: case i::JS_SET_VALUE_ITERATOR_TYPE: case i::JS_GENERATOR_OBJECT_TYPE: case i::JS_ASYNC_FUNCTION_OBJECT_TYPE: case i::JS_ASYNC_GENERATOR_OBJECT_TYPE: case i::JS_ARRAY_ITERATOR_TYPE: { return false; } default: // TODO(behamilton): Handle any types that fall through here. return false; } } class ObjectVisitorDeepFreezer : i::ObjectVisitor { public: explicit ObjectVisitorDeepFreezer(i::Isolate* isolate, Context::DeepFreezeDelegate* delegate) : isolate_(isolate), delegate_(delegate), objects_to_freeze_(isolate), lazy_accessor_pairs_to_freeze_(isolate) {} bool DeepFreeze(i::DirectHandle<i::Context> context) { bool success = VisitObject(i::Cast<i::HeapObject>(*context)); if (success) { success = InstantiateAndVisitLazyAccessorPairs(); } DCHECK_EQ(success, !error_.has_value()); if (!success) { THROW_NEW_ERROR_RETURN_VALUE( isolate_, NewTypeError(error_->msg_id, error_->name), false); } for (const auto& obj : objects_to_freeze_) { RETURN_ON_EXCEPTION_VALUE(isolate_, i::JSReceiver::SetIntegrityLevel( isolate_, obj, i::FROZEN, i::kThrowOnError), false); } return true; } void VisitPointers(i::Tagged<i::HeapObject> host, i::ObjectSlot start, i::ObjectSlot end) final { VisitPointersImpl(start, end); } void VisitPointers(i::Tagged<i::HeapObject> host, i::MaybeObjectSlot start, i::MaybeObjectSlot end) final { VisitPointersImpl(start, end); } void VisitMapPointer(i::Tagged<i::HeapObject> host) final { VisitPointer(host, host->map_slot()); } void VisitInstructionStreamPointer(i::Tagged<i::Code> host, i::InstructionStreamSlot slot) final {} void VisitCustomWeakPointers(i::Tagged<i::HeapObject> host, i::ObjectSlot start, i::ObjectSlot end) final {} private: struct ErrorInfo { i::MessageTemplate msg_id; i::DirectHandle<i::String> name; }; template <typename TSlot> void VisitPointersImpl(TSlot start, TSlot end) { for (TSlot current = start; current < end; ++current) { typename TSlot::TObject object = current.load(isolate_); i::Tagged<i::HeapObject> heap_object; if (object.GetHeapObjectIfStrong(&heap_object)) { if (!VisitObject(heap_object)) { return; } } } } bool FreezeEmbedderObjectAndVisitChildren(i::DirectHandle<i::JSObject> obj) { DCHECK(delegate_); LocalVector<Object> children(reinterpret_cast<Isolate*>(isolate_)); if (!delegate_->FreezeEmbedderObjectAndGetChildren(Utils::ToLocal(obj), children)) { return false; } for (auto child : children) { if (!VisitObject( *Utils::OpenDirectHandle<Object, i::JSReceiver>(child))) { return false; } } return true; } bool VisitObject(i::Tagged<i::HeapObject> obj) { DCHECK(!obj.is_null()); if (error_.has_value()) { return false; } i::DisallowGarbageCollection no_gc; i::InstanceType obj_type = obj->map()->instance_type(); // Skip common types that can't contain items to freeze. if (!MayContainObjectsToFreeze(obj_type)) { return true; } if (!done_list_.insert(obj).second) { // If we couldn't insert (because it is already in the set) then we're // done. return true; } if (i::InstanceTypeChecker::IsAccessorPair(obj_type)) { // For AccessorPairs we need to ensure that the functions they point to // have been instantiated into actual JavaScript objects that can be // frozen. If they haven't then we need to save them to instantiate // (and recurse) before freezing. i::Tagged<i::AccessorPair> accessor_pair = i::Cast<i::AccessorPair>(obj); if (i::IsFunctionTemplateInfo(accessor_pair->getter()) || IsFunctionTemplateInfo(accessor_pair->setter())) { i::DirectHandle<i::AccessorPair> lazy_accessor_pair(accessor_pair, isolate_); lazy_accessor_pairs_to_freeze_.push_back(lazy_accessor_pair); } } else if (i::InstanceTypeChecker::IsContext(obj_type)) { // For contexts we need to ensure that all accessible locals are const. // If not they could be replaced to bypass freezing. i::Tagged<i::ScopeInfo> scope_info = i::Cast<i::Context>(obj)->scope_info(); for (auto it : i::ScopeInfo::IterateLocalNames(scope_info, no_gc)) { if (!IsImmutableLexicalVariableMode( scope_info->ContextLocalMode(it->index()))) { DCHECK(!error_.has_value()); error_ = ErrorInfo{i::MessageTemplate::kCannotDeepFreezeValue, i::direct_handle(it->name(), isolate_)}; return false; } } } else if (i::InstanceTypeChecker::IsJSReceiver(obj_type)) { i::DirectHandle<i::JSReceiver> receiver(i::Cast<i::JSReceiver>(obj), isolate_); if (RequiresEmbedderSupportToFreeze(obj_type)) { auto js_obj = i::Cast<i::JSObject>(receiver); // External objects don't have slots but still need to be processed by // the embedder. if (i::InstanceTypeChecker::IsJSExternalObject(obj_type) || js_obj->GetEmbedderFieldCount() > 0) { if (!delegate_) { DCHECK(!error_.has_value()); error_ = ErrorInfo{i::MessageTemplate::kCannotDeepFreezeObject, i::direct_handle(receiver->class_name(), isolate_)}; return false; } // Handle embedder specific types and any v8 children it wants to // freeze. if (!FreezeEmbedderObjectAndVisitChildren(js_obj)) { return false; } } else { DCHECK_EQ(js_obj->GetEmbedderFieldCount(), 0); } } else { DCHECK_IMPLIES( i::InstanceTypeChecker::IsJSObject(obj_type), i::Cast<i::JSObject>(*receiver)->GetEmbedderFieldCount() == 0); if (!IsJSReceiverSafeToFreeze(obj_type)) { DCHECK(!error_.has_value()); error_ = ErrorInfo{i::MessageTemplate::kCannotDeepFreezeObject, i::direct_handle(receiver->class_name(), isolate_)}; return false; } } // Save this to freeze after we are done. Freezing triggers garbage // collection which doesn't work well with this visitor pattern, so we // delay it until after. objects_to_freeze_.push_back(receiver); } else { DCHECK(!i::InstanceTypeChecker::IsAccessorPair(obj_type)); DCHECK(!i::InstanceTypeChecker::IsContext(obj_type)); DCHECK(!i::InstanceTypeChecker::IsJSReceiver(obj_type)); } DCHECK(!error_.has_value()); i::VisitObject(isolate_, obj, this); // Iterate sets error_ on failure. We should propagate errors. return !error_.has_value(); } bool InstantiateAndVisitLazyAccessorPairs() { i::DirectHandle<i::NativeContext> native_context = isolate_->native_context(); i::DirectHandleVector<i::AccessorPair> lazy_accessor_pairs_to_freeze( isolate_); std::swap(lazy_accessor_pairs_to_freeze, lazy_accessor_pairs_to_freeze_); for (const auto& accessor_pair : lazy_accessor_pairs_to_freeze) { i::AccessorPair::GetComponent(isolate_, native_context, accessor_pair, i::ACCESSOR_GETTER); i::AccessorPair::GetComponent(isolate_, native_context, accessor_pair, i::ACCESSOR_SETTER); VisitObject(*accessor_pair); } // Ensure no new lazy accessor pairs were discovered. CHECK_EQ(lazy_accessor_pairs_to_freeze_.size(), 0); return true; } i::Isolate* isolate_; Context::DeepFreezeDelegate* delegate_; std::unordered_set<i::Tagged<i::Object>, i::Object::Hasher> done_list_; i::DirectHandleVector<i::JSReceiver> objects_to_freeze_; i::DirectHandleVector<i::AccessorPair> lazy_accessor_pairs_to_freeze_; std::optional<ErrorInfo> error_; }; } // namespace Maybe<void> Context::DeepFreeze(DeepFreezeDelegate* delegate) { auto env = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); // TODO(behamilton): Incorporate compatibility improvements similar to NodeJS: // https://github.com/nodejs/node/blob/main/lib/internal/freeze_intrinsics.js // These need to be done before freezing. Local<Context> context = Utils::ToLocal(env); EnterV8NoScriptScope<> api_scope{i_isolate, context, RCCId::kAPI_Context_DeepFreeze}; ObjectVisitorDeepFreezer vfreezer(i_isolate, delegate); if (!vfreezer.DeepFreeze(env)) return {}; return JustVoid(); } v8::MicrotaskQueue* Context::GetMicrotaskQueue() { auto env = Utils::OpenDirectHandle(this); Utils::ApiCheck(i::IsNativeContext(*env), "v8::Context::GetMicrotaskQueue", "Must be called on a native context"); return env->microtask_queue(); } void Context::SetMicrotaskQueue(v8::MicrotaskQueue* queue) { auto context = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); Utils::ApiCheck(i::IsNativeContext(*context), "v8::Context::SetMicrotaskQueue", "Must be called on a native context"); i::HandleScopeImplementer* impl = i_isolate->handle_scope_implementer(); Utils::ApiCheck(!context->microtask_queue()->IsRunningMicrotasks(), "v8::Context::SetMicrotaskQueue", "Must not be running microtasks"); Utils::ApiCheck(context->microtask_queue()->GetMicrotasksScopeDepth() == 0, "v8::Context::SetMicrotaskQueue", "Must not have microtask scope pushed"); Utils::ApiCheck(impl->EnteredContextCount() == 0, "v8::Context::SetMicrotaskQueue()", "Cannot set Microtask Queue with an entered context"); context->set_microtask_queue(i_isolate, static_cast<const i::MicrotaskQueue*>(queue)); } v8::Local<v8::Object> Context::Global() { auto context = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); i::DirectHandle<i::JSObject> global(context->global_proxy(), i_isolate); return Utils::ToLocal(global); } void Context::DetachGlobal() { auto context = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i_isolate->DetachGlobal(context); } Local<v8::Object> Context::GetExtrasBindingObject() { auto context = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); return Utils::ToLocal( i::direct_handle(context->extras_binding_object(), i_isolate)); } void Context::AllowCodeGenerationFromStrings(bool allow) { auto context = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); context->set_allow_code_gen_from_strings( i::ReadOnlyRoots(i_isolate).boolean_value(allow)); } bool Context::IsCodeGenerationFromStringsAllowed() const { auto context = Utils::OpenDirectHandle(this); return !IsFalse(context->allow_code_gen_from_strings(), i::Isolate::Current()); } void Context::SetErrorMessageForCodeGenerationFromStrings(Local<String> error) { auto context = Utils::OpenDirectHandle(this); auto error_handle = Utils::OpenDirectHandle(*error); context->set_error_message_for_code_gen_from_strings(*error_handle); } void Context::SetErrorMessageForWasmCodeGeneration(Local<String> error) { auto context = Utils::OpenDirectHandle(this); auto error_handle = Utils::OpenDirectHandle(*error); context->set_error_message_for_wasm_code_gen(*error_handle); } void Context::SetAbortScriptExecution( Context::AbortScriptExecutionCallback callback) { auto context = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); if (callback == nullptr) { context->set_script_execution_callback( i::ReadOnlyRoots(i_isolate).undefined_value()); } else { SET_FIELD_WRAPPED(i_isolate, context, set_script_execution_callback, callback, internal::kApiAbortScriptExecutionCallbackTag); } } void v8::Context::SetPromiseHooks(Local<Function> init_hook, Local<Function> before_hook, Local<Function> after_hook, Local<Function> resolve_hook) { #ifdef V8_ENABLE_JAVASCRIPT_PROMISE_HOOKS auto context = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); auto undefined = i_isolate->factory()->undefined_value(); i::DirectHandle<i::Object> init = undefined; i::DirectHandle<i::Object> before = undefined; i::DirectHandle<i::Object> after = undefined; i::DirectHandle<i::Object> resolve = undefined; bool has_hook = false; if (!init_hook.IsEmpty()) { init = Utils::OpenDirectHandle(*init_hook); has_hook = true; } if (!before_hook.IsEmpty()) { before = Utils::OpenDirectHandle(*before_hook); has_hook = true; } if (!after_hook.IsEmpty()) { after = Utils::OpenDirectHandle(*after_hook); has_hook = true; } if (!resolve_hook.IsEmpty()) { resolve = Utils::OpenDirectHandle(*resolve_hook); has_hook = true; } i_isolate->SetHasContextPromiseHooks(has_hook); context->native_context()->set_promise_hook_init_function(*init); context->native_context()->set_promise_hook_before_function(*before); context->native_context()->set_promise_hook_after_function(*after); context->native_context()->set_promise_hook_resolve_function(*resolve); #else // V8_ENABLE_JAVASCRIPT_PROMISE_HOOKS Utils::ApiCheck(false, "v8::Context::SetPromiseHook", "V8 was compiled without JavaScript Promise hooks"); #endif // V8_ENABLE_JAVASCRIPT_PROMISE_HOOKS } bool Context::HasTemplateLiteralObject(Local<Value> object) { i::DisallowGarbageCollection no_gc; i::Tagged<i::Object> i_object = *Utils::OpenDirectHandle(*object); if (!IsJSArray(i_object)) return false; return Utils::OpenDirectHandle(this) ->native_context() ->HasTemplateLiteralObject(i::Cast<i::JSArray>(i_object)); } MaybeLocal<Context> metrics::Recorder::GetContext( Isolate* v8_isolate, metrics::Recorder::ContextId id) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); return i_isolate->GetContextFromRecorderContextId(id); } metrics::Recorder::ContextId metrics::Recorder::GetContextId( Local<Context> context) { auto i_context = Utils::OpenDirectHandle(*context); i::Isolate* i_isolate = i::Isolate::Current(); return i_isolate->GetOrRegisterRecorderContextId( direct_handle(i_context->native_context(), i_isolate)); } metrics::LongTaskStats metrics::LongTaskStats::Get(v8::Isolate* v8_isolate) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); return *i_isolate->GetCurrentLongTaskStats(); } namespace { i::ValueHelper::InternalRepresentationType GetSerializedDataFromFixedArray( i::Isolate* i_isolate, i::Tagged<i::FixedArray> list, size_t index) { if (index < static_cast<size_t>(list->length())) { int int_index = static_cast<int>(index); i::Tagged<i::Object> object = list->get(int_index); if (!IsTheHole(object, i_isolate)) { list->set_the_hole(i_isolate, int_index); // Shrink the list so that the last element is not the hole (unless it's // the first element, because we don't want to end up with a non-canonical // empty FixedArray). int last = list->length() - 1; while (last >= 0 && list->is_the_hole(i_isolate, last)) last--; if (last != -1) list->RightTrim(i_isolate, last + 1); return i::Handle<i::Object>(object, i_isolate).repr(); } } return i::ValueHelper::kEmpty; } } // anonymous namespace i::ValueHelper::InternalRepresentationType Context::GetDataFromSnapshotOnce( size_t index) { auto context = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); auto list = i::Cast<i::FixedArray>(context->serialized_objects()); return GetSerializedDataFromFixedArray(i_isolate, list, index); } MaybeLocal<v8::Object> ObjectTemplate::NewInstance(Local<Context> context) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_ObjectTemplate_NewInstance}; i::Isolate* i_isolate = api_scope.i_isolate(); auto self = Utils::OpenDirectHandle(this); return api_scope.EscapeMaybe( i::ApiNatives::InstantiateObject(i_isolate, self)); } void v8::ObjectTemplate::CheckCast(Data* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsObjectTemplateInfo(*obj), "v8::ObjectTemplate::Cast", "Value is not an ObjectTemplate"); } void v8::DictionaryTemplate::CheckCast(Data* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsDictionaryTemplateInfo(*obj), "v8::DictionaryTemplate::Cast", "Value is not an DictionaryTemplate"); } void v8::FunctionTemplate::CheckCast(Data* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsFunctionTemplateInfo(*obj), "v8::FunctionTemplate::Cast", "Value is not a FunctionTemplate"); } void v8::Signature::CheckCast(Data* that) { auto obj = Utils::OpenDirectHandle(that); Utils::ApiCheck(i::IsFunctionTemplateInfo(*obj), "v8::Signature::Cast", "Value is not a Signature"); } MaybeLocal<v8::Function> FunctionTemplate::GetFunction(Local<Context> context) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_FunctionTemplate_GetFunction}; i::Isolate* i_isolate = api_scope.i_isolate(); auto self = Utils::OpenDirectHandle(this); return api_scope.EscapeMaybe(i::ApiNatives::InstantiateFunction( i_isolate, i_isolate->native_context(), self)); } MaybeLocal<v8::Object> FunctionTemplate::NewRemoteInstance() { i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope( i_isolate, RCCId::kAPI_FunctionTemplate_NewRemoteInstance); i::HandleScope scope(i_isolate); i::DirectHandle<i::FunctionTemplateInfo> constructor = EnsureConstructor(i_isolate, *InstanceTemplate()); Utils::ApiCheck(constructor->needs_access_check(), "v8::FunctionTemplate::NewRemoteInstance", "InstanceTemplate needs to have access checks enabled"); i::DirectHandle<i::AccessCheckInfo> access_check_info( i::Cast<i::AccessCheckInfo>(constructor->GetAccessCheckInfo()), i_isolate); Utils::ApiCheck( access_check_info->named_interceptor() != i::Tagged<i::Object>(), "v8::FunctionTemplate::NewRemoteInstance", "InstanceTemplate needs to have access check handlers"); i::DirectHandle<i::JSObject> object; if (!i::ApiNatives::InstantiateRemoteObject( Utils::OpenDirectHandle(*InstanceTemplate())) .ToHandle(&object)) { return {}; } return Utils::ToLocal(scope.CloseAndEscape(object)); } bool FunctionTemplate::HasInstance(v8::Local<v8::Value> value) { auto self = Utils::OpenDirectHandle(this); auto obj = Utils::OpenDirectHandle(*value); if (i::IsJSObject(*obj) && self->IsTemplateFor(i::Cast<i::JSObject>(*obj))) { return true; } if (i::IsJSGlobalProxy(*obj)) { // If it's a global proxy, then test with the global object. Note that the // inner global object may not necessarily be a JSGlobalObject. auto jsobj = i::Cast<i::JSObject>(*obj); i::PrototypeIterator iter(i::Isolate::Current(), jsobj->map()); // The global proxy should always have a prototype, as it is a bug to call // this on a detached JSGlobalProxy. DCHECK(!iter.IsAtEnd()); return self->IsTemplateFor(iter.GetCurrent<i::JSObject>()); } return false; } bool FunctionTemplate::IsLeafTemplateForApiObject( v8::Local<v8::Value> value) const { i::DisallowGarbageCollection no_gc; auto self = Utils::OpenDirectHandle(this); i::Tagged<i::Object> object = *Utils::OpenDirectHandle(*value); return self->IsLeafTemplateForApiObject(object); } void ObjectTemplate::SealAndPrepareForPromotionToReadOnly() { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); i::ObjectTemplateInfo::SealAndPrepareForPromotionToReadOnly(i_isolate, self); } void FunctionTemplate::SealAndPrepareForPromotionToReadOnly() { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); i::FunctionTemplateInfo::SealAndPrepareForPromotionToReadOnly(i_isolate, self); } Local<External> v8::External::New(Isolate* v8_isolate, void* value, ExternalPointerTypeTag api_tag) { static_assert(sizeof(value) == sizeof(i::Address)); // Nullptr is not allowed here because serialization/deserialization of // nullptr external api references is not possible as nullptr is used as an // external_references table terminator, see v8::SnapshotCreator() // constructors. DCHECK_NOT_NULL(value); i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_External_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); uint16_t tag_value = static_cast<uint16_t>(i::kFirstExternalTypeTag) + static_cast<uint16_t>(api_tag); Utils::ApiCheck(tag_value <= i::kLastExternalTypeTag, "v8::External::New", "The provided tag is outside the allowed range"); i::DirectHandle<i::JSObject> external = i_isolate->factory()->NewExternal( value, static_cast<i::ExternalPointerTag>(tag_value)); return Utils::ExternalToLocal(external); } void* External::Value(ExternalPointerTypeTag api_tag) const { i::IsolateForSandbox isolate = i::GetCurrentIsolateForSandbox(); uint16_t tag_value = static_cast<uint16_t>(i::kFirstExternalTypeTag) + static_cast<uint16_t>(api_tag); Utils::ApiCheck(tag_value <= i::kLastExternalTypeTag, "v8::External::Value", "The provided tag is outside the allowed range"); return i::Cast<i::JSExternalObject>(*Utils::OpenDirectHandle(this)) ->value(isolate, static_cast<i::ExternalPointerTag>(tag_value)); } Local<CppHeapExternal> v8::CppHeapExternal::NewImpl(Isolate* v8_isolate, void* value, CppHeapPointerTag tag) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_CppHeapExternal_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::CppHeapExternalObject> external = i_isolate->factory()->NewCppHeapExternal(); i::CppHeapObjectWrapper(*external).SetCppHeapWrappable(i_isolate, value, tag); return Utils::CppHeapExternalToLocal(external); } void* CppHeapExternal::ValueImpl(v8::Isolate* isolate, CppHeapPointerTagRange tag_range) const { DCHECK_LE(tag_range.first, tag_range.last); auto self = Utils::OpenDirectHandle(this); return i::CppHeapObjectWrapper(*self).GetCppHeapWrappable( reinterpret_cast<i::Isolate*>(isolate), tag_range); } // anonymous namespace for string creation helper functions namespace { inline int StringLength(const char* string) { size_t len = strlen(string); CHECK_GE(String::kMaxLength, len); static_assert(String::kMaxLength <= i::kMaxInt); return static_cast<int>(len); } inline int StringLength(const uint8_t* string) { return StringLength(reinterpret_cast<const char*>(string)); } inline int StringLength(const uint16_t* string) { size_t length = 0; while (string[length] != '\0') length++; CHECK_GE(String::kMaxLength, length); static_assert(String::kMaxLength <= i::kMaxInt); return static_cast<int>(length); } V8_WARN_UNUSED_RESULT inline i::MaybeHandle<i::String> NewString(i::Factory* factory, NewStringType type, base::Vector<const char> string) { if (type == NewStringType::kInternalized) { return factory->InternalizeUtf8String(string); } return factory->NewStringFromUtf8(string); } V8_WARN_UNUSED_RESULT inline i::MaybeHandle<i::String> NewString(i::Factory* factory, NewStringType type, base::Vector<const uint8_t> string) { if (type == NewStringType::kInternalized) { return factory->InternalizeString(string); } return factory->NewStringFromOneByte(string); } V8_WARN_UNUSED_RESULT inline i::MaybeHandle<i::String> NewString( i::Factory* factory, NewStringType type, base::Vector<const uint16_t> string) { if (type == NewStringType::kInternalized) { return factory->InternalizeString(string); } return factory->NewStringFromTwoByte(string); } static_assert(v8::String::kMaxLength == i::String::kMaxLength); } // anonymous namespace // TODO(dcarney): throw a context free exception. #define NEW_STRING(v8_isolate, class_name, function_name, Char, data, type, \ length) \ MaybeLocal<String> result; \ if (length == 0) { \ result = String::Empty(v8_isolate); \ } else if (length > 0 && \ static_cast<uint32_t>(length) > i::String::kMaxLength) { \ result = MaybeLocal<String>(); \ } else { \ i::Isolate* i_isolate = reinterpret_cast<internal::Isolate*>(v8_isolate); \ EnterV8NoScriptNoExceptionScope api_scope(i_isolate); \ ApiRuntimeCallStatsScope rcs_scope( \ i_isolate, RCCId::kAPI_##class_name##_##function_name); \ if (length < 0) length = StringLength(data); \ i::DirectHandle<i::String> handle_result = \ NewString(i_isolate->factory(), type, \ base::Vector<const Char>(data, length)) \ .ToHandleChecked(); \ result = Utils::ToLocal(handle_result); \ } Local<String> String::NewFromUtf8Literal(Isolate* v8_isolate, const char* literal, NewStringType type, int length) { DCHECK_LE(length, i::String::kMaxLength); i::Isolate* i_isolate = reinterpret_cast<internal::Isolate*>(v8_isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_String_NewFromUtf8Literal); i::DirectHandle<i::String> handle_result = NewString(i_isolate->factory(), type, base::Vector<const char>(literal, length)) .ToHandleChecked(); return Utils::ToLocal(handle_result); } MaybeLocal<String> String::NewFromUtf8(Isolate* v8_isolate, const char* data, NewStringType type, int length) { NEW_STRING(v8_isolate, String, NewFromUtf8, char, data, type, length); return result; } MaybeLocal<String> String::NewFromOneByte(Isolate* v8_isolate, const uint8_t* data, NewStringType type, int length) { NEW_STRING(v8_isolate, String, NewFromOneByte, uint8_t, data, type, length); return result; } MaybeLocal<String> String::NewFromTwoByte(Isolate* v8_isolate, const uint16_t* data, NewStringType type, int length) { NEW_STRING(v8_isolate, String, NewFromTwoByte, uint16_t, data, type, length); return result; } Local<String> v8::String::Concat(Isolate* v8_isolate, Local<String> left, Local<String> right) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); auto left_string = Utils::OpenHandle(*left); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_String_Concat); auto right_string = Utils::OpenHandle(*right); // If we are steering towards a range error, do not wait for the error to be // thrown, and return the null handle instead. if (left_string->length() + right_string->length() > i::String::kMaxLength) { return {}; } i::DirectHandle<i::String> result = i_isolate->factory() ->NewConsString(left_string, right_string) .ToHandleChecked(); return Utils::ToLocal(result); } MaybeLocal<String> v8::String::NewExternalTwoByte( Isolate* v8_isolate, v8::String::ExternalStringResource* resource) { CHECK(resource && resource->data()); // TODO(dcarney): throw a context free exception. if (resource->length() > static_cast<size_t>(i::String::kMaxLength)) { return {}; } i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_String_NewExternalTwoByte); if (resource->length() > 0) { i::DirectHandle<i::String> string = i_isolate->factory() ->NewExternalStringFromTwoByte(resource) .ToHandleChecked(); return Utils::ToLocal(string); } else { // The resource isn't going to be used, free it immediately. resource->Unaccount(v8_isolate); resource->Dispose(); return Utils::ToLocal(i_isolate->factory()->empty_string()); } } MaybeLocal<String> v8::String::NewExternalOneByte( Isolate* v8_isolate, v8::String::ExternalOneByteStringResource* resource) { CHECK_NOT_NULL(resource); // TODO(dcarney): throw a context free exception. if (resource->length() > static_cast<size_t>(i::String::kMaxLength)) { return {}; } i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_String_NewExternalOneByte); if (resource->length() == 0) { // The resource isn't going to be used, free it immediately. resource->Unaccount(v8_isolate); resource->Dispose(); return Utils::ToLocal(i_isolate->factory()->empty_string()); } CHECK_NOT_NULL(resource->data()); i::DirectHandle<i::String> string = i_isolate->factory() ->NewExternalStringFromOneByte(resource) .ToHandleChecked(); return Utils::ToLocal(string); } bool v8::String::MakeExternal(v8::String::ExternalStringResource* resource) { v8::Isolate* isolate = v8::Isolate::GetCurrent(); return MakeExternal(isolate, resource); } bool v8::String::MakeExternal(Isolate* isolate, v8::String::ExternalStringResource* resource) { i::DisallowGarbageCollection no_gc; i::Tagged<i::String> obj = *Utils::OpenDirectHandle(this); if (i::IsThinString(obj)) { obj = i::Cast<i::ThinString>(obj)->actual(); } if (!obj->SupportsExternalization(Encoding::TWO_BYTE_ENCODING)) { return false; } i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); CHECK(resource && resource->data()); bool result = obj->MakeExternal(i_isolate, resource); DCHECK_IMPLIES(result, HasExternalStringResource(obj)); return result; } bool v8::String::MakeExternal( v8::String::ExternalOneByteStringResource* resource) { v8::Isolate* isolate = v8::Isolate::GetCurrent(); return MakeExternal(isolate, resource); } bool v8::String::MakeExternal( Isolate* isolate, v8::String::ExternalOneByteStringResource* resource) { i::DisallowGarbageCollection no_gc; i::Tagged<i::String> obj = *Utils::OpenDirectHandle(this); if (i::IsThinString(obj)) { obj = i::Cast<i::ThinString>(obj)->actual(); } if (!obj->SupportsExternalization(Encoding::ONE_BYTE_ENCODING)) { return false; } i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); CHECK(resource && resource->data()); bool result = obj->MakeExternal(i_isolate, resource); DCHECK_IMPLIES(result, HasExternalStringResource(obj)); return result; } bool v8::String::CanMakeExternal(Encoding encoding) const { i::Tagged<i::String> obj = *Utils::OpenDirectHandle(this); return obj->SupportsExternalization(encoding); } bool v8::String::StringEquals(Local<String> that) const { auto self = Utils::OpenDirectHandle(this); auto other = Utils::OpenDirectHandle(*that); return self->Equals(*other); } Local<v8::Object> v8::Object::New(Isolate* v8_isolate) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Object_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::JSObject> obj = i_isolate->factory()->NewJSObject(i_isolate->object_function()); return Utils::ToLocal(obj); } namespace { // TODO(v8:7569): This is a workaround for the Handle vs MaybeHandle difference // in the return types of the different Add functions: // OrderedNameDictionary::Add returns MaybeHandle, NameDictionary::Add returns // Handle. template <typename T> i::DirectHandle<T> ToHandle(i::Handle<T> h) { return h; } template <typename T> i::DirectHandle<T> ToHandle(i::MaybeHandle<T> h) { return h.ToHandleChecked(); } template <typename T> i::DirectHandle<T> ToHandle(i::DirectHandle<T> h) { return h; } template <typename T> i::DirectHandle<T> ToHandle(i::MaybeDirectHandle<T> h) { return h.ToHandleChecked(); } template <typename Dictionary> void AddPropertiesAndElementsToObject( i::Isolate* i_isolate, i::DirectHandle<Dictionary>& properties, i::DirectHandle<i::FixedArrayBase>& elements, Local<Name>* names, Local<Value>* values, size_t length) { for (size_t i = 0; i < length; ++i) { auto name = Utils::OpenDirectHandle(*names[i]); auto value = Utils::OpenDirectHandle(*values[i]); // See if the {name} is a valid array index, in which case we need to // add the {name}/{value} pair to the {elements}, otherwise they end // up in the {properties} backing store. uint32_t index; if (name->AsArrayIndex(&index)) { // If this is the first element, allocate a proper // dictionary elements backing store for {elements}. if (!IsNumberDictionary(*elements)) { elements = i::NumberDictionary::New(i_isolate, static_cast<uint32_t>(length)); } elements = i::NumberDictionary::Set( i_isolate, i::Cast<i::NumberDictionary>(elements), index, value); } else { // Internalize the {name} first. name = i_isolate->factory()->InternalizeName(name); i::InternalIndex const entry = properties->FindEntry(i_isolate, name); if (entry.is_not_found()) { // Add the {name}/{value} pair as a new entry. properties = ToHandle(Dictionary::Add( i_isolate, properties, name, value, i::PropertyDetails::Empty())); } else { // Overwrite the {entry} with the {value}. properties->ValueAtPut(entry, *value); } } } } } // namespace Local<v8::Object> v8::Object::New(Isolate* v8_isolate, Local<Value> prototype_or_null, Local<Name>* names, Local<Value>* values, size_t length) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i::DirectHandle<i::JSPrototype> proto; if (!Utils::ApiCheck( i::TryCast(Utils::OpenDirectHandle(*prototype_or_null), &proto), "v8::Object::New", "prototype must be null or object")) { return {}; } ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Object_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::FixedArrayBase> elements = i_isolate->factory()->empty_fixed_array(); // We assume that this API is mostly used to create objects with named // properties, and so we default to creating a properties backing store // large enough to hold all of them, while we start with no elements // (see http://bit.ly/v8-fast-object-create-cpp for the motivation). if (V8_ENABLE_SWISS_NAME_DICTIONARY_BOOL) { i::DirectHandle<i::SwissNameDictionary> properties = i_isolate->factory()->NewSwissNameDictionary(static_cast<int>(length)); AddPropertiesAndElementsToObject(i_isolate, properties, elements, names, values, length); i::DirectHandle<i::JSObject> obj = i_isolate->factory()->NewSlowJSObjectWithPropertiesAndElements( proto, properties, elements); return Utils::ToLocal(obj); } else { i::DirectHandle<i::NameDictionary> properties = i::NameDictionary::New(i_isolate, static_cast<int>(length)); AddPropertiesAndElementsToObject(i_isolate, properties, elements, names, values, length); i::DirectHandle<i::JSObject> obj = i_isolate->factory()->NewSlowJSObjectWithPropertiesAndElements( proto, properties, elements); return Utils::ToLocal(obj); } } Local<v8::Value> v8::NumberObject::New(Isolate* v8_isolate, double value) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_NumberObject_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::Object> number = i_isolate->factory()->NewNumber(value); i::DirectHandle<i::Object> obj = i::Object::ToObject(i_isolate, number).ToHandleChecked(); return Utils::ToLocal(obj); } double v8::NumberObject::ValueOf() const { auto obj = Utils::OpenDirectHandle(this); auto js_primitive_wrapper = i::Cast<i::JSPrimitiveWrapper>(obj); ApiRuntimeCallStatsScope rcs_scope(i::Isolate::Current(), RCCId::kAPI_NumberObject_NumberValue); return i::Object::NumberValue( i::Cast<i::Number>(js_primitive_wrapper->value())); } Local<v8::Value> v8::BigIntObject::New(Isolate* v8_isolate, int64_t value) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_BigIntObject_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::Object> bigint = i::BigInt::FromInt64(i_isolate, value); i::DirectHandle<i::Object> obj = i::Object::ToObject(i_isolate, bigint).ToHandleChecked(); return Utils::ToLocal(obj); } Local<v8::BigInt> v8::BigIntObject::ValueOf() const { auto obj = Utils::OpenDirectHandle(this); auto js_primitive_wrapper = i::Cast<i::JSPrimitiveWrapper>(obj); i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_BigIntObject_BigIntValue); return Utils::ToLocal(i::direct_handle( i::Cast<i::BigInt>(js_primitive_wrapper->value()), i_isolate)); } Local<v8::Value> v8::BooleanObject::New(Isolate* v8_isolate, bool value) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_BooleanObject_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::Object> boolean = i_isolate->factory()->ToBoolean(value); i::DirectHandle<i::Object> obj = i::Object::ToObject(i_isolate, boolean).ToHandleChecked(); return Utils::ToLocal(obj); } bool v8::BooleanObject::ValueOf() const { i::Tagged<i::Object> obj = *Utils::OpenDirectHandle(this); i::Tagged<i::JSPrimitiveWrapper> js_primitive_wrapper = i::Cast<i::JSPrimitiveWrapper>(obj); i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_BooleanObject_BooleanValue); return i::IsTrue(js_primitive_wrapper->value(), i_isolate); } Local<v8::Value> v8::StringObject::New(Isolate* v8_isolate, Local<String> value) { auto string = Utils::OpenDirectHandle(*value); i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_StringObject_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::Object> obj = i::Object::ToObject(i_isolate, string).ToHandleChecked(); return Utils::ToLocal(obj); } Local<v8::String> v8::StringObject::ValueOf() const { auto obj = Utils::OpenDirectHandle(this); auto js_primitive_wrapper = i::Cast<i::JSPrimitiveWrapper>(obj); i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_StringObject_StringValue); return Utils::ToLocal(i::direct_handle( i::Cast<i::String>(js_primitive_wrapper->value()), i_isolate)); } Local<v8::Value> v8::SymbolObject::New(Isolate* v8_isolate, Local<Symbol> value) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_SymbolObject_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::Object> obj = i::Object::ToObject(i_isolate, Utils::OpenDirectHandle(*value)) .ToHandleChecked(); return Utils::ToLocal(obj); } Local<v8::Symbol> v8::SymbolObject::ValueOf() const { auto obj = Utils::OpenDirectHandle(this); auto js_primitive_wrapper = i::Cast<i::JSPrimitiveWrapper>(obj); i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_SymbolObject_SymbolValue); return Utils::ToLocal(i::direct_handle( i::Cast<i::Symbol>(js_primitive_wrapper->value()), i_isolate)); } MaybeLocal<v8::Value> v8::Date::New(Local<Context> context, double time) { if (std::isnan(time)) { // Introduce only canonical NaN value into the VM, to avoid signaling NaNs. time = std::numeric_limits<double>::quiet_NaN(); } PrepareForExecutionScope api_scope{context, RCCId::kAPI_Date_New}; i::Isolate* i_isolate = api_scope.i_isolate(); return api_scope.EscapeMaybe( Utils::ToMaybeLocal(i::JSDate::New(i_isolate, i_isolate->date_function(), i_isolate->date_function(), time))); } MaybeLocal<Value> v8::Date::Parse(Local<Context> context, Local<String> value) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_Date_Parse}; i::Isolate* i_isolate = api_scope.i_isolate(); auto string = Utils::OpenDirectHandle(*value); double time = ParseDateTimeString(i_isolate, string); return api_scope.EscapeMaybe( Utils::ToMaybeLocal(i::JSDate::New(i_isolate, i_isolate->date_function(), i_isolate->date_function(), time))); } double v8::Date::ValueOf() const { auto obj = Utils::OpenDirectHandle(this); auto jsdate = i::Cast<i::JSDate>(obj); return jsdate->value(); } v8::Local<v8::String> v8::Date::ToISOString() const { auto obj = Utils::OpenDirectHandle(this); auto jsdate = i::Cast<i::JSDate>(obj); i::Isolate* i_isolate = i::Isolate::Current(); i::DateBuffer buffer = i::ToDateString(jsdate->value(), i_isolate->date_cache(), i::ToDateStringMode::kISODateAndTime); i::DirectHandle<i::String> str = i_isolate->factory() ->NewStringFromUtf8(base::VectorOf(buffer)) .ToHandleChecked(); return Utils::ToLocal(str); } v8::Local<v8::String> v8::Date::ToUTCString() const { auto obj = Utils::OpenDirectHandle(this); auto jsdate = i::Cast<i::JSDate>(obj); i::Isolate* i_isolate = i::Isolate::Current(); i::DateBuffer buffer = i::ToDateString(jsdate->value(), i_isolate->date_cache(), i::ToDateStringMode::kUTCDateAndTime); i::DirectHandle<i::String> str = i_isolate->factory() ->NewStringFromUtf8(base::VectorOf(buffer)) .ToHandleChecked(); return Utils::ToLocal(str); } // Assert that the static TimeZoneDetection cast in // DateTimeConfigurationChangeNotification is valid. #define TIME_ZONE_DETECTION_ASSERT_EQ(value) \ static_assert( \ static_cast<int>(v8::Isolate::TimeZoneDetection::value) == \ static_cast<int>(base::TimezoneCache::TimeZoneDetection::value)); TIME_ZONE_DETECTION_ASSERT_EQ(kSkip) TIME_ZONE_DETECTION_ASSERT_EQ(kRedetect) #undef TIME_ZONE_DETECTION_ASSERT_EQ MaybeLocal<v8::RegExp> v8::RegExp::New(Local<Context> context, Local<String> pattern, Flags flags) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_RegExp_New}; i::Isolate* i_isolate = api_scope.i_isolate(); return api_scope.EscapeMaybe( i::JSRegExp::New(i_isolate, Utils::OpenDirectHandle(*pattern), static_cast<i::JSRegExp::Flags>(flags))); } MaybeLocal<v8::RegExp> v8::RegExp::NewWithBacktrackLimit( Local<Context> context, Local<String> pattern, Flags flags, uint32_t backtrack_limit) { Utils::ApiCheck(i::Smi::IsValid(backtrack_limit), "v8::RegExp::NewWithBacktrackLimit", "backtrack_limit is too large or too small"); Utils::ApiCheck(backtrack_limit != i::JSRegExp::kNoBacktrackLimit, "v8::RegExp::NewWithBacktrackLimit", "Must set backtrack_limit"); PrepareForExecutionScope api_scope{context, RCCId::kAPI_RegExp_New}; i::Isolate* i_isolate = api_scope.i_isolate(); return api_scope.EscapeMaybe(i::JSRegExp::New( i_isolate, Utils::OpenDirectHandle(*pattern), static_cast<i::JSRegExp::Flags>(flags), backtrack_limit)); } Local<v8::String> v8::RegExp::GetSource() const { auto obj = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); return Utils::ToLocal(i::direct_handle(obj->EscapedPattern(), i_isolate)); } // Assert that the static flags cast in GetFlags is valid. #define REGEXP_FLAG_ASSERT_EQ(flag) \ static_assert(static_cast<int>(v8::RegExp::flag) == \ static_cast<int>(i::JSRegExp::flag)) REGEXP_FLAG_ASSERT_EQ(kNone); REGEXP_FLAG_ASSERT_EQ(kGlobal); REGEXP_FLAG_ASSERT_EQ(kIgnoreCase); REGEXP_FLAG_ASSERT_EQ(kMultiline); REGEXP_FLAG_ASSERT_EQ(kSticky); REGEXP_FLAG_ASSERT_EQ(kUnicode); REGEXP_FLAG_ASSERT_EQ(kHasIndices); REGEXP_FLAG_ASSERT_EQ(kLinear); REGEXP_FLAG_ASSERT_EQ(kUnicodeSets); #undef REGEXP_FLAG_ASSERT_EQ v8::RegExp::Flags v8::RegExp::GetFlags() const { auto obj = Utils::OpenDirectHandle(this); return RegExp::Flags(static_cast<int>(obj->flags())); } MaybeLocal<v8::Object> v8::RegExp::Exec(Local<Context> context, Local<v8::String> subject) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_RegExp_Exec}; i::Isolate* i_isolate = api_scope.i_isolate(); auto regexp = Utils::OpenHandle(this); auto subject_string = Utils::OpenDirectHandle(*subject); // TODO(jgruber): RegExpUtils::RegExpExec was not written with efficiency in // mind. It fetches the 'exec' property and then calls it through JSEntry. // Unfortunately, this is currently the only full implementation of // RegExp.prototype.exec available in C++. i::DirectHandle<i::JSAny> result; if (!i::RegExpUtils::RegExpExec(i_isolate, regexp, subject_string, i_isolate->factory()->undefined_value()) .ToHandle(&result)) { return {}; } // RegExp::Exec is documented to return Null on failure, but the return type // is `MaybeLocal<Object>` which cannot legally hold `Null`, thus the unsafe // `Utils::Convert<Object>`. // TODO(jgruber): Fix this. return api_scope.Escape(Utils::Convert<i::JSAny, Object>(result)); } Local<v8::Array> v8::Array::New(Isolate* v8_isolate, int length) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Array_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); int real_length = length > 0 ? length : 0; i::DirectHandle<i::JSArray> obj = i_isolate->factory()->NewJSArray(real_length); i::DirectHandle<i::Number> length_obj = i_isolate->factory()->NewNumberFromInt(real_length); obj->set_length(*length_obj); return Utils::ToLocal(obj); } Local<v8::Array> v8::Array::New(Isolate* v8_isolate, Local<Value>* elements, size_t length) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i::Factory* factory = i_isolate->factory(); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Array_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); int len = static_cast<int>(length); i::DirectHandle<i::FixedArray> result = factory->NewFixedArray(len); for (int i = 0; i < len; i++) { auto element = Utils::OpenDirectHandle(*elements[i]); result->set(i, *element); } return Utils::ToLocal( factory->NewJSArrayWithElements(result, i::PACKED_ELEMENTS, len)); } // static MaybeLocal<v8::Array> v8::Array::New( Local<Context> context, size_t length, std::function<MaybeLocal<v8::Value>()> next_value_callback) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_Array_New}; i::Isolate* i_isolate = api_scope.i_isolate(); i::Factory* factory = i_isolate->factory(); const int len = static_cast<int>(length); i::DirectHandle<i::FixedArray> backing = factory->NewFixedArray(len); v8::Local<v8::Value> value; for (int i = 0; i < len; i++) { MaybeLocal<v8::Value> maybe_value = next_value_callback(); // The embedder may signal to abort creation on exception via an empty // local. if (!maybe_value.ToLocal(&value)) { CHECK(i_isolate->has_exception()); return {}; } backing->set(i, *Utils::OpenDirectHandle(*value)); } return api_scope.Escape(Utils::ToLocal( factory->NewJSArrayWithElements(backing, i::PACKED_ELEMENTS, len))); } namespace internal { uint32_t GetLength(Tagged<JSArray> array) { Tagged<Number> length = array->length(); if (IsSmi(length)) return Smi::ToInt(length); return static_cast<uint32_t>(Object::NumberValue(length)); } } // namespace internal uint32_t v8::Array::Length() const { return i::GetLength(*Utils::OpenDirectHandle(this)); } namespace internal { bool CanUseFastIteration(Isolate* isolate, DirectHandle<JSArray> array) { if (IsCustomElementsReceiverMap(array->map())) return false; if (array->GetElementsAccessor()->HasAccessors(*array)) return false; if (!JSObject::PrototypeHasNoElements(isolate, *array)) return false; return true; } enum class FastIterateResult { kException = static_cast<int>(v8::Array::CallbackResult::kException), kBreak = static_cast<int>(v8::Array::CallbackResult::kBreak), kSlowPath, kFinished, }; FastIterateResult FastIterateArray(DirectHandle<JSArray> array, Isolate* isolate, v8::Array::IterationCallback callback, void* callback_data) { // Instead of relying on callers to check condition, this function returns // {kSlowPath} for situations it can't handle. // Most code paths below don't allocate, and rely on {callback} not allocating // either, but this isn't enforced with {DisallowHeapAllocation} to allow // embedders to allocate error objects before terminating the iteration. // Since {callback} must not allocate anyway, we can get away with fake // handles, reducing per-element overhead. if (!CanUseFastIteration(isolate, array)) return FastIterateResult::kSlowPath; using Result = v8::Array::CallbackResult; DisallowJavascriptExecution no_js(isolate); uint32_t length = GetLength(*array); if (length == 0) return FastIterateResult::kFinished; switch (array->GetElementsKind()) { case PACKED_SMI_ELEMENTS: case PACKED_ELEMENTS: case PACKED_FROZEN_ELEMENTS: case PACKED_SEALED_ELEMENTS: case PACKED_NONEXTENSIBLE_ELEMENTS: { Tagged<FixedArray> elements = Cast<FixedArray>(array->elements()); for (uint32_t i = 0; i < length; i++) { Tagged<Object> element = elements->get(static_cast<int>(i)); // TODO(13270): When we switch to CSS, we can pass {element} to // the callback directly, without {fake_handle}. IndirectHandle<Object> fake_handle( reinterpret_cast<Address*>(&element)); Result result = callback(i, Utils::ToLocal(fake_handle), callback_data); if (result != Result::kContinue) { return static_cast<FastIterateResult>(result); } DCHECK(CanUseFastIteration(isolate, array)); } return FastIterateResult::kFinished; } case HOLEY_SMI_ELEMENTS: case HOLEY_FROZEN_ELEMENTS: case HOLEY_SEALED_ELEMENTS: case HOLEY_NONEXTENSIBLE_ELEMENTS: case HOLEY_ELEMENTS: { Tagged<FixedArray> elements = Cast<FixedArray>(array->elements()); for (uint32_t i = 0; i < length; i++) { Tagged<Object> element = elements->get(static_cast<int>(i)); // TODO(13270): When we switch to CSS, we can pass {element} to // the callback directly, without {fake_handle}. auto fake_handle = IsTheHole(element) ? isolate->factory()->undefined_value() : IndirectHandle<Object>(reinterpret_cast<Address*>(&element)); Result result = callback(i, Utils::ToLocal(fake_handle), callback_data); if (result != Result::kContinue) { return static_cast<FastIterateResult>(result); } DCHECK(CanUseFastIteration(isolate, array)); } return FastIterateResult::kFinished; } case HOLEY_DOUBLE_ELEMENTS: case PACKED_DOUBLE_ELEMENTS: { DCHECK_NE(length, 0); // Cast to FixedDoubleArray would be invalid. DirectHandle<FixedDoubleArray> elements( Cast<FixedDoubleArray>(array->elements()), isolate); FOR_WITH_HANDLE_SCOPE(isolate, uint32_t i = 0, i, i < length, i++) { DirectHandle<Object> value; if (elements->is_the_hole(i)) { value = Handle<Object>(isolate->factory()->undefined_value()); #ifdef V8_ENABLE_UNDEFINED_DOUBLE } else if (elements->is_undefined(i)) { value = Handle<Object>(isolate->factory()->undefined_value()); #endif // V8_ENABLE_UNDEFINED_DOUBLE } else { value = isolate->factory()->NewNumber(elements->get_scalar(i)); } Result result = callback(i, Utils::ToLocal(value), callback_data); if (result != Result::kContinue) { return static_cast<FastIterateResult>(result); } DCHECK(CanUseFastIteration(isolate, array)); } return FastIterateResult::kFinished; } case DICTIONARY_ELEMENTS: { DisallowGarbageCollection no_gc; Tagged<NumberDictionary> dict = array->element_dictionary(); struct Entry { uint32_t index; InternalIndex entry; }; std::vector<Entry> sorted; sorted.reserve(dict->NumberOfElements()); ReadOnlyRoots roots(isolate); for (InternalIndex i : dict->IterateEntries()) { Tagged<Object> key = dict->KeyAt(isolate, i); if (!dict->IsKey(roots, key)) continue; uint32_t index = static_cast<uint32_t>(Object::NumberValue(Cast<Number>(key))); sorted.push_back({index, i}); } std::sort( sorted.begin(), sorted.end(), [](const Entry& a, const Entry& b) { return a.index < b.index; }); for (const Entry& entry : sorted) { Tagged<Object> value = dict->ValueAt(entry.entry); // TODO(13270): When we switch to CSS, we can pass {element} to // the callback directly, without {fake_handle}. IndirectHandle<Object> fake_handle(reinterpret_cast<Address*>(&value)); Result result = callback(entry.index, Utils::ToLocal(fake_handle), callback_data); if (result != Result::kContinue) { return static_cast<FastIterateResult>(result); } SLOW_DCHECK(CanUseFastIteration(isolate, array)); } return FastIterateResult::kFinished; } case NO_ELEMENTS: return FastIterateResult::kFinished; case FAST_SLOPPY_ARGUMENTS_ELEMENTS: case SLOW_SLOPPY_ARGUMENTS_ELEMENTS: // Probably not worth implementing. Take the slow path. return FastIterateResult::kSlowPath; case WASM_ARRAY_ELEMENTS: case FAST_STRING_WRAPPER_ELEMENTS: case SLOW_STRING_WRAPPER_ELEMENTS: case SHARED_ARRAY_ELEMENTS: #define TYPED_ARRAY_CASE(Type, type, TYPE, ctype) case TYPE##_ELEMENTS: TYPED_ARRAYS(TYPED_ARRAY_CASE) RAB_GSAB_TYPED_ARRAYS(TYPED_ARRAY_CASE) #undef TYPED_ARRAY_CASE // These are never used by v8::Array instances. UNREACHABLE(); } // The input value of the switch is untrusted, so even if it's exhaustive, it // can skip all cases and end up here, triggering UB since there's no return. UNREACHABLE(); } } // namespace internal Maybe<void> v8::Array::Iterate(Local<Context> context, v8::Array::IterationCallback callback, void* callback_data) { auto array = Utils::OpenDirectHandle(this); i::Isolate* isolate = i::Isolate::Current(); i::FastIterateResult fast_result = i::FastIterateArray(array, isolate, callback, callback_data); if (fast_result == i::FastIterateResult::kException) return {}; // Early breaks and completed iteration both return successfully. if (fast_result != i::FastIterateResult::kSlowPath) return JustVoid(); // Slow path: retrieving elements could have side effects. EnterV8Scope<> api_scope{isolate, context, RCCId::kAPI_Array_Iterate}; for (uint32_t i = 0; i < i::GetLength(*array); ++i) { i::DirectHandle<i::Object> element; if (!i::JSReceiver::GetElement(isolate, array, i).ToHandle(&element)) { return {}; } using Result = v8::Array::CallbackResult; Result result = callback(i, Utils::ToLocal(element), callback_data); if (result == Result::kException) return {}; if (result == Result::kBreak) return JustVoid(); } return JustVoid(); } v8::TypecheckWitness::TypecheckWitness(Isolate* isolate) #ifdef V8_ENABLE_DIRECT_HANDLE // An empty local suffices. : cached_map_() #else // We need to reserve a handle that we can patch later. // We initialize it with something that cannot compare equal to any map. : cached_map_(v8::Number::New(isolate, 1)) #endif { } void v8::TypecheckWitness::Update(Local<Value> baseline) { i::Tagged<i::Object> obj = *Utils::OpenDirectHandle(*baseline); #ifdef V8_ENABLE_DIRECT_HANDLE if (IsSmi(obj)) { cached_map_ = Local<Data>(); } else { i::Tagged<i::HeapObject> map = i::Cast<i::HeapObject>(obj)->map(); cached_map_ = Local<Data>::FromAddress(map->ptr()); } #else i::Tagged<i::Object> map = i::Smi::zero(); if (!IsSmi(obj)) map = i::Cast<i::HeapObject>(obj)->map(); // Design overview: in the {TypecheckWitness} constructor, we create // a single handle for the witness value. Whenever {Update} is called, we // make this handle point at the fresh baseline/witness; the intention is // to allow having short-lived HandleScopes (e.g. in {FastIterateArray} // above) while a {TypecheckWitness} is alive: it therefore cannot hold // on to one of the short-lived handles. // Calling {OpenIndirectHandle} on the {cached_map_} only serves to // "reinterpret_cast" it to an {i::IndirectHandle} on which we can call // {PatchValue}. auto cache = Utils::OpenIndirectHandle(*cached_map_); cache.PatchValue(map); #endif } Local<v8::Map> v8::Map::New(Isolate* v8_isolate) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Map_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::JSMap> obj = i_isolate->factory()->NewJSMap(); return Utils::ToLocal(obj); } size_t v8::Map::Size() const { auto obj = Utils::OpenDirectHandle(this); return i::Cast<i::OrderedHashMap>(obj->table())->NumberOfElements(); } void Map::Clear() { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Map_Clear); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::JSMap::Clear(i_isolate, self); } MaybeLocal<Value> Map::Get(Local<Context> context, Local<Value> key) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_Map_Get}; i::Isolate* i_isolate = api_scope.i_isolate(); auto self = Utils::OpenDirectHandle(this); i::DirectHandle<i::Object> args[] = {Utils::OpenDirectHandle(*key)}; return api_scope.EscapeMaybe(i::Execution::CallBuiltin( i_isolate, i_isolate->map_get(), self, base::VectorOf(args))); } MaybeLocal<Map> Map::Set(Local<Context> context, Local<Value> key, Local<Value> value) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_Map_Set}; i::Isolate* i_isolate = api_scope.i_isolate(); auto self = Utils::OpenDirectHandle(this); i::DirectHandle<i::Object> args[] = {Utils::OpenDirectHandle(*key), Utils::OpenDirectHandle(*value)}; return api_scope.EscapeMaybe(i::Cast<i::JSMap>(i::Execution::CallBuiltin( i_isolate, i_isolate->map_set(), self, base::VectorOf(args)))); } Maybe<bool> Map::Has(Local<Context> context, Local<Value> key) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Map_Has}; auto self = Utils::OpenDirectHandle(this); i::DirectHandle<i::Object> result; i::DirectHandle<i::Object> args[] = {Utils::OpenDirectHandle(*key)}; if (!i::Execution::CallBuiltin(i_isolate, i_isolate->map_has(), self, base::VectorOf(args)) .ToHandle(&result)) { return {}; } return Just(i::IsTrue(*result, i_isolate)); } Maybe<bool> Map::Delete(Local<Context> context, Local<Value> key) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Map_Delete}; auto self = Utils::OpenDirectHandle(this); i::DirectHandle<i::Object> result; i::DirectHandle<i::Object> args[] = {Utils::OpenDirectHandle(*key)}; if (!i::Execution::CallBuiltin(i_isolate, i_isolate->map_delete(), self, base::VectorOf(args)) .ToHandle(&result)) { return {}; } return Just(i::IsTrue(*result, i_isolate)); } namespace { enum class MapAsArrayKind { kEntries = i::JS_MAP_KEY_VALUE_ITERATOR_TYPE, kKeys = i::JS_MAP_KEY_ITERATOR_TYPE, kValues = i::JS_MAP_VALUE_ITERATOR_TYPE }; enum class SetAsArrayKind { kEntries = i::JS_SET_KEY_VALUE_ITERATOR_TYPE, kValues = i::JS_SET_VALUE_ITERATOR_TYPE }; i::DirectHandle<i::JSArray> MapAsArray(i::Isolate* i_isolate, i::Tagged<i::Object> table_obj, int offset, MapAsArrayKind kind) { i::Factory* factory = i_isolate->factory(); i::DirectHandle<i::OrderedHashMap> table( i::Cast<i::OrderedHashMap>(table_obj), i_isolate); const bool collect_keys = kind == MapAsArrayKind::kEntries || kind == MapAsArrayKind::kKeys; const bool collect_values = kind == MapAsArrayKind::kEntries || kind == MapAsArrayKind::kValues; int capacity = table->UsedCapacity(); int max_length = (capacity - offset) * ((collect_keys && collect_values) ? 2 : 1); i::DirectHandle<i::FixedArray> result = factory->NewFixedArray(max_length); int result_index = 0; { i::DisallowGarbageCollection no_gc; i::Tagged<i::Hole> hash_table_hole = i::ReadOnlyRoots(i_isolate).hash_table_hole_value(); for (int i = offset; i < capacity; ++i) { i::InternalIndex entry(i); i::Tagged<i::Object> key = table->KeyAt(entry); if (key == hash_table_hole) continue; if (collect_keys) result->set(result_index++, key); if (collect_values) result->set(result_index++, table->ValueAt(entry)); } } DCHECK_GE(max_length, result_index); if (result_index == 0) return factory->NewJSArray(0); result->RightTrim(i_isolate, result_index); return factory->NewJSArrayWithElements(result, i::PACKED_ELEMENTS, result_index); } } // namespace Local<Array> Map::AsArray() const { auto obj = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Map_AsArray); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); return Utils::ToLocal( MapAsArray(i_isolate, obj->table(), 0, MapAsArrayKind::kEntries)); } Local<v8::Set> v8::Set::New(Isolate* v8_isolate) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Set_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::JSSet> obj = i_isolate->factory()->NewJSSet(); return Utils::ToLocal(obj); } size_t v8::Set::Size() const { auto obj = Utils::OpenDirectHandle(this); return i::Cast<i::OrderedHashSet>(obj->table())->NumberOfElements(); } void Set::Clear() { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Set_Clear); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::JSSet::Clear(i_isolate, self); } MaybeLocal<Set> Set::Add(Local<Context> context, Local<Value> key) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_Set_Add}; i::Isolate* i_isolate = api_scope.i_isolate(); auto self = Utils::OpenDirectHandle(this); i::DirectHandle<i::Object> args[] = {Utils::OpenDirectHandle(*key)}; return api_scope.EscapeMaybe(i::Cast<i::JSSet>(i::Execution::CallBuiltin( i_isolate, i_isolate->set_add(), self, base::VectorOf(args)))); } Maybe<bool> Set::Has(Local<Context> context, Local<Value> key) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Set_Has}; auto self = Utils::OpenDirectHandle(this); i::DirectHandle<i::Object> result; i::DirectHandle<i::Object> args[] = {Utils::OpenDirectHandle(*key)}; if (!i::Execution::CallBuiltin(i_isolate, i_isolate->set_has(), self, base::VectorOf(args)) .ToHandle(&result)) { return {}; } return Just(i::IsTrue(*result, i_isolate)); } Maybe<bool> Set::Delete(Local<Context> context, Local<Value> key) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Set_Delete}; auto self = Utils::OpenDirectHandle(this); i::DirectHandle<i::Object> result; i::DirectHandle<i::Object> args[] = {Utils::OpenDirectHandle(*key)}; if (!i::Execution::CallBuiltin(i_isolate, i_isolate->set_delete(), self, base::VectorOf(args)) .ToHandle(&result)) { return {}; } return Just(i::IsTrue(*result, i_isolate)); } namespace { i::DirectHandle<i::JSArray> SetAsArray(i::Isolate* i_isolate, i::Tagged<i::Object> table_obj, int offset, SetAsArrayKind kind) { i::Factory* factory = i_isolate->factory(); i::DirectHandle<i::OrderedHashSet> table( i::Cast<i::OrderedHashSet>(table_obj), i_isolate); // Elements skipped by |offset| may already be deleted. int capacity = table->UsedCapacity(); const bool collect_key_values = kind == SetAsArrayKind::kEntries; int max_length = (capacity - offset) * (collect_key_values ? 2 : 1); if (max_length == 0) return factory->NewJSArray(0); i::DirectHandle<i::FixedArray> result = factory->NewFixedArray(max_length); int result_index = 0; { i::DisallowGarbageCollection no_gc; i::Tagged<i::Hole> hash_table_hole = i::ReadOnlyRoots(i_isolate).hash_table_hole_value(); for (int i = offset; i < capacity; ++i) { i::InternalIndex entry(i); i::Tagged<i::Object> key = table->KeyAt(entry); if (key == hash_table_hole) continue; result->set(result_index++, key); if (collect_key_values) result->set(result_index++, key); } } DCHECK_GE(max_length, result_index); if (result_index == 0) return factory->NewJSArray(0); result->RightTrim(i_isolate, result_index); return factory->NewJSArrayWithElements(result, i::PACKED_ELEMENTS, result_index); } } // namespace Local<Array> Set::AsArray() const { auto obj = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Set_AsArray); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); return Utils::ToLocal( SetAsArray(i_isolate, obj->table(), 0, SetAsArrayKind::kValues)); } MaybeLocal<Promise::Resolver> Promise::Resolver::New(Local<Context> context) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_Promise_Resolver_New}; i::Isolate* i_isolate = api_scope.i_isolate(); Local<Promise::Resolver> result = Utils::ToLocal(i::Cast<i::JSObject>(i_isolate->factory()->NewJSPromise())) .As<Promise::Resolver>(); // Also check if promise hooks set an exception. // TODO(clemensb): Should `Factory::NewJSPromise()` return a MaybeHandle // instead? if (i_isolate->has_exception()) return {}; return api_scope.Escape(result); } Local<Promise> Promise::Resolver::GetPromise() { auto promise = Utils::OpenDirectHandle(this); return Local<Promise>::Cast(Utils::ToLocal(promise)); } Maybe<bool> Promise::Resolver::Resolve(Local<Context> context, Local<Value> value) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Promise_Resolver_Resolve}; auto self = Utils::OpenDirectHandle(this); auto promise = i::Cast<i::JSPromise>(self); if (promise->status() != Promise::kPending) { return Just(true); } // TODO(434637746): Drop this CHECK when the bug is fixed. CHECK(!value.IsEmpty()); if (i::JSPromise::Resolve(promise, Utils::OpenDirectHandle(*value)) .is_null()) { return {}; } return Just(true); } Maybe<bool> Promise::Resolver::Reject(Local<Context> context, Local<Value> value) { auto i_isolate = i::Isolate::Current(); EnterV8Scope<> api_scope{i_isolate, context, RCCId::kAPI_Promise_Resolver_Reject}; auto self = Utils::OpenDirectHandle(this); auto promise = i::Cast<i::JSPromise>(self); if (promise->status() != Promise::kPending) { return Just(true); } if (i::JSPromise::Reject(promise, Utils::OpenDirectHandle(*value)) .is_null()) { return {}; } return Just(true); } MaybeLocal<Promise> Promise::Catch(Local<Context> context, Local<Function> handler) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_Promise_Catch}; i::Isolate* i_isolate = api_scope.i_isolate(); auto self = Utils::OpenDirectHandle(this); i::Handle<i::JSPromise> return_promise = i_isolate->factory()->NewJSPromise(); i::DirectHandle<i::Object> args[] = {i_isolate->factory()->undefined_value(), Utils::OpenDirectHandle(*handler), return_promise}; // Do not call the built-in Promise.prototype.catch! // v8::Promise should not call out to a monkeypatched Promise.prototype.then // as the implementation of Promise.prototype.catch does. auto result = Utils::ToMaybeLocal( i::Execution::CallBuiltin(i_isolate, i_isolate->perform_promise_then(), self, base::VectorOf(args))); if (result.IsEmpty()) return {}; return api_scope.Escape(Utils::ToLocal(return_promise)); } MaybeLocal<Promise> Promise::Then(Local<Context> context, Local<Function> handler) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_Promise_Then}; i::Isolate* i_isolate = api_scope.i_isolate(); auto self = Utils::OpenDirectHandle(this); i::Handle<i::JSPromise> return_promise = i_isolate->factory()->NewJSPromise(); i::DirectHandle<i::Object> args[] = {Utils::OpenDirectHandle(*handler), i_isolate->factory()->undefined_value(), return_promise}; // Do not call the built-in Promise.prototype.then! // v8::Promise should not trigger species lookup on a monkeypatched Promise // as the implementation of Promise.prototype.then does. auto result = Utils::ToMaybeLocal( i::Execution::CallBuiltin(i_isolate, i_isolate->perform_promise_then(), self, base::VectorOf(args))); if (result.IsEmpty()) return {}; return api_scope.Escape(Utils::ToLocal(return_promise)); } MaybeLocal<Promise> Promise::Then(Local<Context> context, Local<Function> on_fulfilled, Local<Function> on_rejected) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_Promise_Then}; i::Isolate* i_isolate = api_scope.i_isolate(); auto self = Utils::OpenDirectHandle(this); i::Handle<i::JSPromise> return_promise = i_isolate->factory()->NewJSPromise(); i::DirectHandle<i::Object> args[] = {Utils::OpenDirectHandle(*on_fulfilled), Utils::OpenDirectHandle(*on_rejected), return_promise}; // Do not call the built-in Promise.prototype.then! // v8::Promise should not trigger species lookup on a monkeypatched Promise // as the implementation of Promise.prototype.then does. auto result = Utils::ToMaybeLocal( i::Execution::CallBuiltin(i_isolate, i_isolate->perform_promise_then(), self, base::VectorOf(args))); if (result.IsEmpty()) return {}; return api_scope.Escape(Utils::ToLocal(return_promise)); } bool Promise::HasHandler() const { i::Tagged<i::JSReceiver> promise = *Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Promise_HasRejectHandler); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); if (!IsJSPromise(promise)) return false; return i::Cast<i::JSPromise>(promise)->has_handler(); } Local<Value> Promise::Result() { auto promise = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Promise_Result); auto js_promise = i::Cast<i::JSPromise>(promise); Utils::ApiCheck(js_promise->status() != kPending, "v8_Promise_Result", "Promise is still pending"); return Utils::ToLocal(i::direct_handle(js_promise->result(), i_isolate)); } Promise::PromiseState Promise::State() { auto promise = Utils::OpenDirectHandle(this); ApiRuntimeCallStatsScope rcs_scope(i::Isolate::Current(), RCCId::kAPI_Promise_Status); auto js_promise = i::Cast<i::JSPromise>(promise); return static_cast<PromiseState>(js_promise->status()); } void Promise::MarkAsHandled() { Utils::OpenDirectHandle(this)->set_has_handler(true); } void Promise::MarkAsSilent() { Utils::OpenDirectHandle(this)->set_is_silent(true); } Local<Value> Proxy::GetTarget() { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); return Utils::ToLocal(i::direct_handle(self->target(), i_isolate)); } Local<Value> Proxy::GetHandler() { auto self = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); return Utils::ToLocal(i::direct_handle(self->handler(), i_isolate)); } bool Proxy::IsRevoked() const { return Utils::OpenDirectHandle(this)->IsRevoked(); } void Proxy::Revoke() { auto self = Utils::OpenDirectHandle(this); i::JSProxy::Revoke(self); } MaybeLocal<Proxy> Proxy::New(Local<Context> context, Local<Object> local_target, Local<Object> local_handler) { PrepareForExecutionScope api_scope{context, RCCId::kAPI_Proxy_New}; i::Isolate* i_isolate = api_scope.i_isolate(); auto target = Utils::OpenDirectHandle(*local_target); auto handler = Utils::OpenDirectHandle(*local_handler); // The API doesn't distinguish revocable proxies, so we must assume that all // objects created through it are revocable. bool api_proxies_assumed_revocable = true; return api_scope.EscapeMaybe(i::JSProxy::New(i_isolate, target, handler, api_proxies_assumed_revocable)); } CompiledWasmModule::CompiledWasmModule( std::shared_ptr<internal::wasm::NativeModule> native_module, std::string source_url) : native_module_(std::move(native_module)), source_url_(std::move(source_url)) { CHECK_NOT_NULL(native_module_); } OwnedBuffer CompiledWasmModule::Serialize() { #if V8_ENABLE_WEBASSEMBLY TRACE_EVENT0("v8.wasm", "wasm.SerializeModule"); i::wasm::WasmSerializer wasm_serializer(native_module_.get()); size_t buffer_size = wasm_serializer.GetSerializedNativeModuleSize(); std::unique_ptr<uint8_t[]> buffer(new uint8_t[buffer_size]); if (!wasm_serializer.SerializeNativeModule({buffer.get(), buffer_size})) { return {}; } return {std::move(buffer), buffer_size}; #else UNREACHABLE(); #endif // V8_ENABLE_WEBASSEMBLY } MemorySpan<const uint8_t> CompiledWasmModule::GetWireBytesRef() { #if V8_ENABLE_WEBASSEMBLY base::Vector<const uint8_t> bytes_vec = native_module_->wire_bytes(); return {bytes_vec.begin(), bytes_vec.size()}; #else UNREACHABLE(); #endif // V8_ENABLE_WEBASSEMBLY } Local<ArrayBuffer> v8::WasmMemoryObject::Buffer() { #if V8_ENABLE_WEBASSEMBLY i::DirectHandle<i::WasmMemoryObject> obj = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); return Utils::ToLocal(i::WasmMemoryObject::GetArrayBuffer(i_isolate, obj)); #else UNREACHABLE(); #endif // V8_ENABLE_WEBASSEMBLY } CompiledWasmModule WasmModuleObject::GetCompiledModule() { #if V8_ENABLE_WEBASSEMBLY auto obj = i::Cast<i::WasmModuleObject>(Utils::OpenDirectHandle(this)); auto url = i::direct_handle(i::Cast<i::String>(obj->script()->name()), i::Isolate::Current()); size_t length; std::unique_ptr<char[]> cstring = url->ToCString(&length); return CompiledWasmModule(std::move(obj->shared_native_module()), {cstring.get(), length}); #else UNREACHABLE(); #endif // V8_ENABLE_WEBASSEMBLY } MaybeLocal<WasmModuleObject> WasmModuleObject::FromCompiledModule( Isolate* v8_isolate, const CompiledWasmModule& compiled_module) { #if V8_ENABLE_WEBASSEMBLY i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i::DirectHandle<i::WasmModuleObject> module_object = i::wasm::GetWasmEngine()->ImportNativeModule( i_isolate, compiled_module.native_module_, base::VectorOf(compiled_module.source_url())); return Utils::ToLocal(module_object); #else UNREACHABLE(); #endif // V8_ENABLE_WEBASSEMBLY } MaybeLocal<WasmModuleObject> WasmModuleObject::Compile( Isolate* v8_isolate, MemorySpan<const uint8_t> wire_bytes) { #if V8_ENABLE_WEBASSEMBLY base::OwnedVector<const uint8_t> bytes = base::OwnedCopyOf(wire_bytes); i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); // We don't check for `IsWasmCodegenAllowed` here, because this function is // used for ESM integration, which in terms of security is equivalent to // <script> tags rather than to {eval}. i::MaybeDirectHandle<i::WasmModuleObject> maybe_compiled; { i::wasm::ErrorThrower thrower(i_isolate, "WasmModuleObject::Compile()"); auto enabled_features = i::wasm::WasmEnabledFeatures::FromIsolate(i_isolate); // TODO(14179): Provide an API method that supports compile options. maybe_compiled = i::wasm::GetWasmEngine()->SyncCompile( i_isolate, enabled_features, i::wasm::CompileTimeImports{}, &thrower, std::move(bytes)); } CHECK_EQ(maybe_compiled.is_null(), i_isolate->has_exception()); if (maybe_compiled.is_null()) return {}; return Utils::ToLocal(maybe_compiled.ToHandleChecked()); #else Utils::ApiCheck(false, "WasmModuleObject::Compile", "WebAssembly support is not enabled"); UNREACHABLE(); #endif // V8_ENABLE_WEBASSEMBLY } // static Local<WasmMemoryMapDescriptor> WasmMemoryMapDescriptor::New( v8::Isolate* v8_isolate, WasmMemoryMapDescriptor::WasmFileDescriptor fd) { #if V8_ENABLE_WEBASSEMBLY CHECK(i::v8_flags.experimental_wasm_memory_control); i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i::DirectHandle<i::WasmMemoryMapDescriptor> result = i::WasmMemoryMapDescriptor::NewFromFileDescriptor(i_isolate, fd); return Utils::ToLocal(result); #else Utils::ApiCheck(false, "WasmMemoryMapDescriptor::New", "WebAssembly support is not enabled"); UNREACHABLE(); #endif } // static v8::ArrayBuffer::Allocator* v8::ArrayBuffer::Allocator::NewDefaultAllocator() { #ifdef V8_ENABLE_SANDBOX return new ArrayBufferAllocator(i::IsolateGroup::GetDefault()); #else return new ArrayBufferAllocator(); #endif } #if defined(V8_COMPRESS_POINTERS) && \ !defined(V8_COMPRESS_POINTERS_IN_SHARED_CAGE) v8::ArrayBuffer::Allocator* v8::ArrayBuffer::Allocator::NewDefaultAllocator( const IsolateGroup& group) { #ifdef V8_ENABLE_SANDBOX return new ArrayBufferAllocator(group.isolate_group_); #else return new ArrayBufferAllocator(); #endif } #endif // defined(V8_COMPRESS_POINTERS) && // !defined(V8_COMPRESS_POINTERS_IN_SHARED_CAGE) bool v8::ArrayBuffer::IsDetachable() const { return Utils::OpenDirectHandle(this)->is_detachable(); } bool v8::ArrayBuffer::WasDetached() const { return Utils::OpenDirectHandle(this)->was_detached(); } bool v8::ArrayBuffer::IsImmutable() const { return Utils::OpenDirectHandle(this)->is_immutable(); } size_t v8::ArrayBuffer::CopyArrayBufferBytes(size_t source_start, size_t bytes_to_copy, Local<ArrayBuffer> target, size_t target_start) const { i::DisallowGarbageCollection no_gc; auto self = Utils::OpenDirectHandle(this); auto that = Utils::OpenDirectHandle(*target); if (self->was_detached()) return 0; if (that->was_detached() || that->is_immutable()) return 0; return CopyArrayBufferBytesImpl<false>(self->backing_store(), source_start, self->GetByteLength(), that->backing_store(), target_start, that->GetByteLength(), bytes_to_copy); } namespace { std::shared_ptr<i::BackingStore> ToInternal( std::shared_ptr<i::BackingStoreBase> backing_store) { return std::static_pointer_cast<i::BackingStore>(backing_store); } } // namespace Maybe<bool> v8::ArrayBuffer::Detach(v8::Local<v8::Value> key) { auto obj = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); Utils::ApiCheck(obj->is_detachable(), "v8::ArrayBuffer::Detach", "Only detachable ArrayBuffers can be detached"); Local<Context> context = reinterpret_cast<v8::Isolate*>(i_isolate)->GetCurrentContext(); // TODO(verwaest): Remove this case after forcing the embedder to enter the // context. if (context.IsEmpty()) { EnterV8NoScriptNoExceptionScope api_scope(i_isolate); if (key.IsEmpty()) { i::JSArrayBuffer::Detach(obj).Check(); } else { auto i_key = Utils::OpenDirectHandle(*key); constexpr bool kForceForWasmMemory = false; i::JSArrayBuffer::Detach(obj, kForceForWasmMemory, i_key).Check(); } return Just(true); } EnterV8NoScriptScope<> api_scope{i_isolate, context, RCCId::kAPI_ArrayBuffer_Detach}; if (key.IsEmpty()) return i::JSArrayBuffer::Detach(obj); auto i_key = Utils::OpenDirectHandle(*key); constexpr bool kForceForWasmMemory = false; return i::JSArrayBuffer::Detach(obj, kForceForWasmMemory, i_key); } void v8::ArrayBuffer::Detach() { Detach(Local<Value>()).Check(); } void v8::ArrayBuffer::SetDetachKey(v8::Local<v8::Value> key) { i::Isolate* i_isolate = i::Isolate::Current(); i::HandleScope scope(i_isolate); auto obj = Utils::OpenDirectHandle(this); auto i_key = Utils::OpenDirectHandle(*key); i::JSArrayBuffer::SetDetachKey(obj, i_key, i_isolate); } size_t v8::ArrayBuffer::ByteLength() const { return Utils::OpenDirectHandle(this)->GetByteLength(); } size_t v8::ArrayBuffer::MaxByteLength() const { return Utils::OpenDirectHandle(this)->max_byte_length(); } namespace { i::InitializedFlag GetInitializedFlag( BackingStoreInitializationMode initialization_mode) { switch (initialization_mode) { case BackingStoreInitializationMode::kUninitialized: return i::InitializedFlag::kUninitialized; case BackingStoreInitializationMode::kZeroInitialized: return i::InitializedFlag::kZeroInitialized; } UNREACHABLE(); } } // namespace MaybeLocal<ArrayBuffer> v8::ArrayBuffer::MaybeNew( Isolate* isolate, size_t byte_length, BackingStoreInitializationMode initialization_mode) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_ArrayBuffer_MaybeNew); size_t max = i_isolate->array_buffer_allocator()->MaxAllocationSize(); DCHECK(max <= ArrayBuffer::kMaxByteLength); if (byte_length > max) return {}; EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::MaybeDirectHandle<i::JSArrayBuffer> result = i_isolate->factory()->NewJSArrayBufferAndBackingStore( byte_length, GetInitializedFlag(initialization_mode)); i::DirectHandle<i::JSArrayBuffer> array_buffer; if (!result.ToHandle(&array_buffer)) return {}; return Utils::ToLocal(array_buffer); } Local<ArrayBuffer> v8::ArrayBuffer::New( Isolate* v8_isolate, size_t byte_length, BackingStoreInitializationMode initialization_mode) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_ArrayBuffer_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::MaybeDirectHandle<i::JSArrayBuffer> result = i_isolate->factory()->NewJSArrayBufferAndBackingStore( byte_length, GetInitializedFlag(initialization_mode)); i::DirectHandle<i::JSArrayBuffer> array_buffer; if (!result.ToHandle(&array_buffer)) { i::V8::FatalProcessOutOfMemory(i_isolate, "v8::ArrayBuffer::New"); } return Utils::ToLocal(array_buffer); } Local<ArrayBuffer> v8::ArrayBuffer::New( Isolate* v8_isolate, std::shared_ptr<BackingStore> backing_store) { CHECK_IMPLIES(backing_store->ByteLength() != 0, backing_store->Data() != nullptr); i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_ArrayBuffer_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); std::shared_ptr<i::BackingStore> i_backing_store( ToInternal(std::move(backing_store))); Utils::ApiCheck( !i_backing_store->is_shared(), "v8_ArrayBuffer_New", "Cannot construct ArrayBuffer with a BackingStore of SharedArrayBuffer"); i::DirectHandle<i::JSArrayBuffer> obj = i_isolate->factory()->NewJSArrayBuffer(std::move(i_backing_store)); if (obj->backing_store() && static_cast<i::BackingStore*>(obj->GetBackingStore().get()) ->is_immutable()) { obj->set_is_immutable(true); } return Utils::ToLocal(obj); } std::unique_ptr<v8::BackingStore> v8::ArrayBuffer::NewBackingStore( Isolate* v8_isolate, size_t byte_length, BackingStoreInitializationMode initialization_mode, BackingStoreOnFailureMode on_failure) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_ArrayBuffer_NewBackingStore); if (on_failure == BackingStoreOnFailureMode::kOutOfMemory) { CHECK_LE(byte_length, i::JSArrayBuffer::kMaxByteLength); } else if (byte_length > i::JSArrayBuffer::kMaxByteLength) { DCHECK(on_failure == BackingStoreOnFailureMode::kReturnNull); return {}; } EnterV8NoScriptNoExceptionScope api_scope(i_isolate); std::unique_ptr<i::BackingStoreBase> backing_store = i::BackingStore::Allocate(i_isolate, byte_length, i::SharedFlag::kNotShared, GetInitializedFlag(initialization_mode)); if (!backing_store) { if (on_failure == BackingStoreOnFailureMode::kOutOfMemory) { i::V8::FatalProcessOutOfMemory(i_isolate, "v8::ArrayBuffer::NewBackingStore"); } else { DCHECK(on_failure == BackingStoreOnFailureMode::kReturnNull); return {}; } } return std::unique_ptr<v8::BackingStore>( static_cast<v8::BackingStore*>(backing_store.release())); } #ifdef V8_ENABLE_SANDBOX bool v8::IsolateGroup::SandboxContains(void* pointer) const { return isolate_group_->sandbox()->Contains(pointer); } VirtualAddressSpace* v8::IsolateGroup::GetSandboxAddressSpace() { i::Sandbox* sandbox = isolate_group_->sandbox(); Utils::ApiCheck(sandbox->is_initialized(), "v8::V8::GetSandboxAddressSpace", "The sandbox must be initialized first"); return sandbox->address_space(); } #endif std::unique_ptr<v8::BackingStore> v8::ArrayBuffer::NewBackingStore( void* data, size_t byte_length, v8::BackingStore::DeleterCallback deleter, void* deleter_data) { CHECK_LE(byte_length, i::JSArrayBuffer::kMaxByteLength); #ifdef V8_ENABLE_SANDBOX Utils::ApiCheck(!data || i::Sandbox::current()->Contains(data), "v8_ArrayBuffer_NewBackingStore", "When the V8 Sandbox is enabled, ArrayBuffer backing stores " "must be allocated inside the sandbox address space. Please " "use an appropriate ArrayBuffer::Allocator to allocate these " "buffers, or disable the sandbox."); #endif // V8_ENABLE_SANDBOX std::unique_ptr<i::BackingStoreBase> backing_store = i::BackingStore::WrapAllocation(data, byte_length, deleter, deleter_data, i::SharedFlag::kNotShared); return std::unique_ptr<v8::BackingStore>( static_cast<v8::BackingStore*>(backing_store.release())); } // static std::unique_ptr<BackingStore> v8::ArrayBuffer::NewResizableBackingStore( size_t byte_length, size_t max_byte_length) { Utils::ApiCheck(byte_length <= max_byte_length, "v8::ArrayBuffer::NewResizableBackingStore", "Cannot construct resizable ArrayBuffer, byte_length must be " "<= max_byte_length"); Utils::ApiCheck( byte_length <= i::JSArrayBuffer::kMaxByteLength, "v8::ArrayBuffer::NewResizableBackingStore", "Cannot construct resizable ArrayBuffer, requested length is too big"); size_t page_size, initial_pages, max_pages; if (i::JSArrayBuffer::GetResizableBackingStorePageConfiguration( nullptr, byte_length, max_byte_length, i::kDontThrow, &page_size, &initial_pages, &max_pages) .IsNothing()) { i::V8::FatalProcessOutOfMemory(nullptr, "v8::ArrayBuffer::NewResizableBackingStore"); } std::unique_ptr<i::BackingStoreBase> backing_store = i::BackingStore::TryAllocateAndPartiallyCommitMemory( nullptr, byte_length, max_byte_length, page_size, initial_pages, max_pages, i::WasmMemoryFlag::kNotWasm, i::SharedFlag::kNotShared); if (!backing_store) { i::V8::FatalProcessOutOfMemory(nullptr, "v8::ArrayBuffer::NewResizableBackingStore"); } return std::unique_ptr<v8::BackingStore>( static_cast<v8::BackingStore*>(backing_store.release())); } Local<ArrayBuffer> v8::ArrayBufferView::Buffer() { auto obj = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); if (i::IsJSDataView(*obj)) { i::DirectHandle<i::JSDataView> data_view(i::Cast<i::JSDataView>(*obj), i_isolate); DCHECK(IsJSArrayBuffer(data_view->buffer())); return Utils::ToLocal(i::direct_handle( i::Cast<i::JSArrayBuffer>(data_view->buffer()), i_isolate)); } else if (i::IsJSRabGsabDataView(*obj)) { i::DirectHandle<i::JSRabGsabDataView> data_view( i::Cast<i::JSRabGsabDataView>(*obj), i_isolate); DCHECK(IsJSArrayBuffer(data_view->buffer())); return Utils::ToLocal(i::direct_handle( i::Cast<i::JSArrayBuffer>(data_view->buffer()), i_isolate)); } else { DCHECK(IsJSTypedArray(*obj)); return Utils::ToLocal(i::Cast<i::JSTypedArray>(*obj)->GetBuffer(i_isolate)); } } size_t v8::ArrayBufferView::CopyContents(void* dest, size_t byte_length) { size_t bytes_to_copy = std::min(byte_length, ByteLength()); auto self = Utils::OpenDirectHandle(this); if (bytes_to_copy) { i::DisallowGarbageCollection no_gc; const char* source; bool is_shared; if (i::IsJSTypedArray(*self)) { i::Tagged<i::JSTypedArray> array = i::Cast<i::JSTypedArray>(*self); is_shared = array->buffer()->is_shared(); source = reinterpret_cast<char*>(array->DataPtr()); } else { DCHECK(i::IsJSDataView(*self) || i::IsJSRabGsabDataView(*self)); i::Tagged<i::JSDataViewOrRabGsabDataView> data_view = i::Cast<i::JSDataViewOrRabGsabDataView>(*self); is_shared = data_view->buffer()->is_shared(); source = reinterpret_cast<char*>(data_view->data_pointer()); } if (is_shared) { base::Relaxed_Memcpy(reinterpret_cast<char*>(dest), source, bytes_to_copy); } else { memcpy(dest, source, bytes_to_copy); } } return bytes_to_copy; } v8::MemorySpan<uint8_t> v8::ArrayBufferView::GetContents( v8::MemorySpan<uint8_t> storage) { internal::DisallowGarbageCollection no_gc; auto self = Utils::OpenDirectHandle(this); if (self->IsDetachedOrOutOfBounds()) return {}; if (internal::IsJSTypedArray(*self)) { i::Tagged<i::JSTypedArray> typed_array = i::Cast<i::JSTypedArray>(*self); if (typed_array->is_on_heap()) { // The provided storage does not have enough capacity for the content of // the TypedArray. size_t bytes_to_copy = self->byte_length(); CHECK_LE(bytes_to_copy, storage.size()); const uint8_t* source = reinterpret_cast<uint8_t*>(typed_array->DataPtr()); memcpy(reinterpret_cast<void*>(storage.data()), source, bytes_to_copy); return {storage.data(), bytes_to_copy}; } // The TypedArray already has off-heap storage, just return a view on it. return {reinterpret_cast<uint8_t*>(typed_array->DataPtr()), typed_array->GetByteLength()}; } if (i::IsJSDataView(*self)) { i::Tagged<i::JSDataView> data_view = i::Cast<i::JSDataView>(*self); return {reinterpret_cast<uint8_t*>(data_view->data_pointer()), data_view->byte_length()}; } // Other types of ArrayBufferView always have an off-heap storage. DCHECK(i::IsJSRabGsabDataView(*self)); i::Tagged<i::JSRabGsabDataView> data_view = i::Cast<i::JSRabGsabDataView>(*self); return {reinterpret_cast<uint8_t*>(data_view->data_pointer()), data_view->GetByteLength()}; } bool v8::ArrayBufferView::HasBuffer() const { auto self = Utils::OpenDirectHandle(this); if (!IsJSTypedArray(*self)) return true; auto typed_array = i::Cast<i::JSTypedArray>(self); return !typed_array->is_on_heap(); } size_t v8::ArrayBufferView::ByteOffset() { auto obj = Utils::OpenDirectHandle(this); return obj->IsDetachedOrOutOfBounds() ? 0 : obj->byte_offset(); } size_t v8::ArrayBufferView::ByteLength() { i::DisallowGarbageCollection no_gc; i::Tagged<i::JSArrayBufferView> obj = *Utils::OpenDirectHandle(this); if (obj->IsDetachedOrOutOfBounds()) { return 0; } if (i::IsJSTypedArray(obj)) { return i::Cast<i::JSTypedArray>(obj)->GetByteLength(); } if (i::IsJSDataView(obj)) { return i::Cast<i::JSDataView>(obj)->byte_length(); } return i::Cast<i::JSRabGsabDataView>(obj)->GetByteLength(); } size_t v8::TypedArray::Length() { i::DisallowGarbageCollection no_gc; i::Tagged<i::JSTypedArray> obj = *Utils::OpenDirectHandle(this); return obj->IsDetachedOrOutOfBounds() ? 0 : obj->GetLength(); } static_assert(v8::TypedArray::kMaxByteLength == i::JSTypedArray::kMaxByteLength, "v8::TypedArray::kMaxByteLength must match " "i::JSTypedArray::kMaxByteLength"); #define TYPED_ARRAY_NEW(Type, type, TYPE, ctype) \ Local<Type##Array> Type##Array::New(Local<ArrayBuffer> array_buffer, \ size_t byte_offset, size_t length) { \ i::Isolate* i_isolate = i::Isolate::Current(); \ ApiRuntimeCallStatsScope rcs_scope(i_isolate, \ RCCId::kAPI_##Type##Array_New); \ EnterV8NoScriptNoExceptionScope api_scope(i_isolate); \ if (!Utils::ApiCheck(length <= kMaxLength, \ "v8::" #Type \ "Array::New(Local<ArrayBuffer>, size_t, size_t)", \ "length exceeds max allowed value")) { \ return {}; \ } \ auto buffer = Utils::OpenDirectHandle(*array_buffer); \ i::DirectHandle<i::JSTypedArray> obj = \ i_isolate->factory()->NewJSTypedArray(i::kExternal##Type##Array, \ buffer, byte_offset, length); \ return Utils::ToLocal##Type##Array(obj); \ } \ Local<Type##Array> Type##Array::New( \ Local<SharedArrayBuffer> shared_array_buffer, size_t byte_offset, \ size_t length) { \ i::Isolate* i_isolate = i::Isolate::Current(); \ ApiRuntimeCallStatsScope rcs_scope(i_isolate, \ RCCId::kAPI_##Type##Array_New); \ EnterV8NoScriptNoExceptionScope api_scope(i_isolate); \ if (!Utils::ApiCheck( \ length <= kMaxLength, \ "v8::" #Type \ "Array::New(Local<SharedArrayBuffer>, size_t, size_t)", \ "length exceeds max allowed value")) { \ return {}; \ } \ auto buffer = Utils::OpenDirectHandle(*shared_array_buffer); \ i::DirectHandle<i::JSTypedArray> obj = \ i_isolate->factory()->NewJSTypedArray(i::kExternal##Type##Array, \ buffer, byte_offset, length); \ return Utils::ToLocal##Type##Array(obj); \ } TYPED_ARRAYS_BASE(TYPED_ARRAY_NEW) #undef TYPED_ARRAY_NEW Local<Float16Array> Float16Array::New(Local<ArrayBuffer> array_buffer, size_t byte_offset, size_t length) { Utils::ApiCheck(i::v8_flags.js_float16array, "v8::Float16Array::New", "Float16Array is not supported"); i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Float16Array_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); if (!Utils::ApiCheck( length <= kMaxLength, "v8::Float16Array::New(Local<ArrayBuffer>, size_t, size_t)", "length exceeds max allowed value")) { return {}; } auto buffer = Utils::OpenDirectHandle(*array_buffer); i::DirectHandle<i::JSTypedArray> obj = i_isolate->factory()->NewJSTypedArray( i::kExternalFloat16Array, buffer, byte_offset, length); return Utils::ToLocalFloat16Array(obj); } Local<Float16Array> Float16Array::New( Local<SharedArrayBuffer> shared_array_buffer, size_t byte_offset, size_t length) { Utils::ApiCheck(i::v8_flags.js_float16array, "v8::Float16Array::New", "Float16Array is not supported"); i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Float16Array_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); if (!Utils::ApiCheck( length <= kMaxLength, "v8::Float16Array::New(Local<SharedArrayBuffer>, size_t, size_t)", "length exceeds max allowed value")) { return {}; } auto buffer = Utils::OpenDirectHandle(*shared_array_buffer); i::DirectHandle<i::JSTypedArray> obj = i_isolate->factory()->NewJSTypedArray( i::kExternalFloat16Array, buffer, byte_offset, length); return Utils::ToLocalFloat16Array(obj); } // TODO(v8:11111): Support creating length tracking DataViews via the API. Local<DataView> DataView::New(Local<ArrayBuffer> array_buffer, size_t byte_offset, size_t byte_length) { auto buffer = Utils::OpenDirectHandle(*array_buffer); i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_DataView_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); auto obj = i::Cast<i::JSDataView>( i_isolate->factory()->NewJSDataViewOrRabGsabDataView(buffer, byte_offset, byte_length)); return Utils::ToLocal(obj); } Local<DataView> DataView::New(Local<SharedArrayBuffer> shared_array_buffer, size_t byte_offset, size_t byte_length) { auto buffer = Utils::OpenDirectHandle(*shared_array_buffer); i::Isolate* i_isolate = i::Isolate::Current(); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_DataView_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); auto obj = i::Cast<i::JSDataView>( i_isolate->factory()->NewJSDataViewOrRabGsabDataView(buffer, byte_offset, byte_length)); return Utils::ToLocal(obj); } size_t v8::SharedArrayBuffer::ByteLength() const { return Utils::OpenDirectHandle(this)->GetByteLength(); } size_t v8::SharedArrayBuffer::MaxByteLength() const { return Utils::OpenDirectHandle(this)->max_byte_length(); } Local<SharedArrayBuffer> v8::SharedArrayBuffer::New( Isolate* v8_isolate, size_t byte_length, BackingStoreInitializationMode initialization_mode) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_SharedArrayBuffer_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); std::unique_ptr<i::BackingStore> backing_store = i::BackingStore::Allocate(i_isolate, byte_length, i::SharedFlag::kShared, GetInitializedFlag(initialization_mode)); if (!backing_store) { i::V8::FatalProcessOutOfMemory(i_isolate, "v8::SharedArrayBuffer::New"); } i::DirectHandle<i::JSArrayBuffer> obj = i_isolate->factory()->NewJSSharedArrayBuffer(std::move(backing_store)); return Utils::ToLocalShared(obj); } MaybeLocal<SharedArrayBuffer> v8::SharedArrayBuffer::MaybeNew( Isolate* v8_isolate, size_t byte_length, BackingStoreInitializationMode initialization_mode) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_SharedArrayBuffer_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); std::unique_ptr<i::BackingStore> backing_store = i::BackingStore::Allocate(i_isolate, byte_length, i::SharedFlag::kShared, GetInitializedFlag(initialization_mode)); if (!backing_store) return {}; i::DirectHandle<i::JSArrayBuffer> obj = i_isolate->factory()->NewJSSharedArrayBuffer(std::move(backing_store)); return Utils::ToLocalShared(obj); } Local<SharedArrayBuffer> v8::SharedArrayBuffer::New( Isolate* v8_isolate, std::shared_ptr<BackingStore> backing_store) { CHECK_IMPLIES(backing_store->ByteLength() != 0, backing_store->Data() != nullptr); i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_SharedArrayBuffer_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); std::shared_ptr<i::BackingStore> i_backing_store(ToInternal(backing_store)); Utils::ApiCheck( i_backing_store->is_shared(), "v8::SharedArrayBuffer::New", "Cannot construct SharedArrayBuffer with BackingStore of ArrayBuffer"); i::DirectHandle<i::JSArrayBuffer> obj = i_isolate->factory()->NewJSSharedArrayBuffer(std::move(i_backing_store)); return Utils::ToLocalShared(obj); } std::unique_ptr<v8::BackingStore> v8::SharedArrayBuffer::NewBackingStore( Isolate* v8_isolate, size_t byte_length, BackingStoreInitializationMode initialization_mode, BackingStoreOnFailureMode on_failure) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope( i_isolate, RCCId::kAPI_SharedArrayBuffer_NewBackingStore); if (on_failure == BackingStoreOnFailureMode::kOutOfMemory) { Utils::ApiCheck( byte_length <= i::JSArrayBuffer::kMaxByteLength, "v8::SharedArrayBuffer::NewBackingStore", "Cannot construct SharedArrayBuffer, requested length is too big"); } else { DCHECK(on_failure == BackingStoreOnFailureMode::kReturnNull); if (byte_length > i::JSArrayBuffer::kMaxByteLength) return {}; } EnterV8NoScriptNoExceptionScope api_scope(i_isolate); std::unique_ptr<i::BackingStoreBase> backing_store = i::BackingStore::Allocate(i_isolate, byte_length, i::SharedFlag::kShared, GetInitializedFlag(initialization_mode)); if (!backing_store) { if (on_failure == BackingStoreOnFailureMode::kOutOfMemory) { i::V8::FatalProcessOutOfMemory(i_isolate, "v8::SharedArrayBuffer::NewBackingStore"); } else { DCHECK(on_failure == BackingStoreOnFailureMode::kReturnNull); return {}; } } return std::unique_ptr<v8::BackingStore>( static_cast<v8::BackingStore*>(backing_store.release())); } std::unique_ptr<v8::BackingStore> v8::SharedArrayBuffer::NewBackingStore( void* data, size_t byte_length, v8::BackingStore::DeleterCallback deleter, void* deleter_data) { CHECK_LE(byte_length, i::JSArrayBuffer::kMaxByteLength); std::unique_ptr<i::BackingStoreBase> backing_store = i::BackingStore::WrapAllocation(data, byte_length, deleter, deleter_data, i::SharedFlag::kShared); return std::unique_ptr<v8::BackingStore>( static_cast<v8::BackingStore*>(backing_store.release())); } Local<Symbol> v8::Symbol::New(Isolate* v8_isolate, Local<String> name) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Symbol_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::Symbol> result = i_isolate->factory()->NewSymbol(); if (!name.IsEmpty()) result->set_description(*Utils::OpenDirectHandle(*name)); return Utils::ToLocal(result); } Local<Symbol> v8::Symbol::For(Isolate* v8_isolate, Local<String> name) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); auto i_name = Utils::OpenHandle(*name); return Utils::ToLocal( i_isolate->SymbolFor(i::RootIndex::kPublicSymbolTable, i_name, false)); } Local<Symbol> v8::Symbol::ForApi(Isolate* v8_isolate, Local<String> name) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); auto i_name = Utils::OpenHandle(*name); return Utils::ToLocal( i_isolate->SymbolFor(i::RootIndex::kApiSymbolTable, i_name, false)); } #define WELL_KNOWN_SYMBOLS(V) \ V(AsyncIterator, async_iterator) \ V(HasInstance, has_instance) \ V(IsConcatSpreadable, is_concat_spreadable) \ V(Iterator, iterator) \ V(Match, match) \ V(Replace, replace) \ V(Search, search) \ V(Split, split) \ V(ToPrimitive, to_primitive) \ V(ToStringTag, to_string_tag) \ V(Unscopables, unscopables) \ V(Dispose, dispose) \ V(AsyncDispose, async_dispose) #define SYMBOL_GETTER(Name, name) \ Local<Symbol> v8::Symbol::Get##Name(Isolate* v8_isolate) { \ i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); \ return Utils::ToLocal(i_isolate->factory()->name##_symbol()); \ } WELL_KNOWN_SYMBOLS(SYMBOL_GETTER) #undef SYMBOL_GETTER #undef WELL_KNOWN_SYMBOLS Local<Private> v8::Private::New(Isolate* v8_isolate, Local<String> name) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Private_New); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::Symbol> symbol = i_isolate->factory()->NewPrivateSymbol(); if (!name.IsEmpty()) symbol->set_description(*Utils::OpenDirectHandle(*name)); Local<Symbol> result = Utils::ToLocal(symbol); return result.UnsafeAs<Private>(); } Local<Private> v8::Private::ForApi(Isolate* v8_isolate, Local<String> name) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i::DisallowJavascriptExecutionDebugOnly no_execution(i_isolate); i::DisallowExceptionsDebugOnly no_exceptions(i_isolate); auto i_name = Utils::OpenHandle(*name); Local<Symbol> result = Utils::ToLocal( i_isolate->SymbolFor(i::RootIndex::kApiPrivateSymbolTable, i_name, true)); return result.UnsafeAs<Private>(); } Local<Number> v8::Number::NewFromInt32(Isolate* v8_isolate, int32_t value) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i::DisallowJavascriptExecutionDebugOnly no_execution(i_isolate); i::DisallowExceptionsDebugOnly no_exceptions(i_isolate); i::DirectHandle<i::Object> result = i_isolate->factory()->NewNumberFromInt(value); return Utils::NumberToLocal(result); } Local<Number> v8::Number::NewFromUint32(Isolate* v8_isolate, uint32_t value) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i::DisallowJavascriptExecutionDebugOnly no_execution(i_isolate); i::DisallowExceptionsDebugOnly no_exceptions(i_isolate); i::DirectHandle<i::Object> result = i_isolate->factory()->NewNumberFromUint(value); return Utils::NumberToLocal(result); } Local<Number> v8::Number::New(Isolate* v8_isolate, double value) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i::DisallowJavascriptExecutionDebugOnly no_execution(i_isolate); i::DisallowExceptionsDebugOnly no_exceptions(i_isolate); if (std::isnan(value)) { // Introduce only canonical NaN value into the VM, to avoid signaling NaNs. value = std::numeric_limits<double>::quiet_NaN(); } i::DirectHandle<i::Object> result = i_isolate->factory()->NewNumber(value); return Utils::NumberToLocal(result); } Local<Integer> v8::Integer::New(Isolate* v8_isolate, int32_t value) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); if (i::Smi::IsValid(value)) { return Utils::IntegerToLocal( i::DirectHandle<i::Object>(i::Smi::FromInt(value), i_isolate)); } i::DirectHandle<i::Object> result = i_isolate->factory()->NewNumber(value); return Utils::IntegerToLocal(result); } Local<Integer> v8::Integer::NewFromUnsigned(Isolate* v8_isolate, uint32_t value) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); bool fits_into_int32_t = (value & (1 << 31)) == 0; if (fits_into_int32_t) { return Integer::New(v8_isolate, static_cast<int32_t>(value)); } i::DirectHandle<i::Object> result = i_isolate->factory()->NewNumber(value); return Utils::IntegerToLocal(result); } Local<BigInt> v8::BigInt::New(Isolate* v8_isolate, int64_t value) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::BigInt> result = i::BigInt::FromInt64(i_isolate, value); return Utils::ToLocal(result); } Local<BigInt> v8::BigInt::NewFromUnsigned(Isolate* v8_isolate, uint64_t value) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::DirectHandle<i::BigInt> result = i::BigInt::FromUint64(i_isolate, value); return Utils::ToLocal(result); } MaybeLocal<BigInt> v8::BigInt::NewFromWords(Local<Context> context, int sign_bit, int word_count, const uint64_t* words) { i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptScope<InternalEscapableScope> api_scope{ i_isolate, context, RCCId::kAPI_BigInt_NewFromWords}; return api_scope.EscapeMaybe( i::BigInt::FromWords64(i_isolate, sign_bit, word_count, words)); } uint64_t v8::BigInt::Uint64Value(bool* lossless) const { return Utils::OpenDirectHandle(this)->AsUint64(lossless); } int64_t v8::BigInt::Int64Value(bool* lossless) const { return Utils::OpenDirectHandle(this)->AsInt64(lossless); } int BigInt::WordCount() const { return Utils::OpenDirectHandle(this)->Words64Count(); } void BigInt::ToWordsArray(int* sign_bit, int* word_count, uint64_t* words) const { // TODO(saelo): consider migrating the public API to also use uint32_t or // size_t for length and count values. uint32_t unsigned_word_count = *word_count; Utils::OpenDirectHandle(this)->ToWordsArray64(sign_bit, &unsigned_word_count, words); *word_count = base::checked_cast<int>(unsigned_word_count); } int64_t Isolate::AdjustAmountOfExternalAllocatedMemoryImpl( int64_t change_in_bytes) { // Try to check for unreasonably large or small values from the embedder; if (i::v8_flags.external_memory_max_reasonable_size > 0) { const int64_t kMaxReasonableBytes = static_cast<int64_t>(i::v8_flags.external_memory_max_reasonable_size) * internal::GB; const int64_t kMinReasonableBytes = -kMaxReasonableBytes; CHECK_LE(kMinReasonableBytes, change_in_bytes); CHECK_LT(change_in_bytes, kMaxReasonableBytes); } i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); const uint64_t amount = i_isolate->heap()->UpdateExternalMemory(change_in_bytes); if (change_in_bytes <= 0) { return amount; } #if V8_VERIFY_WRITE_BARRIERS // Incrementing the number of allocated bytes may trigger GC. i_isolate->main_thread_local_heap() ->allocator() ->ResetMostRecentYoungAllocation(); #endif if (amount > i_isolate->heap()->external_memory_limit_for_interrupt()) { HandleExternalMemoryInterrupt(); } return amount; } void Isolate::HandleExternalMemoryInterrupt() { i::Heap* heap = reinterpret_cast<i::Isolate*>(this)->heap(); if (heap->gc_state() != i::Heap::NOT_IN_GC) return; heap->HandleExternalMemoryInterrupt(); } bool Isolate::RetryCustomAllocate(std::function<bool()> allocate) { i::Heap* heap = reinterpret_cast<i::Isolate*>(this)->heap(); return heap->allocator()->RetryCustomAllocate( [&allocate]() { return allocate(); }, internal::AllocationType::kOld); } IsolateGroup::IsolateGroup(i::IsolateGroup*&& isolate_group) : isolate_group_(isolate_group) { DCHECK_NOT_NULL(isolate_group_); } IsolateGroup::IsolateGroup(const IsolateGroup& other) : isolate_group_(other.isolate_group_) { if (isolate_group_) isolate_group_->Acquire(); } IsolateGroup& IsolateGroup::operator=(const IsolateGroup& other) { if (this != &other && isolate_group_ != other.isolate_group_) { if (isolate_group_) isolate_group_->Release(); isolate_group_ = other.isolate_group_; if (isolate_group_) isolate_group_->Acquire(); } return *this; } IsolateGroup::~IsolateGroup() { if (isolate_group_) { isolate_group_->Release(); #ifdef DEBUG isolate_group_ = nullptr; #endif } } // static IsolateGroup IsolateGroup::GetDefault() { return IsolateGroup(i::IsolateGroup::AcquireDefault()); } // static bool IsolateGroup::CanCreateNewGroups() { return i::IsolateGroup::CanCreateNewGroups(); } // static IsolateGroup IsolateGroup::Create() { return IsolateGroup(i::IsolateGroup::New()); } IsolateGroup::IsolateGroup(IsolateGroup&& other) { isolate_group_ = other.isolate_group_; other.isolate_group_ = nullptr; } IsolateGroup& v8::IsolateGroup::operator=(IsolateGroup&& other) { if (this == &other) { return *this; } if (isolate_group_) { isolate_group_->Release(); } isolate_group_ = other.isolate_group_; other.isolate_group_ = nullptr; return *this; } HeapProfiler* Isolate::GetHeapProfiler() { i::HeapProfiler* heap_profiler = reinterpret_cast<i::Isolate*>(this)->heap()->heap_profiler(); return reinterpret_cast<HeapProfiler*>(heap_profiler); } void Isolate::SetIdle(bool is_idle) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->SetIdle(is_idle); } ArrayBuffer::Allocator* Isolate::GetArrayBufferAllocator() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); return i_isolate->array_buffer_allocator(); } bool Isolate::InContext() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); return !i_isolate->context().is_null(); } void Isolate::ClearKeptObjects() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->ClearKeptObjects(); } v8::Local<v8::Context> Isolate::GetCurrentContext() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i::Tagged<i::Context> context = i_isolate->context(); if (context.is_null()) return {}; i::Tagged<i::NativeContext> native_context = context->native_context(); return Utils::ToLocal(i::direct_handle(native_context, i_isolate)); } // TODO(ishell): rename back to GetEnteredContext(). v8::Local<v8::Context> Isolate::GetEnteredOrMicrotaskContext() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i::DirectHandle<i::NativeContext> last = i_isolate->handle_scope_implementer()->LastEnteredContext(); if (last.is_null()) return {}; return Utils::ToLocal(last); } v8::Local<v8::Context> Isolate::GetIncumbentContext() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i::DirectHandle<i::NativeContext> context = i_isolate->GetIncumbentContext(); return Utils::ToLocal(context); } v8::MaybeLocal<v8::Data> Isolate::GetCurrentHostDefinedOptions() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i::DirectHandle<i::Script> script; if (!i_isolate->CurrentReferrerScript().ToHandle(&script)) return {}; return ToApiHandle<Data>( i::direct_handle(script->host_defined_options(), i_isolate)); } v8::Local<Value> Isolate::ThrowError(v8::Local<v8::String> message) { return ThrowException(v8::Exception::Error(message)); } v8::Local<Value> Isolate::ThrowException(v8::Local<v8::Value> value) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); EnterV8BasicScope api_scope(i_isolate); i_isolate->clear_internal_exception(); // If we're passed an empty handle, we throw an undefined exception // to deal more gracefully with out of memory situations. if (value.IsEmpty()) { i_isolate->Throw(i::ReadOnlyRoots(i_isolate).undefined_value()); } else { i_isolate->Throw(*Utils::OpenDirectHandle(*value)); } return v8::Undefined(reinterpret_cast<v8::Isolate*>(i_isolate)); } bool Isolate::HasPendingException() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); if (i_isolate->has_exception()) { return true; } v8::TryCatch* try_catch_handler = i_isolate->thread_local_top()->try_catch_handler_; return try_catch_handler && try_catch_handler->HasCaught(); } void Isolate::AddGCPrologueCallback(GCCallbackWithData callback, void* data, GCType gc_type) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->heap()->AddGCPrologueCallback(callback, gc_type, data); } void Isolate::RemoveGCPrologueCallback(GCCallbackWithData callback, void* data) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->heap()->RemoveGCPrologueCallback(callback, data); } void Isolate::AddGCEpilogueCallback(GCCallbackWithData callback, void* data, GCType gc_type) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->heap()->AddGCEpilogueCallback(callback, gc_type, data); } void Isolate::RemoveGCEpilogueCallback(GCCallbackWithData callback, void* data) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->heap()->RemoveGCEpilogueCallback(callback, data); } static void CallGCCallbackWithoutData(Isolate* v8_isolate, GCType type, GCCallbackFlags flags, void* data) { reinterpret_cast<Isolate::GCCallback>(data)(v8_isolate, type, flags); } void Isolate::AddGCPrologueCallback(GCCallback callback, GCType gc_type) { void* data = reinterpret_cast<void*>(callback); AddGCPrologueCallback(CallGCCallbackWithoutData, data, gc_type); } void Isolate::RemoveGCPrologueCallback(GCCallback callback) { void* data = reinterpret_cast<void*>(callback); RemoveGCPrologueCallback(CallGCCallbackWithoutData, data); } void Isolate::AddGCEpilogueCallback(GCCallback callback, GCType gc_type) { void* data = reinterpret_cast<void*>(callback); AddGCEpilogueCallback(CallGCCallbackWithoutData, data, gc_type); } void Isolate::RemoveGCEpilogueCallback(GCCallback callback) { void* data = reinterpret_cast<void*>(callback); RemoveGCEpilogueCallback(CallGCCallbackWithoutData, data); } void Isolate::SetEmbedderRootsHandler(EmbedderRootsHandler* handler) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->heap()->SetEmbedderRootsHandler(handler); } CppHeap* Isolate::GetCppHeap() const { const i::Isolate* i_isolate = reinterpret_cast<const i::Isolate*>(this); return i_isolate->heap()->cpp_heap(); } void Isolate::SetReleaseCppHeapCallbackForTesting( ReleaseCppHeapCallback callback) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->SetReleaseCppHeapCallback(callback); } void Isolate::SetGetExternallyAllocatedMemoryInBytesCallback( GetExternallyAllocatedMemoryInBytesCallback callback) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->heap()->SetGetExternallyAllocatedMemoryInBytesCallback(callback); } void Isolate::TerminateExecution() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->stack_guard()->RequestTerminateExecution(); } bool Isolate::IsExecutionTerminating() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); return i_isolate->is_execution_terminating(); } void Isolate::CancelTerminateExecution() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->stack_guard()->ClearTerminateExecution(); i_isolate->CancelTerminateExecution(); } void Isolate::RequestInterrupt(InterruptCallback callback, void* data) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->RequestInterrupt(callback, data); } bool Isolate::HasPendingBackgroundTasks() { #if V8_ENABLE_WEBASSEMBLY i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); return i::wasm::GetWasmEngine()->HasRunningCompileJob(i_isolate); #else return false; #endif // V8_ENABLE_WEBASSEMBLY } void Isolate::RequestGarbageCollectionForTesting(GarbageCollectionType type) { Utils::ApiCheck(i::v8_flags.expose_gc, "v8::Isolate::RequestGarbageCollectionForTesting", "Must use --expose-gc"); // The embedder must have entered the isolate (via `Isolate::Scope`) such that // the GC can get the "current" isolate from TLS. DCHECK_EQ(this, Isolate::TryGetCurrent()); if (type == kMinorGarbageCollection) { reinterpret_cast<i::Isolate*>(this)->heap()->CollectGarbage( i::NEW_SPACE, i::GarbageCollectionReason::kTesting, kGCCallbackFlagForced); } else { DCHECK_EQ(kFullGarbageCollection, type); reinterpret_cast<i::Isolate*>(this)->heap()->PreciseCollectAllGarbage( i::GCFlag::kNoFlags, i::GarbageCollectionReason::kTesting, kGCCallbackFlagForced); } } void Isolate::RequestGarbageCollectionForTesting(GarbageCollectionType type, StackState stack_state) { std::optional<i::EmbedderStackStateScope> stack_scope; if (type == kFullGarbageCollection) { stack_scope.emplace(reinterpret_cast<i::Isolate*>(this)->heap(), i::EmbedderStackStateOrigin::kExplicitInvocation, stack_state); } RequestGarbageCollectionForTesting(type); } Isolate* Isolate::GetCurrent() { i::Isolate* i_isolate = i::Isolate::Current(); return reinterpret_cast<Isolate*>(i_isolate); } Isolate* Isolate::TryGetCurrent() { i::Isolate* i_isolate = i::Isolate::TryGetCurrent(); return reinterpret_cast<Isolate*>(i_isolate); } bool Isolate::IsCurrent() const { return reinterpret_cast<const i::Isolate*>(this)->IsCurrent(); } // static Isolate* Isolate::Allocate() { return Isolate::Allocate(IsolateGroup::GetDefault()); } // static Isolate* Isolate::Allocate(const IsolateGroup& group) { i::IsolateGroup* isolate_group = group.isolate_group_->Acquire(); return reinterpret_cast<Isolate*>(i::Isolate::New(isolate_group)); } IsolateGroup Isolate::GetGroup() const { const i::Isolate* i_isolate = reinterpret_cast<const i::Isolate*>(this); return IsolateGroup(i_isolate->isolate_group()->Acquire()); } Isolate::CreateParams::CreateParams() = default; Isolate::CreateParams::~CreateParams() = default; // static // This is separate so that tests can provide a different |isolate|. void Isolate::Initialize(Isolate* v8_isolate, const v8::Isolate::CreateParams& params) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); TRACE_EVENT_CALL_STATS_SCOPED(i_isolate, "v8", "V8.IsolateInitialize"); if (auto allocator = params.array_buffer_allocator_shared) { CHECK(params.array_buffer_allocator == nullptr || params.array_buffer_allocator == allocator.get()); i_isolate->set_array_buffer_allocator(allocator.get()); i_isolate->set_array_buffer_allocator_shared(std::move(allocator)); } else { CHECK_NOT_NULL(params.array_buffer_allocator); i_isolate->set_array_buffer_allocator(params.array_buffer_allocator); } if (params.snapshot_blob != nullptr) { i_isolate->set_snapshot_blob(params.snapshot_blob); } else { i_isolate->set_snapshot_blob(i::Snapshot::DefaultSnapshotBlob()); } if (params.fatal_error_callback) { v8_isolate->SetFatalErrorHandler(params.fatal_error_callback); } #if __clang__ #pragma clang diagnostic push #pragma clang diagnostic ignored "-Wdeprecated-declarations" #endif if (params.oom_error_callback) { v8_isolate->SetOOMErrorHandler(params.oom_error_callback); } #if __clang__ #pragma clang diagnostic pop #endif if (params.counter_lookup_callback) { v8_isolate->SetCounterFunction(params.counter_lookup_callback); } if (params.create_histogram_callback) { v8_isolate->SetCreateHistogramFunction(params.create_histogram_callback); } if (params.add_histogram_sample_callback) { v8_isolate->SetAddHistogramSampleFunction( params.add_histogram_sample_callback); } i_isolate->set_api_external_references(params.external_references); i_isolate->set_allow_atomics_wait(params.allow_atomics_wait); CppHeap* cpp_heap = params.cpp_heap; if (!cpp_heap) { cpp_heap = CppHeap::Create(i::V8::GetCurrentPlatform(), CppHeapCreateParams{{}}) .release(); } i_isolate->heap()->ConfigureHeap(params.constraints, cpp_heap); if (params.constraints.stack_limit() != nullptr) { uintptr_t limit = reinterpret_cast<uintptr_t>(params.constraints.stack_limit()); i_isolate->stack_guard()->SetStackLimit(limit); i_isolate->set_stack_size(base::Stack::GetStackStart() - limit); } // TODO(v8:2487): Once we got rid of Isolate::Current(), we can remove this. Isolate::Scope isolate_scope(v8_isolate); if (i_isolate->snapshot_blob() == nullptr) { FATAL( "V8 snapshot blob was not set during initialization. This can mean " "that the snapshot blob file is corrupted or missing."); } if (!i::Snapshot::Initialize(i_isolate)) { // If snapshot data was provided and we failed to deserialize it must // have been corrupted. FATAL( "Failed to deserialize the V8 snapshot blob. This can mean that the " "snapshot blob file is corrupted or missing."); } { // Set up code event handlers. Needs to be after i::Snapshot::Initialize // because that is where we add the isolate to WasmEngine. auto code_event_handler = params.code_event_handler; if (code_event_handler) { v8_isolate->SetJitCodeEventHandler(kJitCodeEventEnumExisting, code_event_handler); } } if (!i::V8::GetCurrentPlatform() ->GetForegroundTaskRunner(v8_isolate) ->NonNestableTasksEnabled()) { FATAL( "The current platform's foreground task runner does not have " "non-nestable tasks enabled. The embedder must provide one."); } } Isolate* Isolate::New(const Isolate::CreateParams& params) { return Isolate::New(IsolateGroup::GetDefault(), params); } Isolate* Isolate::New(const IsolateGroup& group, const Isolate::CreateParams& params) { Isolate* v8_isolate = Allocate(group); Initialize(v8_isolate, params); return v8_isolate; } void Isolate::Dispose() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); if (!Utils::ApiCheck(!i_isolate->IsInUse(), "v8::Isolate::Dispose()", "Disposing the isolate that is entered by a thread")) { return; } i::Isolate::Delete(i_isolate); } void Isolate::Deinitialize() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); if (!Utils::ApiCheck( !i_isolate->IsInUse(), "v8::Isolate::Deinitialize()", "Deinitializing the isolate that is entered by a thread")) { return; } i::Isolate::Deinitialize(i_isolate); } void Isolate::Free(Isolate* isolate) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(isolate); i::Isolate::Free(i_isolate); } void Isolate::DumpAndResetStats() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->DumpAndResetStats(); } void Isolate::DiscardThreadSpecificMetadata() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->DiscardPerThreadDataForThisThread(); } void Isolate::Enter() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->Enter(); } void Isolate::Exit() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->Exit(); } void Isolate::SetAbortOnUncaughtExceptionCallback( AbortOnUncaughtExceptionCallback callback) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->SetAbortOnUncaughtExceptionCallback(callback); } void Isolate::SetHostImportModuleDynamicallyCallback( HostImportModuleDynamicallyCallback callback) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->SetHostImportModuleDynamicallyCallback(callback); } void Isolate::SetHostImportModuleWithPhaseDynamicallyCallback( HostImportModuleWithPhaseDynamicallyCallback callback) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->SetHostImportModuleWithPhaseDynamicallyCallback(callback); } void Isolate::SetHostInitializeImportMetaObjectCallback( HostInitializeImportMetaObjectCallback callback) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->SetHostInitializeImportMetaObjectCallback(callback); } void Isolate::SetHostCreateShadowRealmContextCallback( HostCreateShadowRealmContextCallback callback) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->SetHostCreateShadowRealmContextCallback(callback); } void Isolate::SetPrepareStackTraceCallback(PrepareStackTraceCallback callback) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->SetPrepareStackTraceCallback(callback); } int Isolate::GetStackTraceLimit() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); int stack_trace_limit = 0; if (!i_isolate->GetStackTraceLimit(i_isolate, &stack_trace_limit)) { return i::v8_flags.stack_trace_limit; } return stack_trace_limit; } Isolate::DisallowJavascriptExecutionScope::DisallowJavascriptExecutionScope( Isolate* v8_isolate, Isolate::DisallowJavascriptExecutionScope::OnFailure on_failure) : v8_isolate_(v8_isolate), on_failure_(on_failure) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); switch (on_failure_) { case CRASH_ON_FAILURE: i::DisallowJavascriptExecution::Open(i_isolate, &was_execution_allowed_); break; case THROW_ON_FAILURE: i::ThrowOnJavascriptExecution::Open(i_isolate, &was_execution_allowed_); break; case DUMP_ON_FAILURE: i::DumpOnJavascriptExecution::Open(i_isolate, &was_execution_allowed_); break; } } Isolate::DisallowJavascriptExecutionScope::~DisallowJavascriptExecutionScope() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate_); switch (on_failure_) { case CRASH_ON_FAILURE: i::DisallowJavascriptExecution::Close(i_isolate, was_execution_allowed_); break; case THROW_ON_FAILURE: i::ThrowOnJavascriptExecution::Close(i_isolate, was_execution_allowed_); break; case DUMP_ON_FAILURE: i::DumpOnJavascriptExecution::Close(i_isolate, was_execution_allowed_); break; } } Isolate::AllowJavascriptExecutionScope::AllowJavascriptExecutionScope( Isolate* v8_isolate) : v8_isolate_(v8_isolate) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i::AllowJavascriptExecution::Open(i_isolate, &was_execution_allowed_assert_); i::NoThrowOnJavascriptExecution::Open(i_isolate, &was_execution_allowed_throws_); i::NoDumpOnJavascriptExecution::Open(i_isolate, &was_execution_allowed_dump_); } Isolate::AllowJavascriptExecutionScope::~AllowJavascriptExecutionScope() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate_); i::AllowJavascriptExecution::Close(i_isolate, was_execution_allowed_assert_); i::NoThrowOnJavascriptExecution::Close(i_isolate, was_execution_allowed_throws_); i::NoDumpOnJavascriptExecution::Close(i_isolate, was_execution_allowed_dump_); } Isolate::SuppressMicrotaskExecutionScope::SuppressMicrotaskExecutionScope( Isolate* v8_isolate, MicrotaskQueue* microtask_queue) : i_isolate_(reinterpret_cast<i::Isolate*>(v8_isolate)), microtask_queue_(microtask_queue ? static_cast<i::MicrotaskQueue*>(microtask_queue) : i_isolate_->default_microtask_queue()) { i_isolate_->thread_local_top()->IncrementCallDepth<true>(this); microtask_queue_->IncrementMicrotasksSuppressions(); } Isolate::SuppressMicrotaskExecutionScope::~SuppressMicrotaskExecutionScope() { microtask_queue_->DecrementMicrotasksSuppressions(); i_isolate_->thread_local_top()->DecrementCallDepth(this); } i::ValueHelper::InternalRepresentationType Isolate::GetDataFromSnapshotOnce( size_t index) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); auto list = i::Cast<i::FixedArray>(i_isolate->heap()->serialized_objects()); return GetSerializedDataFromFixedArray(i_isolate, list, index); } Local<Value> Isolate::GetContinuationPreservedEmbedderData() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); #ifdef V8_ENABLE_CONTINUATION_PRESERVED_EMBEDDER_DATA return ToApiHandle<Object>(i::direct_handle( i_isolate->isolate_data()->continuation_preserved_embedder_data(), i_isolate)); #else // V8_ENABLE_CONTINUATION_PRESERVED_EMBEDDER_DATA return v8::Undefined(reinterpret_cast<v8::Isolate*>(i_isolate)); #endif // V8_ENABLE_CONTINUATION_PRESERVED_EMBEDDER_DATA } void Isolate::SetContinuationPreservedEmbedderData(Local<Value> data) { #ifdef V8_ENABLE_CONTINUATION_PRESERVED_EMBEDDER_DATA i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); if (data.IsEmpty()) data = v8::Undefined(reinterpret_cast<v8::Isolate*>(this)); i_isolate->isolate_data()->set_continuation_preserved_embedder_data( *Utils::OpenDirectHandle(*data)); #endif // V8_ENABLE_CONTINUATION_PRESERVED_EMBEDDER_DATA } Local<Data> Isolate::GetContinuationPreservedEmbedderDataV2() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); #ifdef V8_ENABLE_CONTINUATION_PRESERVED_EMBEDDER_DATA return ToApiHandle<Data>(i::direct_handle( i_isolate->isolate_data()->continuation_preserved_embedder_data(), i_isolate)); #else // V8_ENABLE_CONTINUATION_PRESERVED_EMBEDDER_DATA return v8::Undefined(reinterpret_cast<v8::Isolate*>(i_isolate)); #endif // V8_ENABLE_CONTINUATION_PRESERVED_EMBEDDER_DATA } void Isolate::SetContinuationPreservedEmbedderDataV2(Local<Data> data) { #ifdef V8_ENABLE_CONTINUATION_PRESERVED_EMBEDDER_DATA i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); if (data.IsEmpty()) { data = v8::Undefined(reinterpret_cast<v8::Isolate*>(this)); } i_isolate->isolate_data()->set_continuation_preserved_embedder_data( *Utils::OpenDirectHandle(*data)); #endif // V8_ENABLE_CONTINUATION_PRESERVED_EMBEDDER_DATA } void Isolate::GetHeapStatistics(HeapStatistics* heap_statistics) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i::Heap* heap = i_isolate->heap(); // Embedder may call GetHeapStatistics() from any thread. Make sure to set the // TLS variable to *this. i::SetCurrentIsolateScope set_current_isolate(i_isolate); heap->FreeMainThreadLinearAllocationAreas(); // The order of acquiring memory statistics is important here. We query in // this order because of concurrent allocation: 1) used memory 2) committed // physical memory 3) committed memory. Therefore the condition used <= // committed physical <= committed should hold. heap_statistics->used_global_handles_size_ = heap->UsedGlobalHandlesSize(); heap_statistics->total_global_handles_size_ = heap->TotalGlobalHandlesSize(); DCHECK_LE(heap_statistics->used_global_handles_size_, heap_statistics->total_global_handles_size_); heap_statistics->used_heap_size_ = heap->SizeOfObjects(); heap_statistics->total_physical_size_ = heap->CommittedPhysicalMemory(); heap_statistics->total_heap_size_ = heap->CommittedMemory(); heap_statistics->total_available_size_ = heap->Available(); // TODO(dinfuehr): Right now used <= committed physical does not hold. Fix // this and add DCHECK. DCHECK_LE(heap_statistics->used_heap_size_, heap_statistics->total_heap_size_); heap_statistics->total_heap_size_executable_ = heap->CommittedMemoryExecutable(); heap_statistics->heap_size_limit_ = heap->MaxReserved(); // TODO(7424): There is no public API for the {WasmEngine} yet. Once such an // API becomes available we should report the malloced memory separately. For // now we just add the values, thereby over-approximating the peak slightly. heap_statistics->malloced_memory_ = i_isolate->allocator()->GetCurrentMemoryUsage() + i_isolate->string_table()->GetCurrentMemoryUsage(); // On 32-bit systems backing_store_bytes() might overflow size_t temporarily // due to concurrent array buffer sweeping. heap_statistics->external_memory_ = base::saturated_cast<size_t>(i_isolate->heap()->backing_store_bytes()); heap_statistics->peak_malloced_memory_ = i_isolate->allocator()->GetMaxMemoryUsage(); heap_statistics->number_of_native_contexts_ = heap->NumberOfNativeContexts(); heap_statistics->number_of_detached_contexts_ = heap->NumberOfDetachedContexts(); heap_statistics->total_allocated_bytes_ = heap->GetTotalAllocatedBytes(); heap_statistics->does_zap_garbage_ = i::heap::ShouldZapGarbage(); #if V8_ENABLE_WEBASSEMBLY heap_statistics->malloced_memory_ += i::wasm::GetWasmEngine()->allocator()->GetCurrentMemoryUsage(); heap_statistics->peak_malloced_memory_ += i::wasm::GetWasmEngine()->allocator()->GetMaxMemoryUsage(); #endif // V8_ENABLE_WEBASSEMBLY } size_t Isolate::NumberOfHeapSpaces() { return i::LAST_SPACE - i::FIRST_SPACE + 1; } bool Isolate::GetHeapSpaceStatistics(HeapSpaceStatistics* space_statistics, size_t index) { if (!space_statistics) return false; // Embedder may call GetHeapSpaceStatistics() from any thread. Make sure to // set the TLS variable to *this. i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i::SetCurrentIsolateScope set_current_isolate(i_isolate); const auto maybe_space = i::Heap::TryGetAllocationSpaceFromIndex(index); if (!maybe_space) { return false; } const i::AllocationSpace allocation_space = maybe_space.value(); i::Heap* heap = i_isolate->heap(); heap->FreeMainThreadLinearAllocationAreas(); space_statistics->space_name_ = i::ToString(allocation_space); if (allocation_space == i::RO_SPACE) { // Read-only space is shard across all isolates. Its statistics can be // retrieved using `V8::GetSharedMemoryStatistics()`. space_statistics->space_size_ = 0; space_statistics->space_used_size_ = 0; space_statistics->space_available_size_ = 0; space_statistics->physical_space_size_ = 0; } else { i::Space* space = heap->space(allocation_space); space_statistics->space_size_ = space ? space->CommittedMemory() : 0; space_statistics->space_used_size_ = space ? space->SizeOfObjects() : 0; space_statistics->space_available_size_ = space ? space->Available() : 0; space_statistics->physical_space_size_ = space ? space->CommittedPhysicalMemory() : 0; } return true; } size_t Isolate::NumberOfTrackedHeapObjectTypes() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i::Heap* heap = i_isolate->heap(); return heap->NumberOfTrackedHeapObjectTypes(); } bool Isolate::GetHeapObjectStatisticsAtLastGC( HeapObjectStatistics* object_statistics, size_t type_index) { if (!object_statistics) return false; if (V8_LIKELY(!i::TracingFlags::is_gc_stats_enabled())) return false; i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); // Embedder may call GetHeapObjectStatisticsAtLastGC() from any thread. Make // sure to set the TLS variable to *this. i::SetCurrentIsolateScope set_current_isolate(i_isolate); i::Heap* heap = i_isolate->heap(); if (type_index >= heap->NumberOfTrackedHeapObjectTypes()) return false; const char* object_type; const char* object_sub_type; size_t object_count = heap->ObjectCountAtLastGC(type_index); size_t object_size = heap->ObjectSizeAtLastGC(type_index); if (!heap->GetObjectTypeName(type_index, &object_type, &object_sub_type)) { // There should be no objects counted when the type is unknown. DCHECK_EQ(object_count, 0U); DCHECK_EQ(object_size, 0U); return false; } object_statistics->object_type_ = object_type; object_statistics->object_sub_type_ = object_sub_type; object_statistics->object_count_ = object_count; object_statistics->object_size_ = object_size; return true; } bool Isolate::GetHeapCodeAndMetadataStatistics( HeapCodeStatistics* code_statistics) { if (!code_statistics) return false; i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->heap()->CollectCodeStatistics(); code_statistics->code_and_metadata_size_ = i_isolate->code_and_metadata_size(); code_statistics->bytecode_and_metadata_size_ = i_isolate->bytecode_and_metadata_size(); code_statistics->external_script_source_size_ = i_isolate->external_script_source_size(); code_statistics->cpu_profiler_metadata_size_ = i::CpuProfiler::GetAllProfilersMemorySize(i_isolate); return true; } bool Isolate::MeasureMemory(std::unique_ptr<MeasureMemoryDelegate> delegate, MeasureMemoryExecution execution) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); return i_isolate->heap()->MeasureMemory(std::move(delegate), execution); } std::unique_ptr<MeasureMemoryDelegate> MeasureMemoryDelegate::Default( Isolate* v8_isolate, Local<Context> context, Local<Promise::Resolver> promise_resolver, MeasureMemoryMode mode) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); return i_isolate->heap()->CreateDefaultMeasureMemoryDelegate( context, promise_resolver, mode); } void Isolate::GetStackSample(const RegisterState& state, void** frames, size_t frames_limit, SampleInfo* sample_info) { RegisterState regs = state; i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); if (i::TickSample::GetStackSample(i_isolate, ®s, i::TickSample::kSkipCEntryFrame, frames, frames_limit, sample_info)) { return; } sample_info->frames_count = 0; sample_info->vm_state = OTHER; sample_info->external_callback_entry = nullptr; } int64_t Isolate::AdjustAmountOfExternalAllocatedMemory( int64_t change_in_bytes) { return AdjustAmountOfExternalAllocatedMemoryImpl(change_in_bytes); } void Isolate::SetEventLogger(LogEventCallback that) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->set_event_logger(that); } void Isolate::AddBeforeCallEnteredCallback(BeforeCallEnteredCallback callback) { if (callback == nullptr) return; i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->AddBeforeCallEnteredCallback(callback); } void Isolate::RemoveBeforeCallEnteredCallback( BeforeCallEnteredCallback callback) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->RemoveBeforeCallEnteredCallback(callback); } void Isolate::AddCallCompletedCallback(CallCompletedCallback callback) { if (callback == nullptr) return; i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->AddCallCompletedCallback(callback); } void Isolate::RemoveCallCompletedCallback(CallCompletedCallback callback) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->RemoveCallCompletedCallback(callback); } void Isolate::SetPromiseHook(PromiseHook hook) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->SetPromiseHook(hook); } void Isolate::SetPromiseRejectCallback(PromiseRejectCallback callback) { if (callback == nullptr) return; i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->SetPromiseRejectCallback(callback); } void Isolate::SetExceptionPropagationCallback( ExceptionPropagationCallback callback) { if (callback == nullptr) return; i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->SetExceptionPropagationCallback(callback); } void Isolate::PerformMicrotaskCheckpoint() { DCHECK_NE(MicrotasksPolicy::kScoped, GetMicrotasksPolicy()); i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->default_microtask_queue()->PerformCheckpoint(this); } void Isolate::EnqueueMicrotask(Local<Function> v8_function) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); auto function = Utils::OpenDirectHandle(*v8_function); i::DirectHandle<i::NativeContext> handler_context; if (!i::JSReceiver::GetContextForMicrotask(function).ToHandle( &handler_context)) handler_context = i_isolate->native_context(); MicrotaskQueue* microtask_queue = handler_context->microtask_queue(); if (microtask_queue) microtask_queue->EnqueueMicrotask(this, v8_function); } void Isolate::EnqueueMicrotask(MicrotaskCallback callback, void* data) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->default_microtask_queue()->EnqueueMicrotask(this, callback, data); } void Isolate::SetMicrotasksPolicy(MicrotasksPolicy policy) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->default_microtask_queue()->set_microtasks_policy(policy); } MicrotasksPolicy Isolate::GetMicrotasksPolicy() const { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(const_cast<Isolate*>(this)); return i_isolate->default_microtask_queue()->microtasks_policy(); } void Isolate::AddMicrotasksCompletedCallback( MicrotasksCompletedCallbackWithData callback, void* data) { DCHECK(callback); i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->default_microtask_queue()->AddMicrotasksCompletedCallback(callback, data); } void Isolate::RemoveMicrotasksCompletedCallback( MicrotasksCompletedCallbackWithData callback, void* data) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->default_microtask_queue()->RemoveMicrotasksCompletedCallback( callback, data); } void Isolate::SetUseCounterCallback(UseCounterCallback callback) { reinterpret_cast<i::Isolate*>(this)->SetUseCounterCallback(callback); } void Isolate::SetCounterFunction(CounterLookupCallback callback) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->counters()->ResetCounterFunction(callback); } void Isolate::SetCreateHistogramFunction(CreateHistogramCallback callback) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->counters()->ResetCreateHistogramFunction(callback); } void Isolate::SetAddHistogramSampleFunction( AddHistogramSampleCallback callback) { reinterpret_cast<i::Isolate*>(this) ->counters() ->SetAddHistogramSampleFunction(callback); } void Isolate::SetMetricsRecorder( const std::shared_ptr<metrics::Recorder>& metrics_recorder) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->metrics_recorder()->SetEmbedderRecorder(i_isolate, metrics_recorder); } void Isolate::SetAddCrashKeyCallback(AddCrashKeyCallback callback) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->SetAddCrashKeyCallback(callback); } void Isolate::SetCrashKeyStringCallbacks(AllocateCrashKeyStringCallback alloc, SetCrashKeyStringCallback set) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->SetCrashKeyStringCallbacks(alloc, set); } void Isolate::LowMemoryNotification() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); { i::NestedTimedHistogramScope idle_notification_scope( i_isolate->counters()->gc_low_memory_notification()); TRACE_EVENT0("v8", "V8.GCLowMemoryNotification"); i_isolate->heap()->CollectAllAvailableGarbage( i::GarbageCollectionReason::kLowMemoryNotification); } } int Isolate::ContextDisposedNotification(bool dependant_context) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); if (V8_UNLIKELY(i::v8_flags.trace_context_disposal)) { i_isolate->PrintWithTimestamp("[context-disposal] Disposing %s context\n", dependant_context ? "nested" : "top-level"); } #if V8_ENABLE_WEBASSEMBLY if (!dependant_context) { if (!i_isolate->context().is_null()) { // We left the current context, we can abort all WebAssembly compilations // of that context. // A handle scope for the native context. i::HandleScope handle_scope(i_isolate); i::wasm::GetWasmEngine()->DeleteCompileJobsOnContext( i_isolate->native_context()); } } #endif // V8_ENABLE_WEBASSEMBLY i_isolate->AbortConcurrentOptimization(i::BlockingBehavior::kDontBlock); return i_isolate->heap()->NotifyContextDisposed(dependant_context); } void Isolate::ContextDisposedNotification(ContextDependants dependants) { // TODO(mlippautz): Replace implementation with the old version of // ContextDisposedNotification() that still has a return parameter. START_ALLOW_USE_DEPRECATED() ContextDisposedNotification(dependants == ContextDependants::kSomeDependants); END_ALLOW_USE_DEPRECATED() } void Isolate::IsolateInForegroundNotification() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); return i_isolate->SetPriority(Priority::kUserBlocking); } void Isolate::IsolateInBackgroundNotification() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); return i_isolate->SetPriority(Priority::kBestEffort); } void Isolate::SetPriority(Priority priority) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); return i_isolate->SetPriority(priority); } void Isolate::MemoryPressureNotification(MemoryPressureLevel level) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); bool on_isolate_thread = i_isolate->was_locker_ever_used() ? i_isolate->thread_manager()->IsLockedByCurrentThread() : i::ThreadId::Current() == i_isolate->thread_id(); i_isolate->heap()->MemoryPressureNotification(level, on_isolate_thread); } void Isolate::SetBatterySaverMode(bool battery_saver_mode_enabled) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->set_battery_saver_mode_enabled(battery_saver_mode_enabled); } void Isolate::SetMemorySaverMode(bool memory_saver_mode_enabled) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->set_memory_saver_mode_enabled(memory_saver_mode_enabled); } void Isolate::ClearCachesForTesting() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->AbortConcurrentOptimization(i::BlockingBehavior::kBlock); i_isolate->ClearSerializerData(); i_isolate->compilation_cache()->Clear(); } void Isolate::SetIsLoading(bool is_loading) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->SetIsLoading(is_loading); } void Isolate::SetIsInputHandling(bool is_input_handling) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->SetIsInputHandling(is_input_handling); } void Isolate::Freeze(bool is_frozen) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->Freeze(is_frozen); } void Isolate::IncreaseHeapLimitForDebugging() { // No-op. } void Isolate::RestoreOriginalHeapLimit() { // No-op. } bool Isolate::IsHeapLimitIncreasedForDebugging() { return false; } void Isolate::SetJitCodeEventHandler(JitCodeEventOptions options, JitCodeEventHandler event_handler) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); // Ensure that logging is initialized for our isolate. i_isolate->InitializeLoggingAndCounters(); i_isolate->v8_file_logger()->SetCodeEventHandler(options, event_handler); } void Isolate::SetStackLimit(uintptr_t stack_limit) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); CHECK(stack_limit); i_isolate->stack_guard()->SetStackLimit(stack_limit); i_isolate->set_stack_size(base::Stack::GetStackStart() - stack_limit); } void Isolate::GetCodeRange(void** start, size_t* length_in_bytes) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); const base::AddressRegion& code_region = i_isolate->heap()->code_region(); *start = reinterpret_cast<void*>(code_region.begin()); *length_in_bytes = code_region.size(); } void Isolate::GetEmbeddedCodeRange(const void** start, size_t* length_in_bytes) { // Note, we should return the embedded code rande from the .text section here. i::EmbeddedData d = i::EmbeddedData::FromBlob(); *start = reinterpret_cast<const void*>(d.code()); *length_in_bytes = d.code_size(); } JSEntryStubs Isolate::GetJSEntryStubs() { JSEntryStubs entry_stubs; i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); std::array<std::pair<i::Builtin, JSEntryStub*>, 3> stubs = { {{i::Builtin::kJSEntry, &entry_stubs.js_entry_stub}, {i::Builtin::kJSConstructEntry, &entry_stubs.js_construct_entry_stub}, {i::Builtin::kJSRunMicrotasksEntry, &entry_stubs.js_run_microtasks_entry_stub}}}; for (auto& pair : stubs) { i::Tagged<i::Code> js_entry = i_isolate->builtins()->code(pair.first); pair.second->code.start = reinterpret_cast<const void*>(js_entry->instruction_start()); pair.second->code.length_in_bytes = js_entry->instruction_size(); } return entry_stubs; } size_t Isolate::CopyCodePages(size_t capacity, MemoryRange* code_pages_out) { #if !defined(V8_TARGET_ARCH_64_BIT) && !defined(V8_TARGET_ARCH_ARM) // Not implemented on other platforms. UNREACHABLE(); #else i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); std::vector<MemoryRange>* code_pages = i_isolate->GetCodePages(); DCHECK_NOT_NULL(code_pages); // Copy as many elements into the output vector as we can. If the // caller-provided buffer is not big enough, we fill it, and the caller can // provide a bigger one next time. We do it this way because allocation is not // allowed in signal handlers. size_t limit = std::min(capacity, code_pages->size()); for (size_t i = 0; i < limit; i++) { code_pages_out[i] = code_pages->at(i); } return code_pages->size(); #endif } #define CALLBACK_SETTER(ExternalName, Type, InternalName) \ void Isolate::Set##ExternalName(Type callback) { \ i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); \ i_isolate->set_##InternalName(callback); \ } CALLBACK_SETTER(FatalErrorHandler, FatalErrorCallback, exception_behavior) CALLBACK_SETTER(ModifyCodeGenerationFromStringsCallback, ModifyCodeGenerationFromStringsCallback2, modify_code_gen_callback) CALLBACK_SETTER(AllowWasmCodeGenerationCallback, AllowWasmCodeGenerationCallback, allow_wasm_code_gen_callback) CALLBACK_SETTER(WasmModuleCallback, ExtensionCallback, wasm_module_callback) CALLBACK_SETTER(WasmInstanceCallback, ExtensionCallback, wasm_instance_callback) CALLBACK_SETTER(WasmStreamingCallback, WasmStreamingCallback, wasm_streaming_callback) CALLBACK_SETTER(WasmAsyncResolvePromiseCallback, WasmAsyncResolvePromiseCallback, wasm_async_resolve_promise_callback) CALLBACK_SETTER(WasmLoadSourceMapCallback, WasmLoadSourceMapCallback, wasm_load_source_map_callback) CALLBACK_SETTER(WasmCustomDescriptorsEnabledCallback, WasmCustomDescriptorsEnabledCallback, wasm_custom_descriptors_enabled_callback) CALLBACK_SETTER(SharedArrayBufferConstructorEnabledCallback, SharedArrayBufferConstructorEnabledCallback, sharedarraybuffer_constructor_enabled_callback) CALLBACK_SETTER(IsJSApiWrapperNativeErrorCallback, IsJSApiWrapperNativeErrorCallback, is_js_api_wrapper_native_error_callback) void Isolate::InstallConditionalFeatures(Local<Context> context) { v8::HandleScope handle_scope(this); v8::Context::Scope context_scope(context); i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); if (i_isolate->is_execution_terminating()) return; i_isolate->InstallConditionalFeatures(Utils::OpenDirectHandle(*context)); if (i_isolate->has_exception()) return; #if V8_ENABLE_WEBASSEMBLY i::WasmJs::InstallConditionalFeatures(i_isolate, Utils::OpenDirectHandle(*context)); #endif // V8_ENABLE_WEBASSEMBLY } void Isolate::SetOOMErrorHandler(OOMErrorCallback callback) { void* data = reinterpret_cast<void*>(callback); SetOOMErrorHandler( [](const char* location, const OOMDetails& details, void* data) { reinterpret_cast<OOMErrorCallback>(data)(location, details); }, data); } void Isolate::SetOOMErrorHandler(OOMErrorCallbackWithData callback, void* data) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->set_oom_behavior(callback); i_isolate->set_oom_callback_data(data); } void Isolate::AddNearHeapLimitCallback(v8::NearHeapLimitCallback callback, void* data) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->heap()->AddNearHeapLimitCallback(callback, data); } void Isolate::RemoveNearHeapLimitCallback(v8::NearHeapLimitCallback callback, size_t heap_limit) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->heap()->RemoveNearHeapLimitCallback(callback, heap_limit); } void Isolate::AutomaticallyRestoreInitialHeapLimit(double threshold_percent) { DCHECK_GT(threshold_percent, 0.0); DCHECK_LT(threshold_percent, 1.0); i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->heap()->AutomaticallyRestoreInitialHeapLimit(threshold_percent); } bool Isolate::IsDead() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); return i_isolate->IsDead(); } bool Isolate::AddMessageListener(MessageCallback callback, Local<Value> data) { return AddMessageListenerWithErrorLevel(callback, kMessageError, data); } bool Isolate::AddMessageListenerWithErrorLevel(MessageCallback callback, int message_levels, Local<Value> data) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::HandleScope scope(i_isolate); i::DirectHandle<i::ArrayList> list = i_isolate->factory()->message_listeners(); i::DirectHandle<i::FixedArray> listener = i_isolate->factory()->NewFixedArray(3); i::DirectHandle<i::Object> callback_obj = FromCData<internal::kMessageListenerTag>(i_isolate, callback); listener->set(0, *callback_obj); listener->set(1, data.IsEmpty() ? i::ReadOnlyRoots(i_isolate).undefined_value() : *Utils::OpenDirectHandle(*data)); listener->set(2, i::Smi::FromInt(message_levels)); list = i::ArrayList::Add(i_isolate, list, listener); i_isolate->heap()->SetMessageListeners(*list); return true; } void Isolate::RemoveMessageListeners(MessageCallback callback) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::HandleScope scope(i_isolate); i::DisallowGarbageCollection no_gc; i::Tagged<i::ArrayList> listeners = i_isolate->heap()->message_listeners(); i::ReadOnlyRoots roots(i_isolate); for (int i = 0; i < listeners->length(); i++) { if (i::IsUndefined(listeners->get(i), roots)) { continue; // skip deleted ones } i::Tagged<i::FixedArray> listener = i::Cast<i::FixedArray>(listeners->get(i)); v8::MessageCallback cur_callback = v8::ToCData<v8::MessageCallback, i::kMessageListenerTag>( i_isolate, listener->get(0)); if (cur_callback == callback) { listeners->set(i, roots.undefined_value()); } } } void Isolate::SetFailedAccessCheckCallbackFunction( FailedAccessCheckCallback callback) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->SetFailedAccessCheckCallback(callback); } void Isolate::SetCaptureStackTraceForUncaughtExceptions( bool capture, int frame_limit, StackTrace::StackTraceOptions options) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->SetCaptureStackTraceForUncaughtExceptions(capture, frame_limit, options); } bool Isolate::IsInUse() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); return i_isolate->IsInUse(); } void Isolate::SetAllowAtomicsWait(bool allow) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->set_allow_atomics_wait(allow); } void v8::Isolate::DateTimeConfigurationChangeNotification( TimeZoneDetection time_zone_detection) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); ApiRuntimeCallStatsScope rcs_scope( i_isolate, RCCId::kAPI_Isolate_DateTimeConfigurationChangeNotification); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i_isolate->date_cache()->ResetDateCache( static_cast<base::TimezoneCache::TimeZoneDetection>(time_zone_detection)); i_isolate->IncreaseDateCacheStampAndInvalidateProtector(); #ifdef V8_INTL_SUPPORT i_isolate->clear_cached_icu_object( i::Isolate::ICUObjectCacheType::kDefaultSimpleDateFormat); i_isolate->clear_cached_icu_object( i::Isolate::ICUObjectCacheType::kDefaultSimpleDateFormatForTime); i_isolate->clear_cached_icu_object( i::Isolate::ICUObjectCacheType::kDefaultSimpleDateFormatForDate); #endif // V8_INTL_SUPPORT } void v8::Isolate::LocaleConfigurationChangeNotification() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); ApiRuntimeCallStatsScope rcs_scope( i_isolate, RCCId::kAPI_Isolate_LocaleConfigurationChangeNotification); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); #ifdef V8_INTL_SUPPORT i_isolate->ResetDefaultLocale(); #endif // V8_INTL_SUPPORT } std::string Isolate::GetDefaultLocale() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); #ifdef V8_INTL_SUPPORT return i_isolate->DefaultLocale(); #else return std::string(); #endif } Maybe<std::string> Isolate::ValidateAndCanonicalizeUnicodeLocaleId( std::string_view tag) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); EnterV8NoScriptScope<> api_scope{ i_isolate, RCCId::kAPI_Isolate_ValidateAndCanonicalizeUnicodeLocaleId}; #ifdef V8_INTL_SUPPORT return i::Intl::ValidateAndCanonicalizeUnicodeLocaleId(i_isolate, tag); #else THROW_NEW_ERROR( i_isolate, NewRangeError(i::MessageTemplate::kInvalidLanguageTag, i_isolate->factory()->NewStringFromAsciiChecked(tag))); #endif } uint64_t Isolate::GetHashSeed() { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); return i::HashSeed(i_isolate).seed(); } #if defined(V8_ENABLE_ETW_STACK_WALKING) void Isolate::SetFilterETWSessionByURLCallback( FilterETWSessionByURLCallback callback) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->SetFilterETWSessionByURLCallback(callback); } void Isolate::SetFilterETWSessionByURL2Callback( FilterETWSessionByURL2Callback callback) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(this); i_isolate->SetFilterETWSessionByURL2Callback(callback); } #endif // V8_ENABLE_ETW_STACK_WALKING bool v8::Object::IsCodeLike(v8::Isolate* v8_isolate) const { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_Object_IsCodeLike); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::HandleScope scope(i_isolate); return Utils::OpenDirectHandle(this)->IsCodeLike(i_isolate); } // static std::unique_ptr<MicrotaskQueue> MicrotaskQueue::New(Isolate* v8_isolate, MicrotasksPolicy policy) { auto microtask_queue = i::MicrotaskQueue::New(reinterpret_cast<i::Isolate*>(v8_isolate)); microtask_queue->set_microtasks_policy(policy); std::unique_ptr<MicrotaskQueue> ret(std::move(microtask_queue)); return ret; } MicrotasksScope::MicrotasksScope(Local<Context> v8_context, MicrotasksScope::Type type) : MicrotasksScope(v8::Isolate::GetCurrent(), v8_context->GetMicrotaskQueue(), type) {} MicrotasksScope::MicrotasksScope(Isolate* v8_isolate, MicrotaskQueue* microtask_queue, MicrotasksScope::Type type) : i_isolate_(reinterpret_cast<i::Isolate*>(v8_isolate)), microtask_queue_(microtask_queue ? static_cast<i::MicrotaskQueue*>(microtask_queue) : i_isolate_->default_microtask_queue()), run_(type == MicrotasksScope::kRunMicrotasks) { if (run_) microtask_queue_->IncrementMicrotasksScopeDepth(); #ifdef DEBUG if (!run_) microtask_queue_->IncrementDebugMicrotasksScopeDepth(); #endif } MicrotasksScope::~MicrotasksScope() { if (run_) { microtask_queue_->DecrementMicrotasksScopeDepth(); if (MicrotasksPolicy::kScoped == microtask_queue_->microtasks_policy() && !i_isolate_->has_exception()) { microtask_queue_->PerformCheckpoint( reinterpret_cast<Isolate*>(i_isolate_)); DCHECK_IMPLIES(i_isolate_->has_exception(), i_isolate_->is_execution_terminating()); } } #ifdef DEBUG if (!run_) microtask_queue_->DecrementDebugMicrotasksScopeDepth(); #endif } // static void MicrotasksScope::PerformCheckpoint(Isolate* v8_isolate) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); auto* microtask_queue = i_isolate->default_microtask_queue(); microtask_queue->PerformCheckpoint(v8_isolate); } // static int MicrotasksScope::GetCurrentDepth(Isolate* v8_isolate) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); auto* microtask_queue = i_isolate->default_microtask_queue(); return microtask_queue->GetMicrotasksScopeDepth(); } // static bool MicrotasksScope::IsRunningMicrotasks(Isolate* v8_isolate) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); auto* microtask_queue = i_isolate->default_microtask_queue(); return microtask_queue->IsRunningMicrotasks(); } String::Utf8Value::Utf8Value(v8::Isolate* v8_isolate, v8::Local<v8::Value> obj) : str_(nullptr), length_(0) { if (obj.IsEmpty()) return; i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); Local<Context> context = v8_isolate->GetCurrentContext(); EnterV8BasicScope api_scope(i_isolate); i::HandleScope scope(i_isolate); TryCatch try_catch(v8_isolate); Local<String> str; if (!obj->ToString(context).ToLocal(&str)) return; length_ = str->Utf8LengthV2(v8_isolate); str_ = i::NewArray<char>(length_ + 1); int flags = String::WriteFlags::kNullTerminate | String::WriteFlags::kReplaceInvalidUtf8; str->WriteUtf8V2(v8_isolate, str_, length_ + 1, flags); } String::Utf8Value::~Utf8Value() { i::DeleteArray(str_); } String::Value::Value(v8::Isolate* v8_isolate, v8::Local<v8::Value> obj) : str_(nullptr), length_(0) { if (obj.IsEmpty()) return; i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i::HandleScope scope(i_isolate); Local<Context> context = v8_isolate->GetCurrentContext(); EnterV8BasicScope api_scope(i_isolate); TryCatch try_catch(v8_isolate); Local<String> str; if (!obj->ToString(context).ToLocal(&str)) return; length_ = str->Length(); str_ = i::NewArray<uint16_t>(length_ + 1); str->WriteV2(v8_isolate, 0, length_, str_, String::WriteFlags::kNullTerminate); } String::Value::~Value() { i::DeleteArray(str_); } String::ValueView::ValueView(v8::Isolate* v8_isolate, v8::Local<v8::String> str) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); i::DirectHandle<i::String> i_str = Utils::OpenDirectHandle(*str); // If the underlying string is flat, we can access its content directly. // Otherwise, we need to create a handle scope to flatten the string. if (i_str->IsFlat()) { i::DisallowGarbageCollectionInRelease* no_gc = new (no_gc_debug_scope_) i::DisallowGarbageCollectionInRelease(); i::String::FlatContent flat_content = i_str->GetFlatContent(*no_gc); flat_str_ = str; is_one_byte_ = flat_content.IsOneByte(); length_ = flat_content.length(); if (is_one_byte_) { data8_ = flat_content.ToOneByteVector().data(); } else { data16_ = flat_content.ToUC16Vector().data(); } } else { i::HandleScope scope(i_isolate); i::DirectHandle<i::String> i_flat_str = i::String::Flatten(i_isolate, i_str); flat_str_ = Utils::ToLocal(i_flat_str); i::DisallowGarbageCollectionInRelease* no_gc = new (no_gc_debug_scope_) i::DisallowGarbageCollectionInRelease(); i::String::FlatContent flat_content = i_flat_str->GetFlatContent(*no_gc); DCHECK(flat_content.IsFlat()); is_one_byte_ = flat_content.IsOneByte(); length_ = flat_content.length(); if (is_one_byte_) { data8_ = flat_content.ToOneByteVector().data(); } else { data16_ = flat_content.ToUC16Vector().data(); } } } String::ValueView::~ValueView() { using i::DisallowGarbageCollectionInRelease; DisallowGarbageCollectionInRelease* no_gc = reinterpret_cast<DisallowGarbageCollectionInRelease*>(no_gc_debug_scope_); no_gc->~DisallowGarbageCollectionInRelease(); } void String::ValueView::CheckOneByte(bool is_one_byte) const { if (is_one_byte) { Utils::ApiCheck(is_one_byte_, "v8::String::ValueView::data8", "Called the one-byte accessor on a two-byte string view."); } else { Utils::ApiCheck(!is_one_byte_, "v8::String::ValueView::data16", "Called the two-byte accessor on a one-byte string view."); } } #define DEFINE_ERROR(NAME, name) \ Local<Value> Exception::NAME(v8::Local<v8::String> raw_message, \ v8::Local<v8::Value> raw_options) { \ i::Isolate* i_isolate = i::Isolate::Current(); \ ApiRuntimeCallStatsScope rcs_scope(i_isolate, RCCId::kAPI_##NAME##_New); \ EnterV8NoScriptNoExceptionScope api_scope(i_isolate); \ i::Tagged<i::Object> error; \ { \ i::HandleScope scope(i_isolate); \ i::DirectHandle<i::Object> options; \ if (!raw_options.IsEmpty()) { \ options = Utils::OpenDirectHandle(*raw_options); \ } \ auto message = Utils::OpenDirectHandle(*raw_message); \ i::DirectHandle<i::JSFunction> constructor = \ i_isolate->name##_function(); \ error = *i_isolate->factory()->NewError(constructor, message, options); \ } \ return Utils::ToLocal(i::direct_handle(error, i_isolate)); \ } DEFINE_ERROR(RangeError, range_error) DEFINE_ERROR(ReferenceError, reference_error) DEFINE_ERROR(SyntaxError, syntax_error) DEFINE_ERROR(TypeError, type_error) DEFINE_ERROR(WasmCompileError, wasm_compile_error) DEFINE_ERROR(WasmLinkError, wasm_link_error) DEFINE_ERROR(WasmRuntimeError, wasm_runtime_error) DEFINE_ERROR(WasmSuspendError, wasm_suspend_error) DEFINE_ERROR(Error, error) #undef DEFINE_ERROR Local<Message> Exception::CreateMessage(Isolate* v8_isolate, Local<Value> exception) { auto obj = Utils::OpenHandle(*exception); i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(v8_isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); i::HandleScope scope(i_isolate); return Utils::MessageToLocal( scope.CloseAndEscape(i_isolate->CreateMessage(obj, nullptr))); } Local<StackTrace> Exception::GetStackTrace(Local<Value> exception) { auto obj = Utils::OpenDirectHandle(*exception); if (!IsJSObject(*obj)) return {}; auto js_obj = i::Cast<i::JSObject>(obj); i::Isolate* i_isolate = i::Isolate::Current(); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); auto stack_trace = i_isolate->GetDetailedStackTrace(js_obj); return Utils::StackTraceToLocal(stack_trace); } Maybe<bool> Exception::CaptureStackTrace(Local<Context> context, Local<Object> object) { auto i_isolate = i::Isolate::Current(); EnterV8NoScriptScope<> api_scope{i_isolate, context, RCCId::kAPI_Exception_CaptureStackTrace}; auto obj = Utils::OpenHandle(*object); if (!IsJSObject(*obj)) return Just(false); auto js_obj = i::Cast<i::JSObject>(obj); i::FrameSkipMode mode = i::FrameSkipMode::SKIP_FIRST; auto result = i::ErrorUtils::CaptureStackTrace(i_isolate, js_obj, mode, {}); i::DirectHandle<i::Object> handle; if (!result.ToHandle(&handle)) return {}; return Just(true); } v8::MaybeLocal<v8::Array> v8::Object::PreviewEntries(bool* is_key_value) { auto object = Utils::OpenDirectHandle(this); i::Isolate* i_isolate = i::Isolate::Current(); if (i_isolate->is_execution_terminating()) return {}; if (IsMap()) { *is_key_value = true; return Map::Cast(this)->AsArray(); } if (IsSet()) { *is_key_value = false; return Set::Cast(this)->AsArray(); } Isolate* v8_isolate = reinterpret_cast<Isolate*>(i_isolate); EnterV8NoScriptNoExceptionScope api_scope(i_isolate); if (i::IsJSWeakCollection(*object)) { *is_key_value = IsJSWeakMap(*object); return Utils::ToLocal(i::JSWeakCollection::GetEntries( i::Cast<i::JSWeakCollection>(object), 0)); } if (i::IsJSMapIterator(*object)) { auto it = i::Cast<i::JSMapIterator>(object); MapAsArrayKind const kind = static_cast<MapAsArrayKind>(it->map()->instance_type()); *is_key_value = kind == MapAsArrayKind::kEntries; if (!it->HasMore()) return v8::Array::New(v8_isolate); return Utils::ToLocal( MapAsArray(i_isolate, it->table(), i::Smi::ToInt(it->index()), kind)); } if (i::IsJSSetIterator(*object)) { auto it = i::Cast<i::JSSetIterator>(object); SetAsArrayKind const kind = static_cast<SetAsArrayKind>(it->map()->instance_type()); *is_key_value = kind == SetAsArrayKind::kEntries; if (!it->HasMore()) return v8::Array::New(v8_isolate); return Utils::ToLocal( SetAsArray(i_isolate, it->table(), i::Smi::ToInt(it->index()), kind)); } return {}; } Local<String> CpuProfileNode::GetFunctionName() const { const i::ProfileNode* node = reinterpret_cast<const i::ProfileNode*>(this); i::Isolate* i_isolate = node->isolate(); const i::CodeEntry* entry = node->entry(); i::DirectHandle<i::String> name = i_isolate->factory()->InternalizeUtf8String(entry->name()); return ToApiHandle<String>(name); } const char* CpuProfileNode::GetFunctionNameStr() const { const i::ProfileNode* node = reinterpret_cast<const i::ProfileNode*>(this); return node->entry()->name(); } int CpuProfileNode::GetScriptId() const { const i::ProfileNode* node = reinterpret_cast<const i::ProfileNode*>(this); const i::CodeEntry* entry = node->entry(); return entry->script_id(); } Local<String> CpuProfileNode::GetScriptResourceName() const { const i::ProfileNode* node = reinterpret_cast<const i::ProfileNode*>(this); i::Isolate* i_isolate = node->isolate(); return ToApiHandle<String>(i_isolate->factory()->InternalizeUtf8String( node->entry()->resource_name())); } const char* CpuProfileNode::GetScriptResourceNameStr() const { const i::ProfileNode* node = reinterpret_cast<const i::ProfileNode*>(this); return node->entry()->resource_name(); } bool CpuProfileNode::IsScriptSharedCrossOrigin() const { const i::ProfileNode* node = reinterpret_cast<const i::ProfileNode*>(this); return node->entry()->is_shared_cross_origin(); } int CpuProfileNode::GetLineNumber() const { return reinterpret_cast<const i::ProfileNode*>(this)->line_and_column().line; } int CpuProfileNode::GetColumnNumber() const { return reinterpret_cast<const i::ProfileNode*>(this) ->line_and_column() .column; } unsigned int CpuProfileNode::GetHitLineCount() const { const i::ProfileNode* node = reinterpret_cast<const i::ProfileNode*>(this); return node->GetHitLineCount(); } bool CpuProfileNode::GetLineTicks(LineTick* entries, unsigned int length) const { const i::ProfileNode* node = reinterpret_cast<const i::ProfileNode*>(this); return node->GetLineTicks(entries, length); } const char* CpuProfileNode::GetBailoutReason() const { const i::ProfileNode* node = reinterpret_cast<const i::ProfileNode*>(this); return node->entry()->bailout_reason(); } unsigned CpuProfileNode::GetHitCount() const { return reinterpret_cast<const i::ProfileNode*>(this)->self_ticks(); } unsigned CpuProfileNode::GetNodeId() const { return reinterpret_cast<const i::ProfileNode*>(this)->id(); } CpuProfileNode::SourceType CpuProfileNode::GetSourceType() const { return reinterpret_cast<const i::ProfileNode*>(this)->source_type(); } int CpuProfileNode::GetChildrenCount() const { return static_cast<int>( reinterpret_cast<const i::ProfileNode*>(this)->children()->size()); } const CpuProfileNode* CpuProfileNode::GetChild(int index) const { const i::ProfileNode* child = reinterpret_cast<const i::ProfileNode*>(this)->children()->at(index); return reinterpret_cast<const CpuProfileNode*>(child); } const CpuProfileNode* CpuProfileNode::GetParent() const { const i::ProfileNode* parent = reinterpret_cast<const i::ProfileNode*>(this)->parent(); return reinterpret_cast<const CpuProfileNode*>(parent); } const std::vector<CpuProfileDeoptInfo>& CpuProfileNode::GetDeoptInfos() const { const i::ProfileNode* node = reinterpret_cast<const i::ProfileNode*>(this); return node->deopt_infos(); } void CpuProfile::Delete() { i::CpuProfile* profile = reinterpret_cast<i::CpuProfile*>(this); i::CpuProfiler* profiler = profile->cpu_profiler(); DCHECK_NOT_NULL(profiler); profiler->DeleteProfile(profile); } Local<String> CpuProfile::GetTitle() const { const i::CpuProfile* profile = reinterpret_cast<const i::CpuProfile*>(this); i::Isolate* i_isolate = profile->top_down()->isolate(); return ToApiHandle<String>( i_isolate->factory()->InternalizeUtf8String(profile->title())); } const CpuProfileNode* CpuProfile::GetTopDownRoot() const { const i::CpuProfile* profile = reinterpret_cast<const i::CpuProfile*>(this); return reinterpret_cast<const CpuProfileNode*>(profile->top_down()->root()); } const CpuProfileNode* CpuProfile::GetSample(int index) const { const i::CpuProfile* profile = reinterpret_cast<const i::CpuProfile*>(this); return reinterpret_cast<const CpuProfileNode*>(profile->sample(index).node); } const int CpuProfileNode::kNoLineNumberInfo; const int CpuProfileNode::kNoColumnNumberInfo; int64_t CpuProfile::GetSampleTimestamp(int index) const { const i::CpuProfile* profile = reinterpret_cast<const i::CpuProfile*>(this); return profile->sample(index).timestamp.since_origin().InMicroseconds(); } StateTag CpuProfile::GetSampleState(int index) const { const i::CpuProfile* profile = reinterpret_cast<const i::CpuProfile*>(this); return profile->sample(index).state_tag; } EmbedderStateTag CpuProfile::GetSampleEmbedderState(int index) const { const i::CpuProfile* profile = reinterpret_cast<const i::CpuProfile*>(this); return profile->sample(index).embedder_state_tag; } int64_t CpuProfile::GetStartTime() const { const i::CpuProfile* profile = reinterpret_cast<const i::CpuProfile*>(this); return profile->start_time().since_origin().InMicroseconds(); } int64_t CpuProfile::GetEndTime() const { const i::CpuProfile* profile = reinterpret_cast<const i::CpuProfile*>(this); return profile->end_time().since_origin().InMicroseconds(); } static i::CpuProfile* ToInternal(const CpuProfile* profile) { return const_cast<i::CpuProfile*>( reinterpret_cast<const i::CpuProfile*>(profile)); } void CpuProfile::Serialize(OutputStream* stream, CpuProfile::SerializationFormat format) const { Utils::ApiCheck(format == kJSON, "v8::CpuProfile::Serialize", "Unknown serialization format"); Utils::ApiCheck(stream->GetChunkSize() > 0, "v8::CpuProfile::Serialize", "Invalid stream chunk size"); i::CpuProfileJSONSerializer serializer(ToInternal(this)); serializer.Serialize(stream); } int CpuProfile::GetSamplesCount() const { return reinterpret_cast<const i::CpuProfile*>(this)->samples_count(); } CpuProfiler* CpuProfiler::New(Isolate* v8_isolate, CpuProfilingNamingMode naming_mode, CpuProfilingLoggingMode logging_mode) { return reinterpret_cast<CpuProfiler*>(new i::CpuProfiler( reinterpret_cast<i::Isolate*>(v8_isolate), naming_mode, logging_mode)); } CpuProfilingOptions::CpuProfilingOptions(CpuProfilingMode mode, unsigned max_samples, int sampling_interval_us, MaybeLocal<Context> filter_context, CpuProfileSource profile_source) : mode_(mode), max_samples_(max_samples), sampling_interval_us_(sampling_interval_us), profile_source_(profile_source) { if (!filter_context.IsEmpty()) { Local<Context> local_filter_context = filter_context.ToLocalChecked(); filter_context_.Reset(v8::Isolate::GetCurrent(), local_filter_context); filter_context_.SetWeak(); } } void* CpuProfilingOptions::raw_filter_context() const { return reinterpret_cast<void*>( i::Cast<i::Context>(*Utils::OpenPersistent(filter_context_)) ->native_context() .address()); } void CpuProfiler::Dispose() { delete reinterpret_cast<i::CpuProfiler*>(this); } // static // |trace_id| is an optional identifier stored in the sample record used // to associate the sample with a trace event. void CpuProfiler::CollectSample(Isolate* v8_isolate, const std::optional<uint64_t> trace_id) { i::CpuProfiler::CollectSample(reinterpret_cast<i::Isolate*>(v8_isolate), trace_id); } void CpuProfiler::SetSamplingInterval(int us) { DCHECK_GE(us, 0); return reinterpret_cast<i::CpuProfiler*>(this)->set_sampling_interval( base::TimeDelta::FromMicroseconds(us)); } void CpuProfiler::SetUsePreciseSampling(bool use_precise_sampling) { reinterpret_cast<i::CpuProfiler*>(this)->set_use_precise_sampling( use_precise_sampling); } CpuProfilingResult CpuProfiler::Start( CpuProfilingOptions options, std::unique_ptr<DiscardedSamplesDelegate> delegate) { return reinterpret_cast<i::CpuProfiler*>(this)->StartProfiling( std::move(options), std::move(delegate)); } CpuProfilingResult CpuProfiler::Start( Local<String> title, CpuProfilingOptions options, std::unique_ptr<DiscardedSamplesDelegate> delegate) { return reinterpret_cast<i::CpuProfiler*>(this)->StartProfiling( *Utils::OpenDirectHandle(*title), std::move(options), std::move(delegate)); } CpuProfilingResult CpuProfiler::Start(Local<String> title, bool record_samples) { CpuProfilingOptions options( kLeafNodeLineNumbers, record_samples ? CpuProfilingOptions::kNoSampleLimit : 0); return reinterpret_cast<i::CpuProfiler*>(this)->StartProfiling( *Utils::OpenDirectHandle(*title), std::move(options)); } CpuProfilingResult CpuProfiler::Start(Local<String> title, CpuProfilingMode mode, bool record_samples, unsigned max_samples) { CpuProfilingOptions options(mode, record_samples ? max_samples : 0); return reinterpret_cast<i::CpuProfiler*>(this)->StartProfiling( *Utils::OpenDirectHandle(*title), std::move(options)); } CpuProfilingStatus CpuProfiler::StartProfiling( Local<String> title, CpuProfilingOptions options, std::unique_ptr<DiscardedSamplesDelegate> delegate) { return Start(title, std::move(options), std::move(delegate)).status; } CpuProfilingStatus CpuProfiler::StartProfiling(Local<String> title, bool record_samples) { return Start(title, record_samples).status; } CpuProfilingStatus CpuProfiler::StartProfiling(Local<String> title, CpuProfilingMode mode, bool record_samples, unsigned max_samples) { return Start(title, mode, record_samples, max_samples).status; } CpuProfile* CpuProfiler::StopProfiling(Local<String> title) { return reinterpret_cast<CpuProfile*>( reinterpret_cast<i::CpuProfiler*>(this)->StopProfiling( *Utils::OpenDirectHandle(*title))); } CpuProfile* CpuProfiler::Stop(ProfilerId id) { return reinterpret_cast<CpuProfile*>( reinterpret_cast<i::CpuProfiler*>(this)->StopProfiling(id)); } void CpuProfiler::UseDetailedSourcePositionsForProfiling(Isolate* v8_isolate) { reinterpret_cast<i::Isolate*>(v8_isolate) ->SetDetailedSourcePositionsForProfiling(true); } uintptr_t CodeEvent::GetCodeStartAddress() { return reinterpret_cast<i::CodeEvent*>(this)->code_start_address; } size_t CodeEvent::GetCodeSize() { return reinterpret_cast<i::CodeEvent*>(this)->code_size; } Local<String> CodeEvent::GetFunctionName() { return ToApiHandle<String>( reinterpret_cast<i::CodeEvent*>(this)->function_name); } Local<String> CodeEvent::GetScriptName() { return ToApiHandle<String>( reinterpret_cast<i::CodeEvent*>(this)->script_name); } int CodeEvent::GetScriptLine() { return reinterpret_cast<i::CodeEvent*>(this)->script_line; } int CodeEvent::GetScriptColumn() { return reinterpret_cast<i::CodeEvent*>(this)->script_column; } CodeEventType CodeEvent::GetCodeType() { return reinterpret_cast<i::CodeEvent*>(this)->code_type; } const char* CodeEvent::GetComment() { return reinterpret_cast<i::CodeEvent*>(this)->comment; } uintptr_t CodeEvent::GetPreviousCodeStartAddress() { return reinterpret_cast<i::CodeEvent*>(this)->previous_code_start_address; } const char* CodeEvent::GetCodeEventTypeName(CodeEventType code_event_type) { switch (code_event_type) { case kUnknownType: return "Unknown"; #define V(Name) \ case k##Name##Type: \ return #Name; CODE_EVENTS_LIST(V) #undef V } // The execution should never pass here UNREACHABLE(); } CodeEventHandler::CodeEventHandler(Isolate* v8_isolate) { internal_listener_ = new i::ExternalLogEventListener( reinterpret_cast<i::Isolate*>(v8_isolate)); } CodeEventHandler::~CodeEventHandler() { delete reinterpret_cast<i::ExternalLogEventListener*>(internal_listener_); } void CodeEventHandler::Enable() { reinterpret_cast<i::ExternalLogEventListener*>(internal_listener_) ->StartListening(this); } void CodeEventHandler::Disable() { reinterpret_cast<i::ExternalLogEventListener*>(internal_listener_) ->StopListening(); } static i::HeapGraphEdge* ToInternal(const HeapGraphEdge* edge) { return const_cast<i::HeapGraphEdge*>( reinterpret_cast<const i::HeapGraphEdge*>(edge)); } HeapGraphEdge::Type HeapGraphEdge::GetType() const { return static_cast<HeapGraphEdge::Type>(ToInternal(this)->type()); } Local<Value> HeapGraphEdge::GetName() const { i::HeapGraphEdge* edge = ToInternal(this); i::Isolate* i_isolate = edge->isolate(); switch (edge->type()) { case i::HeapGraphEdge::kContextVariable: case i::HeapGraphEdge::kInternal: case i::HeapGraphEdge::kProperty: case i::HeapGraphEdge::kShortcut: case i::HeapGraphEdge::kWeak: return ToApiHandle<String>( i_isolate->factory()->InternalizeUtf8String(edge->name())); case i::HeapGraphEdge::kElement: case i::HeapGraphEdge::kHidden: return ToApiHandle<Number>( i_isolate->factory()->NewNumberFromInt(edge->index())); default: UNREACHABLE(); } } const HeapGraphNode* HeapGraphEdge::GetFromNode() const { const i::HeapEntry* from = ToInternal(this)->from(); return reinterpret_cast<const HeapGraphNode*>(from); } const HeapGraphNode* HeapGraphEdge::GetToNode() const { const i::HeapEntry* to = ToInternal(this)->to(); return reinterpret_cast<const HeapGraphNode*>(to); } static i::HeapEntry* ToInternal(const HeapGraphNode* entry) { return const_cast<i::HeapEntry*>( reinterpret_cast<const i::HeapEntry*>(entry)); } HeapGraphNode::Type HeapGraphNode::GetType() const { return static_cast<HeapGraphNode::Type>(ToInternal(this)->type()); } Local<String> HeapGraphNode::GetName() const { i::Isolate* i_isolate = ToInternal(this)->isolate(); return ToApiHandle<String>( i_isolate->factory()->InternalizeUtf8String(ToInternal(this)->name())); } SnapshotObjectId HeapGraphNode::GetId() const { return ToInternal(this)->id(); } size_t HeapGraphNode::GetShallowSize() const { return ToInternal(this)->self_size(); } int HeapGraphNode::GetChildrenCount() const { return ToInternal(this)->children_count(); } const HeapGraphEdge* HeapGraphNode::GetChild(int index) const { return reinterpret_cast<const HeapGraphEdge*>(ToInternal(this)->child(index)); } static i::HeapSnapshot* ToInternal(const HeapSnapshot* snapshot) { return const_cast<i::HeapSnapshot*>( reinterpret_cast<const i::HeapSnapshot*>(snapshot)); } void HeapSnapshot::Delete() { i::Isolate* i_isolate = ToInternal(this)->profiler()->isolate(); if (i_isolate->heap()->heap_profiler()->GetSnapshotsCount() > 1 || i_isolate->heap()->heap_profiler()->IsTakingSnapshot()) { ToInternal(this)->Delete(); } else { // If this is the last snapshot, clean up all accessory data as well. i_isolate->heap()->heap_profiler()->DeleteAllSnapshots(); } } const HeapGraphNode* HeapSnapshot::GetRoot() const { return reinterpret_cast<const HeapGraphNode*>(ToInternal(this)->root()); } const HeapGraphNode* HeapSnapshot::GetNodeById(SnapshotObjectId id) const { return reinterpret_cast<const HeapGraphNode*>( ToInternal(this)->GetEntryById(id)); } int HeapSnapshot::GetNodesCount() const { return static_cast<int>(ToInternal(this)->entries().size()); } const HeapGraphNode* HeapSnapshot::GetNode(int index) const { return reinterpret_cast<const HeapGraphNode*>( &ToInternal(this)->entries().at(index)); } SnapshotObjectId HeapSnapshot::GetMaxSnapshotJSObjectId() const { return ToInternal(this)->max_snapshot_js_object_id(); } void HeapSnapshot::Serialize(OutputStream* stream, HeapSnapshot::SerializationFormat format) const { Utils::ApiCheck(format == kJSON, "v8::HeapSnapshot::Serialize", "Unknown serialization format"); Utils::ApiCheck(stream->GetChunkSize() > 0, "v8::HeapSnapshot::Serialize", "Invalid stream chunk size"); i::HeapSnapshotJSONSerializer serializer(ToInternal(this)); serializer.Serialize(stream); } // static STATIC_CONST_MEMBER_DEFINITION const SnapshotObjectId HeapProfiler::kUnknownObjectId; int HeapProfiler::GetSnapshotCount() { return reinterpret_cast<i::HeapProfiler*>(this)->GetSnapshotsCount(); } void HeapProfiler::QueryObjects(Local<Context> v8_context, QueryObjectPredicate* predicate, std::vector<Global<Object>>* objects) { i::Isolate* isolate = i::Isolate::Current(); i::HeapProfiler* profiler = reinterpret_cast<i::HeapProfiler*>(this); DCHECK_EQ(isolate, profiler->isolate()); EnterV8NoScriptNoExceptionScope api_scope(isolate); profiler->QueryObjects(Utils::OpenDirectHandle(*v8_context), predicate, objects); } const HeapSnapshot* HeapProfiler::GetHeapSnapshot(int index) { return reinterpret_cast<const HeapSnapshot*>( reinterpret_cast<i::HeapProfiler*>(this)->GetSnapshot(index)); } SnapshotObjectId HeapProfiler::GetObjectId(Local<Value> value) { auto obj = Utils::OpenDirectHandle(*value); return reinterpret_cast<i::HeapProfiler*>(this)->GetSnapshotObjectId(obj); } SnapshotObjectId HeapProfiler::GetObjectId(NativeObject value) { return reinterpret_cast<i::HeapProfiler*>(this)->GetSnapshotObjectId(value); } Local<Value> HeapProfiler::FindObjectById(SnapshotObjectId id) { i::DirectHandle<i::Object> obj = reinterpret_cast<i::HeapProfiler*>(this)->FindHeapObjectById(id); if (obj.is_null()) return {}; return Utils::ToLocal(obj); } void HeapProfiler::ClearObjectIds() { reinterpret_cast<i::HeapProfiler*>(this)->ClearHeapObjectMap(); } const HeapSnapshot* HeapProfiler::TakeHeapSnapshot( const HeapSnapshotOptions& options) { return reinterpret_cast<const HeapSnapshot*>( reinterpret_cast<i::HeapProfiler*>(this)->TakeSnapshot(options)); } const HeapSnapshot* HeapProfiler::TakeHeapSnapshot(ActivityControl* control, ObjectNameResolver* resolver, bool hide_internals, bool capture_numeric_value) { HeapSnapshotOptions options; options.control = control; options.global_object_name_resolver = resolver; options.snapshot_mode = hide_internals ? HeapSnapshotMode::kRegular : HeapSnapshotMode::kExposeInternals; options.numerics_mode = capture_numeric_value ? NumericsMode::kExposeNumericValues : NumericsMode::kHideNumericValues; return TakeHeapSnapshot(options); } const HeapSnapshot* HeapProfiler::TakeHeapSnapshot( ActivityControl* control, ContextNameResolver* resolver, bool hide_internals, bool capture_numeric_value) { HeapSnapshotOptions options; options.control = control; options.context_name_resolver = resolver; options.snapshot_mode = hide_internals ? HeapSnapshotMode::kRegular : HeapSnapshotMode::kExposeInternals; options.numerics_mode = capture_numeric_value ? NumericsMode::kExposeNumericValues : NumericsMode::kHideNumericValues; return TakeHeapSnapshot(options); } const HeapSnapshot* HeapProfiler::TakeHeapSnapshot(ActivityControl* control, std::nullptr_t resolver, bool hide_internals, bool capture_numeric_value) { HeapSnapshotOptions options; options.control = control; options.snapshot_mode = hide_internals ? HeapSnapshotMode::kRegular : HeapSnapshotMode::kExposeInternals; options.numerics_mode = capture_numeric_value ? NumericsMode::kExposeNumericValues : NumericsMode::kHideNumericValues; return TakeHeapSnapshot(options); } std::vector<v8::Local<v8::Value>> HeapProfiler::GetDetachedJSWrapperObjects() { return reinterpret_cast<i::HeapProfiler*>(this) ->GetDetachedJSWrapperObjects(); } void HeapProfiler::StartTrackingHeapObjects(bool track_allocations) { reinterpret_cast<i::HeapProfiler*>(this)->StartHeapObjectsTracking( track_allocations); } void HeapProfiler::StopTrackingHeapObjects() { reinterpret_cast<i::HeapProfiler*>(this)->StopHeapObjectsTracking(); } SnapshotObjectId HeapProfiler::GetHeapStats(OutputStream* stream, int64_t* timestamp_us) { i::HeapProfiler* heap_profiler = reinterpret_cast<i::HeapProfiler*>(this); return heap_profiler->PushHeapObjectsStats(stream, timestamp_us); } bool HeapProfiler::StartSamplingHeapProfiler(uint64_t sample_interval, int stack_depth, SamplingFlags flags) { return reinterpret_cast<i::HeapProfiler*>(this)->StartSamplingHeapProfiler( sample_interval, stack_depth, flags); } void HeapProfiler::StopSamplingHeapProfiler() { reinterpret_cast<i::HeapProfiler*>(this)->StopSamplingHeapProfiler(); } AllocationProfile* HeapProfiler::GetAllocationProfile() { return reinterpret_cast<i::HeapProfiler*>(this)->GetAllocationProfile(); } void HeapProfiler::DeleteAllHeapSnapshots() { reinterpret_cast<i::HeapProfiler*>(this)->DeleteAllSnapshots(); } v8::EmbedderGraph::Node* v8::EmbedderGraph::V8Node( const v8::Local<v8::Data>& data) { CHECK(data->IsValue()); return V8Node(data.As<v8::Value>()); } void HeapProfiler::AddBuildEmbedderGraphCallback( BuildEmbedderGraphCallback callback, void* data) { reinterpret_cast<i::HeapProfiler*>(this)->AddBuildEmbedderGraphCallback( callback, data); } void HeapProfiler::RemoveBuildEmbedderGraphCallback( BuildEmbedderGraphCallback callback, void* data) { reinterpret_cast<i::HeapProfiler*>(this)->RemoveBuildEmbedderGraphCallback( callback, data); } void HeapProfiler::SetGetDetachednessCallback(GetDetachednessCallback callback, void* data) { reinterpret_cast<i::HeapProfiler*>(this)->SetGetDetachednessCallback(callback, data); } bool HeapProfiler::IsTakingSnapshot() { return reinterpret_cast<i::HeapProfiler*>(this)->IsTakingSnapshot(); } const char* HeapProfiler::CopyNameForHeapSnapshot(const char* name) { return reinterpret_cast<i::HeapProfiler*>(this)->CopyNameForHeapSnapshot( name); } EmbedderStateScope::EmbedderStateScope(Isolate* v8_isolate, Local<v8::Context> context, EmbedderStateTag tag) : embedder_state_(new internal::EmbedderState(v8_isolate, context, tag)) {} // std::unique_ptr's destructor is not compatible with Forward declared // EmbedderState class. // Default destructor must be defined in implementation file. EmbedderStateScope::~EmbedderStateScope() = default; void TracedReferenceBase::CheckValue() const { #ifdef V8_HOST_ARCH_64_BIT if (IsEmpty()) return; CHECK_NE(internal::kGlobalHandleZapValue, *reinterpret_cast<uint64_t*>(slot())); #endif // V8_HOST_ARCH_64_BIT } CFunction::CFunction(const void* address, const CFunctionInfo* type_info) : address_(address), type_info_(type_info) { CHECK_NOT_NULL(address_); CHECK_NOT_NULL(type_info_); } CFunctionInfo::CFunctionInfo(const CTypeInfo& return_info, unsigned int arg_count, const CTypeInfo* arg_info, Int64Representation repr) : return_info_(return_info), repr_(repr), arg_count_(arg_count), arg_info_(arg_info) { DCHECK(repr == Int64Representation::kNumber || repr == Int64Representation::kBigInt); if (arg_count_ > 0) { for (unsigned int i = 0; i < arg_count_ - 1; ++i) { DCHECK(arg_info_[i].GetType() != CTypeInfo::kCallbackOptionsType); } } } const CTypeInfo& CFunctionInfo::ArgumentInfo(unsigned int index) const { DCHECK_LT(index, ArgumentCount()); return arg_info_[index]; } namespace api_internal { V8_EXPORT v8::Local<v8::Value> GetFunctionTemplateData( v8::Isolate* isolate, v8::Local<v8::Data> raw_target) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(isolate); i::DirectHandle<i::Object> target = Utils::OpenDirectHandle(*raw_target); if (i::IsFunctionTemplateInfo(*target)) { i::DirectHandle<i::Object> data( i::Cast<i::FunctionTemplateInfo>(*target)->callback_data(kAcquireLoad), i_isolate); return Utils::ToLocal(data); } else if (i::IsJSFunction(*target)) { i::DirectHandle<i::JSFunction> target_func = i::Cast<i::JSFunction>(target); auto shared = target_func->shared(); if (shared->IsApiFunction()) { i::DirectHandle<i::Object> data( shared->api_func_data()->callback_data(kAcquireLoad), i_isolate); return Utils::ToLocal(data); } } Utils::ApiCheck(false, "api_internal::GetFunctionTemplateData", "Target function is not an Api function"); UNREACHABLE(); } } // namespace api_internal RegisterState::RegisterState() : pc(nullptr), sp(nullptr), fp(nullptr), lr(nullptr) {} RegisterState::~RegisterState() = default; RegisterState::RegisterState(const RegisterState& other) { *this = other; } RegisterState& RegisterState::operator=(const RegisterState& other) { if (&other != this) { pc = other.pc; sp = other.sp; fp = other.fp; lr = other.lr; if (other.callee_saved) { // Make a deep copy if {other.callee_saved} is non-null. callee_saved = std::make_unique<CalleeSavedRegisters>(*(other.callee_saved)); } else { // Otherwise, set {callee_saved} to null to match {other}. callee_saved.reset(); } } return *this; } #if !V8_ENABLE_WEBASSEMBLY // If WebAssembly is disabled, we still need to provide an implementation of the // WasmStreaming API. Since {WasmStreaming::Unpack} will always fail, all // methods are unreachable. class WasmStreaming::WasmStreamingImpl {}; WasmStreaming::WasmStreaming(std::unique_ptr<WasmStreamingImpl>) { UNREACHABLE(); } WasmStreaming::~WasmStreaming() = default; void WasmStreaming::OnBytesReceived(const uint8_t* bytes, size_t size) { UNREACHABLE(); } void WasmStreaming::Finish( const WasmStreaming::ModuleCachingCallback& caching_callback) { UNREACHABLE(); } void WasmStreaming::Abort(MaybeLocal<Value> exception) { UNREACHABLE(); } void WasmStreaming::SetHasCompiledModuleBytes() { UNREACHABLE(); } void WasmStreaming::SetMoreFunctionsCanBeSerializedCallback( std::function<void(CompiledWasmModule)>) { UNREACHABLE(); } void WasmStreaming::SetUrl(const char* url, size_t length) { UNREACHABLE(); } // static std::shared_ptr<WasmStreaming> WasmStreaming::Unpack(Isolate* v8_isolate, Local<Value> value) { FATAL("WebAssembly is disabled"); } #endif // !V8_ENABLE_WEBASSEMBLY namespace internal { const size_t HandleScopeImplementer::kEnteredContextsOffset = offsetof(HandleScopeImplementer, entered_contexts_); void HandleScopeImplementer::FreeThreadResources() { Free(); } char* HandleScopeImplementer::ArchiveThread(char* storage) { HandleScopeData* current = isolate_->handle_scope_data(); handle_scope_data_ = *current; MemCopy(storage, this, sizeof(*this)); ResetAfterArchive(); current->Initialize(); return storage + ArchiveSpacePerThread(); } int HandleScopeImplementer::ArchiveSpacePerThread() { return sizeof(HandleScopeImplementer); } char* HandleScopeImplementer::RestoreThread(char* storage) { MemCopy(this, storage, sizeof(*this)); *isolate_->handle_scope_data() = handle_scope_data_; return storage + ArchiveSpacePerThread(); } void HandleScopeImplementer::IterateThis(RootVisitor* v) { #ifdef DEBUG bool found_block_before_persistent = false; #endif // Iterate over all handles in the blocks except for the last. for (int i = static_cast<int>(blocks()->size()) - 2; i >= 0; --i) { Address* block = blocks()->at(i); // Cast possibly-unrelated pointers to plain Address before comparing them // to avoid undefined behavior. if (HasPersistentScope() && (reinterpret_cast<Address>( last_handle_before_persistent_block_.value()) <= reinterpret_cast<Address>(&block[kHandleBlockSize])) && (reinterpret_cast<Address>( last_handle_before_persistent_block_.value()) >= reinterpret_cast<Address>(block))) { v->VisitRootPointers( Root::kHandleScope, nullptr, FullObjectSlot(block), FullObjectSlot(last_handle_before_persistent_block_.value())); DCHECK(!found_block_before_persistent); #ifdef DEBUG found_block_before_persistent = true; #endif } else { v->VisitRootPointers(Root::kHandleScope, nullptr, FullObjectSlot(block), FullObjectSlot(&block[kHandleBlockSize])); } } DCHECK_EQ(HasPersistentScope() && last_handle_before_persistent_block_.value() != nullptr, found_block_before_persistent); // Iterate over live handles in the last block (if any). if (!blocks()->empty()) { v->VisitRootPointers(Root::kHandleScope, nullptr, FullObjectSlot(blocks()->back()), FullObjectSlot(handle_scope_data_.next)); } saved_contexts_.shrink_to_fit(); if (!saved_contexts_.empty()) { FullObjectSlot start(&saved_contexts_.front()); v->VisitRootPointers(Root::kHandleScope, nullptr, start, start + static_cast<int>(saved_contexts_.size())); } entered_contexts_.shrink_to_fit(); if (!entered_contexts_.empty()) { FullObjectSlot start(&entered_contexts_.front()); v->VisitRootPointers(Root::kHandleScope, nullptr, start, start + static_cast<int>(entered_contexts_.size())); } } void HandleScopeImplementer::Iterate(RootVisitor* v) { HandleScopeData* current = isolate_->handle_scope_data(); handle_scope_data_ = *current; IterateThis(v); } char* HandleScopeImplementer::Iterate(RootVisitor* v, char* storage) { HandleScopeImplementer* scope_implementer = reinterpret_cast<HandleScopeImplementer*>(storage); scope_implementer->IterateThis(v); return storage + ArchiveSpacePerThread(); } std::unique_ptr<PersistentHandles> HandleScopeImplementer::DetachPersistent( Address* first_block) { std::unique_ptr<PersistentHandles> ph(new PersistentHandles(isolate())); DCHECK(HasPersistentScope()); DCHECK_NOT_NULL(first_block); Address* block_start; do { block_start = blocks_.back(); ph->blocks_.push_back(blocks_.back()); #if DEBUG ph->ordered_blocks_.insert(blocks_.back()); #endif blocks_.pop_back(); } while (block_start != first_block); // ph->blocks_ now contains the blocks installed on the HandleScope stack // since BeginPersistentScope was called, but in reverse order. // Switch first and last blocks, such that the last block is the one // that is potentially half full. DCHECK(!ph->blocks_.empty()); std::swap(ph->blocks_.front(), ph->blocks_.back()); ph->block_next_ = isolate()->handle_scope_data()->next; block_start = ph->blocks_.back(); ph->block_limit_ = block_start + kHandleBlockSize; DCHECK_EQ(blocks_.empty(), last_handle_before_persistent_block_.value() == nullptr); last_handle_before_persistent_block_.reset(); return ph; } void InvokeAccessorGetterCallback( v8::Local<v8::Name> property, const v8::PropertyCallbackInfo<v8::Value>& info) { // Leaving JavaScript. i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(info.GetIsolate()); RCS_SCOPE(i_isolate, RuntimeCallCounterId::kAccessorGetterCallback); v8::AccessorNameGetterCallback getter; { DirectHandle<AccessorInfo> accessor_info = PropertyCallbackArguments::GetAccessorInfo(info); getter = reinterpret_cast<v8::AccessorNameGetterCallback>( accessor_info->getter(i_isolate)); if (V8_UNLIKELY(i_isolate->should_check_side_effects())) { i::DirectHandle<Object> receiver_check_unsupported; if (!i_isolate->debug()->PerformSideEffectCheckForAccessor( accessor_info, receiver_check_unsupported, ACCESSOR_GETTER)) { return; } } } ExternalCallbackScope call_scope(i_isolate, FUNCTION_ADDR(getter), v8::ExceptionContext::kAttributeGet, &info); getter(property, info); } v8::Intercepted InvokeNamedInterceptorGetterCallback( v8::Local<v8::Name> property, const v8::PropertyCallbackInfo<v8::Value>& info) { // Leaving JavaScript. i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(info.GetIsolate()); RCS_SCOPE(i_isolate, RuntimeCallCounterId::kNamedGetterCallback); v8::NamedPropertyGetterCallback getter; { DirectHandle<InterceptorInfo> interceptor_info = PropertyCallbackArguments::GetInterceptorInfo(info); getter = reinterpret_cast<v8::NamedPropertyGetterCallback>( interceptor_info->named_getter(i_isolate)); if (i_isolate->should_check_side_effects() && !i_isolate->debug()->PerformSideEffectCheckForInterceptor( interceptor_info)) { return {}; } } ExternalCallbackScope call_scope(i_isolate, FUNCTION_ADDR(getter), v8::ExceptionContext::kNamedGetter, &info); v8::Intercepted intercepted = getter(property, info); return intercepted; } // TODO(https://crbug.com/348660658): migrate setter callbacks to a new // signature with const v8::PropertyCallbackInfo<v8::Boolean>& info. v8::Intercepted InvokeNamedInterceptorSetterCallback( v8::Local<v8::Name> property, v8::Local<v8::Value> value, const v8::PropertyCallbackInfo<void>& info) { // Leaving JavaScript. i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(info.GetIsolate()); RCS_SCOPE(i_isolate, RuntimeCallCounterId::kNamedSetterCallback); v8::NamedPropertySetterCallback setter; { DirectHandle<InterceptorInfo> interceptor_info = PropertyCallbackArguments::GetInterceptorInfo(info); setter = reinterpret_cast<v8::NamedPropertySetterCallback>( interceptor_info->named_setter(i_isolate)); if (i_isolate->should_check_side_effects() && !i_isolate->debug()->PerformSideEffectCheckForInterceptor( interceptor_info)) { return {}; } } ExternalCallbackScope call_scope(i_isolate, FUNCTION_ADDR(setter), v8::ExceptionContext::kNamedSetter, &info); v8::Intercepted intercepted = setter(property, value, info); return intercepted; } namespace { inline Tagged<FunctionTemplateInfo> GetTargetFunctionTemplateInfo( const v8::FunctionCallbackInfo<v8::Value>& info) { Tagged<Object> target = FunctionCallbackArguments::GetTarget(info); CHECK(IsFunctionTemplateInfo(target)); return Cast<FunctionTemplateInfo>(target); } inline void InvokeFunctionCallback( const v8::FunctionCallbackInfo<v8::Value>& info, CallApiCallbackMode mode) { i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(info.GetIsolate()); RCS_SCOPE(i_isolate, RuntimeCallCounterId::kFunctionCallback); Tagged<FunctionTemplateInfo> fti = GetTargetFunctionTemplateInfo(info); v8::FunctionCallback callback = reinterpret_cast<v8::FunctionCallback>(fti->callback(i_isolate)); switch (mode) { case CallApiCallbackMode::kGeneric: { if (V8_UNLIKELY(i_isolate->should_check_side_effects())) { if (!i_isolate->debug()->PerformSideEffectCheckForCallback( handle(fti, i_isolate))) { // Failed side effect check. return; } if (DEBUG_BOOL) { // Clear raw pointer to ensure it's not accidentally used after // potential GC in PerformSideEffectCheckForCallback. fti = {}; } } break; } case CallApiCallbackMode::kOptimized: // CallFunction builtin should deoptimize an optimized function when // side effects checking is enabled, so we don't have to handle side // effects checking in the optimized version of the builtin. DCHECK(!i_isolate->should_check_side_effects()); break; case CallApiCallbackMode::kOptimizedNoProfiling: // This mode doesn't call InvokeFunctionCallback. UNREACHABLE(); } ExternalCallbackScope call_scope(i_isolate, FUNCTION_ADDR(callback), info.IsConstructCall() ? v8::ExceptionContext::kConstructor : v8::ExceptionContext::kOperation, &info); callback(info); } } // namespace void InvokeFunctionCallbackGeneric( const v8::FunctionCallbackInfo<v8::Value>& info) { InvokeFunctionCallback(info, CallApiCallbackMode::kGeneric); } void InvokeFunctionCallbackOptimized( const v8::FunctionCallbackInfo<v8::Value>& info) { InvokeFunctionCallback(info, CallApiCallbackMode::kOptimized); } void InvokeFinalizationRegistryCleanupFromTask( DirectHandle<NativeContext> native_context, DirectHandle<JSFinalizationRegistry> finalization_registry) { i::Isolate* i_isolate = i::Isolate::Current(); RCS_SCOPE(i_isolate, RuntimeCallCounterId::kFinalizationRegistryCleanupFromTask); // Do not use ENTER_V8 because this is always called from a running // FinalizationRegistryCleanupTask within V8 and we should not log it as an // API call. This method is implemented here to avoid duplication of the // exception handling and microtask running logic in CallDepthScope. if (i_isolate->is_execution_terminating()) return; Local<v8::Context> api_context = Utils::ToLocal(native_context); CallDepthScope<true> call_depth_scope(i_isolate, api_context); VMState<OTHER> state(i_isolate); JSFinalizationRegistry::Cleanup(i_isolate, finalization_registry); } template <> EXPORT_TEMPLATE_DEFINE(V8_EXPORT_PRIVATE) int32_t ConvertDouble(double d) { return internal::DoubleToInt32(d); } template <> EXPORT_TEMPLATE_DEFINE(V8_EXPORT_PRIVATE) uint32_t ConvertDouble(double d) { return internal::DoubleToUint32(d); } template <> EXPORT_TEMPLATE_DEFINE(V8_EXPORT_PRIVATE) float ConvertDouble(double d) { return internal::DoubleToFloat32(d); } template <> EXPORT_TEMPLATE_DEFINE(V8_EXPORT_PRIVATE) double ConvertDouble(double d) { return d; } template <> EXPORT_TEMPLATE_DEFINE(V8_EXPORT_PRIVATE) int64_t ConvertDouble(double d) { return internal::DoubleToWebIDLInt64(d); } template <> EXPORT_TEMPLATE_DEFINE(V8_EXPORT_PRIVATE) uint64_t ConvertDouble(double d) { return internal::DoubleToWebIDLUint64(d); } template <> EXPORT_TEMPLATE_DEFINE(V8_EXPORT_PRIVATE) bool ConvertDouble(double d) { // Implements https://tc39.es/ecma262/#sec-toboolean. return !std::isnan(d) && d != 0; } // Undefine macros for jumbo build. #undef SET_FIELD_WRAPPED #undef NEW_STRING #undef CALLBACK_SETTER template <typename T> bool ValidateFunctionCallbackInfo(const FunctionCallbackInfo<T>& info) { CHECK_GE(info.Length(), 0); // Theortically args-length is unlimited, practically we run out of stack // space. This should guard against accidentally used raw pointers. CHECK_LE(info.Length(), 0xFFFFF); if (info.Length() > 0) { CHECK(info[0]->IsValue()); CHECK(info[info.Length() - 1]->IsValue()); } auto* i_isolate = reinterpret_cast<i::Isolate*>(info.GetIsolate()); CHECK_EQ(i_isolate, Isolate::Current()); CHECK(!i_isolate->GetIncumbentContext().is_null()); CHECK(info.This()->IsObject()); CHECK(!info.Data().IsEmpty()); CHECK(info.GetReturnValue().Get()->IsValue()); return true; } template <typename T> bool ValidatePropertyCallbackInfo(const PropertyCallbackInfo<T>& info) { auto* i_isolate = reinterpret_cast<i::Isolate*>(info.GetIsolate()); CHECK_EQ(i_isolate, Isolate::Current()); CHECK(info.HolderV2()->IsObject()); CHECK(!i::IsJSGlobalObject(*Utils::OpenDirectHandle(*info.HolderV2()))); if (i::PropertyCallbackArguments::IsNamed(info)) { i::Tagged<i::Object> name = *i::PropertyCallbackArguments::GetPropertyName(info); CHECK(i::IsName(name)); } CHECK(info.Data()->IsValue()); USE(info.ShouldThrowOnError()); if (!std::is_same_v<T, void>) { CHECK(info.GetReturnValue().Get()->IsValue()); } return true; } template <> bool V8_EXPORT ValidateCallbackInfo(const FunctionCallbackInfo<void>& info) { return ValidateFunctionCallbackInfo(info); } template <> bool V8_EXPORT ValidateCallbackInfo(const FunctionCallbackInfo<v8::Value>& info) { return ValidateFunctionCallbackInfo(info); } template <> bool V8_EXPORT ValidateCallbackInfo(const PropertyCallbackInfo<v8::Value>& info) { return ValidatePropertyCallbackInfo(info); } template <> bool V8_EXPORT ValidateCallbackInfo(const PropertyCallbackInfo<v8::Array>& info) { return ValidatePropertyCallbackInfo(info); } template <> bool V8_EXPORT ValidateCallbackInfo(const PropertyCallbackInfo<v8::Boolean>& info) { return ValidatePropertyCallbackInfo(info); } template <> bool V8_EXPORT ValidateCallbackInfo(const PropertyCallbackInfo<v8::Integer>& info) { return ValidatePropertyCallbackInfo(info); } template <> bool V8_EXPORT ValidateCallbackInfo(const PropertyCallbackInfo<void>& info) { return ValidatePropertyCallbackInfo(info); } } // namespace internal ExternalMemoryAccounter::~ExternalMemoryAccounter() { #ifdef V8_ENABLE_MEMORY_ACCOUNTING_CHECKS DCHECK_EQ(amount_of_external_memory_, 0U); #endif } ExternalMemoryAccounter::ExternalMemoryAccounter( ExternalMemoryAccounter&& other) { #if V8_ENABLE_MEMORY_ACCOUNTING_CHECKS amount_of_external_memory_ = std::exchange(other.amount_of_external_memory_, 0U); isolate_ = std::exchange(other.isolate_, nullptr); #endif } ExternalMemoryAccounter& ExternalMemoryAccounter::operator=( ExternalMemoryAccounter&& other) { #if V8_ENABLE_MEMORY_ACCOUNTING_CHECKS if (this == &other) { return *this; } DCHECK_EQ(amount_of_external_memory_, 0U); amount_of_external_memory_ = std::exchange(other.amount_of_external_memory_, 0U); isolate_ = std::exchange(other.isolate_, nullptr); #endif return *this; } void ExternalMemoryAccounter::Increase(Isolate* isolate, size_t size) { #ifdef V8_ENABLE_MEMORY_ACCOUNTING_CHECKS DCHECK(isolate == isolate_ || isolate_ == nullptr); isolate_ = isolate; amount_of_external_memory_ += size; #endif isolate->AdjustAmountOfExternalAllocatedMemoryImpl( static_cast<int64_t>(size)); } void ExternalMemoryAccounter::Update(Isolate* isolate, int64_t delta) { #ifdef V8_ENABLE_MEMORY_ACCOUNTING_CHECKS DCHECK(isolate == isolate_ || isolate_ == nullptr); DCHECK_GE(static_cast<int64_t>(amount_of_external_memory_), -delta); isolate_ = isolate; amount_of_external_memory_ += delta; #endif isolate->AdjustAmountOfExternalAllocatedMemoryImpl(delta); } void ExternalMemoryAccounter::Decrease(Isolate* isolate, size_t size) { internal::DisallowGarbageCollection no_gc; if (size == 0) { return; } #ifdef V8_ENABLE_MEMORY_ACCOUNTING_CHECKS DCHECK_EQ(isolate, isolate_); DCHECK_GE(amount_of_external_memory_, size); amount_of_external_memory_ -= size; #endif i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(isolate); i_isolate->heap()->UpdateExternalMemory(-static_cast<int64_t>(size)); } int64_t ExternalMemoryAccounter::GetTotalAmountOfExternalAllocatedMemoryForTesting( const Isolate* isolate) { const i::Isolate* i_isolate = reinterpret_cast<const i::Isolate*>(isolate); return i_isolate->heap()->external_memory(); } template <> bool V8_EXPORT V8_WARN_UNUSED_RESULT TryToCopyAndConvertArrayToCppBuffer<CTypeInfoBuilder<int32_t>::Build().GetId(), int32_t>(Local<Array> src, int32_t* dst, uint32_t max_length) { return CopyAndConvertArrayToCppBuffer< CTypeInfo(CTypeInfo::Type::kInt32).GetId(), int32_t>(src, dst, max_length); } template <> bool V8_EXPORT V8_WARN_UNUSED_RESULT TryToCopyAndConvertArrayToCppBuffer<CTypeInfoBuilder<uint32_t>::Build().GetId(), uint32_t>(Local<Array> src, uint32_t* dst, uint32_t max_length) { return CopyAndConvertArrayToCppBuffer< CTypeInfo(CTypeInfo::Type::kUint32).GetId(), uint32_t>(src, dst, max_length); } template <> bool V8_EXPORT V8_WARN_UNUSED_RESULT TryToCopyAndConvertArrayToCppBuffer<CTypeInfoBuilder<float>::Build().GetId(), float>(Local<Array> src, float* dst, uint32_t max_length) { return CopyAndConvertArrayToCppBuffer< CTypeInfo(CTypeInfo::Type::kFloat32).GetId(), float>(src, dst, max_length); } template <> bool V8_EXPORT V8_WARN_UNUSED_RESULT TryToCopyAndConvertArrayToCppBuffer<CTypeInfoBuilder<double>::Build().GetId(), double>(Local<Array> src, double* dst, uint32_t max_length) { return CopyAndConvertArrayToCppBuffer< CTypeInfo(CTypeInfo::Type::kFloat64).GetId(), double>(src, dst, max_length); } std::string SourceLocation::ToString() const { if (!*this) return {}; return (std::ostringstream{} << loc_.function_name() << '@' << loc_.file_name() << ':' << loc_.line()) .str(); } } // namespace v8 #ifdef ENABLE_SLOW_DCHECKS EXPORT_CONTEXTUAL_VARIABLE(i::StackAllocatedCheck) #endif