v8
3.14.5(node0.10.28)
V8 is Google's open source JavaScript engine
|
#include <v8.h>
Friends | |
template<class T > | |
class | Handle |
template<class T > | |
class | Local |
template<class T > | |
class | Persistent |
class | Context |
|
static |
Adds a callback to notify the host application when a script finished running. If a script re-enters the runtime during executing, the CallCompletedCallback is only invoked when the outer-most script execution ends. Executing scripts inside the callback do not trigger further callbacks.
Definition at line 5445 of file api.cc.
References V8::AddCallCompletedCallback(), Isolate::EnsureDefaultIsolate(), and NULL.
Referenced by TEST().
|
static |
Enables the host application to receive a notification after a garbage collection. Allocations are not allowed in the callback function, you therefore cannot manipulate objects (set or delete properties for example) since it is possible such operations will result in the allocation of objects. It is possible to specify the GCType filter for your callback. But it is not possible to register the same callback function two times with different GCType filters.
Definition at line 5413 of file api.cc.
References Heap::AddGCEpilogueCallback(), and Isolate::heap().
Referenced by TEST().
|
static |
Enables the host application to receive a notification before a garbage collection. Allocations are not allowed in the callback function, you therefore cannot manipulate objects (set or delete properties for example) since it is possible such operations will result in the allocation of objects. It is possible to specify the GCType filter for your callback. But it is not possible to register the same callback function two times with different GCType filters.
Definition at line 5399 of file api.cc.
References Heap::AddGCPrologueCallback(), and Isolate::heap().
Referenced by TEST().
|
static |
Allows the host application to declare implicit references between the objects: if |parent| is alive, all |children| are alive too. After each garbage collection, all implicit references are removed. It is intended to be used in the before-garbage-collection callback function.
Definition at line 5362 of file api.cc.
References GlobalHandles::AddImplicitReferences(), Isolate::global_handles(), and STATIC_ASSERT.
|
static |
Enables the host application to provide a mechanism to be notified and perform custom logging when V8 Allocates Executable Memory.
Definition at line 5427 of file api.cc.
References MemoryAllocator::AddMemoryAllocationCallback(), and Isolate::memory_allocator().
|
static |
Adds a message listener.
The same message listener can be added more than once and in that case it will be called more than once for each message.
Definition at line 5273 of file api.cc.
References NeanderArray::add(), ENTER_V8, Isolate::factory(), FUNCTION_ADDR, Factory::NewForeign(), and ON_BAILOUT.
Referenced by TEST(), and THREADED_TEST().
|
static |
Allows the host application to group objects together. If one object in the group is alive, all objects in the group are alive. After each garbage collection, object groups are removed. It is intended to be used in the before-garbage-collection callback function, for instance to simulate DOM tree connections among JS wrapper objects. See v8-profiler.h for RetainedObjectInfo interface description.
Definition at line 5351 of file api.cc.
References GlobalHandles::AddObjectGroup(), Isolate::global_handles(), and STATIC_ASSERT.
|
static |
Adjusts the amount of registered external memory. Used to give V8 an indication of the amount of externally allocated memory that is kept alive by JavaScript objects. V8 uses this to decide when to perform global garbage collections. Registering externally allocated memory will trigger global garbage collections more often than otherwise in an attempt to garbage collect the JavaScript objects keeping the externally allocated memory alive.
change_in_bytes | the change in externally allocated memory that is kept alive by JavaScript objects. |
Definition at line 5374 of file api.cc.
References Heap::AdjustAmountOfExternalAllocatedMemory(), Isolate::heap(), Isolate::IsInitialized(), and NULL.
Referenced by Shell::ReadBuffer(), and THREADED_TEST().
|
static |
Optional notification that a context has been disposed. V8 uses these notifications to guide the GC heuristic. Returns the number of context disposals - including this one - since the last time V8 had a chance to clean up.
Definition at line 4387 of file api.cc.
References Isolate::heap(), Isolate::IsInitialized(), and Heap::NotifyContextDisposed().
Referenced by Shell::RunMain(), and TEST().
|
static |
Releases any resources used by v8 and stops any utility threads that may be running. Note that disposing v8 is permanent, it cannot be reinitialized.
It should generally not be necessary to dispose v8 before exiting a process, this should happen automatically. It is only necessary to use if the process needs the resources taken up by v8.
Definition at line 4303 of file api.cc.
References Isolate::IsDefaultIsolate(), NULL, and V8::TearDown().
Referenced by Shell::Main(), and main().
|
static |
Enables the computation of a sliding window of states. The sliding window information is recorded in statistics counters.
Definition at line 5335 of file api.cc.
References Logger::EnableSlidingStateWindow(), and Isolate::logger().
|
static |
Definition at line 395 of file api.cc.
References StartupData::compressed_size, Snapshot::context_data(), Snapshot::context_raw_size(), Snapshot::context_size(), Snapshot::data(), StartupData::data, NativesCollection< type >::GetRawScriptsSize(), NativesCollection< type >::GetScriptsSource(), v8::kExperimentalLibraries, v8::kLibraries, v8::kSnapshot, v8::kSnapshotContext, Vector< T >::length(), Snapshot::raw_size(), StartupData::raw_size, Snapshot::size(), and Vector< T >::start().
Referenced by StartupDataDecompressor::Decompress().
|
static |
The following 4 functions are to be used when V8 is built with the 'compress_startup_data' flag enabled. In this case, the embedder must decompress startup data prior to initializing V8.
This is how interaction with V8 should look like: int compressed_data_count = v8::V8::GetCompressedStartupDataCount(); v8::StartupData* compressed_data = new v8::StartupData[compressed_data_count]; v8::V8::GetCompressedStartupData(compressed_data); ... decompress data (compressed_data can be updated in-place) ... v8::V8::SetDecompressedStartupData(compressed_data); ... now V8 can be initialized ... make sure the decompressed data stays valid until V8 shutdown
A helper class StartupDataDecompressor is provided. It implements the protocol of the interaction described above, and can be used in most cases instead of calling these API functions directly.
Definition at line 369 of file api.cc.
References StartupData::kBZip2, and StartupData::kUncompressed.
|
static |
Definition at line 386 of file api.cc.
References v8::kCompressedStartupDataCount.
Referenced by StartupDataDecompressor::Decompress(), StartupDataDecompressor::StartupDataDecompressor(), and StartupDataDecompressor::~StartupDataDecompressor().
|
static |
Retrieve the V8 thread id of the calling thread.
The thread id for a thread should only be retrieved after the V8 lock has been acquired with a Locker object with that thread.
Definition at line 5480 of file api.cc.
References Isolate::thread_id(), and ThreadId::ToInteger().
Referenced by LoopingThread::Run().
|
static |
Get statistics about the heap memory usage.
Definition at line 4321 of file api.cc.
References Heap::CommittedMemory(), Heap::CommittedMemoryExecutable(), Heap::MaxReserved(), and Heap::SizeOfObjects().
Referenced by THREADED_TEST().
|
static |
Get the version string.
Definition at line 4394 of file api.cc.
References Version::GetVersion().
Referenced by RunShell(), v8::internal::RUNTIME_FUNCTION(), THREADED_TEST(), Version(), and Shell::Version().
|
static |
Optional notification that the embedder is idle. V8 uses the notification to reduce memory footprint. This call can be used repeatedly if the embedder remains idle. Returns true if the embedder should stop calling IdleNotification until real work has been done. This indicates that V8 has done as much cleanup as it will be able to do.
The hint argument specifies the amount of work to be done in the function on scale from 1 to 1000. There is no guarantee that the actual work will match the hint.
Definition at line 4371 of file api.cc.
References V8::IdleNotification(), Isolate::IsInitialized(), and NULL.
Referenced by Shell::RunMain(), and TEST().
|
static |
Ignore out-of-memory exceptions.
V8 running out of memory is treated as a fatal error by default. This means that the fatal error handler is called and that V8 is terminated.
IgnoreOutOfMemoryException can be used to not treat an out-of-memory situation as a fatal error. This way, the contexts that did not cause the out of memory problem might be able to continue execution.
Definition at line 5268 of file api.cc.
References Isolate::set_ignore_out_of_memory().
Referenced by InitDefaultIsolateThread::Run(), and TEST().
|
static |
Initializes from snapshot if possible. Otherwise, attempts to initialize from scratch. This function is called implicitly if you use the API without calling it first.
Definition at line 4269 of file api.cc.
References Isolate::IsInitialized(), and NULL.
Referenced by Locker::Locker(), TEST(), and THREADED_TEST().
|
static |
Check if V8 is dead and therefore unusable. This is the case after fatal errors such as out-of-memory situations.
Definition at line 228 of file api.cc.
References V8::IsDead().
Is V8 terminating JavaScript execution.
Returns true if JavaScript execution is currently terminating because of a call to TerminateExecution. In that case there are still JavaScript frames on the stack and the termination exception is still active.
isolate | The isolate in which to check. |
Definition at line 5513 of file api.cc.
References NULL.
Referenced by DoLoop(), DoLoopNoCall(), Loop(), LoopGetProperty(), ReenterAfterTermination(), TerminatorThread::Run(), LoopingThread::Run(), TerminateCurrentThread(), TerminateOrReturnObject(), and TEST().
|
static |
Return whether profiler is currently paused.
Definition at line 5474 of file api.cc.
References Logger::IsProfilerPaused(), and Isolate::logger().
|
static |
Optional notification that the system is running low on memory. V8 uses these notifications to attempt to free memory.
Definition at line 4380 of file api.cc.
References Heap::CollectAllAvailableGarbage(), Isolate::heap(), Isolate::IsInitialized(), and NULL.
|
static |
Suspends recording of tick samples in the profiler. When the V8 profiling mode is enabled (usually via command line switches) this function suspends recording of tick samples. Profiling ticks are discarded until ResumeProfiler() is called.
See also the –prof and –prof_auto command line switches to enable V8 profiling.
Definition at line 5462 of file api.cc.
References Isolate::logger(), and Logger::PauseProfiler().
Referenced by Shell::DisableProfiler(), v8::internal::RUNTIME_FUNCTION(), and TEST().
|
static |
Removes callback that was installed by AddCallCompletedCallback.
Definition at line 5454 of file api.cc.
References Isolate::EnsureDefaultIsolate(), and V8::RemoveCallCompletedCallback().
Referenced by TEST().
|
static |
This function removes callback which was installed by AddGCEpilogueCallback function.
Definition at line 5420 of file api.cc.
References Isolate::heap(), and Heap::RemoveGCEpilogueCallback().
Referenced by TEST().
|
static |
This function removes callback which was installed by AddGCPrologueCallback function.
Definition at line 5406 of file api.cc.
References Isolate::heap(), and Heap::RemoveGCPrologueCallback().
Referenced by TEST().
|
static |
Removes callback that was installed by AddMemoryAllocationCallback.
Definition at line 5437 of file api.cc.
References Isolate::memory_allocator(), and MemoryAllocator::RemoveMemoryAllocationCallback().
|
static |
Remove all message listeners from the specified callback function.
Definition at line 5285 of file api.cc.
References Foreign::cast(), ENTER_V8, Isolate::factory(), FUNCTION_ADDR, Isolate::heap(), and ON_BAILOUT.
Referenced by TEST(), and THREADED_TEST().
|
static |
Resumes recording of tick samples in the profiler. See also PauseProfiler().
Definition at line 5468 of file api.cc.
References Isolate::logger(), and Logger::ResumeProfiler().
Referenced by Shell::EnableProfiler(), v8::internal::RUNTIME_FUNCTION(), and TEST().
|
static |
Definition at line 5328 of file api.cc.
References Isolate::stats_table().
Referenced by Shell::MapCounters(), and InitDefaultIsolateThread::Run().
|
static |
|
static |
|
static |
Enables the host application to provide a mechanism for recording statistics counters.
Definition at line 5314 of file api.cc.
References StatsTable::SetCounterFunction(), and Isolate::stats_table().
Referenced by Shell::MapCounters(), and InitDefaultIsolateThread::Run().
|
static |
Enables the host application to provide a mechanism for recording histograms. The CreateHistogram function returns a histogram which will later be passed to the AddHistogramSample function.
Definition at line 5320 of file api.cc.
References Isolate::counters(), Isolate::InitializeLoggingAndCounters(), Counters::ResetHistograms(), StatsTable::SetCreateHistogramFunction(), and Isolate::stats_table().
Referenced by Shell::MapCounters(), and InitDefaultIsolateThread::Run().
|
static |
Definition at line 426 of file api.cc.
References ASSERT_EQ, Snapshot::context_raw_size(), NativesCollection< type >::GetRawScriptsSize(), v8::kExperimentalLibraries, v8::kLibraries, v8::kSnapshot, v8::kSnapshotContext, Snapshot::raw_size(), Snapshot::set_context_raw_data(), Snapshot::set_raw_data(), and NativesCollection< type >::SetRawScriptsSource().
Referenced by StartupDataDecompressor::Decompress().
|
static |
Allows the host application to provide a callback which can be used as a source of entropy for random number generators.
Definition at line 4278 of file api.cc.
References V8::SetEntropySource().
|
static |
Callback function for reporting failed access checks.
Definition at line 5342 of file api.cc.
References Isolate::SetFailedAccessCheckCallback().
Referenced by TEST().
|
static |
Set the callback to invoke in case of fatal errors.
Definition at line 455 of file api.cc.
Referenced by ExternalArrayLimitTestHelper(), InitDefaultIsolateThread::Run(), and TEST().
|
static |
|
static |
Sets V8 flags from a string.
Definition at line 476 of file api.cc.
References FlagList::SetFlagsFromString().
|
static |
Allows the host application to provide the address of a function that's invoked on entry to every V8-generated function. Note that entry_hook
is invoked at the very start of each generated function.
entry_hook | a function that will be invoked on entry to every V8-generated function. |
Definition at line 4289 of file api.cc.
References ProfileEntryHookStub::SetFunctionEntryHook().
Referenced by TEST().
|
static |
The function is deprecated. Please use AddGCEpilogueCallback instead. Enables the host application to receive a notification after a major garbage collection. Allocations are not allowed in the callback function, you therefore cannot manipulate objects (set or delete properties for example) since it is possible such operations will result in the allocation of objects.
Definition at line 5392 of file api.cc.
References Isolate::heap(), and Heap::SetGlobalGCEpilogueCallback().
|
static |
The function is deprecated. Please use AddGCPrologueCallback instead. Enables the host application to receive a notification before a garbage collection. Allocations are not allowed in the callback function, you therefore cannot manipulate objects (set or delete properties for example) since it is possible such operations will result in the allocation of objects.
Definition at line 5385 of file api.cc.
References Isolate::heap(), and Heap::SetGlobalGCPrologueCallback().
Referenced by TEST().
|
static |
Allows the host application to provide the address of a function that is notified each time code is added, moved or removed.
options | options for the JIT code event handler. |
event_handler | the JIT code event handler, which will be invoked each time code is added, moved or removed. |
event_handler
won't get notified of existent code. event_handler
may get notifications of code that overlaps earlier code notifications. This happens when code areas are reused, and the earlier overlapping code areas should therefore be discarded. event_handler
and the strings they point to are not guaranteed to live past each call. The event_handler
must copy strings and other parameters it needs to keep around. event_handler
function must ignore event codes it does not recognize to maintain future compatibility. Definition at line 4294 of file api.cc.
References Isolate::InitializeLoggingAndCounters(), Isolate::logger(), and Logger::SetCodeEventHandler().
|
static |
Allows the host application to provide a callback that allows v8 to cooperate with a profiler that rewrites return addresses on stack.
Definition at line 4283 of file api.cc.
References V8::SetReturnAddressLocationResolver().
|
static |
Forcefully terminate execution of a JavaScript thread. This can be used to terminate long-running scripts.
TerminateExecution should only be called when then V8 lock has been acquired with a Locker object. Therefore, in order to be able to terminate long-running threads, preemption must be enabled to allow the user of TerminateExecution to acquire the lock.
The termination is achieved by throwing an exception that is uncatchable by JavaScript exception handlers. Termination exceptions act as if they were caught by a C++ TryCatch exception handler. If forceful termination is used, any C++ TryCatch exception handler that catches an exception should check if that exception is a termination exception and immediately return if that is the case. Returning immediately in that case will continue the propagation of the termination exception if needed.
The thread id passed to TerminateExecution must have been obtained by calling GetCurrentThreadId on the thread in question.
thread_id | The thread id of the thread to terminate. |
Definition at line 5487 of file api.cc.
References API_ENTRY_CHECK, ThreadId::FromInteger(), Isolate::IsInitialized(), Isolate::stack_guard(), ThreadManager::TerminateExecution(), StackGuard::TerminateExecution(), Isolate::thread_id(), and Isolate::thread_manager().
Referenced by TerminatorThread::Run(), TerminateCurrentThread(), TerminateOrReturnObject(), and TEST().
Forcefully terminate the current thread of JavaScript execution in the given isolate. If no isolate is provided, the default isolate is used.
This method can be used by any thread even if that thread has not acquired the V8 lock with a Locker object.
isolate | The isolate in which to terminate the current JS execution. |
Definition at line 5503 of file api.cc.
References Isolate::GetDefaultIsolateStackGuard(), NULL, StackGuard::TerminateExecution(), and Isolate::TerminateExecution().
|
static |
Iterates through all external resources referenced from current isolate heap. This method is not expected to be used except for debugging purposes and may be quite slow.
Definition at line 4340 of file api.cc.
References Isolate::heap(), and Heap::VisitExternalResources().
Referenced by TEST().
|
static |
Iterates through all the persistent handles in the current isolate's heap that have class_ids.
Definition at line 4347 of file api.cc.
References Isolate::global_handles(), GlobalHandles::IterateAllRootsWithClassIds(), and UNREACHABLE.
Referenced by TEST().
|
friend |