أحداث الدفع

لقد تناولنا حتى الآن كيفية اشتراك المستخدم وإرسال رسالة فورية. الخطوة التالية هي تلقّي رسالة الإشعار الفوري هذه على جهاز المستخدم وعرض إشعار (بالإضافة إلى تنفيذ أي عمل آخر قد نريد تنفيذه).

حدث الإرسال

عند تلقّي رسالة، سيؤدي ذلك إلى إرسال حدث دفع في مشغّل الخدمات.

يجب أن يكون الرمز البرمجي لإعداد متتبِّع أحداث الإشعارات الفورية مشابهًا إلى حد كبير لأي متتبِّع أحداث آخر تكتبه بلغة JavaScript:

self.addEventListener('push', function(event) {
    if (event.data) {
    console.log('This push event has data: ', event.data.text());
    } else {
    console.log('This push event has no data.');
    }
});

الجزء الأكثر غرابة في هذا الرمز بالنسبة إلى معظم المطوّرين الجدد في مجال مشغّلي الخدمات هو المتغيّر self. يُستخدم self عادةً في مشغّلات الويب، ومنها مشغّل الخدمات. يشير self إلى النطاق العام، مثل window في صفحة الويب. أما بالنسبة إلى مشغّلات الويب ومشغّلات الخدمات، فيشير self إلى المشغّل نفسه.

في المثال أعلاه، يمكن اعتبار self.addEventListener() بمثابة إضافة متتبِّع أحداث إلى مشغّل الخدمات نفسه.

في مثال حدث الإرسال، نتحقق مما إذا كانت هناك أي بيانات ونطبع شيئًا ما على وحدة التحكم.

هناك طرق أخرى يمكنك من خلالها تحليل البيانات من حدث دفع:

// Returns string
event.data.text()

// Parses data as JSON string and returns an Object
event.data.json()

// Returns blob of data
event.data.blob()

// Returns an arrayBuffer
event.data.arrayBuffer()

يستخدم معظم الأشخاص json() أو text() حسب ما يتوقعونه من تطبيقهم.

يوضّح هذا المثال كيفية إضافة متتبِّع أحداث الإشعارات الفورية وكيفية الوصول إلى البيانات، ولكنّه يفتقر إلى وظيفتَين مهمتَين للغاية. لا يعرض إشعارًا ولا يستخدم event.waitUntil().

الانتظار حتى

من الأمور التي يجب فهمها حول مشغِّلات الخدمات هو أنّك لا تملك سوى قدر ضئيل من التحكّم في وقت تشغيل رمز مشغِّل الخدمات. ويقرّر المتصفّح متى يتم تنشيطها ومتى يتم إنهاؤها. الطريقة الوحيدة لإعلام المتصفّح بأنّك مشغول جدًا في تنفيذ مهام مهمة هي تمرير وعد إلى الإجراء event.waitUntil(). وبذلك، سيُبقي المتصفّح مشغّل الخدمات قيد التشغيل إلى أن تتم تسوية الوعد الذي تم تمريره.

في ما يتعلّق بأحداث الإشعارات الفورية، هناك شرط إضافي يتمثّل في ضرورة عرض إشعار قبل تسوية الوعد الذي تم تمريره.

في ما يلي مثال أساسي على عرض إشعار:

self.addEventListener('push', function(event) {
    const promiseChain = self.registration.showNotification('Hello, World.');

    event.waitUntil(promiseChain);
});

يتم استدعاء self.registration.showNotification() لعرض إشعار للمستخدم، ويتم عرض وعد سيتم تنفيذه بعد عرض الإشعار.

للحفاظ على وضوح هذا المثال قدر الإمكان، قمت بتعيين هذا الوعد لمتغير يسمى promiseChain. يتم بعد ذلك تمرير هذه القيمة إلى event.waitUntil(). أعلم أنّ هذا الشرح طويل جدًا، ولكنّني رأيت عددًا من المشاكل التي تفاقمت نتيجة سوء فهم ما يجب تمريره إلى waitUntil() أو نتيجة سلاسل الوعود المعطّلة.

