Body-parser

بودي بارسر: دليل شامل للمبتدئين

بودي بارسر (Body-parser) هو وسيط (middleware) أساسي في تطبيقات الويب المبنية باستخدام Node.js و Express.js. وظيفته الأساسية هي تحليل بيانات الطلب الواردة من العميل (مثل المتصفح) وتحويلها إلى تنسيق يمكن لتطبيقك فهمه ومعالجته بسهولة. بدون بودي بارسر، ستصل بيانات الطلب إلى خادمك كسلسلة نصية خام، مما يجعل استخلاص المعلومات منها أمرًا صعبًا للغاية. هذا المقال يقدم شرحًا مفصلاً لمفهوم بودي بارسر، وأنواعه المختلفة، وكيفية استخدامه في تطبيقات Express.js، مع التركيز على الجوانب العملية والتطبيقات الواقعية.

لماذا نحتاج إلى بودي بارسر؟

عندما يرسل العميل طلبًا إلى الخادم، قد يحتوي هذا الطلب على بيانات مرفقة (data) في عدة أجزاء، مثل:

بيانات النموذج (Form Data): تُستخدم لإرسال البيانات من نماذج HTML، غالبًا باستخدام طريقة POST.
بيانات JSON (JSON Data): تنسيق شائع لتبادل البيانات بين الخادم والعميل، خاصة في تطبيقات الويب الحديثة و واجهات برمجة التطبيقات (APIs).
بيانات URL-encoded: تنسيق تستخدمه المتصفحات لإرسال البيانات في عنوان URL، غالبًا في استعلامات GET.
بيانات Raw (Raw Data): بيانات غير مُعالجة، يمكن أن تكون بأي تنسيق.

بدون بودي بارسر، ستصل هذه البيانات إلى الخادم كسلسلة نصية طويلة وغير منظمة. يساعد بودي بارسر في تحليل هذه السلاسل النصية وتحويلها إلى كائنات JavaScript (objects) أو مصفوفات (arrays) يمكن لتطبيقك الوصول إليها واستخدامها بسهولة.

أنواع بودي بارسر

هناك العديد من أنواع بودي بارسر المتاحة، ولكل منها ميزات وخصائص مختلفة. بعض الأنواع الأكثر شيوعًا تشمل:

body-parser (القديم): كان هذا هو الحل الأكثر شيوعًا في الماضي، ولكنه الآن يعتبر قديمًا. تم دمج وظائفه في Express.js نفسه بدءًا من الإصدار 4.16.0.
raw-body: يوفر الوصول إلى البيانات الخام للطلب قبل أي معالجة.
urlencoded ( جزء من Express.js ): يحلل بيانات URL-encoded.
json ( جزء من Express.js ): يحلل بيانات JSON.
text ( جزء من Express.js ): يحلل بيانات النص العادي.

استخدام بودي بارسر في Express.js

اعتبارًا من Express.js 4.16.0، لم تعد هناك حاجة لتثبيت حزمة `body-parser` بشكل منفصل. تم دمج الوظائف الأساسية في Express.js نفسه. لتحليل أنواع مختلفة من بيانات الطلب، يمكنك استخدام الوظائف المضمنة في Express.js كما هو موضح أدناه:

تحليل أنواع بيانات الطلب المختلفة في Express.js
الكود \| شرح \|	`express.urlencoded({ extended: true })` \| يحلل بيانات URL-encoded. `extended: true` يسمح بتحليل هياكل البيانات المعقدة. \|	`express.json()` \| يحلل بيانات JSON. \|	`express.raw()` \| يوفر الوصول إلى البيانات الخام للطلب. \|	`express.text()` \| يحلل بيانات النص العادي. \|

مثال:

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

// تحليل بيانات URL-encoded app.use(express.urlencoded({ extended: true }));

// تحليل بيانات JSON app.use(express.json());

app.post('/submit', (req, res) => {

 console.log('بيانات النموذج:', req.body);
 res.send('تم استلام البيانات بنجاح!');

});

