node-addon-api 2.0.2 → 3.1.0

package/doc/object_wrap.md

@@ -1,18 +1,20 @@
 # Object Wrap
 
-The `Napi::ObjectWrap` class is used to bind the lifetime of C++ code to a
+Class `Napi::ObjectWrap<T>` inherits from class [`Napi::InstanceWrap<T>`][].
+
+The `Napi::ObjectWrap<T>` class is used to bind the lifetime of C++ code to a
 JavaScript object. Once bound, each time an instance of the JavaScript object
 is created, an instance of the C++ class will also be created. When a method
 is called on the JavaScript object which is defined as an InstanceMethod, the
 corresponding C++ method on the wrapped C++ class will be invoked.
 
 In order to create a wrapper it's necessary to extend the
-`Napi::ObjectWrap`class which contains all the plumbing to connect JavaScript code
-with a C++ object. Classes extending `Napi::ObjectWrap` can be instantiated from
-JavaScript using the **new** operator, and their methods can be directly invoked
-from JavaScript. The **wrap** word refers to a way of grouping methods and state
-of the class because it will be necessary write custom code to bridge each of
-your C++ class methods.
+`Napi::ObjectWrap<T>` class which contains all the plumbing to connect
+JavaScript code with a C++ object. Classes extending `Napi::ObjectWrap` can be
+instantiated from JavaScript using the **new** operator, and their methods can
+be directly invoked from JavaScript. The **wrap** word refers to a way of
+grouping methods and state of the class because it will be necessary write
+custom code to bridge each of your C++ class methods.
 
 ## Example
 
@@ -22,49 +24,58 @@ your C++ class methods.
 class Example : public Napi::ObjectWrap<Example> {
   public:
     static Napi::Object Init(Napi::Env env, Napi::Object exports);
-    Example(const Napi::CallbackInfo &info);
+    Example(const Napi::CallbackInfo& info);
+    static Napi::Value CreateNewItem(const Napi::CallbackInfo& info);
 
   private:
-    static Napi::FunctionReference constructor;
     double _value;
-    Napi::Value GetValue(const Napi::CallbackInfo &info);
-    Napi::Value SetValue(const Napi::CallbackInfo &info);
+    Napi::Value GetValue(const Napi::CallbackInfo& info);
+    Napi::Value SetValue(const Napi::CallbackInfo& info);
 };
 
 Napi::Object Example::Init(Napi::Env env, Napi::Object exports) {
     // This method is used to hook the accessor and method callbacks
     Napi::Function func = DefineClass(env, "Example", {
-        InstanceMethod("GetValue", &Example::GetValue),
-        InstanceMethod("SetValue", &Example::SetValue)
+        InstanceMethod<&Example::GetValue>("GetValue"),
+        InstanceMethod<&Example::SetValue>("SetValue"),
+        StaticMethod<&Example::CreateNewItem>("CreateNewItem"),
     });
 
-    // Create a peristent reference to the class constructor. This will allow
+    Napi::FunctionReference* constructor = new Napi::FunctionReference();
+
+    // Create a persistent reference to the class constructor. This will allow
     // a function called on a class prototype and a function
     // called on instance of a class to be distinguished from each other.
-    constructor = Napi::Persistent(func);
-    // Call the SuppressDestruct() method on the static data prevent the calling
-    // to this destructor to reset the reference when the environment is no longer
-    // available.
-    constructor.SuppressDestruct();
+    *constructor = Napi::Persistent(func);
     exports.Set("Example", func);
+
+    // Store the constructor as the add-on instance data. This will allow this
+    // add-on to support multiple instances of itself running on multiple worker
+    // threads, as well as multiple instances of itself running in different
+    // contexts on the same thread.
+    //
+    // By default, the value set on the environment here will be destroyed when
+    // the add-on is unloaded using the `delete` operator, but it is also
+    // possible to supply a custom deleter.
+    env.SetInstanceData<Napi::FunctionReference>(constructor);
+
     return exports;
 }
 
