XeNote/.yarn/unplugged/node-addon-api-npm-3.0.2-4c22ea0673/node_modules/node-addon-api/doc/symbol.md

Symbol

Class Napi::Symbol inherits from class Napi::Name.

Methods

Constructor

Instantiates a new Napi::Symbol value.

Napi::Symbol::Symbol();

Returns a new empty Napi::Symbol.

New

Napi::Symbol::New(napi_env env, const std::string& description);
Napi::Symbol::New(napi_env env, const char* description);
Napi::Symbol::New(napi_env env, Napi::String description);
Napi::Symbol::New(napi_env env, napi_value description);

• [in] env: The napi_env environment in which to construct the Napi::Symbol object.
• [in] value: The C++ primitive which represents the description hint for the Napi::Symbol. description may be any of:
  • std::string& - UTF8 string description.
  • const char* - represents a UTF8 string description.
  • String - Node addon API String description.
  • napi_value - N-API napi_value description.

If an error occurs, a Napi::Error will get thrown. If C++ exceptions are not being used, callers should check the result of Napi::Env::IsExceptionPending before attempting to use the returned value.

Utf8Value

static Napi::Symbol Napi::Symbol::WellKnown(napi_env env, const std::string& name);

• [in] env: The napi_env environment in which to construct the Napi::Symbol object.
• [in] name: The C++ string representing the Napi::Symbol to retrieve.

Returns a Napi::Symbol representing a well-known Symbol from the Symbol registry.