2017-03-31 19:07:40 +02:00
< p align = "center" >
2017-04-10 18:13:20 +02:00
< a href = "https://nodejs.org/" >
< img alt = "Node.js" src = "https://nodejs.org/static/images/logo-light.svg" width = "400" / >
< / a >
2017-03-31 19:07:40 +02:00
< / p >
< p align = "center" >
< a title = "CII Best Practices" href = "https://bestpractices.coreinfrastructure.org/projects/29" > < img src = "https://bestpractices.coreinfrastructure.org/projects/29/badge" > < / a >
< / p >
2011-01-24 05:52:37 +01:00
2018-01-31 18:53:10 +01:00
Node.js is a JavaScript runtime built on Chrome's V8 JavaScript engine. For
more information on using Node.js, see the
[Node.js Website][].
2015-12-07 06:29:24 +01:00
2015-10-22 06:09:33 +02:00
The Node.js project is supported by the
[Node.js Foundation ](https://nodejs.org/en/foundation/ ). Contributions,
2016-10-02 04:28:37 +02:00
policies, and releases are managed under an
2017-03-31 16:21:32 +02:00
[open governance model ](./GOVERNANCE.md ).
**This project is bound by a [Code of Conduct][].**
2014-12-02 03:06:21 +01:00
2017-03-01 15:45:01 +01:00
# Table of Contents
2017-10-27 01:14:35 +02:00
* [Support ](#support )
2017-03-01 15:45:01 +01:00
* [Release Types ](#release-types )
* [Download ](#download )
* [Current and LTS Releases ](#current-and-lts-releases )
* [Nightly Releases ](#nightly-releases )
* [API Documentation ](#api-documentation )
* [Verifying Binaries ](#verifying-binaries )
* [Building Node.js ](#building-nodejs )
2017-11-17 23:07:01 +01:00
* [Security ](#security )
* [Current Project Team Members ](#current-project-team-members )
* [TSC (Technical Steering Committee) ](#tsc-technical-steering-committee )
* [Collaborators ](#collaborators )
* [Release Team ](#release-team )
2017-11-17 23:04:19 +01:00
* [Contributing to Node.js ](#contributing-to-nodejs )
2017-03-01 15:45:01 +01:00
2017-10-27 01:14:35 +02:00
## Support
Node.js contributors have limited availability to address general support
questions. Please make sure you are using a [currently-supported version of
Node.js](https://github.com/nodejs/Release#release-schedule).
2016-05-10 23:46:12 +02:00
2017-10-27 01:14:35 +02:00
When looking for support, please first search for your question in these venues:
2016-07-20 17:24:57 +02:00
2017-10-27 01:14:35 +02:00
* [Node.js Website][]
2016-09-17 05:04:50 +02:00
* [Node.js Help][]
2017-10-27 01:14:35 +02:00
* [Open or closed issues in the Node.js GitHub organization ](https://github.com/issues?utf8=%E2%9C%93&q=sort%3Aupdated-desc+org%3Anodejs+is%3Aissue )
* [Questions tagged 'node.js' on StackOverflow][]
If you didn't find an answer in one of the venues above, you can:
2016-07-20 17:24:57 +02:00
2017-10-27 01:14:35 +02:00
* Join the **unofficial** [#node.js channel on chat.freenode.net][]. See
< http: / / nodeirc . info / > for more information.
2016-07-20 17:24:57 +02:00
2017-10-27 01:14:35 +02:00
GitHub issues are meant for tracking enhancements and bugs, not general support.
2016-07-20 17:24:57 +02:00
2017-10-27 01:14:35 +02:00
Remember, libre != gratis; the open source license grants you the freedom to use
and modify, but not commitments of other people's time. Please be respectful,
and set your expectations accordingly.
2016-05-10 23:46:12 +02:00
2015-10-22 06:47:36 +02:00
## Release Types
The Node.js project maintains multiple types of releases:
2016-04-21 02:05:54 +02:00
* **Current**: Released from active development branches of this repository,
2017-11-23 00:07:47 +01:00
versioned by [SemVer ](https://semver.org ) and signed by a member of the
2015-10-22 06:47:36 +02:00
[Release Team ](#release-team ).
2016-04-21 02:05:54 +02:00
Code for Current releases is organized in this repository by major version
2016-10-02 04:28:37 +02:00
number. For example: [v4.x ](https://github.com/nodejs/node/tree/v4.x ).
2016-04-21 02:05:54 +02:00
The major version number of Current releases will increment every 6 months
2015-10-22 06:47:36 +02:00
allowing for breaking changes to be introduced. This happens in April and
2016-04-21 02:05:54 +02:00
October every year. Current release lines beginning in October each year have
a maximum support life of 8 months. Current release lines beginning in April
2015-10-22 06:47:36 +02:00
each year will convert to LTS (see below) after 6 months and receive further
support for 30 months.
* **LTS**: Releases that receive Long-term Support, with a focus on stability
2016-04-21 02:05:54 +02:00
and security. Every second Current release line (major version) will become an
2015-10-22 06:47:36 +02:00
LTS line and receive 18 months of _Active LTS_ support and a further 12
months of _Maintenance_ . LTS release lines are given alphabetically
2016-02-01 05:37:08 +01:00
ordered codenames, beginning with v4 Argon. LTS releases are less frequent
2015-10-22 06:47:36 +02:00
and will attempt to maintain consistent major and minor version numbers,
only incrementing patch version numbers. There are no breaking changes or
2017-07-16 03:41:05 +02:00
feature additions, except in some special circumstances.
2016-04-21 02:05:54 +02:00
* **Nightly**: Versions of code in this repository on the current Current
2015-10-22 06:47:36 +02:00
branch, automatically built every 24-hours where changes exist. Use with
caution.
2017-07-16 03:41:05 +02:00
More information can be found in the [LTS README ](https://github.com/nodejs/LTS/ ).
2017-11-17 23:07:01 +01:00
### Download
2015-01-31 11:55:37 +01:00
2015-02-15 01:52:30 +01:00
Binaries, installers, and source tarballs are available at
2015-08-13 18:14:34 +02:00
< https: / / nodejs . org > .
2015-01-31 11:55:37 +01:00
2017-03-01 15:45:01 +01:00
#### Current and LTS Releases
2016-04-21 02:05:54 +02:00
**Current** and **LTS** releases are available at
2015-10-22 06:47:36 +02:00
< https: / / nodejs . org / download / release / > , listed under their version strings.
The [latest ](https://nodejs.org/download/release/latest/ ) directory is an
2016-04-21 02:05:54 +02:00
alias for the latest Current release. The latest LTS release from an LTS
2016-01-08 13:13:33 +01:00
line is available in the form: latest-_codename_. For example:
2017-10-27 06:15:34 +02:00
< https: / / nodejs . org / download / release / latest-argon > .
2015-01-31 11:55:37 +01:00
2017-03-01 15:45:01 +01:00
#### Nightly Releases
2015-01-31 11:55:37 +01:00
**Nightly** builds are available at
2015-08-13 18:14:34 +02:00
< https: / / nodejs . org / download / nightly / > , listed under their version
2015-01-31 11:55:37 +01:00
string which includes their date (in UTC time) and the commit SHA at
the HEAD of the release.
2017-03-01 15:45:01 +01:00
#### API Documentation
2015-01-31 11:55:37 +01:00
**API documentation** is available in each release and nightly
2015-10-22 06:47:36 +02:00
directory under _docs_ . < https: // nodejs . org / api /> points to the API
documentation of the latest stable version.
2015-01-31 11:55:37 +01:00
### Verifying Binaries
2017-12-07 06:11:44 +01:00
Current, LTS, and Nightly download directories all contain a SHASUMS256.txt
2015-01-31 11:55:37 +01:00
file that lists the SHA checksums for each file available for
2016-04-08 20:08:23 +02:00
download.
2017-12-07 06:11:44 +01:00
The SHASUMS256.txt can be downloaded using `curl` .
2016-04-08 20:08:23 +02:00
2016-08-04 01:32:05 +02:00
```console
2016-04-08 20:08:23 +02:00
$ curl -O https://nodejs.org/dist/vx.y.z/SHASUMS256.txt
```
To check that a downloaded file matches the checksum, run
2015-01-31 11:55:37 +01:00
it through `sha256sum` with a command such as:
2016-08-04 01:32:05 +02:00
```console
2015-08-13 18:14:34 +02:00
$ grep node-vx.y.z.tar.gz SHASUMS256.txt | sha256sum -c -
2015-01-31 11:55:37 +01:00
```
2017-12-07 06:11:44 +01:00
Current and LTS releases (but not Nightlies) also have the GPG detached
signature of SHASUMS256.txt available as SHASUMS256.txt.sig. You can use `gpg`
to verify that SHASUMS256.txt has not been tampered with.
2015-01-31 11:55:37 +01:00
2017-08-31 02:05:39 +02:00
To verify SHASUMS256.txt has not been altered, you will first need to import
all of the GPG keys of individuals authorized to create releases. They are
2015-08-20 06:51:00 +02:00
listed at the bottom of this README under [Release Team ](#release-team ).
Use a command such as this to import the keys:
2015-01-31 11:55:37 +01:00
2016-08-04 01:32:05 +02:00
```console
$ gpg --keyserver pool.sks-keyservers.net --recv-keys DD8F2338BAE7501E3DD5AC78C273792F7D83545D
2015-01-31 11:55:37 +01:00
```
2017-12-07 06:11:44 +01:00
See the bottom of this README for a full script to import active release keys.
2015-01-31 11:55:37 +01:00
2017-08-31 02:05:39 +02:00
Next, download the SHASUMS256.txt.sig for the release:
2015-01-31 11:55:37 +01:00
2017-08-31 02:05:39 +02:00
```console
$ curl -O https://nodejs.org/dist/vx.y.z/SHASUMS256.txt.sig
```
After downloading the appropriate SHASUMS256.txt and SHASUMS256.txt.sig files,
you can then use `gpg --verify SHASUMS256.txt.sig SHASUMS256.txt` to verify
that the file has been signed by an authorized member of the Node.js team.
Once verified, use the SHASUMS256.txt file to get the checksum for
2015-01-31 11:55:37 +01:00
the binary verification command above.
2016-03-10 00:41:52 +01:00
## Building Node.js
2015-01-02 12:52:50 +01:00
2016-03-10 00:41:52 +01:00
See [BUILDING.md ](BUILDING.md ) for instructions on how to build
2017-05-09 21:33:30 +02:00
Node.js from source. The document also contains a list of
officially supported platforms.
2011-08-27 00:04:47 +02:00
2015-06-11 12:37:37 +02:00
## Security
2015-01-02 12:52:50 +01:00
2018-01-01 05:54:56 +01:00
Security flaws in Node.js should be reported by emailing security@nodejs.org.
Please do not disclose security bugs publicly until they have been handled by
the security team.
2015-06-11 12:37:37 +02:00
2018-01-01 05:54:56 +01:00
Your email will be acknowledged within 24 hours, and you will receive a more
2015-06-11 12:37:37 +02:00
detailed response to your email within 48 hours indicating the next steps in
handling your report.
2015-01-02 12:52:50 +01:00
2017-07-25 21:52:49 +02:00
There are no hard and fast rules to determine if a bug is worth reporting as
2018-01-01 05:54:56 +01:00
a security issue. The general rule is an issue worth reporting should allow an
attacker to compromise the confidentiality, integrity, or availability of the
Node.js application or its system for which the attacker does not already have
the capability.
2017-07-25 21:52:49 +02:00
To illustrate the point, here are some examples of past issues and what the
2017-12-18 08:29:39 +01:00
Security Response Team thinks of them. When in doubt, however, please do send
2017-07-25 21:52:49 +02:00
us a report nonetheless.
### Public disclosure preferred
- [#14519 ](https://github.com/nodejs/node/issues/14519 ): _Internal domain
function can be used to cause segfaults_. Causing program termination using
2017-11-19 05:01:57 +01:00
either the public JavaScript APIs or the private bindings layer APIs requires
the ability to execute arbitrary JavaScript code, which is already the highest
2017-07-25 21:52:49 +02:00
level of privilege possible.
- [#12141 ](https://github.com/nodejs/node/pull/12141 ): _buffer: zero fill
2017-12-05 16:03:04 +01:00
Buffer(num) by default_. The buffer constructor behavior was documented,
2017-07-25 21:52:49 +02:00
but found to be prone to [mis-use ](https://snyk.io/blog/exploiting-buffer/ ).
It has since been changed, but despite much debate, was not considered misuse
prone enough to justify fixing in older release lines and breaking our
API stability contract.
### Private disclosure preferred
- [CVE-2016-7099 ](https://nodejs.org/en/blog/vulnerability/september-2016-security-releases/ ):
_Fix invalid wildcard certificate validation check_ . This is a high severity
defect that would allow a malicious TLS server to serve an invalid wildcard
certificate for its hostname and be improperly validated by a Node.js client.
- [#5507 ](https://github.com/nodejs/node/pull/5507 ): _Fix a defect that makes
the CacheBleed Attack possible_. Many, though not all, OpenSSL vulnerabilities
in the TLS/SSL protocols also effect Node.js.
- [CVE-2016-2216 ](https://nodejs.org/en/blog/vulnerability/february-2016-security-releases/ ):
_Fix defects in HTTP header parsing for requests and responses that can allow
response splitting_. While the impact of this vulnerability is application and
network dependent, it is remotely exploitable in the HTTP protocol.
When in doubt, please do send us a report.
2015-01-02 12:52:50 +01:00
## Current Project Team Members
2015-08-13 18:14:34 +02:00
The Node.js project team comprises a group of core collaborators and a sub-group
2017-08-22 07:44:50 +02:00
that forms the _Technical Steering Committee_ (TSC) which governs the project.
For more information about the governance of the Node.js project, see
2015-01-02 12:52:50 +01:00
[GOVERNANCE.md ](./GOVERNANCE.md ).
2017-08-22 07:44:50 +02:00
### TSC (Technical Steering Committee)
2015-05-15 21:51:37 +02:00
2016-08-04 01:32:05 +02:00
* [addaleax ](https://github.com/addaleax ) -
2017-01-31 19:57:08 +01:00
**Anna Henningsen** < anna@addaleax.net> (she/her)
2016-08-04 01:32:05 +02:00
* [ChALkeR ](https://github.com/ChALkeR ) -
2017-01-31 19:57:08 +01:00
**Сковорода Никита Андреевич** < chalkerx@gmail.com> (he/him)
2016-08-04 01:32:05 +02:00
* [cjihrig ](https://github.com/cjihrig ) -
**Colin Ihrig** < cjihrig@gmail.com>
2017-12-13 16:56:19 +01:00
* [danbev ](https://github.com/danbev ) -
**Daniel Bevenius** < daniel.bevenius@gmail.com>
2016-08-04 01:32:05 +02:00
* [evanlucas ](https://github.com/evanlucas ) -
2017-01-31 19:57:08 +01:00
**Evan Lucas** < evanlucas@me.com> (he/him)
2017-02-22 01:32:38 +01:00
* [fhinkel ](https://github.com/fhinkel ) -
2017-10-07 23:29:50 +02:00
**Franziska Hinkelmann** < franziska.hinkelmann@gmail.com> (she/her)
2017-05-06 00:41:29 +02:00
* [Fishrock123 ](https://github.com/Fishrock123 ) -
2016-08-04 01:32:05 +02:00
**Jeremiah Senkpiel** < fishrock123@rocketmail.com>
2018-01-31 18:35:31 +01:00
* [gibfahn ](https://github.com/gibfahn ) -
**Gibson Fahnestock** < gibfahn@gmail.com> (he/him)
2016-08-04 01:32:05 +02:00
* [jasnell ](https://github.com/jasnell ) -
2017-01-31 19:57:08 +01:00
**James M Snell** < jasnell@gmail.com> (he/him)
2017-06-08 00:14:50 +02:00
* [joyeecheung ](https://github.com/joyeecheung ) -
**Joyee Cheung** < joyeec9h3@gmail.com> (she/her)
* [mcollina ](https://github.com/mcollina ) -
**Matteo Collina** < matteo.collina@gmail.com> (he/him)
2016-08-04 01:32:05 +02:00
* [mhdawson ](https://github.com/mhdawson ) -
2017-01-31 19:57:08 +01:00
**Michael Dawson** < michael_dawson@ca.ibm.com> (he/him)
2017-01-03 05:29:56 +01:00
* [MylesBorins ](https://github.com/MylesBorins ) -
2017-01-31 19:57:08 +01:00
**Myles Borins** < myles.borins@gmail.com> (he/him)
2016-08-04 01:32:05 +02:00
* [ofrobots ](https://github.com/ofrobots ) -
**Ali Ijaz Sheikh** < ofrobots@google.com>
* [rvagg ](https://github.com/rvagg ) -
**Rod Vagg** < rod@vagg.org>
2016-12-21 08:15:56 +01:00
* [targos ](https://github.com/targos ) -
2017-01-31 19:57:08 +01:00
**Michaël Zasso** < targos@protonmail.com> (he/him)
2016-11-02 21:41:40 +01:00
* [thefourtheye ](https://github.com/thefourtheye ) -
2017-01-31 19:57:08 +01:00
**Sakthipriyan Vairamani** < thechargingvolcano@gmail.com> (he/him)
2016-08-04 01:32:05 +02:00
* [trevnorris ](https://github.com/trevnorris ) -
**Trevor Norris** < trev.norris@gmail.com>
* [Trott ](https://github.com/Trott ) -
2017-01-31 19:57:08 +01:00
**Rich Trott** < rtrott@gmail.com> (he/him)
2015-05-15 21:51:37 +02:00
2017-08-22 07:44:50 +02:00
### TSC Emeriti
2017-05-26 07:58:04 +02:00
2017-09-26 19:28:03 +02:00
* [bnoordhuis ](https://github.com/bnoordhuis ) -
**Ben Noordhuis** < info@bnoordhuis.nl>
2017-05-26 07:58:04 +02:00
* [chrisdickinson ](https://github.com/chrisdickinson ) -
**Chris Dickinson** < christopher.s.dickinson@gmail.com>
2018-02-13 08:09:44 +01:00
* [indutny ](https://github.com/indutny ) -
**Fedor Indutny** < fedor.indutny@gmail.com>
2017-05-26 07:58:04 +02:00
* [isaacs ](https://github.com/isaacs ) -
**Isaac Z. Schlueter** < i@izs.me>
2018-01-02 18:47:19 +01:00
* [joshgav ](https://github.com/joshgav ) -
**Josh Gavant** < josh.gavant@outlook.com>
2018-01-31 18:36:51 +01:00
* [mscdex ](https://github.com/mscdex ) -
**Brian White** < mscdex@mscdex.net>
2017-10-02 05:43:56 +02:00
* [nebrius ](https://github.com/nebrius ) -
**Bryan Hughes** < bryan@nebri.us>
2017-05-26 07:58:04 +02:00
* [orangemocha ](https://github.com/orangemocha ) -
**Alexis Campailla** < orangemocha@nodejs.org>
* [piscisaureus ](https://github.com/piscisaureus ) -
**Bert Belder** < bertbelder@gmail.com>
2017-10-14 02:11:52 +02:00
* [shigeki ](https://github.com/shigeki ) -
**Shigeki Ohtsu** < ohtsu@ohtsu.org> (he/him)
2017-05-26 07:58:04 +02:00
2015-05-15 21:51:37 +02:00
### Collaborators
2017-01-31 14:33:24 +01:00
* [abouthiroppy ](https://github.com/abouthiroppy ) -
2017-01-31 19:57:08 +01:00
**Yuta Hiroto** < hello@about-hiroppy.com> (he/him)
2017-05-29 17:53:30 +02:00
* [addaleax ](https://github.com/addaleax ) -
**Anna Henningsen** < anna@addaleax.net> (she/her)
2016-09-21 01:36:19 +02:00
* [ak239 ](https://github.com/ak239 ) -
**Aleksei Koziatinskii** < ak239spb@gmail.com>
2016-08-04 01:32:05 +02:00
* [andrasq ](https://github.com/andrasq ) -
**Andras** < andras@kinvey.com>
* [AndreasMadsen ](https://github.com/AndreasMadsen ) -
2017-01-31 19:57:08 +01:00
**Andreas Madsen** < amwebdk@gmail.com> (he/him)
2017-04-14 18:36:35 +02:00
* [AnnaMag ](https://github.com/AnnaMag ) -
**Anna M. Kedzierska** < anna.m.kedzierska@gmail.com>
2017-10-18 20:53:48 +02:00
* [apapirovski ](https://github.com/apapirovski ) -
**Anatoli Papirovski** < apapirovski@mac.com> (he/him)
2017-04-07 18:20:09 +02:00
* [aqrln ](https://github.com/aqrln ) -
2017-04-29 23:03:53 +02:00
**Alexey Orlenko** < eaglexrlnk@gmail.com> (he/him)
2016-08-04 01:32:05 +02:00
* [bengl ](https://github.com/bengl ) -
2017-01-31 19:57:08 +01:00
**Bryan English** < bryan@bryanenglish.com> (he/him)
2016-08-04 01:32:05 +02:00
* [benjamingr ](https://github.com/benjamingr ) -
**Benjamin Gruenbaum** < benjamingr@gmail.com>
* [bmeck ](https://github.com/bmeck ) -
**Bradley Farias** < bradley.meck@gmail.com>
2017-09-29 07:21:27 +02:00
* [bmeurer ](https://github.com/bmeurer ) -
**Benedikt Meurer** < benedikt.meurer@gmail.com>
2017-05-29 17:53:30 +02:00
* [bnoordhuis ](https://github.com/bnoordhuis ) -
**Ben Noordhuis** < info@bnoordhuis.nl>
2016-08-04 01:32:05 +02:00
* [brendanashworth ](https://github.com/brendanashworth ) -
**Brendan Ashworth** < brendan.ashworth@me.com>
2017-08-16 18:24:17 +02:00
* [BridgeAR ](https://github.com/BridgeAR ) -
**Ruben Bridgewater** < ruben@bridgewater.de>
2016-08-04 01:32:05 +02:00
* [bzoz ](https://github.com/bzoz ) -
**Bartosz Sosnowski** < bartosz@janeasystems.com>
* [calvinmetcalf ](https://github.com/calvinmetcalf ) -
**Calvin Metcalf** < calvin.metcalf@gmail.com>
2017-05-29 17:53:30 +02:00
* [ChALkeR ](https://github.com/ChALkeR ) -
**Сковорода Никита Андреевич** < chalkerx@gmail.com> (he/him)
* [chrisdickinson ](https://github.com/chrisdickinson ) -
**Chris Dickinson** < christopher.s.dickinson@gmail.com>
* [cjihrig ](https://github.com/cjihrig ) -
**Colin Ihrig** < cjihrig@gmail.com>
2016-08-04 01:32:05 +02:00
* [claudiorodriguez ](https://github.com/claudiorodriguez ) -
**Claudio Rodriguez** < cjrodr@yahoo.com>
2016-08-30 11:05:33 +02:00
* [danbev ](https://github.com/danbev ) -
**Daniel Bevenius** < daniel.bevenius@gmail.com>
2017-04-16 00:51:48 +02:00
* [DavidCai1993 ](https://github.com/DavidCai1993 ) -
**David Cai** < davidcai1993@yahoo.com> (he/him)
2018-02-09 16:00:00 +01:00
* [devsnek ](https://github.com/devsnek ) -
**Gus Caplan** < me@gus.host> (he/him)
2017-01-18 22:09:36 +01:00
* [edsadr ](https://github.com/edsadr ) -
2017-01-31 19:57:08 +01:00
**Adrian Estrada** < edsadr@gmail.com> (he/him)
2016-08-04 01:32:05 +02:00
* [eljefedelrodeodeljefe ](https://github.com/eljefedelrodeodeljefe ) -
**Robert Jefe Lindstaedt** < robert.lindstaedt@gmail.com>
* [estliberitas ](https://github.com/estliberitas ) -
**Alexander Makarenko** < estliberitas@gmail.com>
2016-09-21 18:57:01 +02:00
* [eugeneo ](https://github.com/eugeneo ) -
**Eugene Ostroukhov** < eostroukhov@google.com>
2017-05-29 17:53:30 +02:00
* [evanlucas ](https://github.com/evanlucas ) -
**Evan Lucas** < evanlucas@me.com> (he/him)
* [fhinkel ](https://github.com/fhinkel ) -
2017-10-07 23:29:50 +02:00
**Franziska Hinkelmann** < franziska.hinkelmann@gmail.com> (she/her)
2016-08-04 01:32:05 +02:00
* [firedfox ](https://github.com/firedfox ) -
**Daniel Wang** < wangyang0123@gmail.com>
2017-05-29 17:53:30 +02:00
* [Fishrock123 ](https://github.com/Fishrock123 ) -
**Jeremiah Senkpiel** < fishrock123@rocketmail.com>
2017-08-08 18:10:47 +02:00
* [gabrielschulhof ](https://github.com/gabrielschulhof ) -
**Gabriel Schulhof** < gabriel.schulhof@intel.com>
2016-08-04 01:32:05 +02:00
* [geek ](https://github.com/geek ) -
**Wyatt Preul** < wpreul@gmail.com>
2016-09-14 18:39:02 +02:00
* [gibfahn ](https://github.com/gibfahn ) -
2017-01-31 19:57:08 +01:00
**Gibson Fahnestock** < gibfahn@gmail.com> (he/him)
2017-06-28 19:01:49 +02:00
* [gireeshpunathil ](https://github.com/gireeshpunathil ) -
**Gireesh Punathil** < gpunathi@in.ibm.com> (he/him)
2017-11-21 18:52:28 +01:00
* [guybedford ](https://github.com/guybedford ) -
**Guy Bedford** < guybedford@gmail.com> (he/him)
2017-11-07 15:10:55 +01:00
* [hashseed ](https://github.com/hashseed ) -
**Yang Guo** < yangguo@chromium.org> (he/him)
2016-08-04 01:32:05 +02:00
* [iarna ](https://github.com/iarna ) -
**Rebecca Turner** < me@re-becca.org>
2017-05-06 00:41:29 +02:00
* [imran-iq ](https://github.com/imran-iq ) -
**Imran Iqbal** < imran@imraniqbal.org>
2016-09-14 08:12:26 +02:00
* [imyller ](https://github.com/imyller ) -
**Ilkka Myller** < ilkka.myller@nodefield.com>
2017-05-29 17:53:30 +02:00
* [indutny ](https://github.com/indutny ) -
**Fedor Indutny** < fedor.indutny@gmail.com>
2016-12-07 19:21:00 +01:00
* [italoacasas ](https://github.com/italoacasas ) -
2017-01-31 19:57:08 +01:00
**Italo A. Casas** < me@italoacasas.com> (he/him)
2016-08-04 01:32:05 +02:00
* [JacksonTian ](https://github.com/JacksonTian ) -
2016-10-05 20:22:55 +02:00
**Jackson Tian** < shyvo1987@gmail.com>
2017-05-29 17:53:30 +02:00
* [jasnell ](https://github.com/jasnell ) -
**James M Snell** < jasnell@gmail.com> (he/him)
2017-05-24 19:43:55 +02:00
* [jasongin ](https://github.com/jasongin ) -
**Jason Ginchereau** < jasongin@microsoft.com>
2016-08-04 01:32:05 +02:00
* [jbergstroem ](https://github.com/jbergstroem ) -
**Johan Bergström** < bugs@bergstroem.nu>
* [jhamhader ](https://github.com/jhamhader ) -
**Yuval Brik** < yuval@brik.org.il>
2017-04-15 17:30:42 +02:00
* [jkrems ](https://github.com/jkrems ) -
**Jan Krems** < jan.krems@gmail.com> (he/him)
2016-08-04 01:32:05 +02:00
* [joaocgreis ](https://github.com/joaocgreis ) -
**João Reis** < reis@janeasystems.com>
2016-08-17 19:30:36 +02:00
* [joshgav ](https://github.com/joshgav ) -
**Josh Gavant** < josh.gavant@outlook.com>
2017-05-29 17:53:30 +02:00
* [joyeecheung ](https://github.com/joyeecheung ) -
**Joyee Cheung** < joyeec9h3@gmail.com> (she/her)
2016-08-04 01:32:05 +02:00
* [julianduque ](https://github.com/julianduque ) -
2017-01-31 19:57:08 +01:00
**Julian Duque** < julianduquej@gmail.com> (he/him)
2016-08-04 01:32:05 +02:00
* [JungMinu ](https://github.com/JungMinu ) -
2017-02-12 04:07:31 +01:00
**Minwoo Jung** < minwoo@nodesource.com> (he/him)
2017-10-09 23:14:19 +02:00
* [kfarnung ](https://github.com/kfarnung ) -
**Kyle Farnung** < kfarnung@microsoft.com> (he/him)
2017-05-24 19:43:55 +02:00
* [kunalspathak ](https://github.com/kunalspathak ) -
**Kunal Pathak** < kunal.pathak@microsoft.com>
2016-08-04 01:32:05 +02:00
* [lance ](https://github.com/lance ) -
**Lance Ball** < lball@redhat.com>
2018-01-11 16:48:17 +01:00
* [Leko ](https://github.com/Leko ) -
**Shingo Inoue** < leko.noor@gmail.com> (he/him)
2016-08-30 07:53:41 +02:00
* [lpinca ](https://github.com/lpinca ) -
2017-01-31 19:57:08 +01:00
**Luigi Pinca** < luigipinca@gmail.com> (he/him)
2017-04-29 23:03:53 +02:00
* [lucamaraschi ](https://github.com/lucamaraschi ) -
**Luca Maraschi** < luca.maraschi@gmail.com> (he/him)
2017-11-24 20:33:59 +01:00
* [maclover7 ](https://github.com/maclover7 ) -
**Jon Moss** < me@jonathanmoss.me> (he/him)
2017-05-29 17:53:30 +02:00
* [mcollina ](https://github.com/mcollina ) -
**Matteo Collina** < matteo.collina@gmail.com> (he/him)
* [mhdawson ](https://github.com/mhdawson ) -
**Michael Dawson** < michael_dawson@ca.ibm.com> (he/him)
2016-08-04 01:32:05 +02:00
* [micnic ](https://github.com/micnic ) -
2017-01-31 19:57:08 +01:00
**Nicu Micleușanu** < micnic90@gmail.com> (he/him)
2016-08-04 01:32:05 +02:00
* [mikeal ](https://github.com/mikeal ) -
**Mikeal Rogers** < mikeal.rogers@gmail.com>
2017-05-29 17:53:30 +02:00
* [misterdjules ](https://github.com/misterdjules ) -
**Julien Gilli** < jgilli@nodejs.org>
2018-02-12 18:43:11 +01:00
* [mmarchini ](https://github.com/mmarchini ) -
**Matheus Marchini** < matheus@sthima.com>
2017-05-29 17:53:30 +02:00
* [mscdex ](https://github.com/mscdex ) -
**Brian White** < mscdex@mscdex.net>
* [MylesBorins ](https://github.com/MylesBorins ) -
**Myles Borins** < myles.borins@gmail.com> (he/him)
2016-09-14 00:20:46 +02:00
* [not-an-aardvark ](https://github.com/not-an-aardvark ) -
**Teddy Katz** < teddy.katz@gmail.com>
2017-05-29 17:53:30 +02:00
* [ofrobots ](https://github.com/ofrobots ) -
**Ali Ijaz Sheikh** < ofrobots@google.com>
* [orangemocha ](https://github.com/orangemocha ) -
**Alexis Campailla** < orangemocha@nodejs.org>
2016-08-04 01:32:05 +02:00
* [othiym23 ](https://github.com/othiym23 ) -
2017-01-31 19:57:08 +01:00
**Forrest L Norvell** < ogd@aoaioxxysz.net> (he/him)
2016-08-04 01:32:05 +02:00
* [phillipj ](https://github.com/phillipj ) -
**Phillip Johnsen** < johphi@gmail.com>
* [pmq20 ](https://github.com/pmq20 ) -
**Minqi Pan** < pmq2001@gmail.com>
* [princejwesley ](https://github.com/princejwesley ) -
**Prince John Wesley** < princejohnwesley@gmail.com>
2017-05-06 00:41:29 +02:00
* [Qard ](https://github.com/Qard ) -
2017-01-31 19:57:08 +01:00
**Stephen Belanger** < admin@stephenbelanger.com> (he/him)
2017-04-08 00:16:28 +02:00
* [refack ](https://github.com/refack ) -
**Refael Ackermann** < refack@gmail.com> (he/him)
2017-03-24 13:27:38 +01:00
* [richardlau ](https://github.com/richardlau ) -
**Richard Lau** < riclau@uk.ibm.com>
2016-08-04 01:32:05 +02:00
* [rmg ](https://github.com/rmg ) -
**Ryan Graham** < r.m.graham@gmail.com>
* [robertkowalski ](https://github.com/robertkowalski ) -
**Robert Kowalski** < rok@kowalski.gd>
* [romankl ](https://github.com/romankl ) -
**Roman Klauke** < romaaan.git@gmail.com>
* [ronkorving ](https://github.com/ronkorving ) -
**Ron Korving** < ron@ronkorving.nl>
* [RReverser ](https://github.com/RReverser ) -
**Ingvar Stepanyan** < me@rreverser.com>
2017-05-29 17:53:30 +02:00
* [rvagg ](https://github.com/rvagg ) -
**Rod Vagg** < rod@vagg.org>
2016-08-04 01:32:05 +02:00
* [saghul ](https://github.com/saghul ) -
**Saúl Ibarra Corretgé** < saghul@gmail.com>
* [sam-github ](https://github.com/sam-github ) -
**Sam Roberts** < vieuxtech@gmail.com>
* [santigimeno ](https://github.com/santigimeno ) -
**Santiago Gimeno** < santiago.gimeno@gmail.com>
2017-09-12 07:09:02 +02:00
* [sebdeckers ](https://github.com/sebdeckers ) -
**Sebastiaan Deckers** < sebdeckers83@gmail.com>
2016-08-04 01:32:05 +02:00
* [seishun ](https://github.com/seishun ) -
**Nikolai Vavilov** < vvnicholas@gmail.com>
2017-05-29 17:53:30 +02:00
* [shigeki ](https://github.com/shigeki ) -
**Shigeki Ohtsu** < ohtsu@ohtsu.org> (he/him)
2016-08-04 01:32:05 +02:00
* [silverwind ](https://github.com/silverwind ) -
**Roman Reiss** < me@silverwind.io>
* [srl295 ](https://github.com/srl295 ) -
**Steven R Loomis** < srloomis@us.ibm.com>
2017-12-24 06:16:50 +01:00
* [starkwang ](https://github.com/starkwang ) -
**Weijia Wang** < starkwang@126.com>
2016-08-04 01:32:05 +02:00
* [stefanmb ](https://github.com/stefanmb ) -
**Stefan Budeanu** < stefan@budeanu.com>
2017-05-29 17:53:30 +02:00
* [targos ](https://github.com/targos ) -
**Michaël Zasso** < targos@protonmail.com> (he/him)
* [thefourtheye ](https://github.com/thefourtheye ) -
**Sakthipriyan Vairamani** < thechargingvolcano@gmail.com> (he/him)
2016-08-04 01:32:05 +02:00
* [thekemkid ](https://github.com/thekemkid ) -
2017-01-31 19:57:08 +01:00
**Glen Keane** < glenkeane.94@gmail.com> (he/him)
2016-08-04 01:32:05 +02:00
* [thlorenz ](https://github.com/thlorenz ) -
**Thorsten Lorenz** < thlorenz@gmx.de>
2017-01-22 22:28:57 +01:00
* [TimothyGu ](https://github.com/TimothyGu ) -
2017-12-28 09:59:06 +01:00
**Tiancheng "Timothy" Gu** < timothygu99@gmail.com> (he/him)
2017-06-01 17:07:47 +02:00
* [tniessen ](https://github.com/tniessen ) -
**Tobias Nießen** < tniessen@tnie.de>
2017-05-29 17:53:30 +02:00
* [trevnorris ](https://github.com/trevnorris ) -
**Trevor Norris** < trev.norris@gmail.com>
* [Trott ](https://github.com/Trott ) -
**Rich Trott** < rtrott@gmail.com> (he/him)
2016-08-04 01:32:05 +02:00
* [tunniclm ](https://github.com/tunniclm ) -
**Mike Tunnicliffe** < m.j.tunnicliffe@gmail.com>
2018-01-29 17:33:18 +01:00
* [vdeturckheim ](https://github.com/vdeturckheim ) -
**Vladimir de Turckheim** < vlad2t@hotmail.com> (he/him)
2016-08-04 01:32:05 +02:00
* [vkurchatkin ](https://github.com/vkurchatkin ) -
**Vladimir Kurchatkin** < vladimir.kurchatkin@gmail.com>
2017-03-20 01:49:37 +01:00
* [vsemozhetbyt ](https://github.com/vsemozhetbyt ) -
**Vse Mozhet Byt** < vsemozhetbyt@gmail.com> (he/him)
2017-03-03 18:17:24 +01:00
* [watilde ](https://github.com/watilde ) -
**Daijiro Wachi** < daijiro.wachi@gmail.com> (he/him)
2016-08-04 01:32:05 +02:00
* [whitlockjc ](https://github.com/whitlockjc ) -
**Jeremy Whitlock** < jwhitlock@apache.org>
2017-07-20 13:32:41 +02:00
* [XadillaX ](https://github.com/XadillaX ) -
**Khaidi Chu** < i@2333.moe> (he/him)
2016-08-04 01:32:05 +02:00
* [yorkie ](https://github.com/yorkie ) -
**Yorkie Liu** < yorkiefixer@gmail.com>
* [yosuke-furukawa ](https://github.com/yosuke-furukawa ) -
**Yosuke Furukawa** < yosuke.furukawa@gmail.com>
build, i18n: improve Intl build, add "--with-intl"
The two main goals of this change are:
- To make it easier to build the Intl option using ICU (particularly,
using a newer ICU than v8/Chromium's version)
- To enable a much smaller ICU build with only English support The goal
here is to get node.js binaries built this way by default so that the
Intl API can be used. Additional data can be added at execution time
(see Readme and wiki)
More details are at https://github.com/joyent/node/pull/7719
In particular, this change adds the "--with-intl=" configure option to
provide more ways of building "Intl":
- "full-icu" picks up an ICU from deps/icu
- "small-icu" is similar, but builds only English
- "system-icu" uses pkg-config to find an installed ICU
- "none" does nothing (no Intl)
For Windows builds, the "full-icu" or "small-icu" options are added to
vcbuild.bat.
Note that the existing "--with-icu-path" option is not removed from
configure, but may not be used alongside the new option.
Wiki changes have already been made on
https://github.com/joyent/node/wiki/Installation
and a new page created at
https://github.com/joyent/node/wiki/Intl
(marked as provisional until this change lands.)
Summary of changes:
* README.md : doc updates
* .gitignore : added "deps/icu" as this is the location where ICU is
unpacked to.
* Makefile : added the tools/icu/* files to cpplint, but excluded a
problematic file.
* configure : added the "--with-intl" option mentioned above.
Calculate at config time the list of ICU source files to use and data
packaging options.
* node.gyp : add the new files src/node_i18n.cc/.h as well as ICU
linkage.
* src/node.cc : add call into
node::i18n::InitializeICUDirectory(icu_data_dir) as well as new
--icu-data-dir option and NODE_ICU_DATA env variable to configure ICU
data loading. This loading is only relevant in the "small"
configuration.
* src/node_i18n.cc : new source file for the above Initialize..
function, to setup ICU as needed.
* tools/icu : new directory with some tools needed for this build.
* tools/icu/icu-generic.gyp : new .gyp file that builds ICU in some new
ways, both on unix/mac and windows.
* tools/icu/icu-system.gyp : new .gyp file to build node against a
pkg-config detected ICU.
* tools/icu/icu_small.json : new config file for the "English-only" small
build.
* tools/icu/icutrim.py : new tool for trimming down ICU data. Reads the
above .json file.
* tools/icu/iculslocs.cc : new tool for repairing ICU data manifests
after trim operation.
* tools/icu/no-op.cc : dummy file to force .gyp into using a C++ linker.
* vcbuild.bat : added small-icu and full-icu options, to call into
configure.
* Fixed toolset dependencies, see
https://github.com/joyent/node/pull/7719#issuecomment-54641687
Note that because of a bug in gyp {CC,CXX}_host must also be set.
Otherwise gcc/g++ will be used by default for part of the build.
Reviewed-by: Trevor Norris <trev.norris@gmail.com>
Reviewed-by: Fedor Indutny <fedor@indutny.com>
2014-09-05 07:03:24 +02:00
2017-10-13 06:12:52 +02:00
### Collaborator Emeriti
* [isaacs ](https://github.com/isaacs ) -
**Isaac Z. Schlueter** < i@izs.me>
* [lxe ](https://github.com/lxe ) -
**Aleksey Smolenchuk** < lxe@lxe.co>
2018-01-05 09:05:41 +01:00
* [matthewloring ](https://github.com/matthewloring ) -
**Matthew Loring** < mattloring@google.com>
2017-10-13 06:12:52 +02:00
* [monsanto ](https://github.com/monsanto ) -
**Christopher Monsanto** < chris@monsan.to>
* [Olegas ](https://github.com/Olegas ) -
**Oleg Elifantiev** < oleg@elifantiev.ru>
* [petkaantonov ](https://github.com/petkaantonov ) -
**Petka Antonov** < petka_antonov@hotmail.com>
* [piscisaureus ](https://github.com/piscisaureus ) -
**Bert Belder** < bertbelder@gmail.com>
* [rlidwka ](https://github.com/rlidwka ) -
**Alex Kocharin** < alex@kocharin.ru>
* [tellnes ](https://github.com/tellnes ) -
**Christian Tellnes** < christian@tellnes.no>
2017-05-29 17:53:30 +02:00
Collaborators follow the [COLLABORATOR_GUIDE.md ](./COLLABORATOR_GUIDE.md ) in
maintaining the Node.js project.
2015-08-20 06:51:00 +02:00
### Release Team
2017-01-28 16:50:39 +01:00
Node.js releases are signed with one of the following GPG keys:
2015-08-20 06:51:00 +02:00
2016-08-04 01:32:05 +02:00
* **Colin Ihrig** < cjihrig@gmail.com>
`94AE36675C464D64BAFA68DD7434390BDBE9B9C5`
* **Evan Lucas** < evanlucas@me.com>
`B9AE9905FFD7803F25714661B63B535A4C206CA9`
2017-10-30 19:18:01 +01:00
* **Gibson Fahnestock** < gibfahn@gmail.com>
`77984A986EBC2AA786BC0F66B01FBB92821C587A`
2017-02-06 22:03:13 +01:00
* **Italo A. Casas** < me@italoacasas.com>
`56730D5401028683275BD23C23EFEFE93C4CFFFE`
2016-08-04 01:32:05 +02:00
* **James M Snell** < jasnell@keybase.io>
`71DCFD284A79C3B38668286BC97EC7A07EDE3FC1`
* **Jeremiah Senkpiel** < fishrock@keybase.io>
`FD3A5288F042B6850C66B31F09FE44734EB7990E`
* **Myles Borins** < myles.borins@gmail.com>
`C4F0DFFF4E8C1A8236409D08E73BC641CC11F4C8`
* **Rod Vagg** < rod@vagg.org>
`DD8F2338BAE7501E3DD5AC78C273792F7D83545D`
2015-08-20 06:51:00 +02:00
The full set of trusted release keys can be imported by running:
2016-08-04 01:32:05 +02:00
```shell
2015-08-20 06:51:00 +02:00
gpg --keyserver pool.sks-keyservers.net --recv-keys 94AE36675C464D64BAFA68DD7434390BDBE9B9C5
gpg --keyserver pool.sks-keyservers.net --recv-keys FD3A5288F042B6850C66B31F09FE44734EB7990E
2015-08-20 06:52:33 +02:00
gpg --keyserver pool.sks-keyservers.net --recv-keys 71DCFD284A79C3B38668286BC97EC7A07EDE3FC1
2015-08-20 06:51:00 +02:00
gpg --keyserver pool.sks-keyservers.net --recv-keys DD8F2338BAE7501E3DD5AC78C273792F7D83545D
2016-01-13 01:22:25 +01:00
gpg --keyserver pool.sks-keyservers.net --recv-keys C4F0DFFF4E8C1A8236409D08E73BC641CC11F4C8
2016-01-08 01:41:16 +01:00
gpg --keyserver pool.sks-keyservers.net --recv-keys B9AE9905FFD7803F25714661B63B535A4C206CA9
2017-02-06 22:03:13 +01:00
gpg --keyserver pool.sks-keyservers.net --recv-keys 56730D5401028683275BD23C23EFEFE93C4CFFFE
2017-10-30 19:18:01 +01:00
gpg --keyserver pool.sks-keyservers.net --recv-keys 77984A986EBC2AA786BC0F66B01FBB92821C587A
2015-08-20 06:51:00 +02:00
```
2016-08-04 01:32:05 +02:00
See the section above on [Verifying Binaries ](#verifying-binaries ) for details
on what to do with these keys to verify that a downloaded file is official.
2015-08-20 06:51:00 +02:00
2017-01-28 16:50:39 +01:00
Previous releases may also have been signed with one of the following GPG keys:
2015-08-20 06:51:00 +02:00
2017-01-26 01:58:34 +01:00
* **Chris Dickinson** < christopher.s.dickinson@gmail.com>
`9554F04D7259F04124DE6B476D5A82AC7E37093B`
2016-08-04 01:32:05 +02:00
* **Isaac Z. Schlueter** < i@izs.me>
`93C7E9E91B49E432C2F75674B0A78B0A6C481CF6`
* **Julien Gilli** < jgilli@fastmail.fm>
`114F43EE0176B71C7BC219DD50A3051F888C628D`
* **Timothy J Fontaine** < tjfontaine@gmail.com>
`7937DFD2AB06298B2293C3187D33FF9D0246406D`
2016-07-20 17:24:57 +02:00
2017-11-17 23:04:19 +01:00
## Contributing to Node.js
2017-10-27 01:14:35 +02:00
* [Contributing to the project][]
2017-11-17 23:01:26 +01:00
* [Working Groups][]
2017-11-17 21:36:19 +01:00
* [Strategic Initiatives][]
2017-10-27 01:14:35 +02:00
2017-10-24 01:37:43 +02:00
[Code of Conduct]: https://github.com/nodejs/admin/blob/master/CODE_OF_CONDUCT.md
2016-07-20 17:24:57 +02:00
[Contributing to the project]: CONTRIBUTING.md
2016-09-17 05:04:50 +02:00
[Node.js Help]: https://github.com/nodejs/help
2017-10-27 01:14:35 +02:00
[Node.js Website]: https://nodejs.org/en/
[Questions tagged 'node.js' on StackOverflow]: https://stackoverflow.com/questions/tagged/node.js
2017-11-17 23:01:26 +01:00
[Working Groups]: https://github.com/nodejs/TSC/blob/master/WORKING_GROUPS.md
2017-11-17 21:36:19 +01:00
[Strategic Initiatives]: https://github.com/nodejs/TSC/blob/master/Strategic-Initiatives.md
2017-10-27 01:14:35 +02:00
[#node.js channel on chat.freenode.net]: https://webchat.freenode.net?channels=node.js& uio=d4