-Example::Example(const Napi::CallbackInfo &info) : Napi::ObjectWrap<Example>(info) {
-    Napi::Env env = info.Env();
-    // ...
-    Napi::Number value = info[0].As<Napi::Number>();
-    this->_value = value.DoubleValue();
+Example::Example(const Napi::CallbackInfo& info) :
+    Napi::ObjectWrap<Example>(info) {
+  Napi::Env env = info.Env();
+  // ...
+  Napi::Number value = info[0].As<Napi::Number>();
+  this->_value = value.DoubleValue();
 }
 
-Napi::FunctionReference Example::constructor;
-
-Napi::Value Example::GetValue(const Napi::CallbackInfo &info){
+Napi::Value Example::GetValue(const Napi::CallbackInfo& info){
     Napi::Env env = info.Env();
     return Napi::Number::New(env, this->_value);
 }
 
-Napi::Value Example::SetValue(const Napi::CallbackInfo &info){
+Napi::Value Example::SetValue(const Napi::CallbackInfo& info){
     Napi::Env env = info.Env();
     // ...
     Napi::Number value = info[0].As<Napi::Number>();
@@ -78,6 +89,16 @@ Napi::Object Init (Napi::Env env, Napi::Object exports) {
     return exports;
 }
 
+// Create a new item using the constructor stored during Init.
+Napi::Value Example::CreateNewItem(const Napi::CallbackInfo& info) {
+  // Retrieve the instance data we stored during `Init()`. We only stored the
+  // constructor there, so we retrieve it here to create a new instance of the
+  // JS class the constructor represents.
+  Napi::FunctionReference* constructor =
+      info.Env().GetInstanceData<Napi::FunctionReference>();
+  return constructor->New({ Napi::Number::New(info.Env(), 42) });
+}
+
 // Register and initialize native add-on
 NODE_API_MODULE(NODE_GYP_MODULE_NAME, Init)
 ```
@@ -97,22 +118,23 @@ console.log(example.GetValue());
 // It prints 19
 ```
 
-At initialization time, the `Napi::ObjectWrap::DefineClass()` method must be used
-to hook up the accessor and method callbacks. It takes a list of property
+At initialization time, the `Napi::ObjectWrap::DefineClass()` method must be
+used to hook up the accessor and method callbacks. It takes a list of property
 descriptors, which can be constructed via the various static methods on the base
 class.
 
-When JavaScript code invokes the constructor, the constructor callback will create
-a new C++ instance and "wrap" it into the newly created JavaScript object.
+When JavaScript code invokes the constructor, the constructor callback will
+create a new C++ instance and "wrap" it into the newly created JavaScript
+object.
 
 When JavaScript code invokes a method or a property accessor on the class the
 corresponding C++ callback function will be executed.
 
-For a wrapped object it could be difficult to distinguish between a function called
-on a class prototype and a function called on instance of a class. Therefore it is
-good practice to save a persistent reference to the class constructor. This allows
-the two cases to be distinguished from each other by checking the this object
-against the class constructor.
+For a wrapped object it could be difficult to distinguish between a function
+called on a class prototype and a function called on instance of a class.
+Therefore it is good practice to save a persistent reference to the class
+constructor. This allows the two cases to be distinguished from each other by
+checking the this object against the class constructor.
 
 ## Methods
 
@@ -137,7 +159,7 @@ static T* Napi::ObjectWrap::Unwrap(Napi::Object wrapper);
 
 * `[in] wrapper`: The JavaScript object that wraps the native instance.
 
-Returns a native instace wrapped in a JavaScript object. Given the
+Returns a native instance wrapped in a JavaScript object. Given the
 Napi:Object, this allows a method to get a pointer to the wrapped
 C++ object and then reference fields, call methods, etc. within that class.
 In many cases calling Unwrap is not required, as methods can
@@ -151,9 +173,9 @@ methods.
 
 ```cpp
 static Napi::Function Napi::ObjectWrap::DefineClass(Napi::Env env,
-                                const char* utf8name,
-                                const std::initializer_list<PropertyDescriptor>& properties,
-                                void* data = nullptr);
+                    const char* utf8name,
+                    const std::initializer_list<PropertyDescriptor>& properties,
+                    void* data = nullptr);
 ```
 
 * `[in] env`: The environment in which to construct a JavaScript class.
@@ -192,8 +214,9 @@ Returns a `Napi::Function` representing the constructor function for the class.
 
 ### Finalize
 
-Provides an opportunity to run cleanup code that requires access to the `Napi::Env`
-before the wrapped native object instance is freed.  Override to implement.
+Provides an opportunity to run cleanup code that requires access to the
+`Napi::Env` before the wrapped native object instance is freed.  Override to
+implement.
 
 ```cpp
 virtual void Finalize(Napi::Env env);
@@ -203,13 +226,15 @@ virtual void Finalize(Napi::Env env);
 
 ### StaticMethod
 
-Creates property descriptor that represents a static method of a JavaScript class.
+Creates property descriptor that represents a static method of a JavaScript
+class.
 
 ```cpp
-static Napi::PropertyDescriptor Napi::ObjectWrap::StaticMethod(const char* utf8name,
-                                       StaticVoidMethodCallback method,
-                                       napi_property_attributes attributes = napi_default,
-                                       void* data = nullptr);
+static Napi::PropertyDescriptor Napi::ObjectWrap::StaticMethod(
+                             const char* utf8name,
+                             StaticVoidMethodCallback method,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
 ```
 
 - `[in] utf8name`: Null-terminated string that represents the name of a static
@@ -225,13 +250,15 @@ JavaScript class.
 
 ### StaticMethod
 
-Creates property descriptor that represents a static method of a JavaScript class.
+Creates property descriptor that represents a static method of a JavaScript
+class.
 
 ```cpp
-static Napi::PropertyDescriptor Napi::ObjectWrap::StaticMethod(const char* utf8name,
-                                       StaticMethodCallback method,
-                                       napi_property_attributes attributes = napi_default,
-                                       void* data = nullptr);
+static Napi::PropertyDescriptor Napi::ObjectWrap::StaticMethod(
+                             const char* utf8name,
+                             StaticMethodCallback method,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
 ```
 
 - `[in] utf8name`: Null-terminated string that represents the name of a static
@@ -247,13 +274,14 @@ JavaScript class.
 
 ### StaticMethod
 
-Creates property descriptor that represents a static method of a JavaScript class.
+Creates property descriptor that represents a static method of a JavaScript
+class.
 
 ```cpp
 static Napi::PropertyDescriptor Napi::ObjectWrap::StaticMethod(Symbol name,
-                                       StaticVoidMethodCallback method,
-                                       napi_property_attributes attributes = napi_default,
-                                       void* data = nullptr);
+                             StaticVoidMethodCallback method,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
 ```
 
 - `[in] name`: Napi:Symbol that represents the name of a static
@@ -269,13 +297,14 @@ JavaScript class.
 
 ### StaticMethod
 
-Creates property descriptor that represents a static method of a JavaScript class.
+Creates property descriptor that represents a static method of a JavaScript
+class.
 
 ```cpp
 static Napi::PropertyDescriptor Napi::ObjectWrap::StaticMethod(Symbol name,
-                                       StaticMethodCallback method,
-                                       napi_property_attributes attributes = napi_default,
-                                       void* data = nullptr);
+                             StaticMethodCallback method,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
 ```
 
 method for the class.
@@ -289,197 +318,203 @@ One or more of `napi_property_attributes`.
 Returns `Napi::PropertyDescriptor` object that represents a static method of a
 JavaScript class.
 
-### StaticAccessor
+### StaticMethod
 
-Creates property descriptor that represents a static accessor property of a
-JavaScript class.
+Creates property descriptor that represents a static method of a JavaScript
+class.
 
 ```cpp
-static Napi::PropertyDescriptor Napi::ObjectWrap::StaticAccessor(const char* utf8name,
-                                         StaticGetterCallback getter,
-                                         StaticSetterCallback setter,
-                                         napi_property_attributes attributes = napi_default,
-                                         void* data = nullptr);
+template <StaticVoidMethodCallback method>
+static Napi::PropertyDescriptor Napi::ObjectWrap::StaticMethod(
+                             const char* utf8name,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
 ```
 
+- `[in] method`: The native function that represents a static method of a
+JavaScript class. This function returns nothing.
 - `[in] utf8name`: Null-terminated string that represents the name of a static
-accessor property for the class.
-- `[in] getter`: The native function to call when a get access to the property of
-a JavaScript class is performed.
-- `[in] setter`: The native function to call when a set access to the property of
-a JavaScript class is performed.
+method for the class.
 - `[in] attributes`: The attributes associated with a particular property.
 One or more of `napi_property_attributes`.
-- `[in] data`: User-provided data passed into getter or setter when
-is invoked.
+- `[in] data`: User-provided data passed into method when it is invoked.
 
-Returns `Napi::PropertyDescriptor` object that represents a static accessor
-property of a JavaScript class.
+Returns `Napi::PropertyDescriptor` object that represents the static method of a
+JavaScript class.
 
-### StaticAccessor
+### StaticMethod
 
-Creates property descriptor that represents a static accessor property of a
-JavaScript class.
+Creates property descriptor that represents a static method of a JavaScript
+class.
 
 ```cpp
-static Napi::PropertyDescriptor Napi::ObjectWrap::StaticAccessor(Symbol name,
-                                         StaticGetterCallback getter,
-                                         StaticSetterCallback setter,
-                                         napi_property_attributes attributes = napi_default,
-                                         void* data = nullptr);
+template <StaticMethodCallback method>
+static Napi::PropertyDescriptor Napi::ObjectWrap::StaticMethod(
+                             const char* utf8name,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
 ```
 
-- `[in] name`: Napi:Symbol that represents the name of a static accessor.
-- `[in] getter`: The native function to call when a get access to the property of
-a JavaScript class is performed.
-- `[in] setter`: The native function to call when a set access to the property of
-a JavaScript class is performed.
+- `[in] method`: The native function that represents a static method of a
+JavaScript class.
+- `[in] utf8name`: Null-terminated string that represents the name of a static
+method for the class.
 - `[in] attributes`: The attributes associated with a particular property.
 One or more of `napi_property_attributes`.
-- `[in] data`: User-provided data passed into getter or setter when
-is invoked.
+- `[in] data`: User-provided data passed into method when it is invoked.
 
-Returns `Napi::PropertyDescriptor` object that represents a static accessor
-property of a JavaScript class.
+Returns `Napi::PropertyDescriptor` object that represents a static method of a
+JavaScript class.
 
-### InstanceMethod
+### StaticMethod
 
-Creates property descriptor that represents an instance method of a JavaScript class.
+Creates property descriptor that represents a static method of a JavaScript
+class.
 
 ```cpp
-static Napi::PropertyDescriptor Napi::ObjectWrap::InstanceMethod(const char* utf8name,
-                                         InstanceVoidMethodCallback method,
-                                         napi_property_attributes attributes = napi_default,
-                                         void* data = nullptr);
+template <StaticVoidMethodCallback method>
+static Napi::PropertyDescriptor Napi::ObjectWrap::StaticMethod(Symbol name,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
 ```
 
-- `[in] utf8name`: Null-terminated string that represents the name of an instance
-method for the class.
-- `[in] method`: The native function that represents an instance method of a
+- `[in] method`: The native function that represents a static method of a
 JavaScript class.
+- `[in] name`: Napi:Symbol that represents the name of a static
+method for the class.
 - `[in] attributes`: The attributes associated with a particular property.
 One or more of `napi_property_attributes`.
 - `[in] data`: User-provided data passed into method when it is invoked.
 
-Returns `Napi::PropertyDescriptor` object that represents an instance method of a
+Returns `Napi::PropertyDescriptor` object that represents the static method of a
 JavaScript class.
 
-### InstanceMethod
+### StaticMethod
 
-Creates property descriptor that represents an instance method of a JavaScript class.
+Creates property descriptor that represents a static method of a JavaScript
+class.
 
 ```cpp
-static Napi::PropertyDescriptor Napi::ObjectWrap::InstanceMethod(const char* utf8name,
-                                         InstanceMethodCallback method,
-                                         napi_property_attributes attributes = napi_default,
-                                         void* data = nullptr);
+template <StaticMethodCallback method>
+static Napi::PropertyDescriptor Napi::ObjectWrap::StaticMethod(Symbol name,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
 ```
 
-- `[in] utf8name`: Null-terminated string that represents the name of an instance
-method for the class.
-- `[in] method`: The native function that represents an instance method of a
+- `[in] method`: The native function that represents a static method of a
 JavaScript class.
+- `[in] name`: Napi:Symbol that represents the name of a static.
 - `[in] attributes`: The attributes associated with a particular property.
 One or more of `napi_property_attributes`.
 - `[in] data`: User-provided data passed into method when it is invoked.
 
-Returns `Napi::PropertyDescriptor` object that represents an instance method of a
+Returns `Napi::PropertyDescriptor` object that represents a static method of a
 JavaScript class.
 
-### InstanceMethod
+### StaticAccessor
 
-Creates property descriptor that represents an instance method of a JavaScript class.
+Creates property descriptor that represents a static accessor property of a
+JavaScript class.
 
 ```cpp
-static Napi::PropertyDescriptor Napi::ObjectWrap::InstanceMethod(Napi::Symbol name,
-                                         InstanceVoidMethodCallback method,
-                                         napi_property_attributes attributes = napi_default,
-                                         void* data = nullptr);
+static Napi::PropertyDescriptor Napi::ObjectWrap::StaticAccessor(
+                             const char* utf8name,
+                             StaticGetterCallback getter,
+                             StaticSetterCallback setter,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
 ```
 
-- `[in] name`: The `Napi::Symbol` object whose value is used to identify the
-instance method for the class.
-- `[in] method`: The native function that represents an instance method of a
-JavaScript class.
+- `[in] utf8name`: Null-terminated string that represents the name of a static
+accessor property for the class.
+- `[in] getter`: The native function to call when a get access to the property
+of a JavaScript class is performed.
+- `[in] setter`: The native function to call when a set access to the property
+of a JavaScript class is performed.
 - `[in] attributes`: The attributes associated with a particular property.
 One or more of `napi_property_attributes`.
-- `[in] data`: User-provided data passed into method when it is invoked.
+- `[in] data`: User-provided data passed into getter or setter when
+is invoked.
 
-Returns `Napi::PropertyDescriptor` object that represents an instance method of a
-JavaScript class.
+Returns `Napi::PropertyDescriptor` object that represents a static accessor
+property of a JavaScript class.
 
-### InstanceMethod
+### StaticAccessor
 
-Creates property descriptor that represents an instance method of a JavaScript class.
+Creates property descriptor that represents a static accessor property of a
+JavaScript class.
 
 ```cpp
-static Napi::PropertyDescriptor Napi::ObjectWrap::InstanceMethod(Napi::Symbol name,
-                                         InstanceMethodCallback method,
-                                         napi_property_attributes attributes = napi_default,
-                                         void* data = nullptr);
+static Napi::PropertyDescriptor Napi::ObjectWrap::StaticAccessor(Symbol name,
+                             StaticGetterCallback getter,
+                             StaticSetterCallback setter,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
 ```
 
-- `[in] name`: The `Napi::Symbol` object whose value is used to identify the
-instance method for the class.
-- `[in] method`: The native function that represents an instance method of a
-JavaScript class.
+- `[in] name`: Napi:Symbol that represents the name of a static accessor.
+- `[in] getter`: The native function to call when a get access to the property
+of a JavaScript class is performed.
+- `[in] setter`: The native function to call when a set access to the property
+of a JavaScript class is performed.
 - `[in] attributes`: The attributes associated with a particular property.
 One or more of `napi_property_attributes`.
-- `[in] data`: User-provided data passed into method when it is invoked.
+- `[in] data`: User-provided data passed into getter or setter when
+is invoked.
 
-Returns `Napi::PropertyDescriptor` object that represents an instance method of a
-JavaScript class.
+Returns `Napi::PropertyDescriptor` object that represents a static accessor
+property of a JavaScript class.
 
-### InstanceAccessor
+### StaticAccessor
 
-Creates property descriptor that represents an instance accessor property of a
+Creates property descriptor that represents a static accessor property of a
 JavaScript class.
 
 ```cpp
-static Napi::PropertyDescriptor Napi::ObjectWrap::InstanceAccessor(const char* utf8name,
-                                           InstanceGetterCallback getter,
-                                           InstanceSetterCallback setter,
-                                           napi_property_attributes attributes = napi_default,
-                                           void* data = nullptr);
+template <StaticGetterCallback getter, StaticSetterCallback setter=nullptr>
+static Napi::PropertyDescriptor Napi::ObjectWrap::StaticAccessor(
+                             const char* utf8name,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
 ```
 
-- `[in] utf8name`: Null-terminated string that represents the name of an instance
+- `[in] getter`: The native function to call when a get access to the property
+of a JavaScript class is performed.
+- `[in] setter`: The native function to call when a set access to the property
+of a JavaScript class is performed.
+- `[in] utf8name`: Null-terminated string that represents the name of a static
 accessor property for the class.
-- `[in] getter`: The native function to call when a get access to the property of
-a JavaScript class is performed.
-- `[in] setter`: The native function to call when a set access to the property of
-a JavaScript class is performed.
-- `[in] attributes`: The attributes associated with the particular property.
+- `[in] attributes`: The attributes associated with a particular property.
 One or more of `napi_property_attributes`.
-- `[in] data`: User-provided data passed into getter or setter when this is invoked.
+- `[in] data`: User-provided data passed into getter or setter when
+is invoked.
 
-Returns `Napi::PropertyDescriptor` object that represents an instance accessor
+Returns `Napi::PropertyDescriptor` object that represents a static accessor
 property of a JavaScript class.
 
-### InstanceAccessor
+### StaticAccessor
 
-Creates property descriptor that represents an instance accessor property of a
+Creates property descriptor that represents a static accessor property of a
 JavaScript class.
 
 ```cpp
-static Napi::PropertyDescriptor Napi::ObjectWrap::InstanceAccessor(Symbol name,
-                                           InstanceGetterCallback getter,
-                                           InstanceSetterCallback setter,
-                                           napi_property_attributes attributes = napi_default,
-                                           void* data = nullptr);
+template <StaticGetterCallback getter, StaticSetterCallback setter=nullptr>
+static Napi::PropertyDescriptor Napi::ObjectWrap::StaticAccessor(Symbol name,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
 ```
 
-- `[in] name`: The `Napi::Symbol` object whose value is used to identify the
-instance accessor.
-- `[in] getter`: The native function to call when a get access to the property of
-a JavaScript class is performed.
-- `[in] setter`: The native function to call when a set access to the property of
-a JavaScript class is performed.
-- `[in] attributes`: The attributes associated with the particular property.
+- `[in] getter`: The native function to call when a get access to the property
+of a JavaScript class is performed.
+- `[in] setter`: The native function to call when a set access to the property
+of a JavaScript class is performed.
+- `[in] name`: Napi:Symbol that represents the name of a static accessor.
+- `[in] attributes`: The attributes associated with a particular property.
 One or more of `napi_property_attributes`.
-- `[in] data`: User-provided data passed into getter or setter when this is invoked.
+- `[in] data`: User-provided data passed into getter or setter when
+is invoked.
 
-Returns `Napi::PropertyDescriptor` object that represents an instance accessor
+Returns `Napi::PropertyDescriptor` object that represents a static accessor
 property of a JavaScript class.
 
 ### StaticValue
@@ -487,16 +522,18 @@ property of a JavaScript class.
 Creates property descriptor that represents an static value property of a
 JavaScript class.
 ```cpp
-static Napi::PropertyDescriptor Napi::ObjectWrap::StaticValue(const char* utf8name,
-                                      Napi::Value value,
-                                      napi_property_attributes attributes = napi_default);
+static Napi::PropertyDescriptor Napi::ObjectWrap::StaticValue(
+                            const char* utf8name,
+                            Napi::Value value,
+                            napi_property_attributes attributes = napi_default);
 ```
 
 - `[in] utf8name`: Null-terminated string that represents the name of the static
 property.
 - `[in] value`: The value that's retrieved by a get access of the property.
-- `[in] attributes`: The attributes to be associated with the property in addition
-to the napi_static attribute.  One or more of `napi_property_attributes`.
+- `[in] attributes`: The attributes to be associated with the property in
+addition to the napi_static attribute.  One or more of
+`napi_property_attributes`.
 
 Returns `Napi::PropertyDescriptor` object that represents an static value
 property of a JavaScript class
@@ -507,51 +544,18 @@ Creates property descriptor that represents an static value property of a
 JavaScript class.
 ```cpp
 static Napi::PropertyDescriptor Napi::ObjectWrap::StaticValue(Symbol name,
-                                      Napi::Value value,
-                                      napi_property_attributes attributes = napi_default);
+                            Napi::Value value,
+                            napi_property_attributes attributes = napi_default);
 ```
 
 - `[in] name`: The `Napi::Symbol` object whose value is used to identify the
 name of the static property.
 - `[in] value`: The value that's retrieved by a get access of the property.
-- `[in] attributes`: The attributes to be associated with the property in addition
-to the napi_static attribute.  One or more of `napi_property_attributes`.
+- `[in] attributes`: The attributes to be associated with the property in
+addition to the napi_static attribute.  One or more of
+`napi_property_attributes`.
 
 Returns `Napi::PropertyDescriptor` object that represents an static value
 property of a JavaScript class
 
-### InstanceValue
-
-Creates property descriptor that represents an instance value property of a
-JavaScript class.
-```cpp
-static Napi::PropertyDescriptor Napi::ObjectWrap::InstanceValue(const char* utf8name,
-                                        Napi::Value value,
-                                        napi_property_attributes attributes = napi_default);
-```
-
-- `[in] utf8name`: Null-terminated string that represents the name of the property.
-- `[in] value`: The value that's retrieved by a get access of the property.
-- `[in] attributes`: The attributes to be associated with the property.
-One or more of `napi_property_attributes`.
-
-Returns `Napi::PropertyDescriptor` object that represents an instance value
-property of a JavaScript class.
-
-### InstanceValue
-
-Creates property descriptor that represents an instance value property of a
-JavaScript class.
-```cpp
-static Napi::PropertyDescriptor Napi::ObjectWrap::InstanceValue(Symbol name,
-                                        Napi::Value value,
-                                        napi_property_attributes attributes = napi_default);
-```
-
-- `[in] name`: The `Napi::Symbol` object whose value is used to identify the
-name of the property.
-- `[in] value`: The value that's retrieved by a get access of the property.
-- `[in] attributes`: The attributes to be associated with the property.
-One or more of `napi_property_attributes`.
-
-Returns `Napi::PropertyDescriptor` object that represents an instance value
+[`Napi::InstanceWrap<T>`]: ./instance_wrap.md