[api] Add DefineProperty() method that skips interceptors.

include/v8.h

 // Copyright 2012 the V8 project authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 /** \mainpage V8 API Reference Guide
  *
  * V8 is Google's open source JavaScript engine.
  *
  * This set of documents provides reference material generated from the
  * V8 header file, include/v8.h.
@@ skipping 438 matching lines @@
   // Calling SetSecondPassCallback on the second pass will immediately crash.
   void SetSecondPassCallback(Callback callback) const { *callback_ = callback; }
 
  private:
   Isolate* isolate_;
   T* parameter_;
   Callback* callback_;
   void* embedder_fields_[kEmbedderFieldsInWeakCallback];
 };
 
-
 // kParameter will pass a void* parameter back to the callback, kInternalFields
 // will pass the first two internal fields back to the callback, kFinalizer
 // will pass a void* parameter back, but is invoked before the object is
 // actually collected, so it can be resurrected. In the last case, it is not
 // possible to request a second pass callback.
 enum class WeakCallbackType { kParameter, kInternalFields, kFinalizer };
 
 /**
  * An object reference that is independent of any handle scope.  Where
  * a Local handle only lives as long as the HandleScope in which it was
@@ skipping 2513 matching lines @@
  * kSkipIndices will exclude integer indicies from being collected.
  */
 enum class IndexFilter { kIncludeIndices, kSkipIndices };
 
 /**
  * Integrity level for objects.
  */
 enum class IntegrityLevel { kFrozen, kSealed };
 
 /**
+ * DONT_SKIP_INTERCEPTORS is the default behaviour and triggers the definer
+ * interceptor when setting an own property on an object using
+ * DefineProperty, while SKIP_INTERCEPTORS bypasses the interceptors.
+ */
+enum CallInterceptors { DONT_SKIP_INTERCEPTORS, SKIP_INTERCEPTORS };

[jochen (gone - plz use gerrit), 2017/05/29 19:45:38]

please use enum class CallInterceptors { kSkip, kDontSkip } or similar

+
+/**
  * A JavaScript object (ECMA-262, 4.3.3)
  */
 class V8_EXPORT Object : public Value {
  public:
   V8_DEPRECATE_SOON("Use maybe version",
                     bool Set(Local<Value> key, Local<Value> value));
   V8_WARN_UNUSED_RESULT Maybe<bool> Set(Local<Context> context,
                                         Local<Value> key, Local<Value> value);
 
   V8_DEPRECATE_SOON("Use maybe version",
@@ skipping 16 matching lines @@
                                                        Local<Value> value);
 
   // Implements DefineOwnProperty.
   //
   // In general, CreateDataProperty will be faster, however, does not allow
   // for specifying attributes.
   //
   // Returns true on success.
   V8_WARN_UNUSED_RESULT Maybe<bool> DefineOwnProperty(
       Local<Context> context, Local<Name> key, Local<Value> value,
-      PropertyAttribute attributes = None);
+      PropertyAttribute attributes = None,
+      CallInterceptors call_interceptors = DONT_SKIP_INTERCEPTORS);
 
   // Implements Object.DefineProperty(O, P, Attributes), see Ecma-262 19.1.2.4.
   //
   // The defineProperty function is used to add an own property or
   // update the attributes of an existing own property of an object.
   //
   // Both data and accessor descriptors can be used.
   //
   // In general, CreateDataProperty is faster, however, does not allow
   // for specifying attributes or an accessor descriptor.
   //
   // The PropertyDescriptor can change when redefining a property.
   //
+  // CallInterceptors call_interceptors = SKIP_INTERCEPTORS
+  //  bypasses interceptors when setting property on an object.
+  //
   // Returns true on success.
   V8_WARN_UNUSED_RESULT Maybe<bool> DefineProperty(
-      Local<Context> context, Local<Name> key, PropertyDescriptor& descriptor);
+      Local<Context> context, Local<Name> key, PropertyDescriptor& descriptor,
+      CallInterceptors call_interceptors = DONT_SKIP_INTERCEPTORS);
 
   // Sets an own property on this object bypassing interceptors and
   // overriding accessors or read-only properties.
   //
   // Note that if the object has an interceptor the property will be set
   // locally, but since the interceptor takes precedence the local property
   // will only be returned if the interceptor doesn't return a value.
   //
   // Note also that this only works for named properties.
   V8_DEPRECATED("Use CreateDataProperty / DefineOwnProperty",
@@ skipping 7084 matching lines @@
  */
 
 
 }  // namespace v8
 
 
 #undef TYPE_CHECK
 
 
 #endif  // INCLUDE_V8_H_