Express.js: Difference between revisions
| (7 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
Express.js, also known as Express, is a Node.js web-framework. | Express.js, also known as Express, is a Node.js web-framework. | ||
It provides access to routing and a rich community of middleware. | |||
The benefit to using JS/TS for your backend is that your full stack is in a single-language. | |||
This also means you can use all of your favorite libraries on npm. | |||
However, since JS is single-threaded, you need to be careful with optimization (i.e. async programming). | |||
Deployment may require running multiple instances of your application even on the same VM. | |||
==Getting Started== | ==Getting Started== | ||
To create a project, do | To create a project, do | ||
<pre> | <pre> | ||
npx express-generator | npx express-generator --view=pug | ||
</pre> | </pre> | ||
or | or | ||
<pre> | <pre> | ||
npm i -g express-generator | npm i -g express-generator | ||
express [dir] | express --view=pug [dir] | ||
</pre> | </pre> | ||
See [https://expressjs.com/en/starter/generator.html express starter generator] for more details. | See [https://expressjs.com/en/starter/generator.html express starter generator] for more details. | ||
* By default, express uses jade for its template engine. This has been replaced by pug. | |||
* If you want to make a typescript project, you can also try [https://www.npmjs.com/package/express-generator-typescript express-generator-typescript]. | |||
** This is made by a third-party and includes some extra libraries. | |||
==Usage== | ==Usage== | ||
| Line 25: | Line 36: | ||
* [https://sequelize.org/ Sequelize] is an object-relation mapping (ORM) for Node. It supports Postgres, MySQL, MariaDB, SQLite, and Microsoft SQL Server. | * [https://sequelize.org/ Sequelize] is an object-relation mapping (ORM) for Node. It supports Postgres, MySQL, MariaDB, SQLite, and Microsoft SQL Server. | ||
* [https://typeorm.io/#/ TypeORM] is another ORM from Node. | * [https://typeorm.io/#/ TypeORM] is another ORM from Node. | ||
** We currently use TypeORM for [https://tuneix.com https://tuneix.com]. | |||
* [http://knexjs.org/ Knex.js] is an SQL query builder. | * [http://knexjs.org/ Knex.js] is an SQL query builder. | ||
* [https://github.com/Vincit/objection.js Objection.js] is another ORM built on Knex.js. | * [https://github.com/Vincit/objection.js Objection.js] is another ORM built on Knex.js. | ||
==Proxies== | |||
It is typically recommended to run express behind a proxy (e.g. Nginx) for production. | |||
See [https://expressjs.com/en/guide/behind-proxies.html guide: behind-proxies] for how to configure this such that the client hostname is correct. | |||
<syntaxhighlight lang="typescript"> | |||
app.set('trust proxy', 'loopback'); | |||
</syntaxhighlight> | |||
==Libraries== | ==Libraries== | ||
* [https://www.npmjs.com/package/express- | Some common libraries and middleware | ||
* [https://www.npmjs.com/package/express-rate-limit express-rate-limit] adds rate limiting. | |||
* [https://expressjs.com/en/resources/middleware/csurf.html csrf] adds csrf protection. | |||
==Resources== | ==Resources== | ||