v8
10.1.124 (node 18.2.0)
V8 is Google's open source JavaScript engine
|
#include <v8-context.h>
Data Structures | |
class | BackupIncumbentScope |
class | Scope |
Public Types | |
enum | EmbedderDataFields { kDebugIdIndex = 0 } |
using | AbortScriptExecutionCallback = void(*)(Isolate *isolate, Local< Context > context) |
Static Public Member Functions | |
static Local< Context > | New (Isolate *isolate, ExtensionConfiguration *extensions=nullptr, MaybeLocal< ObjectTemplate > global_template=MaybeLocal< ObjectTemplate >(), MaybeLocal< Value > global_object=MaybeLocal< Value >(), DeserializeInternalFieldsCallback internal_fields_deserializer=DeserializeInternalFieldsCallback(), MicrotaskQueue *microtask_queue=nullptr) |
static MaybeLocal< Context > | FromSnapshot (Isolate *isolate, size_t context_snapshot_index, DeserializeInternalFieldsCallback embedder_fields_deserializer=DeserializeInternalFieldsCallback(), ExtensionConfiguration *extensions=nullptr, MaybeLocal< Value > global_object=MaybeLocal< Value >(), MicrotaskQueue *microtask_queue=nullptr) |
static MaybeLocal< Object > | NewRemoteContext (Isolate *isolate, Local< ObjectTemplate > global_template, MaybeLocal< Value > global_object=MaybeLocal< Value >()) |
static V8_INLINE Context * | Cast (Data *data) |
Friends | |
class | Value |
class | Script |
class | Object |
class | Function |
A sandboxed execution context with its own set of built-in objects and functions.
Definition at line 45 of file v8-context.h.
using AbortScriptExecutionCallback = void (*)(Isolate* isolate, Local<Context> context) |
If callback is set, abort any attempt to execute JavaScript in this context, call the specified callback, and throw an exception. To unset abort, pass nullptr as callback.
Definition at line 260 of file v8-context.h.
enum EmbedderDataFields |
The field at kDebugIdIndex used to be reserved for the inspector. It now serves no purpose.
Enumerator | |
---|---|
kDebugIdIndex |
Definition at line 176 of file v8-context.h.
void AllowCodeGenerationFromStrings | ( | bool | allow | ) |
Control whether code generation from strings is allowed. Calling this method with false will disable 'eval' and the 'Function' constructor for code running in this context. If 'eval' or the 'Function' constructor are used an exception will be thrown.
If code generation from strings is not allowed the V8::AllowCodeGenerationFromStrings callback will be invoked if set before blocking the call to 'eval' or the 'Function' constructor. If that callback returns true, the call will be allowed, otherwise an exception will be thrown. If no callback is set an exception will be thrown.
Definition at line 398 of file v8-context.h.
void DetachGlobal | ( | ) |
Detaches the global object from its context before the global object can be reused to create a new context.
void Enter | ( | ) |
Enter this context. After entering a context, all code compiled and run is compiled and run in this context. If another context is already entered, this old context is saved so it can be restored when the new context is exited.
Referenced by Context::Scope::Scope().
void Exit | ( | ) |
Exit this context. Exiting the current context restores the context that was in place when entering the current context.
Referenced by Context::Scope::~Scope().
|
static |
Create a new context from a (non-default) context snapshot. There is no way to provide a global object template since we do not create a new global object from template, but we can reuse a global object.
isolate | See v8::Context::New. |
context_snapshot_index | The index of the context snapshot to deserialize from. Use v8::Context::New for the default snapshot. |
embedder_fields_deserializer | Optional callback to deserialize internal fields. It should match the SerializeInternalFieldCallback used to serialize. |
extensions | See v8::Context::New. |
global_object | See v8::Context::New. |
void * GetAlignedPointerFromEmbedderData | ( | int | index | ) |
Gets a 2-byte-aligned native pointer from the embedder data with the given index, which must have been set by a previous call to SetAlignedPointerInEmbedderData with the same index. Note that index 0 currently has a special meaning for Chrome's debugger.
Definition at line 370 of file v8-context.h.
References Internals::GetIsolateForSandbox(), Internals::kEmbedderDataArrayHeaderSize, v8::internal::kEmbedderDataSlotPayloadTag, Internals::kEmbedderDataSlotSize, Internals::kNativeContextEmbedderDataOffset, Internals::ReadExternalPointerField(), and Internals::ReadTaggedPointerField().
Returns the value that was set or restored by SetContinuationPreservedEmbedderData(), if any.
V8_INLINE MaybeLocal<T> GetDataFromSnapshotOnce | ( | size_t | index | ) |
Return data that was previously attached to the context snapshot via SnapshotCreator, and removes the reference to it. Repeated call with the same index returns an empty MaybeLocal.
MaybeLocal<T> GetDataFromSnapshotOnce | ( | size_t | index | ) |
Definition at line 392 of file v8-context.h.
References HandleScope::Local.
Gets the embedder data with the given index, which must have been set by a previous call to SetEmbedderData with the same index.
Definition at line 345 of file v8-context.h.
References HandleScope::CreateHandle(), v8::internal::IsolateFromNeverReadOnlySpaceObject(), Internals::kEmbedderDataArrayHeaderSize, Internals::kEmbedderDataSlotSize, Internals::kNativeContextEmbedderDataOffset, HandleScope::Local, Internals::ReadRawField(), and Internals::ReadTaggedPointerField().
Isolate* GetIsolate | ( | ) |
Returns the isolate associated with a current context.
MicrotaskQueue* GetMicrotaskQueue | ( | ) |
Returns the microtask queue associated with a current context.
uint32_t GetNumberOfEmbedderDataFields | ( | ) |
Return the number of fields allocated for embedder data.
Returns the global proxy object.
Global proxy object is a thin wrapper whose prototype points to actual context's global object with the properties like Object, etc. This is done that way for security reasons (for more details see https://wiki.mozilla.org/Gecko:SplitWindow).
Please note that changes to global proxy object prototype most probably would break VM—v8 expects only global object as a prototype of global proxy object.
bool IsCodeGenerationFromStringsAllowed | ( | ) | const |
Returns true if code generation from strings is allowed for the context. For more details see AllowCodeGenerationFromStrings(bool) documentation.
|
static |
Creates a new context and returns a handle to the newly allocated context.
isolate | The isolate in which to create the context. |
extensions | An optional extension configuration containing the extensions to be installed in the newly created context. |
global_template | An optional object template from which the global object for the newly created context will be created. |
global_object | An optional global object to be reused for the newly created context. This global object must have been created by a previous call to Context::New with the same global template. The state of the global object will be completely reset and only object identify will remain. |
|
static |
Returns an global object that isn't backed by an actual context.
The global template needs to have access checks with handlers installed. If an existing global object is passed in, the global object is detached from its context.
Note that this is different from a detached context where all accesses to the global proxy will fail. Instead, the access check handlers are invoked.
It is also not possible to detach an object returned by this method. Instead, the access check handlers need to return nothing to achieve the same effect.
It is possible, however, to create a new context from the global object returned by this method.
void SetAbortScriptExecution | ( | AbortScriptExecutionCallback | callback | ) |
void SetAlignedPointerInEmbedderData | ( | int | index, |
void * | value | ||
) |
Sets a 2-byte-aligned native pointer in the embedder data with the given index, growing the data as needed. Note that index 0 currently has a special meaning for Chrome's debugger.
Sets a value that will be stored on continuations and reset while the continuation runs.
Sets the embedder data with the given index, growing the data as needed. Note that index 0 currently has a special meaning for Chrome's debugger.
Sets the error description for the exception that is thrown when code generation from strings is not allowed and 'eval' or the 'Function' constructor are called.
void SetPromiseHooks | ( | Local< Function > | init_hook, |
Local< Function > | before_hook, | ||
Local< Function > | after_hook, | ||
Local< Function > | resolve_hook | ||
) |
Set or clear hooks to be invoked for promise lifecycle operations. To clear a hook, set it to an empty v8::Function. Each function will receive the observed promise as the first argument. If a chaining operation is used on a promise, the init will additionally receive the parent promise as the second argument.
Sets the security token for the context. To access an object in another context, the security tokens must match.
void UseDefaultSecurityToken | ( | ) |
Restores the security token to the default value.
|
friend |
Definition at line 334 of file v8-context.h.
|
friend |
Definition at line 333 of file v8-context.h.
|
friend |
Definition at line 332 of file v8-context.h.
|
friend |
Definition at line 331 of file v8-context.h.