// Copyright (c) Microsoft Corporation. All rights reserved.
// Licensed under the MIT license.
#pragma once
//-----------------------------------------------------------------------------
// V8Isolate
//-----------------------------------------------------------------------------
class V8Isolate: public WeakRefTarget, public IV8Entity
{
public:
enum class TaskKind: uint16_t
{
Worker,
DelayedWorker,
Foreground,
DelayedForeground,
NonNestableForeground,
NonNestableDelayedForeground,
Count
};
enum class Flags : int32_t
{
// IMPORTANT: maintain bitwise equivalence with managed enum V8.V8RuntimeFlags
None = 0,
EnableDebugging = 0x00000001,
EnableRemoteDebugging = 0x00000002,
EnableDynamicModuleImports = 0x00000004
};
struct Options final
{
double HeapExpansionMultiplier = 0;
size_t MaxArrayBufferAllocation = SIZE_MAX;
Flags Flags = Flags::None;
int DebugPort = 0;
};
struct Statistics final
{
using TaskCounts = std::array;
void BumpPostedTaskCount(TaskKind kind)
{
++PostedTaskCounts[static_cast(kind)];
}
void BumpInvokedTaskCount(TaskKind kind)
{
++InvokedTaskCounts[static_cast(kind)];
}
size_t ScriptCount = 0;
size_t ScriptCacheSize = 0;
size_t ModuleCount = 0;
TaskCounts PostedTaskCounts = {};
TaskCounts InvokedTaskCounts = {};
};
static V8Isolate* Create(const StdString& name, const v8::ResourceConstraints* pConstraints, const Options& options);
static size_t GetInstanceCount();
virtual size_t GetMaxHeapSize() = 0;
virtual void SetMaxHeapSize(size_t value) = 0;
virtual double GetHeapSizeSampleInterval() = 0;
virtual void SetHeapSizeSampleInterval(double value) = 0;
virtual size_t GetMaxStackUsage() = 0;
virtual void SetMaxStackUsage(size_t value) = 0;
virtual void AwaitDebuggerAndPause() = 0;
virtual void CancelAwaitDebugger() = 0;
virtual V8ScriptHolder* Compile(const V8DocumentInfo& documentInfo, StdString&& code) = 0;
virtual V8ScriptHolder* Compile(const V8DocumentInfo& documentInfo, StdString&& code, V8CacheKind cacheKind, std::vector& cacheBytes) = 0;
virtual V8ScriptHolder* Compile(const V8DocumentInfo& documentInfo, StdString&& code, V8CacheKind cacheKind, const std::vector& cacheBytes, bool& cacheAccepted) = 0;
virtual V8ScriptHolder* Compile(const V8DocumentInfo& documentInfo, StdString&& code, V8CacheKind cacheKind, std::vector& cacheBytes, V8CacheResult& cacheResult) = 0;
virtual bool GetEnableInterruptPropagation() = 0;
virtual void SetEnableInterruptPropagation(bool value) = 0;
virtual bool GetDisableHeapSizeViolationInterrupt() = 0;
virtual void SetDisableHeapSizeViolationInterrupt(bool value) = 0;
virtual void GetHeapStatistics(v8::HeapStatistics& heapStatistics) = 0;
virtual Statistics GetStatistics() = 0;
virtual void CollectGarbage(bool exhaustive) = 0;
typedef void CpuProfileCallback(const v8::CpuProfile& profile, void* pvArg);
virtual bool BeginCpuProfile(const StdString& name, v8::CpuProfilingMode mode, bool recordSamples) = 0;
virtual bool EndCpuProfile(const StdString& name, CpuProfileCallback* pCallback, void* pvArg) = 0;
virtual void CollectCpuProfileSample() = 0;
virtual uint32_t GetCpuProfileSampleInterval() = 0;
virtual void SetCpuProfileSampleInterval(uint32_t value) = 0;
virtual void WriteHeapSnapshot(void* pvStream) = 0;
virtual ~V8Isolate() {}
};