Loading...
Searching...
No Matches
Classes | Public Member Functions | List of all members
v8::ValueSerializer Class Reference

#include <v8.h>

Classes

class  Delegate
 

Public Member Functions

 ValueSerializer (Isolate *isolate)
 
 ValueSerializer (Isolate *isolate, Delegate *delegate)
 
 ~ValueSerializer ()
 
void WriteHeader ()
 
Maybe< bool > WriteValue (Local< Context > context, Local< Value > value)
 
std::vector< uint8_t > ReleaseBuffer ()
 
std::pair< uint8_t *, size_t > Release ()
 
void TransferArrayBuffer (uint32_t transfer_id, Local< ArrayBuffer > array_buffer)
 
void TransferSharedArrayBuffer (uint32_t transfer_id, Local< SharedArrayBuffer > shared_array_buffer)
 
void SetTreatArrayBufferViewsAsHostObjects (bool mode)
 
void WriteUint32 (uint32_t value)
 
void WriteUint64 (uint64_t value)
 
void WriteDouble (double value)
 
void WriteRawBytes (const void *source, size_t length)
 

Detailed Description

Value serialization compatible with the HTML structured clone algorithm. The format is backward-compatible (i.e. safe to store to disk).

WARNING: This API is under development, and changes (including incompatible changes to the API or wire format) may occur without notice until this warning is removed.

Constructor & Destructor Documentation

◆ ValueSerializer() [1/2]

v8::ValueSerializer::ValueSerializer ( Isolate isolate)
explicit

◆ ValueSerializer() [2/2]

v8::ValueSerializer::ValueSerializer ( Isolate isolate,
Delegate delegate 
)

◆ ~ValueSerializer()

v8::ValueSerializer::~ValueSerializer ( )

Member Function Documentation

◆ Release()

std::pair< uint8_t *, size_t > v8::ValueSerializer::Release ( )

Returns the stored data (allocated using the delegate's AllocateBufferMemory) and its size. This serializer should not be used once the buffer is released. The contents are undefined if a previous write has failed.

◆ ReleaseBuffer()

std::vector< uint8_t > v8::ValueSerializer::ReleaseBuffer ( )

Returns the stored data. This serializer should not be used once the buffer is released. The contents are undefined if a previous write has failed.

◆ SetTreatArrayBufferViewsAsHostObjects()

void v8::ValueSerializer::SetTreatArrayBufferViewsAsHostObjects ( bool  mode)

Indicate whether to treat ArrayBufferView objects as host objects, i.e. pass them to Delegate::WriteHostObject. This should not be called when no Delegate was passed.

The default is not to treat ArrayBufferViews as host objects.

◆ TransferArrayBuffer()

void v8::ValueSerializer::TransferArrayBuffer ( uint32_t  transfer_id,
Local< ArrayBuffer array_buffer 
)

Marks an ArrayBuffer as havings its contents transferred out of band. Pass the corresponding ArrayBuffer in the deserializing context to ValueDeserializer::TransferArrayBuffer.

◆ TransferSharedArrayBuffer()

void v8::ValueSerializer::TransferSharedArrayBuffer ( uint32_t  transfer_id,
Local< SharedArrayBuffer shared_array_buffer 
)

Similar to TransferArrayBuffer, but for SharedArrayBuffer.

◆ WriteDouble()

void v8::ValueSerializer::WriteDouble ( double  value)

◆ WriteHeader()

void v8::ValueSerializer::WriteHeader ( )

Writes out a header, which includes the format version.

◆ WriteRawBytes()

void v8::ValueSerializer::WriteRawBytes ( const void *  source,
size_t  length 
)

◆ WriteUint32()

void v8::ValueSerializer::WriteUint32 ( uint32_t  value)

Write raw data in various common formats to the buffer. Note that integer types are written in base-128 varint format, not with a binary copy. For use during an override of Delegate::WriteHostObject.

◆ WriteUint64()

void v8::ValueSerializer::WriteUint64 ( uint64_t  value)

◆ WriteValue()

Maybe< bool > v8::ValueSerializer::WriteValue ( Local< Context context,
Local< Value value 
)

Serializes a JavaScript value into the buffer.


The documentation for this class was generated from the following file: