OSSForks/node
1
0
Fork 0
mirror of https://github.com/zebrajr/node.git synced 2026-01-15 12:15:26 +00:00
Code Issues Actions 8 Packages Projects Releases Wiki Activity
45,598 Commits 30 Branches 683 Tags
8cfcf52db832bf7c8200470cc87a1159816a52e4
Go to file
Clone
Open with VS Code Open with VSCodium Open with Intellij IDEA
Download ZIP Download TAR.GZ Download BUNDLE
Michaël Zasso 8cfcf52db8 tools: refloat 10 Node.js patches to cpplint.py 
Cherry-pick 12c8b4d154
Original commit message:
    This commit is a suggestion for adding a rule for NULL usages in the
    code base. This will currently report a number of errors which could be
    ignored using // NOLINT (readability/null_usage)

    PR-URL: https://github.com/nodejs/node/pull/17373
    Reviewed-By: Jon Moss <me@jonathanmoss.me>
    Reviewed-By: Anna Henningsen <anna@addaleax.net>
    Reviewed-By: Timothy Gu <timothygu99@gmail.com>
    Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
    Reviewed-By: Michael Dawson <michael_dawson@ca.ibm.com>
    Reviewed-By: Sakthipriyan Vairamani <thechargingvolcano@gmail.com>
    Reviewed-By: Tobias Nießen <tniessen@tnie.de>

Refs: 12c8b4d154

Cherry-pick fc81e80191
Original commit message:

    Update cpplint.py to check for inline headers when the corresponding
    header is already included.

    PR-URL: https://github.com/nodejs/node/pull/21521
    Reviewed-By: Ben Noordhuis <info@bnoordhuis.nl>
    Reviewed-By: James M Snell <jasnell@gmail.com>

Refs: fc81e80191

Cherry-pick cbc3dd997e
Original commit message:

    src, tools: add check for left leaning pointers

    This commit adds a rule to cpplint to check that pointers in the code
    base lean to the left and not right, and also fixes the violations
    reported.

    PR-URL: https://github.com/nodejs/node/pull/21010
    Reviewed-By: Ben Noordhuis <info@bnoordhuis.nl>
    Reviewed-By: Anna Henningsen <anna@addaleax.net>
    Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
    Reviewed-By: James M Snell <jasnell@gmail.com>

Refs: cbc3dd997e

Cherry-pick 902998190a
Original commit message:

    tools: fix cpplint.py header rules

    THIS COMMIT SHOULD GO WITH THE NEXT. IT WILL FIND NEW LINT.

    PR-URL: https://github.com/nodejs/node/pull/26306
    Reviewed-By: Gireesh Punathil <gpunathi@in.ibm.com>

Refs: 902998190a

Cherry-pick 0a25ace9c3
Original commit message:

    tools: move cpplint configuration to .cpplint

    PR-URL: https://github.com/nodejs/node/pull/27098
    Reviewed-By: Joyee Cheung <joyeec9h3@gmail.com>
    Reviewed-By: Daniel Bevenius <daniel.bevenius@gmail.com>

Refs: 0a25ace9c3

Cherry-pick afa9a7206c
Original commit message:

    tools: refloat update link to google styleguide for cpplint

    This commit updates two old links to Google's C++ styleguide which
    currently result in a 404 when accessed.

    PR-URL: https://github.com/nodejs/node/pull/30876
    Reviewed-By: Michaël Zasso <targos@protonmail.com>
    Reviewed-By: David Carlier <devnexen@gmail.com>
    Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
    Reviewed-By: Richard Lau <riclau@uk.ibm.com>
    Reviewed-By: Rich Trott <rtrott@gmail.com>

Refs: afa9a7206c

Cherry-pick e23bf8f771
Original commit message:

    tools,src: refloat forbid usage of v8::Persistent

    `v8::Persistent` comes with the surprising catch that it requires
    manual cleanup. `v8::Global` doesn’t, making it easier to use,
    and additionally provides move semantics. New code should always
    use `v8::Global`.

    PR-URL: https://github.com/nodejs/node/pull/31018
    Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
    Reviewed-By: Richard Lau <riclau@uk.ibm.com>
    Reviewed-By: James M Snell <jasnell@gmail.com>
    Reviewed-By: David Carlier <devnexen@gmail.com>
    Reviewed-By: Rich Trott <rtrott@gmail.com>
    Reviewed-By: Gus Caplan <me@gus.host>
    Reviewed-By: Joyee Cheung <joyeec9h3@gmail.com>
    Reviewed-By: Ben Noordhuis <info@bnoordhuis.nl>
    Reviewed-By: Stephen Belanger <admin@stephenbelanger.com>

