261 lines
		
	
	
		
			9.6 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			261 lines
		
	
	
		
			9.6 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
[](http://expressjs.com/)
 | 
						|
 | 
						|
**Fast, unopinionated, minimalist web framework for [Node.js](http://nodejs.org).**
 | 
						|
 | 
						|
**This project has a [Code of Conduct][].**
 | 
						|
 | 
						|
## Table of contents
 | 
						|
 | 
						|
* [Installation](#Installation)
 | 
						|
* [Features](#Features)
 | 
						|
* [Docs & Community](#docs--community)
 | 
						|
* [Quick Start](#Quick-Start)
 | 
						|
* [Running Tests](#Running-Tests)
 | 
						|
* [Philosophy](#Philosophy)
 | 
						|
* [Examples](#Examples)
 | 
						|
* [Contributing to Express](#Contributing)
 | 
						|
* [TC (Technical Committee)](#tc-technical-committee)
 | 
						|
* [Triagers](#triagers)
 | 
						|
* [License](#license)
 | 
						|
 | 
						|
 | 
						|
[![NPM Version][npm-version-image]][npm-url]
 | 
						|
[![NPM Install Size][npm-install-size-image]][npm-install-size-url]
 | 
						|
[![NPM Downloads][npm-downloads-image]][npm-downloads-url]
 | 
						|
[![OpenSSF Scorecard Badge][ossf-scorecard-badge]][ossf-scorecard-visualizer]
 | 
						|
 | 
						|
 | 
						|
```js
 | 
						|
const express = require('express')
 | 
						|
const app = express()
 | 
						|
 | 
						|
app.get('/', function (req, res) {
 | 
						|
  res.send('Hello World')
 | 
						|
})
 | 
						|
 | 
						|
app.listen(3000)
 | 
						|
```
 | 
						|
 | 
						|
## Installation
 | 
						|
 | 
						|
This is a [Node.js](https://nodejs.org/en/) module available through the
 | 
						|
[npm registry](https://www.npmjs.com/).
 | 
						|
 | 
						|
Before installing, [download and install Node.js](https://nodejs.org/en/download/).
 | 
						|
Node.js 0.10 or higher is required.
 | 
						|
 | 
						|
If this is a brand new project, make sure to create a `package.json` first with
 | 
						|
the [`npm init` command](https://docs.npmjs.com/creating-a-package-json-file).
 | 
						|
 | 
						|
Installation is done using the
 | 
						|
[`npm install` command](https://docs.npmjs.com/getting-started/installing-npm-packages-locally):
 | 
						|
 | 
						|
```console
 | 
						|
$ npm install express
 | 
						|
```
 | 
						|
 | 
						|
Follow [our installing guide](http://expressjs.com/en/starter/installing.html)
 | 
						|
for more information.
 | 
						|
 | 
						|
## Features
 | 
						|
 | 
						|
  * Robust routing
 | 
						|
  * Focus on high performance
 | 
						|
  * Super-high test coverage
 | 
						|
  * HTTP helpers (redirection, caching, etc)
 | 
						|
  * View system supporting 14+ template engines
 | 
						|
  * Content negotiation
 | 
						|
  * Executable for generating applications quickly
 | 
						|
 | 
						|
## Docs & Community
 | 
						|
 | 
						|
  * [Website and Documentation](http://expressjs.com/) - [[website repo](https://github.com/expressjs/expressjs.com)]
 | 
						|
  * [#express](https://web.libera.chat/#express) on [Libera Chat](https://libera.chat) IRC
 | 
						|
  * [GitHub Organization](https://github.com/expressjs) for Official Middleware & Modules
 | 
						|
  * Visit the [Wiki](https://github.com/expressjs/express/wiki)
 | 
						|
  * [Google Group](https://groups.google.com/group/express-js) for discussion
 | 
						|
  * [Gitter](https://gitter.im/expressjs/express) for support and discussion
 | 
						|
 | 
						|
**PROTIP** Be sure to read [Migrating from 3.x to 4.x](https://github.com/expressjs/express/wiki/Migrating-from-3.x-to-4.x) as well as [New features in 4.x](https://github.com/expressjs/express/wiki/New-features-in-4.x).
 | 
						|
 | 
						|
## Quick Start
 | 
						|
 | 
						|
  The quickest way to get started with express is to utilize the executable [`express(1)`](https://github.com/expressjs/generator) to generate an application as shown below:
 | 
						|
 | 
						|
  Install the executable. The executable's major version will match Express's:
 | 
						|
 | 
						|
```console
 | 
						|
$ npm install -g express-generator@4
 | 
						|
```
 | 
						|
 | 
						|
  Create the app:
 | 
						|
 | 
						|
```console
 | 
						|
$ express /tmp/foo && cd /tmp/foo
 | 
						|
```
 | 
						|
 | 
						|
  Install dependencies:
 | 
						|
 | 
						|
```console
 | 
						|
$ npm install
 | 
						|
```
 | 
						|
 | 
						|
  Start the server:
 | 
						|
 | 
						|
```console
 | 
						|
$ npm start
 | 
						|
```
 | 
						|
 | 
						|
  View the website at: http://localhost:3000
 | 
						|
 | 
						|
## Philosophy
 | 
						|
 | 
						|
  The Express philosophy is to provide small, robust tooling for HTTP servers, making
 | 
						|
  it a great solution for single page applications, websites, hybrids, or public
 | 
						|
  HTTP APIs.
 | 
						|
 | 
						|
  Express does not force you to use any specific ORM or template engine. With support for over
 | 
						|
  14 template engines via [Consolidate.js](https://github.com/tj/consolidate.js),
 | 
						|
  you can quickly craft your perfect framework.
 | 
						|
 | 
						|
## Examples
 | 
						|
 | 
						|
  To view the examples, clone the Express repo and install the dependencies:
 | 
						|
 | 
						|
```console
 | 
						|
$ git clone https://github.com/expressjs/express.git --depth 1
 | 
						|
$ cd express
 | 
						|
$ npm install
 | 
						|
```
 | 
						|
 | 
						|
  Then run whichever example you want:
 | 
						|
 | 
						|
```console
 | 
						|
$ node examples/content-negotiation
 | 
						|
```
 | 
						|
 | 
						|
## Contributing
 | 
						|
 | 
						|
  [![Linux Build][github-actions-ci-image]][github-actions-ci-url]
 | 
						|
  [![Windows Build][appveyor-image]][appveyor-url]
 | 
						|
  [![Test Coverage][coveralls-image]][coveralls-url]
 | 
						|
 | 
						|
The Express.js project welcomes all constructive contributions. Contributions take many forms,
 | 
						|
from code for bug fixes and enhancements, to additions and fixes to documentation, additional
 | 
						|
tests, triaging incoming pull requests and issues, and more!
 | 
						|
 | 
						|
See the [Contributing Guide](Contributing.md) for more technical details on contributing.
 | 
						|
 | 
						|
### Security Issues
 | 
						|
 | 
						|
If you discover a security vulnerability in Express, please see [Security Policies and Procedures](Security.md).
 | 
						|
 | 
						|
### Running Tests
 | 
						|
 | 
						|
To run the test suite, first install the dependencies, then run `npm test`:
 | 
						|
 | 
						|
```console
 | 
						|
$ npm install
 | 
						|
$ npm test
 | 
						|
```
 | 
						|
 | 
						|
## People
 | 
						|
 | 
						|
The original author of Express is [TJ Holowaychuk](https://github.com/tj)
 | 
						|
 | 
						|
[List of all contributors](https://github.com/expressjs/express/graphs/contributors)
 | 
						|
 | 
						|
### TC (Technical Committee)
 | 
						|
 | 
						|
* [UlisesGascon](https://github.com/UlisesGascon) - **Ulises Gascón** (he/him)
 | 
						|
* [jonchurch](https://github.com/jonchurch) - **Jon Church**
 | 
						|
* [wesleytodd](https://github.com/wesleytodd) - **Wes Todd**
 | 
						|
* [LinusU](https://github.com/LinusU) - **Linus Unnebäck**
 | 
						|
* [blakeembrey](https://github.com/blakeembrey) - **Blake Embrey**
 | 
						|
* [sheplu](https://github.com/sheplu) - **Jean Burellier**
 | 
						|
* [crandmck](https://github.com/crandmck) - **Rand McKinney**
 | 
						|
* [ctcpip](https://github.com/ctcpip) - **Chris de Almeida**
 | 
						|
 | 
						|
<details>
 | 
						|
<summary>TC emeriti members</summary>
 | 
						|
 | 
						|
#### TC emeriti members
 | 
						|
 | 
						|
  * [dougwilson](https://github.com/dougwilson) - **Douglas Wilson**
 | 
						|
  * [hacksparrow](https://github.com/hacksparrow) - **Hage Yaapa**
 | 
						|
  * [jonathanong](https://github.com/jonathanong) - **jongleberry**
 | 
						|
  * [niftylettuce](https://github.com/niftylettuce) - **niftylettuce**
 | 
						|
  * [troygoode](https://github.com/troygoode) - **Troy Goode**
 | 
						|
</details>
 | 
						|
 | 
						|
 | 
						|
### Triagers
 | 
						|
 | 
						|
* [aravindvnair99](https://github.com/aravindvnair99) - **Aravind Nair**
 | 
						|
* [carpasse](https://github.com/carpasse) - **Carlos Serrano**
 | 
						|
* [CBID2](https://github.com/CBID2) - **Christine Belzie**
 | 
						|
* [enyoghasim](https://github.com/enyoghasim) - **David Enyoghasim**
 | 
						|
* [UlisesGascon](https://github.com/UlisesGascon) - **Ulises Gascón** (he/him)
 | 
						|
* [mertcanaltin](https://github.com/mertcanaltin) - **Mert Can Altin**
 | 
						|
* [0ss](https://github.com/0ss) - **Salah**
 | 
						|
* [import-brain](https://github.com/import-brain) - **Eric Cheng** (he/him)
 | 
						|
* [3imed-jaberi](https://github.com/3imed-jaberi) - **Imed Jaberi**
 | 
						|
* [dakshkhetan](https://github.com/dakshkhetan) - **Daksh Khetan** (he/him)
 | 
						|
* [lucasraziel](https://github.com/lucasraziel) - **Lucas Soares Do Rego**
 | 
						|
* [IamLizu](https://github.com/IamLizu) - **S M Mahmudul Hasan** (he/him)
 | 
						|
* [Sushmeet](https://github.com/Sushmeet) - **Sushmeet Sunger**
 | 
						|
 | 
						|
<details>
 | 
						|
<summary>Triagers emeriti members</summary>
 | 
						|
 | 
						|
#### Emeritus Triagers
 | 
						|
 | 
						|
  * [AuggieH](https://github.com/AuggieH) - **Auggie Hudak**
 | 
						|
  * [G-Rath](https://github.com/G-Rath) - **Gareth Jones**
 | 
						|
  * [MohammadXroid](https://github.com/MohammadXroid) - **Mohammad Ayashi**
 | 
						|
  * [NawafSwe](https://github.com/NawafSwe) - **Nawaf Alsharqi**
 | 
						|
  * [NotMoni](https://github.com/NotMoni) - **Moni**
 | 
						|
  * [VigneshMurugan](https://github.com/VigneshMurugan) - **Vignesh Murugan**
 | 
						|
  * [davidmashe](https://github.com/davidmashe) - **David Ashe**
 | 
						|
  * [digitaIfabric](https://github.com/digitaIfabric) - **David**
 | 
						|
  * [e-l-i-s-e](https://github.com/e-l-i-s-e) - **Elise Bonner**
 | 
						|
  * [fed135](https://github.com/fed135) - **Frederic Charette**
 | 
						|
  * [firmanJS](https://github.com/firmanJS) - **Firman Abdul Hakim**
 | 
						|
  * [getspooky](https://github.com/getspooky) - **Yasser Ameur**
 | 
						|
  * [ghinks](https://github.com/ghinks) - **Glenn**
 | 
						|
  * [ghousemohamed](https://github.com/ghousemohamed) - **Ghouse Mohamed**
 | 
						|
  * [gireeshpunathil](https://github.com/gireeshpunathil) - **Gireesh Punathil**
 | 
						|
  * [jake32321](https://github.com/jake32321) - **Jake Reed**
 | 
						|
  * [jonchurch](https://github.com/jonchurch) - **Jon Church**
 | 
						|
  * [lekanikotun](https://github.com/lekanikotun) - **Troy Goode**
 | 
						|
  * [marsonya](https://github.com/marsonya) - **Lekan Ikotun**
 | 
						|
  * [mastermatt](https://github.com/mastermatt) - **Matt R. Wilson**
 | 
						|
  * [maxakuru](https://github.com/maxakuru) - **Max Edell**
 | 
						|
  * [mlrawlings](https://github.com/mlrawlings) - **Michael Rawlings**
 | 
						|
  * [rodion-arr](https://github.com/rodion-arr) - **Rodion Abdurakhimov**
 | 
						|
  * [sheplu](https://github.com/sheplu) - **Jean Burellier**
 | 
						|
  * [tarunyadav1](https://github.com/tarunyadav1) - **Tarun yadav**
 | 
						|
  * [tunniclm](https://github.com/tunniclm) - **Mike Tunnicliffe**
 | 
						|
</details>
 | 
						|
 | 
						|
 | 
						|
## License
 | 
						|
 | 
						|
  [MIT](LICENSE)
 | 
						|
 | 
						|
[appveyor-image]: https://badgen.net/appveyor/ci/dougwilson/express/master?label=windows
 | 
						|
[appveyor-url]: https://ci.appveyor.com/project/dougwilson/express
 | 
						|
[coveralls-image]: https://badgen.net/coveralls/c/github/expressjs/express/master
 | 
						|
[coveralls-url]: https://coveralls.io/r/expressjs/express?branch=master
 | 
						|
[github-actions-ci-image]: https://badgen.net/github/checks/expressjs/express/master?label=linux
 | 
						|
[github-actions-ci-url]: https://github.com/expressjs/express/actions/workflows/ci.yml
 | 
						|
[npm-downloads-image]: https://badgen.net/npm/dm/express
 | 
						|
[npm-downloads-url]: https://npmcharts.com/compare/express?minimal=true
 | 
						|
[npm-install-size-image]: https://badgen.net/packagephobia/install/express
 | 
						|
[npm-install-size-url]: https://packagephobia.com/result?p=express
 | 
						|
[npm-url]: https://npmjs.org/package/express
 | 
						|
[npm-version-image]: https://badgen.net/npm/v/express
 | 
						|
[ossf-scorecard-badge]: https://api.scorecard.dev/projects/github.com/expressjs/express/badge
 | 
						|
[ossf-scorecard-visualizer]: https://ossf.github.io/scorecard-visualizer/#/projects/github.com/expressjs/express
 | 
						|
[Code of Conduct]: https://github.com/expressjs/express/blob/master/Code-Of-Conduct.md
 |