Bazel Rules for Node.js Native Addons

Overview

This repository contains rules for building Node.js Native Addons with Bazel build system.

• node_extension

  This is a wrapper around cc_binary rule that builds a Node.js Native Addon with Node-API headers, node-addon-api headers, and appropriate build flags, producing a .node file.

• node_binding_cc_library

  This is a wrapper around cc_library rule that builds a C/C++ library with Node-API headers, node-addon-api headers, and appropriate build flags. This can be used as a dependency of node_extension rule.

See examples for more details.

Installation

See Release Notes for installation instructions.

FAQ

How do I change Node-API version to build an addon against?

You can set it by the command line flag:

bazel build //my/node/extension:target --@rules_node_binding//node_binding:napi_version=3

Can I use Node.js/V8/libuv API which is not part of Node-API?

Currently, no. Feel free to open an issue if you need it.