“Hello World” 示例是一个简单的插件,用 C++ 编写,相当于以下 JavaScript 代码:

    1. module.exports.hello = () => 'world';

    首先,创建 hello.cc 文件:

    1. // hello.cc
    2. #include <node.h>
    3. namespace demo {
    4. using v8::FunctionCallbackInfo;
    5. using v8::Isolate;
    6. using v8::Local;
    7. using v8::Object;
    8. using v8::String;
    9. using v8::Value;
    10. void Method(const FunctionCallbackInfo<Value>& args) {
    11. Isolate* isolate = args.GetIsolate();
    12. args.GetReturnValue().Set(String::NewFromUtf8(
    13. isolate, "world").ToLocalChecked());
    14. }
    15. void Initialize(Local<Object> exports) {
    16. NODE_SET_METHOD(exports, "hello", Method);
    17. }
    18. NODE_MODULE(NODE_GYP_MODULE_NAME, Initialize)
    19. } // 命名空间示例

    注意,所有的 Node.js 插件必须导出一个如下模式的初始化函数:

    1. void Initialize(Local<Object> exports);
    2. NODE_MODULE(NODE_GYP_MODULE_NAME, Initialize)

    NODE_MODULE 后面没有分号,因为它不是一个函数(详见 node.h)。

    module_name 必须匹配最终的二进制文件名(不包括 .node 后缀)。

    hello.cc 示例中,初始化函数是 Initialize,插件模块名是 addon

    使用 node-gyp 构建插件时,使用宏 NODE_GYP_MODULE_NAME 作为 NODE_MODULE() 的第一个参数将确保会将最终二进制文件的名称传给 NODE_MODULE()