Backport 3d954dcf81
Original commit message:

    tools: remove readability/fn_size rule

    PR-URL: https://github.com/nodejs/node/pull/54663
    Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
    Reviewed-By: Luigi Pinca <luigipinca@gmail.com>

Refs: 3d954dcf81

Cherry-pick c7d7ec7cda
Original commit message:

    tools: check for std::vector<v8::Local> in lint

    PR-URL: https://github.com/nodejs/node/pull/58497
    Reviewed-By: James M Snell <jasnell@gmail.com>
    Reviewed-By: Juan José Arboleda <soyjuanarbol@gmail.com>
    Reviewed-By: Joyee Cheung <joyeec9h3@gmail.com>

Refs: c7d7ec7cda

Cherry-pick e6d94ef106
Original commit message:

    tools: add C++ lint rule to avoid using `String::Utf8Value`

    We should be using our own helpers for this instead.

    PR-URL: https://github.com/nodejs/node/pull/60244
    Reviewed-By: Chengzhong Wu <legendecas@gmail.com>
    Reviewed-By: Rafael Gonzaga <rafael.nunu@hotmail.com>
    Reviewed-By: Edy Silva <edigleyssonsilva@gmail.com>
    Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
    Reviewed-By: Ilyas Shabi <ilyasshabi94@gmail.com>
    Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
    Reviewed-By: Vladimir Morozov <vmorozov@microsoft.com>

Refs: e6d94ef106
PR-URL: https://github.com/nodejs/node/pull/60901
Fixes: https://github.com/nodejs/node/issues/60771
2025-12-02 08:03:25 +00:00
.configurations
build,win: add winget config to set up env
2024-09-30 15:17:20 +00:00
.devcontainer/base
doc: update devcontainer.json and add documentation
2025-11-03 18:26:58 +00:00
.github
tools: add temporal updater
2025-11-25 15:59:21 +00:00
android-patches
…
benchmark
url: remove array.reduce usage
2025-11-23 17:13:58 +00:00
deps
deps,src: prepare for cpplint update
2025-12-02 08:03:23 +00:00
doc
doc: clarify fileURLToPath security considerations
2025-11-30 22:02:12 +00:00
lib
crypto: fix DOMException name for non-extractable key error
2025-11-30 21:45:27 +00:00
src
deps,src: prepare for cpplint update
2025-12-02 08:03:23 +00:00
test
test: update WPT for WebCryptoAPI to 1e4933113d
2025-12-02 00:39:47 +00:00
tools
tools: refloat 10 Node.js patches to cpplint.py
2025-12-02 08:03:25 +00:00
typings
src: add internal binding for constructing SharedArrayBuffers
2025-11-03 13:23:20 +00:00
.clang-format
Revert "build: upgrade clang-format to v18"
2024-09-18 15:58:34 +00:00
.cpplint
tools: disable some new cpplint rules before update
2025-12-02 08:03:24 +00:00
.editorconfig
tools: move ESLint to tools/eslint
2024-06-19 19:54:08 +00:00
.gitattributes
doc: add .gitattributes for md files
2024-04-24 08:15:07 +03:00
.gitignore
doc: update devcontainer.json and add documentation
2025-11-03 18:26:58 +00:00
.gitpod.yml
…
.mailmap
meta: add mailmap entry for aditi-1400
2025-08-03 15:24:00 +00:00
.npmrc
meta: add .npmrc with ignore-scripts=true
2025-09-17 21:46:20 +00:00
.nycrc
build: fix not valid json in coverage
2024-09-30 20:27:55 +00:00
.yamllint.yaml
…
android_configure.py
build: exit on unsupported host OS for Android
2024-05-25 07:39:56 +00:00
android-configure
build: test on Python 3.14 release candidate 3
2025-10-13 14:56:33 +00:00
BSDmakefile
…
BUILD.gn
…
BUILDING.md
doc: correct spelling in BUILDING.md
2025-11-29 17:57:55 +00:00
CHANGELOG.md
2025-11-25, Version 20.19.6 'Iron' (LTS)
2025-11-25 13:25:23 +01:00
CODE_OF_CONDUCT.md
…
codecov.yml
build: update gcovr to 7.2 and codecov config
2024-07-27 21:52:23 +00:00
common.gypi
deps: V8: cherry-pick highway@989a498fdf3
2025-11-13 19:32:11 +00:00
configure
build: test on Python 3.14 release candidate 3
2025-10-13 14:56:33 +00:00
configure.py
build: enable maglev for Linux on s390x
2025-11-28 18:09:19 +00:00
CONTRIBUTING.md
doc, meta: use markdown rather than HTML in CONTRIBUTING.md
2024-06-08 19:16:44 +00:00
eslint.config.mjs
meta: enable jsdoc/check-tag-names rule
2025-07-18 09:28:21 +00:00
glossary.md
doc: fix linter issues
2025-11-08 17:09:29 +00:00
GOVERNANCE.md
doc: clarify details of TSC public and private meetings
2025-07-07 21:25:26 +00:00
LICENSE
deps: update minimatch to 10.1.1
2025-11-17 23:34:43 +00:00
Makefile
build: run embedtest with node_g when BUILDTYPE=Debug
2025-12-01 15:23:30 +00:00
node.gni
build: fix node_use_sqlite for GN builds
2025-08-09 00:22:24 +00:00
node.gyp
build: add temporal_capi gyp
2025-11-23 15:41:31 +00:00
node.gypi
deps: add ngtcp2 test binaries
2025-09-27 12:17:49 -07:00
onboarding.md
doc: remove mention of SMS 2FA
2025-11-15 16:45:12 +00:00
pyproject.toml
build: upgrade Python linter ruff, add rules ASYNC,PERF
2025-10-08 07:37:31 +00:00
README.md
doc: clarify license section and add contributor note
2025-11-17 08:15:38 +00:00
SECURITY.md
doc: add security escalation policy
2025-09-15 06:54:35 +00:00
shell.nix
build: ignore built-in temporal when building with shared lib
2025-11-23 15:41:32 +00:00
tsconfig.json
…
unofficial.gni
src: build v8 tick processor as built-in source text modules
2025-11-11 02:53:13 +00:00
vcbuild.bat
build: add support for Visual Studio 2026
2025-11-19 16:01:37 +00:00