app.listen(port, () => {

 console.log(`التطبيق يستمع على المنفذ ${port}`);

}); ```

في هذا المثال، `app.use()` يستخدم لتطبيق وسيطي (middleware) على جميع الطلبات الواردة. `express.urlencoded({ extended: true })` يحلل بيانات URL-encoded، و `express.json()` يحلل بيانات JSON. في معالج المسار `/submit`، يمكن الوصول إلى البيانات المحللة من خلال `req.body`.

التعامل مع أنواع مختلفة من الطلبات

طلبات GET: عادةً ما تحتوي طلبات GET على بيانات في عنوان URL (query parameters). يمكن الوصول إلى هذه البيانات باستخدام `req.query`. لا تحتاج إلى بودي بارسر لطلبات GET.
طلبات POST: عادةً ما تحتوي طلبات POST على بيانات في نص الطلب (request body). يستخدم بودي بارسر لتحليل هذه البيانات.
طلبات PUT و DELETE: يمكن أن تحتوي طلبات PUT و DELETE أيضًا على بيانات في نص الطلب. يستخدم بودي بارسر لتحليل هذه البيانات أيضًا.

استخدام بودي بارسر مع أنواع محتوى مختلفة (Content-Type)

يجب أن يتطابق نوع بودي بارسر المستخدم مع نوع المحتوى (Content-Type) الذي يرسله العميل. على سبيل المثال:

إذا كان العميل يرسل بيانات JSON، فيجب استخدام `express.json()`.
إذا كان العميل يرسل بيانات URL-encoded، فيجب استخدام `express.urlencoded({ extended: true })`.
إذا كان العميل يرسل بيانات نصية عادية، فيجب استخدام `express.text()`.

إذا لم يتطابق نوع بودي بارسر مع نوع المحتوى، فلن يتم تحليل البيانات بشكل صحيح، وستكون `req.body` فارغة أو غير صالحة.

الأخطاء الشائعة وحلولها

req.body فارغ: تأكد من أنك تستخدم بودي بارسر الصحيح لنوع المحتوى الذي يرسله العميل. تأكد أيضًا من أنك قمت بتطبيق بودي بارسر قبل معالج المسار الذي تريد الوصول إلى `req.body` منه.
خطأ في التحليل: إذا كانت البيانات المرسلة من العميل غير صالحة (على سبيل المثال، JSON غير صالح)، فقد يحدث خطأ في التحليل. تعامل مع هذه الأخطاء باستخدام وسيطي لمعالجة الأخطاء (error handling middleware).
حدود حجم الطلب: قد يكون هناك حد لحجم الطلب الذي يمكن للخادم معالجته. إذا كان الطلب كبيرًا جدًا، فقد يحدث خطأ. يمكنك زيادة حد حجم الطلب باستخدام وسيطي مثل `body-parser` (القديم) أو عن طريق تكوين الخادم.

أفضل الممارسات

استخدم Express.js المدمج: بدلاً من تثبيت حزمة `body-parser` بشكل منفصل، استخدم الوظائف المضمنة في Express.js 4.16.0 والإصدارات الأحدث.
حدد أنواع المحتوى المدعومة: حدد أنواع المحتوى التي يدعمها تطبيقك واستخدم بودي بارسر المناسب لكل نوع.
تحقق من صحة البيانات: تحقق من صحة البيانات التي يتم تحليلها للتأكد من أنها تلبي توقعاتك. استخدم مكتبات التحقق من الصحة (validation libraries) لتبسيط هذه العملية.
تعامل مع الأخطاء: تعامل مع الأخطاء التي قد تحدث أثناء تحليل البيانات بشكل صحيح. استخدم وسيطي لمعالجة الأخطاء لتسجيل الأخطاء وإعادة رسائل خطأ مفيدة للعميل.

بودي بارسر وتطبيقات الويب الحديثة

في تطبيقات الويب الحديثة، غالبًا ما يتم استخدام JSON كشكل أساسي لتبادل البيانات بين الخادم والعميل. لذلك، يعتبر `express.json()` هو بودي بارسر الأكثر استخدامًا. ومع ذلك، لا يزال من المهم فهم كيفية التعامل مع أنواع بيانات الطلب الأخرى، مثل URL-encoded و raw data.

العلاقة ببودى بارسر و RESTful APIs

عند بناء واجهات برمجة التطبيقات (APIs) RESTful، يلعب بودي بارسر دورًا حيويًا في معالجة البيانات المرسلة من قبل العملاء. فهم كيفية تحليل أنواع مختلفة من البيانات (JSON، URL-encoded، إلخ) ضروري لتصميم وتنفيذ واجهات برمجة تطبيقات فعالة وموثوقة. يتيح لك بودي بارسر استخلاص البيانات الضرورية من الطلبات الواردة واستخدامها لتنفيذ العمليات المطلوبة.

التحليل المتقدم للبيانات

بالإضافة إلى التحليل الأساسي، يمكن استخدام بودي بارسر مع مكتبات أخرى للتحليل المتقدم للبيانات. على سبيل المثال، يمكنك استخدام مكتبات للتحقق من صحة البيانات أو لتحويل البيانات إلى تنسيقات مختلفة.

بودي بارسر و الأمان

يجب أن تكون على دراية بمخاطر الأمان المحتملة عند التعامل مع بيانات الطلب. تأكد من التحقق من صحة البيانات وتنظيفها قبل استخدامها لتجنب هجمات مثل حقن SQL و XSS (Cross-Site Scripting).

الخلاصة

بودي بارسر هو أداة أساسية لتطوير تطبيقات ويب باستخدام Node.js و Express.js. من خلال فهم الأنواع المختلفة من بودي بارسر وكيفية استخدامها، يمكنك معالجة بيانات الطلب الواردة بسهولة وكفاءة. باتباع أفضل الممارسات، يمكنك التأكد من أن تطبيقك آمن وموثوق.

مصادر إضافية

روابط لمواضيع ذات صلة

ابدأ التداول الآن

سجل في IQ Option (الحد الأدنى للإيداع $10) افتح حساباً في Pocket Option (الحد الأدنى للإيداع $5)

انضم إلى مجتمعنا

اشترك في قناة Telegram الخاصة بنا @strategybin للحصول على: ✓ إشارات تداول يومية ✓ تحليلات استراتيجية حصرية ✓ تنبيهات باتجاهات السوق ✓ مواد تعليمية للمبتدئين