N-API之Promise篇

本文介绍N-API中的Promise功能的使用。Promise相关的API一共有四个。

napi_create_promise // 创建一个Promise，类似new Promise 
napi_resolve_deferred // resolve一个Promise 
napi_reject_deferred // reject一个Promise 
napi_is_promise // 判断变量是否是一个Promise 

我们首先看一下napi_is_promise。测试代码如下

const { isPromise } = require('./build/Release/test.node'); 
console.log('is Promise', isPromise(1), isPromise(Promise.resolve())); 

接着看看N-API的实现。

static napi_value isPromise(napi_env env, napi_callback_info info) { 
  napi_value result; 
  size_t argc = 1; 
  napi_value argv[1]; 
  bool is_promise; 
 
  napi_get_cb_info(env, info, &argc, argv, NULL, NULL); 
  napi_is_promise(env, argv[0], &is_promise); 
  napi_get_boolean(env, is_promise, &result); 
 
  return result; 
} 
 
napi_value Init(napi_env env, napi_value exports) { 
  napi_value func2; 
  napi_create_function(env, 
                      NULL, 
                      NAPI_AUTO_LENGTH, 
                      isPromise, 
                      NULL, 
                      &func2); 
  napi_set_named_property(env, exports, "isPromise", func2); 
 
  return exports; 
} 

我们看到实现比较简单，只是封装了N-API的API。我们继续看Promise的真正使用。测试代码如下

const { getPromise, isPromise } = require('./build/Release/test.node'); 
getPromise() 
    .then( 
        (result) => { 
            console.log('resolve', result) 
        },  
        (result) => { 
            console.log('reject',result) 
        } 
    ); 

接着看N-API的实现。

struct info{ 
  napi_async_work worker; 
  napi_deferred deferred; 
  int sum; 
}; 
 
static napi_value getPromise(napi_env env, napi_callback_info info) { 
  napi_value promise; 
  napi_value resource_name; 
  struct info data = {nullptr, nullptr, 0}; 
  struct info * ptr = &data; 
  napi_create_promise(env, &ptr->deferred, &promise); 
  napi_create_string_utf8(env,"test", NAPI_AUTO_LENGTH, &resource_name); 
  napi_create_async_work(env, nullptr, resource_name, work, done, (void *)ptr, &ptr->worker); 
  napi_queue_async_work(env, ptr->worker); 
 
  return promise; 
} 
 
napi_value Init(napi_env env, napi_value exports) { 
  napi_value func; 
  napi_create_function(env, 
                      NULL, 
                      NAPI_AUTO_LENGTH, 
                      getPromise, 
                      NULL, 
                      &func); 
  napi_set_named_property(env, exports, "getPromise", func); 
 
  return exports; 
} 

首先通过napi_create_promise创建一个Promise。然后返回给js层，但是这个Promise是未决议的，这里我们通过给Libuv线程池实现一个异步的操作，然后在回调里resolve这个Promise。napi_create_promise API会生成两个对象，一个Promise(返回给js)，一个是deferred，我们修改Promise状态的时候，是通过操作deferred变量，所以我们首先保存了该变量的值，然后在异步回调里修改它的状态。我们看看线程池里执行的代码。

void work(napi_env env, void* data) { 
  struct info *arg = (struct info *)data; 
  int sum = 0; 
  for (int i = 0; i < 1000; i++) { 
    sum += i; 
  } 
  arg->sum = sum; 
} 

我们在子线程里做一个计算，然后把结果保存到info里，接着在回调里做进一步处理。

void done(napi_env env, napi_status status, void* data) {  
  struct info *arg = (struct info *)data; 
  napi_value ret; 
  if (true) { 
    napi_create_int32(env, arg->sum, &ret); 
    napi_resolve_deferred(env, arg->deferred, ret); 
  } else { 
    napi_create_int32(env, 0, &ret); 
    napi_reject_deferred(env, arg->deferred, ret); 
  } 
  napi_delete_async_work(env, arg->worker); 
  arg->deferred = nullptr; 
} 

在回调里，通过napi_resolve_deferred或napi_reject_deferred修改Promise(deferred)的状态，这时候，js层的回调就会被执行。以上就是N-API中关于Promise的使用。