يمكن أن يبدو المثال الأكثر تعقيدًا مع طلب شبكة للبيانات وتتبع حدث الدفع باستخدام التحليلات كما يلي:

self.addEventListener('push', function(event) {
    const analyticsPromise = pushReceivedTracking();
    const pushInfoPromise = fetch('/api/get-more-data')
    .then(function(response) {
        return response.json();
    })
    .then(function(response) {
        const title = response.data.userName + ' says...';
        const message = response.data.message;

        return self.registration.showNotification(title, {
        body: message
        });
    });

    const promiseChain = Promise.all([
    analyticsPromise,
    pushInfoPromise
    ]);

    event.waitUntil(promiseChain);
});

في هذا المثال، نستدعي دالة تعرض وعدًا pushReceivedTracking()، ويمكننا افتراض أنّها ستُرسل طلب شبكة إلى مقدّم خدمة الإحصاءات. نحن أيضًا نرسل طلب شبكة، ونحصل على الاستجابة ونعرض إشعارًا باستخدام بيانات الاستجابة لعنوان الإشعار ورسالته.

يمكننا التأكّد من بقاء مشغّل الخدمات نشطًا أثناء تنفيذ هاتين المهمتَين من خلال دمج هذه الوعود مع Promise.all(). يتم تمرير الوعد الناتج إلى event.waitUntil() ما يعني أنّ المتصفّح سينتظر حتى ينتهي كلا الوعدَين قبل التحقّق من عرض إشعار وإنهاء مشغّل الخدمات.

السبب الذي يدفعنا إلى الاهتمام بـ waitUntil() وكيفية استخدامها هو أنّ إحدى المشاكل الأكثر شيوعًا التي يواجهها المطوّرون هي أنّه عندما تكون سلسلة الوعود غير صحيحة أو معطّلة، سيعرض Chrome هذا الإشعار "التلقائي":

صورة للإشعار التلقائي في Chrome

سيعرض Chrome الإشعار "تم تحديث هذا الموقع الإلكتروني في الخلفية" فقط عند تلقّي رسالة فورية وعدم عرض حدث الإرسال في مشغّل الخدمات إشعارًا بعد انتهاء الوعد الذي تم تمريره إلى event.waitUntil().

السبب الرئيسي وراء وقوع المطوّرين في هذا الخطأ هو أنّ الرمز البرمجي الخاص بهم غالبًا ما يستدعي self.registration.showNotification()، ولكنّهم لا يفعلون أي شيء باستخدام الوعد الذي يعرضه. ويؤدي ذلك بشكل متقطع إلى عرض الإشعار التلقائي. على سبيل المثال، يمكننا إزالة القيمة المعادة لـ self.registration.showNotification() في المثال أعلاه، ولكننا سنواجه خطر ظهور هذا الإشعار.

self.addEventListener('push', function(event) {
    const analyticsPromise = pushReceivedTracking();
    const pushInfoPromise = fetch('/api/get-more-data')
    .then(function(response) {
        return response.json();
    })
    .then(function(response) {
        const title = response.data.userName + ' says...';
        const message = response.data.message;

        self.registration.showNotification(title, {
        body: message
        });
    });

    const promiseChain = Promise.all([
    analyticsPromise,
    pushInfoPromise
    ]);

    event.waitUntil(promiseChain);
});

يمكنك أن ترى كيف أنه من السهل تفويتها.

تذكَّر أنّه إذا ظهر لك هذا الإشعار، عليك التحقّق من سلاسل الوعود وevent.waitUntil().

في القسم التالي، سنلقي نظرة على ما يمكننا فعله لتصميم الإشعارات والمحتوى الذي يمكننا عرضه.

الخطوات التالية

Code labs