تطوير برمجيات وسيطة مخصّصة في Express
اكتبوا دوال البرمجيات الوسيطة الخاصة بكم في Express لتوسيع الوظائف وتبسيط معالجة الطلبات.
تطوير برمجيات وسيطة مخصّصة في Express درس مجاني في Node.js Backend Development Bootcamp على CoddyKit. هذا هو الدرس 1 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في 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 callnext(), 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 (
ifstatements) 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
reqandresobjects, 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/7) وفتح باقي دورة Node.js Backend Development Bootcamp، انتقل إلى CoddyKit PRO. تتضمن دورة Node.js Backend Development Bootcamp 4 دروس في المجموع.
ماذا ستتعلم في «تطوير برمجيات وسيطة مخصّصة في Express»؟
اكتبوا دوال البرمجيات الوسيطة الخاصة بكم في Express لتوسيع الوظائف وتبسيط معالجة الطلبات. تتمرن على Node.js Backend Development Bootcamp مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ Node.js Backend Development Bootcamp؟
لا تُشترط خبرة سابقة. Node.js Backend Development Bootcamp على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 1 من أصل 4.
كم من الوقت يستغرق درس «تطوير برمجيات وسيطة مخصّصة في Express»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس Node.js Backend Development Bootcamp هذا؟
نعم. كل درس في Node.js Backend Development Bootcamp يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- تطوير برمجيات وسيطة مخصّصة في Express
- استراتيجيات معالجة الأخطاء العامة
- التحقق من المدخلات باستخدام Joi/Express-Validator
- البرمجيات الوسيطة للمصادقة باستخدام JWT