インストール中

始める前に、 Node.js 18 以上のインストールがあることを確認してください。 次に、アプリケーションのディレクトリを作成し、その中に移動します。

mkdir myapp
cd myapp

npm init コマンドを使用して、アプリケーション用の package.json ファイルを作成します。 package.json がどのように動作するかについては、npm の package.json handling を参照してください。

npm init

yarn init

pnpm init

bun init

このコマンドを実行すると、アプリケーションの名前やバージョンなど、さまざまなものが表示されます。 今のところ、RETURNを押すと、ほとんどのデフォルトを受け入れることができます。以下の例外があります。

entry point: (index.js)

app.js、またはメインファイルの名前を何でも入力します。 index.jsにしたい場合は、RETURNを押して、推奨されるデフォルトのファイル名を受け入れます。

次に、Expressをmyappディレクトリにインストールし、依存関係リストに保存します。 例:

npm install express

yarn add express

pnpm add express

bun add express

Express を一時的にインストールし、依存関係リストに追加しないでください。

npm install express --no-save

bun add express --no-save

TypeScript

Express is written in JavaScript and does not bundle its own type definitions. To use it with TypeScript, install TypeScript together with the community-maintained types for Express and Node.js (from DefinitelyTyped) as development dependencies:

npm install --save-dev typescript @types/express @types/node

yarn add --dev typescript @types/express @types/node

pnpm add --save-dev typescript @types/express @types/node

bun add --dev typescript @types/express @types/node

Add a tsconfig.json. These options mirror how Node.js runs TypeScript and make the compiler reject non-erasable syntax (such as enums, namespaces, and parameter properties) that Node cannot strip:

{
  "compilerOptions": {
    "target": "esnext",
    "module": "nodenext",
    "rewriteRelativeImportExtensions": true,
    "erasableSyntaxOnly": true,
    "verbatimModuleSyntax": true,
    "noEmit": true,
    "strict": true,
    "skipLibCheck": true
  }
}

Write your application in TypeScript, annotating the request and response objects:

import express, { type Express, type Request, type Response } from 'express';

const app: Express = express();

app.get('/', (req: Request, res: Response) => {
  res.send('Hello World!');
});

app.listen(3000);

You do not need to annotate everything. When you pass a handler directly to a route method or to app.use(), Express infers the types of req, res, and next, and it infers route parameters from the path, so req.params.id is a string in app.get('/users/:id', ...). Add explicit types only where TypeScript has no context to infer from: error-handling middleware, whose (err, req, res, next) signature is not inferred, and handlers you define separately from the route. In those cases, annotate the parameters or type the whole function as RequestHandler or ErrorRequestHandler.

Run the file directly with Node.js, which strips the TypeScript types and runs the result without a build step:

node src/app.ts