README.md

Node.js

Node.js is an open-source, cross-platform JavaScript runtime environment.

For information on using Node.js, see the Node.js website.

The Node.js project uses an open governance model. The OpenJS Foundation provides support for the project.

Contributors are expected to act in a collaborative manner to move the project forward. We encourage the constructive exchange of contrary opinions and compromise. The TSC reserves the right to limit or block contributors who repeatedly act in ways that discourage, exhaust, or otherwise negatively affect other participants.

This project has a Code of Conduct.

Table of contents

Support

Looking for help? Check out the instructions for getting support.

Release types

  • Current: Under active development. Code for the Current release is in the branch for its major version number (for example, v22.x). Node.js releases a new major version every 6 months, allowing for breaking changes. This happens in April and October every year. Releases appearing each October have a support life of 8 months. Releases appearing each April convert to LTS (see below) each October.
  • LTS: Releases that receive Long Term Support, with a focus on stability and security. Every even-numbered major version will become an LTS release. LTS releases receive 12 months of Active LTS support and a further 18 months of Maintenance. LTS release lines have alphabetically-ordered code names, beginning with v4 Argon. There are no breaking changes or feature additions, except in some special circumstances.
  • Nightly: Code from the Current branch built every 24-hours when there are changes. Use with caution.

Current and LTS releases follow semantic versioning. A member of the Release Team signs each Current and LTS release. For more information, see the Release README.

Download

Binaries, installers, and source tarballs are available at https://nodejs.org/en/download/.

Current and LTS releases

https://nodejs.org/download/release/

The latest directory is an alias for the latest Current release. The latest-codename directory is an alias for the latest release from an LTS line. For example, the latest-hydrogen directory contains the latest Hydrogen (Node.js 18) release.

Nightly releases

https://nodejs.org/download/nightly/

Each directory and filename includes the version (e.g., v22.0.0), followed by the UTC date (e.g., 20240424 for April 24, 2024), and the short commit SHA of the HEAD of the release (e.g., ddd0a9e494). For instance, a full directory name might look like v22.0.0-nightly20240424ddd0a9e494.

API documentation

Documentation for the latest Current release is at https://nodejs.org/api/. Version-specific documentation is available in each release directory in the docs subdirectory. Version-specific documentation is also at https://nodejs.org/download/docs/.

