-include config.mk

BUILDTYPE ?= Release

PYTHON ?= python3

DESTDIR ?=

SIGN ?=

PREFIX ?= /usr/local

FLAKY_TESTS ?= run

TEST_CI_ARGS ?=

STAGINGSERVER ?= node-www

CLOUDFLARE_BUCKET ?= r2:dist-staging

LOGLEVEL ?= silent

OSTYPE := $(shell uname -s | tr '[:upper:]' '[:lower:]')

ifeq ($(findstring os/390,$OSTYPE),os/390)

OSTYPE ?= os390

endif

ARCHTYPE := $(shell uname -m | tr '[:upper:]' '[:lower:]')

COVTESTS ?= test-cov

COV_SKIP_TESTS ?= core_line_numbers.js,testFinalizer.js,test_function/test.js

GTEST_FILTER ?= *

GNUMAKEFLAGS += --no-print-directory

GCOV ?= gcov

PWD = $(CURDIR)

BUILD_WITH ?= make

FIND ?= find

ifdef JOBS

PARALLEL_ARGS = -j $(JOBS)

else

PARALLEL_ARGS =

endif

ifdef ENABLE_V8_TAP

TAP_V8 := --junitout '$(PWD)/v8-tap.xml'

TAP_V8_INTL := --junitout '$(PWD)/v8-intl-tap.xml'

TAP_V8_BENCHMARKS := --junitout '$(PWD)/v8-benchmarks-tap.xml'

define convert_to_junit

@true

endef

endif

ifdef ENABLE_CONVERT_V8_JSON_TO_XML

TAP_V8_JSON := $(PWD)/v8-tap.json

TAP_V8_INTL_JSON := $(PWD)/v8-intl-tap.json

TAP_V8_BENCHMARKS_JSON := $(PWD)/v8-benchmarks-tap.json

# By default, the V8's JSON test output only includes the tests which have

# failed. We use --slow-tests-cutoff to ensure that all tests are present

# in the output, including those which pass.

TAP_V8 := --json-test-results '$(TAP_V8_JSON)' --slow-tests-cutoff 1000000

TAP_V8_INTL := --json-test-results '$(TAP_V8_INTL_JSON)' --slow-tests-cutoff 1000000

TAP_V8_BENCHMARKS := --json-test-results '$(TAP_V8_BENCHMARKS_JSON)' --slow-tests-cutoff 1000000

define convert_to_junit

PATH="$(NO_BIN_OVERRIDE_PATH)" \

$(PYTHON) tools/v8-json-to-junit.py < $(1) > $(1:.json=.xml)

endef

endif

V8_TEST_OPTIONS = $(V8_EXTRA_TEST_OPTIONS)

ifdef DISABLE_V8_I18N

V8_BUILD_OPTIONS += i18nsupport=off

endif

# V8 build and test toolchains are not currently compatible with Python 3.

# config.mk may have prepended a symlink for `python` to PATH which we need

# to undo before calling V8's tools.

OVERRIDE_BIN_DIR=$(dir $(abspath $(lastword $(MAKEFILE_LIST))))out/tools/bin

NO_BIN_OVERRIDE_PATH=$(subst $() $(),:,$(filter-out $(OVERRIDE_BIN_DIR),$(subst :, ,$(PATH))))

ifeq ($(OSTYPE), darwin)

GCOV = xcrun llvm-cov gcov

endif

BUILDTYPE_LOWER := $(shell echo $(BUILDTYPE) | tr '[:upper:]' '[:lower:]')

# Determine EXEEXT

EXEEXT := $(shell $(PYTHON) -c \

"import sys; print('.exe' if sys.platform == 'win32' else '')")

NODE_EXE = node$(EXEEXT)

NODE_G_EXE = node_g$(EXEEXT)

NPM ?= ./deps/npm/bin/npm-cli.js

# Release build of node.

# Use $(PWD) so we can cd to anywhere before calling this.

NODE ?= $(PWD)/$(NODE_EXE)

# Prefer $(OUT_NODE) when running tests. Use $(NODE)

# when generating coverage reports or running toolings as

# debug build is be slower.

OUT_NODE ?= $(PWD)/out/$(BUILDTYPE)/node$(EXEEXT)

# Flags for packaging.

BUILD_DOWNLOAD_FLAGS ?= --download=all

BUILD_INTL_FLAGS ?= --with-intl=full-icu

BUILD_RELEASE_FLAGS ?= $(BUILD_DOWNLOAD_FLAGS) $(BUILD_INTL_FLAGS)

# Default to quiet/pretty builds.

# To do verbose builds, run `make V=1` or set the V environment variable.

V ?= 0

# Use -e to double check in case it's a broken link

available-node = \

if [ -x '$(NODE)' ] && [ -e '$(NODE)' ]; then \

PATH='$(PWD)/out/$(BUILDTYPE):$$PATH' '$(NODE)' $(1); \

elif [ -x `command -v node` ] && [ -e `command -v node` ] && [ `command -v node` ]; then \

`command -v node` $(1); \

else \

echo "No available node, cannot run \"node $(1)\""; \

exit 1; \

fi;

.PHONY: all

# BUILDTYPE=Debug builds both release and debug builds. If you want to compile

# just the debug build, run `make -C out BUILDTYPE=Debug` instead.

ifeq ($(BUILDTYPE),Release)

all: $(NODE_EXE) ## Build node in out/Release/node (Default).

$(OUT_NODE): $(NODE_EXE)

else

all: $(NODE_EXE) $(NODE_G_EXE)

$(OUT_NODE): $(NODE_G_EXE)

endif

.PHONY: help

# To add a target to the help, add a double comment (##) on the target line.

help: ## Print help for targets with comments.

@printf "For more targets and info see the comments in the Makefile.\n\n"

