Spaces:
Running
Running
[](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 | |