Node.js Backend Development Bootcamp · レッスン

カスタムExpressミドルウェアを開発する

独自のExpressミドルウェア関数を作成し、機能を拡張してリクエスト処理を効率化します。

「カスタムExpressミドルウェアを開発する」はCoddyKit上の無料Node.js Backend Development Bootcampレッスンです。これはレッスン1/4です。下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。これはNode.js Backend Development Bootcamp学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Node.js Backend Development Bootcampコースには全4レッスンが含まれています。

このレッスンの一部はまだ翻訳されておらず、英語で表示されています。

What is Custom Middleware?

In Express.js, middleware functions are like a chain of helpers that process incoming requests before they reach your final route handler.

They have access to the request (req) and response (res) objects.
They can modify these objects, end the request-response cycle, or pass control to the next middleware.
Custom middleware allows you to add specific functionality tailored to your application's needs, such as logging, authentication, or data parsing.

The Middleware Signature

Every Express middleware function follows a specific signature: (req, res, next).

req (request): The incoming HTTP request object.
res (response): The HTTP response object that Express sends back.
next: A function that, when called, passes control to the next middleware function in the stack. If you don't call next(), the request-response cycle stops, and no further middleware or route handlers will execute.

Your First Logger Middleware

Let's create a simple custom middleware that logs details of every incoming request to the console. This helps in debugging and monitoring.

Try running the code and then accessing http://localhost:3000 in your browser. Check the console output!

const express = require('express');
const app = express();
const port = 3000;

// Custom logging middleware
const requestLogger = (req, res, next) => {
  console.log(`[${new Date().toISOString()}] ${req.method} ${req.url}`);
  next(); // Pass control to the next middleware/route handler
};

// Apply the custom middleware globally
app.use(requestLogger);

// Define a simple route
app.get('/', (req, res) => {
  res.send('Hello from Express!');
});

// Start the server
app.listen(port, () => {
  console.log(`Server running at http://localhost:${port}`);
});

Applying Middleware: Global vs. Route

You can apply middleware at different levels:

Globally (Application-level): Using app.use(middlewareFunction) applies the middleware to ALL incoming requests.
Route-specific: You can apply middleware to specific routes or groups of routes by passing it as an argument before the route handler.

This flexibility allows you to execute logic only where it's needed.

Passing Data Downstream

A powerful feature of middleware is its ability to add properties to the req object. These properties then become accessible to all subsequent middleware functions and the final route handler in the request-response cycle.

This is extremely useful for things like attaching user information after authentication, or parsed data before reaching the main logic.

Example: Attaching User Data

Here's how you might attach a mock user object to the request. In a real application, this data would come from a database or a decoded JSON Web Token (JWT).

Notice how the /profile route handler can directly access req.user because the attachUserInfo middleware ran first.

const express = require('express');
const app = express();
const port = 3000;

// Middleware to attach user info (mock data)
const attachUserInfo = (req, res, next) => {
  req.user = { id: '123', name: 'Alice', role: 'admin' };
  console.log('User info attached to request.');
  next();
};

// Apply the middleware globally
app.use(attachUserInfo);

// Route that uses the attached user info
app.get('/profile', (req, res) => {
  res.send(`Welcome, ${req.user.name}! Your role is: ${req.user.role}`);
});

app.get('/', (req, res) => {
  res.send('Home page (no user info explicitly needed here)');
});

app.listen(port, () => {
  console.log(`Server running at http://localhost:${port}`);
});

Building Middleware Chains

You can chain multiple middleware functions together. Express executes them in the order they are defined. Each middleware must call next() to pass control to the next one.

This allows you to break down complex request processing into smaller, manageable, and reusable functions.
For example, you could have a middleware for authentication, then one for logging, then one for parsing, all before your final route handler.

Conditional Middleware Execution

Sometimes you only want middleware to run under certain conditions. You can achieve this by:

Route-specific application: As seen, applying middleware directly to app.get(), app.post(), etc.
Internal logic: Adding conditional checks (if statements) inside the middleware itself.
Custom wrapper functions: Creating a function that returns a middleware based on parameters.

Practical: Request Timer Middleware

Let's build a middleware that measures how long it takes for a request to be processed and a response to be sent. This is very useful for performance monitoring.

This example uses res.on('finish', ...) to execute code AFTER the response has been sent to the client.

const express = require('express');
const app = express();
const port = 3000;

// Middleware to measure request duration
const requestTimer = (req, res, next) => {
  const start = Date.now(); // Record start time
  res.on('finish', () => { // Listen for the response 'finish' event
    const end = Date.now(); // Record end time
    const duration = end - start;
    console.log(`${req.method} ${req.originalUrl} took ${duration}ms`);
  });
  next(); // Pass control
};

// Apply the timer middleware
app.use(requestTimer);

// Define a route that simulates some work
app.get('/slow', (req, res) => {
  setTimeout(() => {
    res.send('This was a slow response!');
  }, 500); // Simulate 500ms delay
});

app.get('/', (req, res) => {
  res.send('Hello, fast world!');
});

app.listen(port, () => {
  console.log(`Server running at http://localhost:${port}`);
});

Middleware Function Quiz

Consider a custom middleware function defined as const myMiddleware = (req, res, next) => { /* ... */ };

Which of the following statements about its behavior is TRUE?

Custom Middleware Recap

You've learned how to create and use custom Express middleware!

Custom middleware functions have the signature (req, res, next).
Calling next() is crucial to pass control to the next middleware or route handler.
Middleware can modify the req and res objects, making data available downstream.
You can apply middleware globally with app.use() or to specific routes.
They are powerful for adding reusable logic like logging, authentication, or request timing.

Mastering custom middleware is key to building modular and efficient Express applications.

よくある質問

「カスタムExpressミドルウェアを開発する」レッスンは無料ですか？

はい。「カスタムExpressミドルウェアを開発する」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、Node.js Backend Development Bootcampコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Node.js Backend Development Bootcampコースには全4レッスンが含まれています。

「カスタムExpressミドルウェアを開発する」で何を学びますか？

独自のExpressミドルウェア関数を作成し、機能を拡張してリクエスト処理を効率化します。ブラウザで直接実行するハンズオンコードでNode.js Backend Development Bootcampを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

Node.js Backend Development Bootcampを始めるのに経験は必要ですか？

事前経験は必要ありません。CoddyKitのNode.js Backend Development Bootcampは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。これはレッスン1/4です。

「カスタムExpressミドルウェアを開発する」レッスンにはどのくらい時間がかかりますか？

ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このNode.js Backend Development Bootcampレッスンでコードを書いて実行できますか？

はい。すべてのNode.js Backend Development Bootcampレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

← Node.js Backend Development Bootcampに戻る