PropertyCallbackInfo< T > Class Template Reference

#include <v8.h>

Public Member Functions
V8_INLINE Isolate *	GetIsolate () const
V8_INLINE Local< Value >	Data () const
V8_INLINE Local< Object >	This () const
V8_INLINE Local< Object >	Holder () const
V8_INLINE ReturnValue< T >	GetReturnValue () const
V8_INLINE bool	ShouldThrowOnError () const

Static Public Attributes
static const int	kArgsLength = 7

Protected Member Functions
V8_INLINE	PropertyCallbackInfo (internal::Object **args)

Protected Attributes
internal::Object **	args_

Static Protected Attributes
static const int	kShouldThrowOnErrorIndex = 0
static const int	kHolderIndex = 1
static const int	kIsolateIndex = 2
static const int	kReturnValueDefaultValueIndex = 3
static const int	kReturnValueIndex = 4
static const int	kDataIndex = 5
static const int	kThisIndex = 6

Friends
class	MacroAssembler
class	internal::PropertyCallbackArguments
class	internal::CustomArguments< PropertyCallbackInfo >

Detailed Description

template<typename T>
class v8::PropertyCallbackInfo< T >

The information passed to a property callback about the context of the property access.

Definition at line 3709 of file v8.h.

Constructor & Destructor Documentation

PropertyCallbackInfo()

V8_INLINE PropertyCallbackInfo ( internal::Object **  args )

inlineprotected

Definition at line 3811 of file v8.h.

References PropertyCallbackInfo< T >::args_.

Member Function Documentation

Data()

Local< Value > Data

Returns

The data set in the configuration, i.e., in NamedPropertyHandlerConfiguration or IndexedPropertyHandlerConfiguration.

Definition at line 10123 of file v8.h.

References PropertyCallbackInfo< T >::args_, PropertyCallbackInfo< T >::kDataIndex, and Local< T >::Local.

GetIsolate()

Isolate * GetIsolate

Returns

The isolate of the property access.

Definition at line 10117 of file v8.h.

References PropertyCallbackInfo< T >::args_, and PropertyCallbackInfo< T >::kIsolateIndex.

GetReturnValue()

ReturnValue< T > GetReturnValue

Returns

The return value of the callback. Can be changed by calling Set().

info.GetReturnValue().Set(...)

Definition at line 10141 of file v8.h.

References PropertyCallbackInfo< T >::args_, PropertyCallbackInfo< T >::kReturnValueIndex, and Local< T >::ReturnValue.

Holder()

Local< Object > Holder

Returns

The object in the prototype chain of the receiver that has the interceptor. Suppose you have x and its prototype is y, and y has an interceptor. Then info.This() is x and info.Holder() is y. The Holder() could be a hidden object (the global object, rather than the global proxy).

Note

For security reasons, do not pass the object back into the runtime.

Definition at line 10135 of file v8.h.

References PropertyCallbackInfo< T >::args_, PropertyCallbackInfo< T >::kHolderIndex, and Local< T >::Local.

ShouldThrowOnError()

bool ShouldThrowOnError

Returns

True if the intercepted function should throw if an error occurs. Usually, true corresponds to ‘'use strict’`.

Note

Always false when intercepting Reflect.set() independent of the language mode.

Definition at line 10146 of file v8.h.

References PropertyCallbackInfo< T >::args_, Internals::IntToSmi(), and PropertyCallbackInfo< T >::kShouldThrowOnErrorIndex.

This()

Local< Object > This

Returns

The receiver. In many cases, this is the object on which the property access was intercepted. When using Reflect.get, Function.prototype.call, or similar functions, it is the object passed in as receiver or thisArg.

void GetterCallback(Local<Name> name,
                    const v8::PropertyCallbackInfo<v8::Value>& info) {
   auto context = info.GetIsolate()->GetCurrentContext();
 
   v8::Local<v8::Value> a_this =
       info.This()
           ->GetRealNamedProperty(context, v8_str("a"))
           .ToLocalChecked();
   v8::Local<v8::Value> a_holder =
       info.Holder()
           ->GetRealNamedProperty(context, v8_str("a"))
           .ToLocalChecked();
 
  CHECK(v8_str("r")->Equals(context, a_this).FromJust());
  CHECK(v8_str("obj")->Equals(context, a_holder).FromJust());
 
  info.GetReturnValue().Set(name);
}
 
v8::Local<v8::FunctionTemplate> templ =
v8::FunctionTemplate::New(isolate);
templ->InstanceTemplate()->SetHandler(
    v8::NamedPropertyHandlerConfiguration(GetterCallback));
LocalContext env;
env->Global()
    ->Set(env.local(), v8_str("obj"), templ->GetFunction(env.local())
                                         .ToLocalChecked()
                                         ->NewInstance(env.local())
                                         .ToLocalChecked())
    .FromJust();
 
CompileRun("obj.a = 'obj'; var r = {a: 'r'}; Reflect.get(obj, 'x', r)");

Definition at line 10129 of file v8.h.

References PropertyCallbackInfo< T >::args_, PropertyCallbackInfo< T >::kThisIndex, and Local< T >::Local.

Friends And Related Function Documentation

internal::CustomArguments< PropertyCallbackInfo >

friend class internal::CustomArguments< PropertyCallbackInfo >

friend

Definition at line 3801 of file v8.h.

internal::PropertyCallbackArguments

friend class internal::PropertyCallbackArguments

friend

Definition at line 3801 of file v8.h.

MacroAssembler

friend class MacroAssembler

friend

Definition at line 3800 of file v8.h.

Field Documentation

args_

internal::Object** args_

protected

Definition at line 3812 of file v8.h.

Referenced by PropertyCallbackInfo< T >::Data(), PropertyCallbackInfo< T >::GetIsolate(), PropertyCallbackInfo< T >::GetReturnValue(), PropertyCallbackInfo< T >::Holder(), PropertyCallbackInfo< T >::PropertyCallbackInfo(), PropertyCallbackInfo< T >::ShouldThrowOnError(), and PropertyCallbackInfo< T >::This().

kArgsLength

const int kArgsLength = 7

static

Definition at line 3797 of file v8.h.

kDataIndex

const int kDataIndex = 5

staticprotected

Definition at line 3808 of file v8.h.

Referenced by PropertyCallbackInfo< T >::Data().

kHolderIndex

const int kHolderIndex = 1

staticprotected

Definition at line 3804 of file v8.h.

Referenced by PropertyCallbackInfo< T >::Holder().

kIsolateIndex

const int kIsolateIndex = 2

staticprotected

Definition at line 3805 of file v8.h.

Referenced by PropertyCallbackInfo< T >::GetIsolate().

kReturnValueDefaultValueIndex

const int kReturnValueDefaultValueIndex = 3

staticprotected

Definition at line 3806 of file v8.h.

kReturnValueIndex

const int kReturnValueIndex = 4

staticprotected

Definition at line 3807 of file v8.h.

Referenced by PropertyCallbackInfo< T >::GetReturnValue().

kShouldThrowOnErrorIndex

const int kShouldThrowOnErrorIndex = 0

staticprotected

Definition at line 3803 of file v8.h.

Referenced by PropertyCallbackInfo< T >::ShouldThrowOnError().

kThisIndex

const int kThisIndex = 6

staticprotected

Definition at line 3809 of file v8.h.

Referenced by PropertyCallbackInfo< T >::This().

---

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

• include/v8.h