@grep -E '^[[:alnum:]._-]+:.*?## .*$$' Makefile | sort | \

awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-15s\033[0m %s\n", $$1, $$2}'

# The .PHONY is needed to ensure that we recursively use the out/Makefile

# to check for changes.

.PHONY: $(NODE_EXE) $(NODE_G_EXE)

# The -r/-L check stops it recreating the link if it is already in place,

# otherwise $(NODE_EXE) being a .PHONY target means it is always re-run.

# Without the check there is a race condition between the link being deleted

# and recreated which can break the addons build when running test-ci

# See comments on the build-addons target for some more info

ifeq ($(BUILD_WITH), make)

$(NODE_EXE): build_type:=Release

$(NODE_G_EXE): build_type:=Debug

$(NODE_EXE) $(NODE_G_EXE): config.gypi out/Makefile

$(MAKE) -C out BUILDTYPE=${build_type} V=$(V)

if [ ! -r $@ ] || [ ! -L $@ ]; then \

ln -fs out/${build_type}/$(NODE_EXE) $@; fi

else

ifeq ($(BUILD_WITH), ninja)

NINJA ?= ninja

ifeq ($(V),1)

NINJA_ARGS := $(NINJA_ARGS) -v

endif

ifdef JOBS

NINJA_ARGS := $(NINJA_ARGS) -j$(JOBS)

else

IMMEDIATE_NINJA_ARGS := $(NINJA_ARGS)

NINJA_ARGS = $(filter -j%,$(MAKEFLAGS))$(IMMEDIATE_NINJA_ARGS)

endif

$(NODE_EXE): config.gypi out/Release/build.ninja

$(NINJA) -C out/Release $(NINJA_ARGS)

if [ ! -r $@ ] || [ ! -L $@ ]; then ln -fs out/Release/$(NODE_EXE) $@; fi

$(NODE_G_EXE): config.gypi out/Debug/build.ninja

$(NINJA) -C out/Debug $(NINJA_ARGS)

if [ ! -r $@ ] || [ ! -L $@ ]; then ln -fs out/Debug/$(NODE_EXE) $@; fi

else

$(NODE_EXE) $(NODE_G_EXE):

$(warning This Makefile currently only supports building with 'make' or 'ninja')

endif

endif

ifeq ($(BUILDTYPE),Debug)

CONFIG_FLAGS += --debug

endif

.PHONY: with-code-cache

.PHONY: test-code-cache

with-code-cache test-code-cache:

$(warning '$@' target is a noop)

out/Makefile: config.gypi common.gypi node.gyp \

deps/*/*.gyp \

tools/v8_gypfiles/toolchain.gypi \

tools/v8_gypfiles/features.gypi \

tools/v8_gypfiles/inspector.gypi tools/v8_gypfiles/v8.gyp

$(PYTHON) tools/gyp_node.py -f make -Dpython=$(PYTHON)

# node_version.h is listed because the N-API version is taken from there

# and included in config.gypi

config.gypi: configure configure.py src/node_version.h

@if [ -x config.status ]; then \

export PATH="$(NO_BIN_OVERRIDE_PATH)" && ./config.status; \

else \

echo Missing or stale $@, please run ./$<; \

exit 1; \

fi

.PHONY: install

install: all ## Install node into $PREFIX (default=/usr/local).

$(PYTHON) tools/install.py $@ --dest-dir '$(DESTDIR)' --prefix '$(PREFIX)'

.PHONY: uninstall

uninstall: ## Uninstall node from $PREFIX (default=/usr/local).

$(PYTHON) tools/install.py $@ --dest-dir '$(DESTDIR)' --prefix '$(PREFIX)'

.PHONY: clean

.NOTPARALLEL: clean

clean: ## Remove build artifacts.

$(RM) -r out/Makefile $(NODE_EXE) $(NODE_G_EXE) out/$(BUILDTYPE)/$(NODE_EXE) \

out/$(BUILDTYPE)/node.exp

@if [ -d out ]; then $(FIND) out/ -name '*.o' -o -name '*.a' -o -name '*.d' | xargs $(RM) -r; fi

$(RM) -r node_modules

@if [ -d deps/icu ]; then echo deleting deps/icu; $(RM) -r deps/icu; fi

$(RM) test.tap

$(MAKE) testclean

$(MAKE) test-addons-clean

$(MAKE) bench-addons-clean

.PHONY: testclean

.NOTPARALLEL: testclean

testclean: ## Remove test artifacts.

# Next one is legacy remove this at some point

$(RM) -r test/tmp*

$(RM) -r test/.tmp*

.PHONY: distclean

.NOTPARALLEL: distclean

distclean: ## Remove all build and test artifacts.

$(RM) -r out

$(RM) config.gypi icu_config.gypi

$(RM) config.mk config.status

$(RM) -r $(NODE_EXE) $(NODE_G_EXE)

$(RM) -r node_modules

$(RM) -r deps/icu

$(RM) -r deps/icu4c*.tgz deps/icu4c*.zip deps/icu-tmp

$(RM) $(BINARYTAR).* $(TARBALL).*

.PHONY: check

check: test

.PHONY: coverage-clean

.NOTPARALLEL: coverage-clean

# Remove files generated by running coverage, put the non-instrumented lib back

# in place

coverage-clean: ## Remove coverage artifacts.

$(RM) -r node_modules

$(RM) -r gcovr

$(RM) -r coverage/tmp

@if [ -d "out/$(BUILDTYPE)/obj.target" ]; then \

$(FIND) out/$(BUILDTYPE)/obj.target \( -name "*.gcda" -o -name "*.gcno" \) \

-type f | xargs $(RM); \

fi

.PHONY: coverage

# Build and test with code coverage reporting. HTML coverage reports will be

# created under coverage/. For C++ coverage reporting, this needs to be run

# in conjunction with configure --coverage.

# Related CI job: node-test-commit-linux-coverage-daily

coverage: coverage-test ## Run the tests and generate a coverage report.

.PHONY: coverage-build

coverage-build: all ## Build coverage files.

-$(MAKE) coverage-build-js

if [ ! -d gcovr ]; then $(PYTHON) -m pip install -t gcovr gcovr==7.2; fi

$(MAKE)

.PHONY: coverage-build-js

coverage-build-js: ## Build JavaScript coverage files.

mkdir -p node_modules

if [ ! -d node_modules/c8 ]; then \

'$(NODE)' ./deps/npm install c8 --no-save --no-package-lock;\

fi

.PHONY: coverage-test

coverage-test: coverage-build ## Run the tests and generate a coverage report.

@if [ -d "out/$(BUILDTYPE)/obj.target" ]; then \

$(FIND) out/$(BUILDTYPE)/obj.target -name "*.gcda" -type f | xargs $(RM); \

fi

-NODE_V8_COVERAGE=coverage/tmp \

TEST_CI_ARGS="$(TEST_CI_ARGS) --type=coverage" $(MAKE) $(COVTESTS)

$(MAKE) coverage-report-js

-(PYTHONPATH=./gcovr $(PYTHON) -m gcovr \

--object-directory=out \

--filter src -v \

--root ./ \

--html --html-details -o ../coverage/cxxcoverage.html \

--gcov-executable="$(GCOV)")

@printf "Javascript coverage %%: "

@grep -B1 Lines coverage/index.html | head -n1 \

| sed 's/<[^>]*>//g'| sed 's/ //g'

@printf "C++ coverage %%: "

@grep -A3 Lines coverage/cxxcoverage.html | grep style \

| sed 's/<[^>]*>//g'| sed 's/ //g'

.PHONY: coverage-report-js

coverage-report-js: ## Report JavaScript coverage results.

-$(MAKE) coverage-build-js

'$(NODE)' ./node_modules/.bin/c8 report

.PHONY: cctest

cctest: all ## Run the C++ tests using the built `cctest` executable.

@out/$(BUILDTYPE)/$@ --gtest_filter=$(GTEST_FILTER)

.PHONY: list-gtests

list-gtests: ## List all available C++ gtests.

ifeq (,$(wildcard out/$(BUILDTYPE)/cctest))

$(error Please run 'make cctest' first)

endif

@out/$(BUILDTYPE)/cctest --gtest_list_tests

.PHONY: v8

# Related CI job: node-test-commit-v8-linux

# Rebuilds deps/v8 as a git tree, pulls its third-party dependencies, and

# builds it.

v8: ## Build deps/v8.

export PATH="$(NO_BIN_OVERRIDE_PATH)" && \

tools/make-v8.sh $(V8_ARCH).$(BUILDTYPE_LOWER) $(V8_BUILD_OPTIONS)

.PHONY: jstest

jstest: build-addons build-js-native-api-tests build-node-api-tests build-sqlite-tests build-ffi-tests ## Run addon tests and JS tests.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) \

$(TEST_CI_ARGS) \

--skip-tests=$(CI_SKIP_TESTS) \

$(JS_SUITES) \

$(NATIVE_SUITES)

.PHONY: tooltest

tooltest: ## Test the various tools.

@$(PYTHON) -m unittest discover -s ./test/tools

.PHONY: coverage-run-js

coverage-run-js: ## Run JavaScript tests with coverage.

$(RM) -r coverage/tmp

-NODE_V8_COVERAGE=coverage/tmp CI_SKIP_TESTS=$(COV_SKIP_TESTS) \

TEST_CI_ARGS="$(TEST_CI_ARGS) --type=coverage" $(MAKE) jstest

$(MAKE) coverage-report-js

.PHONY: test

# This does not run tests of third-party libraries inside deps.

test: all ## Run default tests and build docs.

$(MAKE) -s tooltest

$(MAKE) -s build-addons

$(MAKE) -s build-js-native-api-tests

$(MAKE) -s build-node-api-tests

$(MAKE) -s build-sqlite-tests

$(MAKE) -s build-ffi-tests

$(MAKE) -s cctest

$(MAKE) -s jstest

.PHONY: test-only

test-only: all ## Run default tests without building the docs.

$(MAKE) build-addons

$(MAKE) build-js-native-api-tests

$(MAKE) build-node-api-tests

$(MAKE) build-sqlite-tests

$(MAKE) build-ffi-tests

$(MAKE) cctest

$(MAKE) jstest

$(MAKE) tooltest

# Used by `make coverage-test`

.PHONY: test-cov

test-cov: all ## Run coverage tests.

$(MAKE) build-addons

$(MAKE) build-js-native-api-tests

$(MAKE) build-node-api-tests

$(MAKE) build-sqlite-tests

$(MAKE) build-ffi-tests

$(MAKE) cctest

CI_SKIP_TESTS=$(COV_SKIP_TESTS) $(MAKE) jstest

.PHONY: test-valgrind

test-valgrind: all ## Run tests using valgrind.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) --valgrind sequential parallel message

.PHONY: test-check-deopts

test-check-deopts: all

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) --check-deopts parallel sequential

DOCBUILDSTAMP_PREREQS = doc/api/addons.md

ifeq ($(OSTYPE),aix)

DOCBUILDSTAMP_PREREQS := $(DOCBUILDSTAMP_PREREQS) out/$(BUILDTYPE)/node.exp

endif

ifeq ($(OSTYPE),os400)

DOCBUILDSTAMP_PREREQS := $(DOCBUILDSTAMP_PREREQS) out/$(BUILDTYPE)/node.exp

endif

DOC_KIT ?= tools/doc/node_modules/@node-core/doc-kit/bin/cli.mjs

node_use_openssl_and_icu = $(call available-node,"-p" \

"process.versions.openssl != undefined && process.versions.icu != undefined")

test/addons/.docbuildstamp: $(DOCBUILDSTAMP_PREREQS) tools/doc/addon-verify.mjs

@if [ "$(shell $(node_use_openssl_and_icu))" != "true" ]; then \

echo "Skipping .docbuildstamp (no crypto and/or no ICU)"; \

else \

$(RM) -r test/addons/??_*/; \

$(call available-node, \

tools/doc/addon-verify.mjs \

--input doc/api/addons.md \

--output test/addons/ \

) \

[ $$? -eq 0 ] && touch $@; \

fi

# All files that will be included in headers tarball should be listed as deps

# for generating headers. The list is manually synchronized with install.py.

ADDONS_HEADERS_PREREQS := tools/install.py \

config.gypi common.gypi \

$(wildcard deps/openssl/config/*.h) \

$(wildcard deps/openssl/openssl/include/openssl/*.h) \

$(wildcard deps/uv/include/*.h) \

$(wildcard deps/uv/include/*/*.h) \

$(wildcard deps/v8/include/*.h) \

$(wildcard deps/v8/include/*/*.h) \

$(wildcard deps/zlib/z*.h) \

src/node.h src/node_api.h src/js_native_api.h src/js_native_api_types.h \

src/node_api_types.h src/node_buffer.h src/node_object_wrap.h \

src/node_version.h

ADDONS_HEADERS_DIR = out/$(BUILDTYPE)/addons_headers

# Generate node headers which will be used for building addons.

test/addons/.headersbuildstamp: $(ADDONS_HEADERS_PREREQS)

$(PYTHON) tools/install.py install --headers-only --dest-dir '$(ADDONS_HEADERS_DIR)' --prefix '/'

@touch $@

ADDONS_BINDING_GYPS := \

$(filter-out test/addons/??_*/binding.gyp, \

$(wildcard test/addons/*/binding.gyp))

ADDONS_BINDING_SOURCES := \

$(filter-out test/addons/??_*/*.cc, $(wildcard test/addons/*/*.cc)) \

$(filter-out test/addons/??_*/*.h, $(wildcard test/addons/*/*.h))

ADDONS_PREREQS := test/addons/.headersbuildstamp \

deps/npm/node_modules/node-gyp/package.json tools/build_addons.py

define run_build_addons

env $(PYTHON) "$$PWD/tools/build_addons.py" --loglevel=$(LOGLEVEL) --headers-dir "$(ADDONS_HEADERS_DIR)" $1

touch $2

endef

# Implicitly depends on $(NODE_EXE), see the build-addons rule for rationale.

# Depends on node-gyp package.json so that build-addons is (re)executed when

# node-gyp is updated as part of an npm update.

test/addons/.buildstamp: $(ADDONS_PREREQS) \

$(ADDONS_BINDING_GYPS) $(ADDONS_BINDING_SOURCES) \

test/addons/.docbuildstamp

@$(call run_build_addons,"$$PWD/test/addons",$@)

.PHONY: build-addons

# .buildstamp needs $(NODE_EXE) but cannot depend on it

# directly because it calls make recursively. The parent make cannot know

# if the subprocess touched anything so it pessimistically assumes that

# .buildstamp is out of date and need a rebuild.

# Just goes to show that recursive make really is harmful...

# TODO(bnoordhuis) Force rebuild after gyp update.

build-addons: | $(NODE_EXE) test/addons/.buildstamp ## Build addons for Node.js.

JS_NATIVE_API_BINDING_GYPS := \

$(filter-out test/js-native-api/??_*/binding.gyp, \

$(wildcard test/js-native-api/*/binding.gyp))

JS_NATIVE_API_BINDING_SOURCES := \

$(filter-out test/js-native-api/??_*/*.c, $(wildcard test/js-native-api/*/*.c)) \

$(filter-out test/js-native-api/??_*/*.cc, $(wildcard test/js-native-api/*/*.cc)) \

$(filter-out test/js-native-api/??_*/*.h, $(wildcard test/js-native-api/*/*.h))

# Implicitly depends on $(NODE_EXE), see the build-js-native-api-tests rule for rationale.

test/js-native-api/.buildstamp: $(ADDONS_PREREQS) \

$(JS_NATIVE_API_BINDING_GYPS) $(JS_NATIVE_API_BINDING_SOURCES) \

src/js_native_api_v8.h src/js_native_api_v8_internals.h

@$(call run_build_addons,"$$PWD/test/js-native-api",$@)

.PHONY: build-js-native-api-tests

# .buildstamp needs $(NODE_EXE) but cannot depend on it

# directly because it calls make recursively. The parent make cannot know

# if the subprocess touched anything so it pessimistically assumes that

# .buildstamp is out of date and need a rebuild.

# Just goes to show that recursive make really is harmful...

# TODO(bnoordhuis) Force rebuild after gyp or node-gyp update.

build-js-native-api-tests: | $(NODE_EXE) test/js-native-api/.buildstamp ## Build JS Native-API tests.

NODE_API_BINDING_GYPS := \

$(filter-out test/node-api/??_*/binding.gyp, \

$(wildcard test/node-api/*/binding.gyp))

NODE_API_BINDING_SOURCES := \

$(filter-out test/node-api/??_*/*.c, $(wildcard test/node-api/*/*.c)) \

$(filter-out test/node-api/??_*/*.cc, $(wildcard test/node-api/*/*.cc)) \

$(filter-out test/node-api/??_*/*.h, $(wildcard test/node-api/*/*.h))

# Implicitly depends on $(NODE_EXE), see the build-node-api-tests rule for rationale.

test/node-api/.buildstamp: $(ADDONS_PREREQS) \

$(NODE_API_BINDING_GYPS) $(NODE_API_BINDING_SOURCES) \

src/js_native_api_v8.h src/js_native_api_v8_internals.h

@$(call run_build_addons,"$$PWD/test/node-api",$@)

.PHONY: build-node-api-tests

# .buildstamp needs $(NODE_EXE) but cannot depend on it

# directly because it calls make recursively. The parent make cannot know

# if the subprocess touched anything so it pessimistically assumes that

# .buildstamp is out of date and need a rebuild.

# Just goes to show that recursive make really is harmful...

# TODO(bnoordhuis) Force rebuild after gyp or node-gyp update.

build-node-api-tests: | $(NODE_EXE) test/node-api/.buildstamp ## Build Node-API tests.

BENCHMARK_NAPI_BINDING_GYPS := $(wildcard benchmark/napi/*/binding.gyp)

BENCHMARK_NAPI_BINDING_SOURCES := \

$(wildcard benchmark/napi/*/*.c) \

$(wildcard benchmark/napi/*/*.cc) \

$(wildcard benchmark/napi/*/*.h)

benchmark/napi/.buildstamp: $(ADDONS_PREREQS) \

$(BENCHMARK_NAPI_BINDING_GYPS) $(BENCHMARK_NAPI_BINDING_SOURCES)

@$(call run_build_addons,"$$PWD/benchmark/napi",$@)

SQLITE_BINDING_GYPS := $(wildcard test/sqlite/*/binding.gyp)

SQLITE_BINDING_SOURCES := \

$(wildcard test/sqlite/*/*.c)

# Implicitly depends on $(NODE_EXE), see the build-sqlite-tests rule for rationale.

ifndef NOSQLITE

test/sqlite/.buildstamp: $(ADDONS_PREREQS) \

$(SQLITE_BINDING_GYPS) $(SQLITE_BINDING_SOURCES)

@$(call run_build_addons,"$$PWD/test/sqlite",$@)

else

test/sqlite/.buildstamp:

endif

.PHONY: build-sqlite-tests

ifndef NOSQLITE

# .buildstamp needs $(NODE_EXE) but cannot depend on it

# directly because it calls make recursively. The parent make cannot know

# if the subprocess touched anything so it pessimistically assumes that

# .buildstamp is out of date and need a rebuild.

build-sqlite-tests: | $(NODE_EXE) test/sqlite/.buildstamp ## Build SQLite tests.

else

build-sqlite-tests:

endif

FFI_BINDING_GYPS := $(wildcard test/ffi/*/binding.gyp)

FFI_BINDING_SOURCES := \

$(wildcard test/ffi/*/*.c) \

$(wildcard test/ffi/*/*.def)

ifndef NOFFI

# Depends on $(NODE_EXE) as order-only to avoid ETXTBSY on AIX when make

# tries to execute node while it is still being linked in parallel.

test/ffi/.buildstamp: $(ADDONS_PREREQS) \

$(FFI_BINDING_GYPS) $(FFI_BINDING_SOURCES) | $(NODE_EXE)

@$(call run_build_addons,"$$PWD/test/ffi",$@)

else

test/ffi/.buildstamp:

endif

.PHONY: build-ffi-tests

ifndef NOFFI

build-ffi-tests: | test/ffi/.buildstamp ## Build FFI tests.

else

build-ffi-tests:

endif

.PHONY: clear-stalled

clear-stalled: ## Clear any stalled processes.

$(info Clean up any leftover processes but don't error if found.)

ps awwx | grep Release/node | grep -v grep | cat

@PS_OUT=`ps awwx | grep Release/node | grep -v grep | awk '{print $$1}'`; \

if [ "$${PS_OUT}" ]; then \

echo $${PS_OUT} | xargs kill -9; \

fi

.PHONY: test-build

test-build: | all build-addons build-js-native-api-tests build-node-api-tests build-sqlite-tests build-ffi-tests ## Build all tests.

.PHONY: test-build-js-native-api

test-build-js-native-api: all build-js-native-api-tests ## Build JS Native-API tests.

.PHONY: test-build-node-api

test-build-node-api: all build-node-api-tests ## Build Node-API tests.

.PHONY: test-build-sqlite

test-build-sqlite: all build-sqlite-tests ## Build SQLite tests.

.PHONY: test-build-ffi

test-build-ffi: all build-ffi-tests ## Build FFI tests.

.PHONY: test-all

test-all: test-build ## Run default tests with both Debug and Release builds.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=debug,release

.PHONY: test-all-valgrind

test-all-valgrind: test-build ## Run all tests using valgrind.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=debug,release --valgrind

.PHONY: test-all-suites

test-all-suites: | clear-stalled test-build bench-addons-build doc-only ## Run all test suites.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) test/*

JS_SUITES ?= default

NATIVE_SUITES ?= addons js-native-api node-api embedding

# CI_* variables should be kept synchronized with the ones in vcbuild.bat

CI_NATIVE_SUITES ?= $(NATIVE_SUITES) benchmark

CI_JS_SUITES ?= $(JS_SUITES) pummel

ifeq ($(node_use_openssl_and_icu), false)

CI_DOC := doctool

else

CI_DOC =

endif

.PHONY: test-ci-native

# Related CI job: node-test-commit-arm-fanned

test-ci-native: LOGLEVEL := info ## Build and test addons without building anything else.

test-ci-native: | benchmark/napi/.buildstamp test/addons/.buildstamp test/js-native-api/.buildstamp test/node-api/.buildstamp test/sqlite/.buildstamp test/ffi/.buildstamp

$(PYTHON) tools/test.py $(PARALLEL_ARGS) -p tap --logfile test.tap \

--mode=$(BUILDTYPE_LOWER) --flaky-tests=$(FLAKY_TESTS) \

$(TEST_CI_ARGS) $(CI_NATIVE_SUITES)

.PHONY: test-ci-js

# This target should not use a native compiler at all

# Related CI job: node-test-commit-arm-fanned

test-ci-js: | clear-stalled ## Build and test JavaScript with building anything else.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) -p tap --logfile test.tap \

--mode=$(BUILDTYPE_LOWER) --flaky-tests=$(FLAKY_TESTS) \

--skip-tests=$(CI_SKIP_TESTS) \

$(TEST_CI_ARGS) $(CI_JS_SUITES)

$(info Clean up any leftover processes, error if found.)

ps awwx | grep Release/node | grep -v grep | cat

@PS_OUT=`ps awwx | grep Release/node | grep -v grep | awk '{print $$1}'`; \

if [ "$${PS_OUT}" ]; then \

echo $${PS_OUT} | xargs kill -9; exit 1; \

fi

.PHONY: test-ci

# Related CI jobs: most CI tests, excluding node-test-commit-arm-fanned

test-ci: LOGLEVEL := info ## Build and test everything (CI).

test-ci: | clear-stalled bench-addons-build build-addons build-js-native-api-tests build-node-api-tests build-sqlite-tests build-ffi-tests doc-only

out/Release/cctest --gtest_output=xml:out/junit/cctest.xml

$(PYTHON) tools/test.py $(PARALLEL_ARGS) -p tap --logfile test.tap \

--mode=$(BUILDTYPE_LOWER) --flaky-tests=$(FLAKY_TESTS) \

$(TEST_CI_ARGS) $(CI_JS_SUITES) $(CI_NATIVE_SUITES) $(CI_DOC)

$(info Clean up any leftover processes, error if found.)

ps awwx | grep Release/node | grep -v grep | cat

@PS_OUT=`ps awwx | grep Release/node | grep -v grep | awk '{print $$1}'`; \

if [ "$${PS_OUT}" ]; then \

echo $${PS_OUT} | xargs kill -9; exit 1; \

fi

.PHONY: build-ci

# Prepare the build for running the tests.

# Related CI jobs: most CI tests, excluding node-test-commit-arm-fanned

build-ci: ## Build everything (CI).

$(PYTHON) ./configure --verbose $(CONFIG_FLAGS)

$(MAKE)

$(MAKE) build-ffi-tests

.PHONY: run-ci

# Run by CI tests, exceptions:

# - node-test-commit-arm-fanned (Raspberry Pis), where the binaries are

# cross-compiled, then transferred elsewhere to run different subsets

# of tests. See `test-ci-native` and `test-ci-js`.

# - node-test-commit-linux-coverage: where the build and the tests need

# to be instrumented, see `coverage`.

#

# Using -j1 as the sub target in `test-ci` already have internal parallelism.

# Refs: https://github.com/nodejs/node/pull/23733

run-ci: build-ci ## Build and run all tests (CI).

$(MAKE) test-ci -j1

.PHONY: test-release

.PHONY: test-debug

test-debug: BUILDTYPE_LOWER=debug ## Run tests on a debug build.

test-release test-debug: test-build ## Run tests on a release or debug build.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER)

.PHONY: test-test426

test-test426: all ## Run the Web Platform Tests.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) test426

.PHONY: test-wpt

test-wpt: all ## Run the Web Platform Tests.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) wpt

# https://github.com/nodejs/node/blob/a00d95c73dcac8fc2b316238fb978a7d5aa650c6/.github/workflows/daily-wpt-fyi.yml#L71-L97

# This uses NODE instead of OUT_NODE and if changes are to be made they'd need to be made on all

# non-EOL release lines' since the wpt.fyi job checks out the repository in a state of a given release

# to ensure future changes to the WPT runner don't need to be backported.

.PHONY: test-wpt-report

test-wpt-report: ## Run the Web Platform Tests and generate a report.

$(RM) -r out/wpt

mkdir -p out/wpt

-WPT_REPORT=1 $(PYTHON) tools/test.py --shell '$(NODE)' $(PARALLEL_ARGS) wpt

'$(NODE)' "$$PWD/tools/merge-wpt-reports.mjs"

.PHONY: test-internet

test-internet: all ## Run internet tests.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) internet

.PHONY: test-tick-processor

test-tick-processor: all ## Run tick processor tests.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) tick-processor

.PHONY: test-doc

test-doc: doc-only lint-md ## Build, lint, and verify the docs.

@if [ "$(shell $(node_use_openssl_and_icu))" != "true" ]; then \

echo "Skipping test-doc (no crypto and/or no ICU)"; \

else \

$(PYTHON) tools/test.py $(PARALLEL_ARGS) doctool; \

fi

.PHONY: test-doc-ci

test-doc-ci: doc-only ## Build, lint, and verify the docs (CI).

$(PYTHON) tools/test.py --shell '$(NODE)' $(TEST_CI_ARGS) $(PARALLEL_ARGS) doctool

.PHONY: test-known-issues

test-known-issues: all ## Run tests for known issues.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) known_issues

# Related CI job: node-test-npm

.PHONY: test-npm

test-npm: $(OUT_NODE) ## Run the npm test suite on deps/npm.

'$(OUT_NODE)' tools/test-npm-package --install --logfile=test-npm.tap deps/npm test

.PHONY: test-npm-publish

test-npm-publish: $(OUT_NODE) ## Test the `npm publish` command.

npm_package_config_publishtest=true '$(OUT_NODE)' deps/npm/test/run.js

.PHONY: test-js-native-api

test-js-native-api: test-build-js-native-api ## Run JS Native-API tests.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) js-native-api

.PHONY: test-js-native-api-clean

.NOTPARALLEL: test-js-native-api-clean

test-js-native-api-clean: ## Remove JS Native-API testing artifacts.

$(RM) -r test/js-native-api/*/build

$(RM) test/js-native-api/.buildstamp

.PHONY: test-node-api

test-node-api: test-build-node-api ## Run Node-API tests.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) node-api

.PHONY: test-node-api-clean

.NOTPARALLEL: test-node-api-clean

test-node-api-clean: ## Remove Node-API testing artifacts.

$(RM) -r test/node-api/*/build

$(RM) test/node-api/.buildstamp

.PHONY: test-sqlite

test-sqlite: test-build-sqlite ## Run SQLite tests.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) sqlite

.PHONY: test-sqlite-clean

.NOTPARALLEL: test-sqlite-clean

test-sqlite-clean: ## Remove SQLite testing artifacts.

$(RM) -r test/sqlite/*/build

$(RM) test/sqlite/.buildstamp

.PHONY: test-ffi

test-ffi: test-build-ffi ## Run FFI tests.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) ffi

.PHONY: test-ffi-clean

.NOTPARALLEL: test-ffi-clean

test-ffi-clean: ## Remove FFI testing artifacts.

$(RM) -r test/ffi/*/build

$(RM) test/ffi/.buildstamp

.PHONY: test-addons

test-addons: test-build test-js-native-api test-node-api ## Run addon tests.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) addons

.PHONY: test-addons-clean

.NOTPARALLEL: test-addons-clean

test-addons-clean: ## Remove addon testing artifacts.

$(RM) -r "$(ADDONS_HEADERS_DIR)"

$(RM) -r test/addons/??_*/

$(RM) -r test/addons/*/build

$(RM) test/addons/.buildstamp test/addons/.docbuildstamp test/addons/.headersbuildstamp

$(MAKE) test-js-native-api-clean

$(MAKE) test-node-api-clean

.PHONY: test-with-async-hooks

test-with-async-hooks: ## Run tests with async hooks.

$(MAKE) build-addons

$(MAKE) build-js-native-api-tests

$(MAKE) build-node-api-tests

$(MAKE) cctest

NODE_TEST_WITH_ASYNC_HOOKS=1 $(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) \

$(JS_SUITES) \

$(NATIVE_SUITES)

.PHONY: test-v8

.PHONY: test-v8-all

.PHONY: test-v8-benchmarks

.PHONY: test-v8-intl

.PHONY: test-v8-updates

ifneq ("","$(wildcard deps/v8/tools/run-tests.py)")

# Related CI job: node-test-commit-v8-linux

test-v8: v8 ## Run the V8 test suite on deps/v8.

export PATH="$(NO_BIN_OVERRIDE_PATH)" && \

$(PYTHON) deps/v8/tools/run-tests.py --gn --arch=$(V8_ARCH) $(V8_TEST_OPTIONS) \

mjsunit cctest debugger inspector message preparser \

$(TAP_V8)

$(call convert_to_junit,$(TAP_V8_JSON))

test-v8-intl: v8 ## Run the v8 test suite, intl tests.

export PATH="$(NO_BIN_OVERRIDE_PATH)" && \

$(PYTHON) deps/v8/tools/run-tests.py --gn --arch=$(V8_ARCH) \

intl \

$(TAP_V8_INTL)

$(call convert_to_junit,$(TAP_V8_INTL_JSON))

test-v8-benchmarks: v8 ## Run the v8 test suite, benchmarks.

export PATH="$(NO_BIN_OVERRIDE_PATH)" && \

$(PYTHON) deps/v8/tools/run-tests.py --gn --arch=$(V8_ARCH) \

benchmarks \

$(TAP_V8_BENCHMARKS)

$(call convert_to_junit,$(TAP_V8_BENCHMARKS_JSON))

test-v8-updates: all ## Run the v8 test suite, updates.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) v8-updates

test-v8-all: test-v8 test-v8-intl test-v8-benchmarks test-v8-updates ## Run the entire V8 test suite, including intl, benchmarks, and updates.

# runs all v8 tests

else

test-v8 test-v8-intl test-v8-benchmarks test-v8-all:

$(warning Testing V8 is not available through the source tarball.)

$(warning Use the git repo instead: $$ git clone https://github.com/nodejs/node.git)

endif

apidoc_dirs = out/doc out/doc/api

skip_apidoc_files = doc/api/quic.md

apidoc_sources = $(filter-out $(skip_apidoc_files), $(wildcard doc/api/*.md))

apidocs_html = $(addprefix out/,$(apidoc_sources:.md=.html))

apidocs_json = $(addprefix out/,$(apidoc_sources:.md=.json))

run-npm-ci = $(PWD)/$(NPM) ci --omit=dev

tools/doc/node_modules: tools/doc/package.json

@if [ "$(shell $(node_use_openssl_and_icu))" != "true" ]; then \

echo "Skipping tools/doc/node_modules (no crypto and/or no ICU)"; \

else \

cd tools/doc && $(call available-node,$(run-npm-ci)) \

fi

RAWVER=$(shell $(PYTHON) tools/getnodeversion.py)

VERSION=v$(RAWVER)

.PHONY: doc-only

.NOTPARALLEL: doc-only

doc-only: $(apidoc_dirs) $(apidocs_html) $(apidocs_json) out/doc/api/all.html out/doc/api/all.json out/doc/apilinks.json ## Builds the docs with the local or the global Node.js binary.

.PHONY: doc

doc: $(NODE_EXE) doc-only ## Build Node.js, and then build the documentation with the new binary.

out/doc:

mkdir -p $@

cp doc/node-config-schema.json $@

# If it's a source tarball, doc/api already contains the generated docs.

# Just copy everything under doc/api over.

out/doc/api: doc/api

mkdir -p $@

cp -r doc/api out/doc

# Generate all doc files (individual and all.html/all.json) in a single doc-kit call

# Using grouped targets (&:) so Make knows one command produces all outputs

ifeq ($(OSTYPE),aix)

# TODO(@nodejs/web-infra): AIX is currently hanging during HTML minification

$(apidocs_html) $(apidocs_json) out/doc/api/all.html out/doc/api/all.json:

@echo "Skipping $@ (not currently supported by $(OSTYPE) machines)"

else ifeq ($(OSTYPE),os400)

# TODO(@nodejs/web-infra): IBMi is currently hanging during HTML minification

$(apidocs_html) $(apidocs_json) out/doc/api/all.html out/doc/api/all.json:

@echo "Skipping $@ (not currently supported by $(OSTYPE) machines)"

else

$(apidocs_html) $(apidocs_json) out/doc/api/all.html out/doc/api/all.json &: $(apidoc_sources) tools/doc/node_modules | out/doc/api

@if [ "$(shell $(node_use_openssl_and_icu))" != "true" ]; then \

echo "Skipping $@ (no crypto and/or no ICU)"; \

else \

$(call available-node, \

$(DOC_KIT) generate \

-t legacy-html-all \

-t legacy-json-all \

-i doc/api/*.md \

--ignore $(skip_apidoc_files) \

-o out/doc/api \

-c ./CHANGELOG.md \

-v $(VERSION) \

--index doc/api/index.md \

--type-map doc/type-map.json \

) \

fi

endif

out/doc/apilinks.json: $(wildcard lib/*.js) tools/doc/node_modules | out/doc

@if [ "$(shell $(node_use_openssl_and_icu))" != "true" ]; then \

echo "Skipping $@ (no crypto and/or no ICU)"; \

else \

$(call available-node, \

$(DOC_KIT) generate \

-t api-links \

-i lib/*.js \

-o $(@D) \

-c ./CHANGELOG.md \

-v $(VERSION) \

--type-map doc/type-map.json \

) \

fi

.PHONY: docopen

docopen: doc-only ## Open the documentation in a web browser.

@$(PYTHON) -mwebbrowser file://$(abspath $<)

.PHONY: docserve

docserve: doc-only ## Serve the documentation on localhost:8000.

@$(PYTHON) -m http.server 8000 --bind 127.0.0.1 --directory out/doc/api

.PHONY: docclean

.NOTPARALLEL: docclean

docclean: ## Remove the generated documentation.

$(RM) -r out/doc

CHANGELOG=doc/changelogs/CHANGELOG_V$(firstword $(subst ., ,$(RAWVER))).md

# For nightly builds, you must set DISTTYPE to "nightly", "next-nightly" or

# "custom". For the nightly and next-nightly case, you need to set DATESTRING

# and COMMIT in order to properly name the build.

# For the rc case you need to set CUSTOMTAG to an appropriate CUSTOMTAG number

ifndef DISTTYPE

DISTTYPE=release

endif

ifeq ($(DISTTYPE),release)

FULLVERSION=$(VERSION)

else # ifeq ($(DISTTYPE),release)

ifeq ($(DISTTYPE),custom)

ifndef CUSTOMTAG

$(error CUSTOMTAG is not set for DISTTYPE=custom)

endif # ifndef CUSTOMTAG

TAG=$(CUSTOMTAG)

else # ifeq ($(DISTTYPE),custom)

ifndef DATESTRING

$(error DATESTRING is not set for nightly)

endif # ifndef DATESTRING

ifndef COMMIT

$(error COMMIT is not set for nightly)

endif # ifndef COMMIT

ifneq ($(DISTTYPE),nightly)

ifneq ($(DISTTYPE),next-nightly)

$(error DISTTYPE is not release, custom, nightly or next-nightly)

endif # ifneq ($(DISTTYPE),next-nightly)

endif # ifneq ($(DISTTYPE),nightly)

TAG=$(DISTTYPE)$(DATESTRING)$(COMMIT)

endif # ifeq ($(DISTTYPE),custom)

FULLVERSION=$(VERSION)-$(TAG)

endif # ifeq ($(DISTTYPE),release)

DISTTYPEDIR ?= $(DISTTYPE)

RELEASE=$(shell sed -ne 's/\#define NODE_VERSION_IS_RELEASE \([01]\)/\1/p' src/node_version.h)

PLATFORM=$(shell uname | tr '[:upper:]' '[:lower:]')

ifeq ($(findstring os/390,$PLATFORM),os/390)

PLATFORM ?= os390

endif

NPMVERSION=v$(shell cat deps/npm/package.json | grep '^ "version"' | sed 's/^[^:]*: "\([^"]*\)",.*/\1/')

UNAME_M=$(shell uname -m)

ifeq ($(findstring x86_64,$(UNAME_M)),x86_64)

DESTCPU ?= x64

else

ifeq ($(findstring amd64,$(UNAME_M)),amd64)

DESTCPU ?= x64

else

ifeq ($(findstring ppc64,$(UNAME_M)),ppc64)

DESTCPU ?= ppc64

else

ifeq ($(findstring s390x,$(UNAME_M)),s390x)

DESTCPU ?= s390x

else

ifeq ($(findstring OS/390,$(shell uname -s)),OS/390)

DESTCPU ?= s390x

else

ifeq ($(findstring arm64,$(UNAME_M)),arm64)

DESTCPU ?= arm64

else

ifeq ($(findstring arm,$(UNAME_M)),arm)

DESTCPU ?= arm

else

ifeq ($(findstring aarch64,$(UNAME_M)),aarch64)

DESTCPU ?= arm64

else

ifeq ($(findstring powerpc,$(shell uname -p)),powerpc)