Napi::Array

千里马-horse2025-12-24 8:52

Napi::Array

Napi::Array类继承自Napi::Object类。

数组是 JavaScript 数组的原生表示。Napi::Array是对表示 JavaScript 数组的napi_value的包装。

Napi::TypedArray和Napi::ArrayBuffer分别对应 JavaScript 中的数据类型（如Napi::Int32Array和Napi::ArrayBuffer），可用于将大量数据从 JavaScript 传输到原生端。展示在原生代码中使用 JavaScript 提供的ArrayBuffer的示例可在此处查看。

构造函数

cpp 复制代码

Napi::Array::Array();

返回一个空数组。

如果发生错误，将抛出Napi::Error。如果不使用 C++ 异常，调用者在尝试使用返回值之前应检查Env::IsExceptionPending的结果。

cpp 复制代码

Napi::Array::Array(napi_env env, napi_value value);

[in] env - 用于创建数组的环境。
[in] value - 要包装的原生值。

返回一个包装了napi_value的Napi::Array。

如果发生错误，将抛出Napi::Error。如果不使用 C++ 异常，调用者在尝试使用返回值之前应检查Env::IsExceptionPending的结果。

方法

New

cpp 复制代码

static Napi::Array Napi::Array::New(napi_env env);

[in] env - 用于创建数组的环境。

返回一个新的Napi::Array。

如果发生错误，将抛出Napi::Error。如果不使用 C++ 异常，调用者在尝试使用返回值之前应检查Env::IsExceptionPending的结果。

New

cpp 复制代码

static Napi::Array Napi::Array::New(napi_env env, size_t length);

[in] env - 用于创建数组的环境。
[in] length - 数组的长度。

返回一个具有指定长度的新Napi::Array。

如果发生错误，将抛出Napi::Error。如果不使用 C++ 异常，调用者在尝试使用返回值之前应检查Env::IsExceptionPending的结果。

Length

cpp 复制代码

uint32_t Napi::Array::Length() const;

返回数组的长度。

注意：根据 JavaScript 语义，这可能会隐式执行 JavaScript 代码。如果发生错误，将抛出Napi::Error。如果不使用 C++ 异常，调用者在尝试使用返回值之前应检查Env::IsExceptionPending的结果。