Name		Name	Last commit message	Last commit date
.github		.github
implementors/node		implementors/node
include		include
scripts		scripts
tests		tests
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CMakeLists.txt		CMakeLists.txt
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE.md		LICENSE.md
PORTING.md		PORTING.md
README.md		README.md
eslint.config.js		eslint.config.js
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

Repository files navigation

Node-API Conformance Test Suite (node-api-cts)

A test suite for Node-API implementors across different JS engines and runtimes. Written in ECMAScript & C/C++ with an implementor customizable harness.

Important

This repository is currently a work-in-progress and shouldn't yet be relied on by anyone.

Overview

Tests

The tests are divided into three buckets:

tests/harness/* exercising the implementor's test harness.

and two parts based on the two header files declaring the Node-API functions:

tests/js-native-api/* testing the engine-specific part of Node-API defined in the js_native_api.h header.
tests/node-api/* testing the runtime-specific part of Node-API defined in the node_api.h header.

Implementors

This repository offers an opportunity for implementors of Node-API to maintain (parts of) their implementor-specific harness inside this repository, in a sub-directory of the implementors directory. We do this in hope of increased velocity from faster iteration and potentials for reuse of code across the harnesses.

We maintain a list of other runtimes implementing Node-API in doc/node-api-engine-bindings.md of the nodejs/abi-stable-node repository.