Verifying binaries

Download directories contain a SHASUMS256.txt.asc file with SHA checksums for the files and the releaser PGP signature.

You can get a trusted keyring from nodejs/release-keys, e.g. using curl:

curl -fsLo "/path/to/nodejs-keyring.kbx" "https://github.com/nodejs/release-keys/raw/HEAD/gpg/pubring.kbx"

Alternatively, you can import the releaser keys in your default keyring, see Release keys for commands to how to do that.

Then, you can verify the files you've downloaded locally (if you're using your default keyring, pass --keyring="${GNUPGHOME:-~/.gnupg}/pubring.kbx"):

curl -fsO "https://nodejs.org/dist/${VERSION}/SHASUMS256.txt.asc" \
&& gpgv --keyring="/path/to/nodejs-keyring.kbx" --output SHASUMS256.txt < SHASUMS256.txt.asc \
&& shasum --check SHASUMS256.txt --ignore-missing

Building Node.js

See BUILDING.md for instructions on how to build Node.js from source and a list of supported platforms.

Security

For information on reporting security vulnerabilities in Node.js, see SECURITY.md.

Contributing to Node.js

Current project team members

For information about the governance of the Node.js project, see GOVERNANCE.md.

TSC (Technical Steering Committee)

TSC voting members

TSC regular members

TSC emeriti members

TSC emeriti members

Collaborators

Emeriti

Collaborator emeriti

Collaborators follow the Collaborator Guide in maintaining the Node.js project.

Triagers

Triagers follow the Triage Guide when responding to new issues.

Release keys

Primary GPG keys for Node.js Releasers (some Releasers sign with subkeys):

You can use the keyring the project maintains at https://github.com/nodejs/release-keys/raw/refs/heads/main/gpg-only-active-keys/pubring.kbx. Alternatively, you can import them from a public key server. Have in mind that the project cannot guarantee the availability of the server nor the keys on that server.

gpg --keyserver hkps://keys.openpgp.org --recv-keys 5BE8A3F6C8A5C01D106C0AD820B1A390B168D356 # Antoine du Hamel
gpg --keyserver hkps://keys.openpgp.org --recv-keys DD792F5973C6DE52C432CBDAC77ABFA00DDBF2B7 # Juan José Arboleda
gpg --keyserver hkps://keys.openpgp.org --recv-keys CC68F5A3106FF448322E48ED27F5E38D5B0A215F # Marco Ippolito
gpg --keyserver hkps://keys.openpgp.org --recv-keys 8FCCA13FEF1D0C2E91008E09770F7A9A5AE15600 # Michaël Zasso
gpg --keyserver hkps://keys.openpgp.org --recv-keys 890C08DB8579162FEE0DF9DB8BEAB4DFCF555EF4 # Rafael Gonzaga
gpg --keyserver hkps://keys.openpgp.org --recv-keys C82FA3AE1CBEDC6BE46B9360C43CEC45C17AB93C # Richard Lau
gpg --keyserver hkps://keys.openpgp.org --recv-keys 108F52B48DB57BB0CC439B2997B01419BD92F80A # Ruy Adorno
gpg --keyserver hkps://keys.openpgp.org --recv-keys A363A499291CBBC940DD62E41F10027AF002F8B0 # Ulises Gascón

See Verifying binaries for how to use these keys to verify a downloaded file.

Other keys used to sign some previous releases

The project maintains a keyring able to verify all past releases of Node.js at https://github.com/nodejs/release-keys/raw/refs/heads/main/gpg/pubring.kbx.

Security release stewards

When possible, the commitment to take slots in the security release steward rotation is made by companies in order to ensure individuals who act as security stewards have the support and recognition from their employer to be able to prioritize security releases. Security release stewards manage security releases on a rotation basis as outlined in the security release process.

License

Node.js is licensed under the MIT License.

This project also depends on external libraries that may use different open-source licenses. For a complete list of included licenses, please see the LICENSE file.

If you are contributing documentation or source changes, please ensure your additions comply with the project’s license guidelines.

Reference in New Issue View Git Blame Copy Permalink
Description
Node.js JavaScript runtime ✨🐢🚀✨ nodejs.org
Readme Multiple Licenses 1.4 GiB
Languages
JavaScript 62.4%
C++ 23.1%
Python 10.1%
C 2.7%
HTML 0.6%
Other 0.9%