Add docs ofr ObjectTemplate::SetHandler*() and *HandlerConfiguration classes [skip ci]

Author: pinepain

stubs/src/IndexedPropertyHandlerConfiguration.php

@@ -21,11 +21,11 @@
 class IndexedPropertyHandlerConfiguration
 {
     /**
-     * @param callable $getter
-     * @param callable $setter
-     * @param callable $query
-     * @param callable $deleter
-     * @param callable $enumerator
+     * @param callable $getter The callback to invoke when getting a property.
+     * @param callable $setter The callback to invoke when setting a property.
+     * @param callable $query The callback to invoke to check if an object has a property.
+     * @param callable $deleter The callback to invoke when deleting a property.
+     * @param callable $enumerator The callback to invoke to enumerate all the indexed properties of an object.
      * @param int $flags One of \v8\PropertyHandlerFlags constants
      */
     public function __construct(callable $getter,

stubs/src/NamedPropertyHandlerConfiguration.php

@@ -21,11 +21,11 @@
 class NamedPropertyHandlerConfiguration
 {
     /**
-     * @param callable $getter
-     * @param callable $setter
-     * @param callable $query
-     * @param callable $deleter
-     * @param callable $enumerator
+     * @param callable $getter The callback to invoke when getting a property.
+     * @param callable $setter The callback to invoke when setting a property.
+     * @param callable $query The callback to invoke to check if a property is present, and if present, get its attributes.
+     * @param callable $deleter The callback to invoke when deleting a property.
+     * @param callable $enumerator The callback to invoke to enumerate all the named properties of an object.
      * @param int $flags One of \v8\PropertyHandlerFlags constants
      */
     public function __construct(callable $getter,

stubs/src/ObjectTemplate.php

@@ -102,20 +102,29 @@ public function SetAccessor(
     /**
      * Sets a named property handler on the object template.
      *
+     * Whenever a property whose name is a string or a symbol is accessed on
+     * objects created from this object template, the provided callback is
+     * invoked instead of accessing the property directly on the JavaScript
+     * object.
+     *
      * See \v8\NamedPropertyHandlerConfiguration constructor argument description for details
      *
-     * @param \v8\NamedPropertyHandlerConfiguration
+     * @param \v8\NamedPropertyHandlerConfiguration The NamedPropertyHandlerConfiguration that defines the callbacks to invoke when accessing a property.
      */
     public function SetHandlerForNamedProperty(NamedPropertyHandlerConfiguration $configuration)
     {
     }
 
     /**
-     * Sets a indexed property handler on the object template.
+     * Sets an indexed property handler on the object template.
+     *
+     * Whenever an indexed property is accessed on objects created from
+     * this object template, the provided callback is invoked instead of
+     * accessing the property directly on the JavaScript object.
      *
      * See \v8\IndexedPropertyHandlerConfiguration constructor argument description for details
      *
-     * @param \V8\IndexedPropertyHandlerConfiguration $configuration
+     * @param \V8\IndexedPropertyHandlerConfiguration $configuration The IndexedPropertyHandlerConfiguration that defines the callbacks to invoke when accessing a property.
      */
     public function SetHandlerForIndexedProperty(IndexedPropertyHandlerConfiguration $configuration)
     {