كيفية إدارة الاستجابات الغير متزامنة في Express.js

عندما تقوم بالنقر على زر “الدفع” في تطبيقك على express.js، تحتاج إلى إجراء استدعاء غير متزامن إلى واجهة برمجة التطبيقات (API) الخاصة بـ Stripe لإتمام عملية الدفع. بما أن هذا الاستدعاء يعتمد على شبكة الإنترنت وغير متزامن، فإن الرد لن يكون متاحًا على الفور.

الطريقة الصحيحة للتعامل مع هذا النوع من الاستدعاءات في express.js هي باستخدام وظائف الاستجابة (response functions) التي توفرها express.js لإدارة الردود على الطلبات. يمكنك استخدام دالة res.send() لإرسال الرد بعد اكتمال الاستدعاء الغير متزامن.

لكن، كيف يمكنك جعل الرد ينتظر حتى اكتمال الاستدعاء الغير متزامن؟ يمكنك استخدام الوظائف الغير متزامنة (async functions) والكائنات Promise للتحكم في تسلسل عمليات الاستدعاء والرد.

للقيام بذلك، يمكنك استخدام كلمة الأمر await داخل وظيفة express.js الخاصة بالتعامل مع الطلبات (request handler function)، والتي يتم تمريرها إلى express.js كمعامل لدالة app.get() أو app.post().

لنفترض أن لديك دالة stripeCheckout() تقوم بالاستدعاء إلى API الخاصة بـ Stripe لإتمام عملية الدفع. يمكنك استخدام await لانتظار اكتمال هذا الاستدعاء قبل إرسال الرد إلى العميل.

إليك مثالًا بسيطًا يوضح كيفية القيام بذلك:

javascriptCopy code
const express = require('express');
const app = express();

// تعريف دالة stripeCheckout لاستدعاء Stripe API
async function stripeCheckout() {
    // قم بإجراء الاستدعاء غير المتزامن إلى API الخاصة بـ Stripe هنا
    // يمكنك استخدام مكتبة مثل 'axios' أو 'node-fetch' لإجراء الاستدعاء
    // على سبيل المثال:
    // const response = await axios.post('https://api.stripe.com/checkout', { data });
    // return response.data;
    return new Promise((resolve) => {
        // في هذا المثال، سنقوم بانتظار 3 ثوانٍ قبل إرجاع رد افتراضي
        setTimeout(() => {
            resolve('تمت عملية الدفع بنجاح!');
        }, 3000);
    });
}

// تعريف معالج الطلبات
app.post('/pay', async (req, res) => {
    try {
        // انتظر حتى اكتمال الاستدعاء غير المتزامن
        const response = await stripeCheckout();

        // إرسال الرد بعد اكتمال الاستدعاء والحصول على الرد
        res.send(response);
    } catch (error) {
        // إرسال رسالة الخطأ إذا حدث خطأ أثناء عملية الدفع
        res.status(500).send('حدث خطأ أثناء عملية الدفع');
    }
});

// بدء استماع التطبيق على المنفذ 3000
app.listen(3000, () => {
    console.log('التطبيق يعمل على المنفذ 3000!');
});

في هذا المثال، عندما يتم استدعاء مسار /pay في التطبيق express.js، سيقوم التطبيق بانتظار اكتمال الاستدعاء الغير متزامن إلى Stripe API باستخدام await، ثم يرسل الرد إلى العميل باستخدام res.send() عندما يكتمل الاستدعاء ويتم الحصول على الرد.

بالطبع، هنا بعض المعلومات الإضافية التي يمكن أن تكون مفيدة لفهم كيفية التعامل مع استجابات الاستدعاءات الغير متزامنة في تطبيق express.js:

1. الوظائف الغير متزامنة (Async Functions): يمكن استخدام الوظائف الغير متزامنة (مع الكلمة الأساسية async) لتحديد الوظائف التي تحتوي على أوامر تنتظر الاكتمال. هذا يسمح لك باستخدام كلمة الأمر await داخل الوظيفة لانتظار اكتمال الأوامر غير المتزامنة داخلها.

2. الوعود (Promises): تستخدم الوعود لإدارة العمليات غير المتزامنة في JavaScript. عندما تقوم بالاستدعاء إلى دالة تُعيد وعدًا (promise)، يمكنك استخدام await لانتظار اكتمال الوعد والحصول على القيمة المُعدة.

3. دالة res.send(): هذه الدالة في express.js تُستخدم لإرسال الرد إلى العميل. يمكنك استخدامها لإرسال نص أو بيانات JSON أو HTML كجزء من استجابة الخادم للطلب.

4. معالجات الأخطاء (Error Handlers): يجب أن تُعالج الأخطاء بشكل صحيح في تطبيق express.js. يمكنك استخدام كلمة الأمر try...catch للتقاط الأخطاء داخل وظائف الاستجابة، ومن ثم إرسال رسالة الخطأ المناسبة إلى العميل.

5. استخدام مكتبات للاتصال بالخدمات الخارجية: للقيام بالاستدعاءات إلى خدمات خارجية مثل Stripe API، يمكنك استخدام مكتبات مثل Axios أو node-fetch. هذه المكتبات تسهل عملية إرسال الطلبات وتحليل الردود بطريقة أكثر فعالية.

6. تجنب الحلول الغير موثوقة للانتظار: يجب تجنب استخدام الحلول الغير موثوقة مثل setTimeout() لانتظار الاستدعاءات الغير متزامنة، حيث أن هذه الحلول قد تؤدي إلى سلوك غير متوقع أو أخطاء في التطبيق.

مع مراعاة هذه النقاط، يمكنك بناء تطبيق express.js قادر على التعامل مع استجابات الاستدعاءات الغير متزامنة بشكل صحيح وفعال.