Holds a counted reference to a Napi::Value object; initially a weak reference unless otherwise specified, may be changed to/from a strong reference by adjusting the refcount.
The referenced Napi::Value is not immediately destroyed when the reference count is zero; it is merely then eligible for garbage-collection if there are no other references to the Napi::Value.
Napi::Reference objects allocated in static space, such as a global static instance, must call the SuppressDestruct method to prevent its destructor, running at program shutdown time, from attempting to reset the reference when the environment is no longer valid.
The following classes inherit, either directly or indirectly, from Napi::Reference:
cpp
static Napi::Reference<T> Napi::Reference::New(const T& value, uint32_t initialRefcount = 0);
[in] value: The value which is to be referenced.
[in] initialRefcount: The initial reference count.
cpp
Napi::Reference::Reference();
Creates a new empty Napi::Reference instance.
cpp
Napi::Reference::Reference(napi_env env, napi_value value);
[in] env: The napi_env environment in which to construct the Napi::Reference object.
[in] value: The N-API primitive value to be held by the Napi::Reference.
cpp
Napi::Env Napi::Reference::Env() const;
Returns the Napi::Env value in which the Napi::Reference was instantiated.
cpp
bool Napi::Reference::IsEmpty() const;
Determines whether the value held by the Napi::Reference is empty.
cpp
T Napi::Reference::Value() const;
Returns the value held by the Napi::Reference.
cpp
uint32_t Napi::Reference::Ref();
Increments the reference count for the Napi::Reference and returns the resulting reference count. Throws an error if the increment fails.
cpp
uint32_t Napi::Reference::Unref();
Decrements the reference count for the Napi::Reference and returns the resulting reference count. Throws an error if the decrement fails.
cpp
void Napi::Reference::Reset();
Sets the value held by the Napi::Reference to be empty.
cpp
void Napi::Reference::Reset(const T& value, uint32_t refcount = 0);
[in] value: The value which is to be referenced.
[in] initialRefcount: The initial reference count.
Sets the value held by the Napi::Reference.
cpp
void Napi::Reference::SuppressDestruct();
Call this method on a Napi::Reference that is declared as static data to prevent its destructor, running at program shutdown time, from attempting to reset the reference when the environment is no longer valid.