في هذا الدرس التطبيقي حول الترميز، ستستخدم عامل خدمة لإدارة الإشعارات. تفترض الإرشادات الواردة هنا أنك على دراية بعاملي الخدمات وأساسيات طلب إذن إرسال الإشعارات وإرسال الإشعارات. إذا كنت بحاجة إلى تنشيط ذاكرتك بشأن الإشعارات، يمكنك الاطّلاع على الدرس التطبيقي بدء استخدام واجهة برمجة تطبيقات الإشعارات. للاطّلاع على مزيد من المعلومات عن مشغِّلات الخدمات، يمكنك الاطّلاع على مقالة مقدّمة عن مشغِّلات الخدمات التي كتبها "مات غونت".
إعادة مزج نموذج التطبيق وعرضه في علامة تبويب جديدة
يتم تلقائيًا حظر الإشعارات من تطبيق Glitch المضمّن، لذا لن تتمكّن من معاينة التطبيق على هذه الصفحة. بدلاً من ذلك، إليك الخطوات التي يجب اتّباعها:
- انقر على Remix to Edit (إنشاء ريمكس لتعديله) ليصبح المشروع قابلاً للتعديل.
- لمعاينة الموقع الإلكتروني، اضغط على عرض التطبيق. ثم اضغط على ملء الشاشة .
من المفترض أن يتم فتح الخطأ في علامة تبويب جديدة على Chrome.
أثناء العمل على هذا الدرس التطبيقي حول الترميز، عليك إجراء تغييرات على الرمز البرمجي في أداة Glitch المضمَّنة في هذه الصفحة. يُرجى إعادة تحميل علامة التبويب الجديدة التي تتضمّن تطبيقك المباشر للاطّلاع على التغييرات.
التعرُّف على نموذج التطبيق ورمز البدء
ابدأ بالنظر إلى التطبيق المباشر في علامة تبويب Chrome الجديدة:
- اضغط على "Control+Shift+J" (أو "Command+Option+J" على نظام التشغيل Mac) لفتح "أدوات مطوري البرامج".
انقر على علامة التبويب وحدة التحكم.
تأكَّد من تحديد الخيار معلومات في القائمة المنسدلة المستويات بجانب مربّع الفلتر.
في وحدة تحكّم أدوات مطوري البرامج لتطبيقك المنشور، من المفترض أن تظهر لك رسالة وحدة تحكّم:
TODO: Implement getRegistration()
.هذه رسالة من مقتطف دالة ستنفذها في هذا الدليل التعليمي.
لنلقِ الآن نظرة على رمز نموذج التطبيق في Glitch المضمّن في هذه الصفحة.
في Glitch المضمّن، اطّلِع على
public/index.js
:هناك أربعة رموز بديلة للدوال التي سيتم تنفيذها:
registerServiceWorker
وgetRegistration
وunRegisterServiceWorker
وsendNotification
.تطلب الدالة
requestPermission
إذن المستخدم لإرسال الإشعارات. إذا كنت قد أجريت الدورة التدريبية حول بدء استخدام Notifications API، ستلاحظ أنّه تم استخدام الدالةrequestPermission
هنا. والفرق الوحيد هو أنّه يتم الآن أيضًا تعديل واجهة المستخدم بعد حلّ طلب الإذن.تعمل الدالة
updateUI
على إعادة تحميل جميع أزرار التطبيق ورسائله.ترصد الدالة
initializePage
الميزات لإمكانيات مشغّل الخدمات في المتصفّح وتعدِّل واجهة مستخدم التطبيق.ينتظر النص البرمجي حتى يتم تحميل الصفحة ثم يُنشئها.
في التطبيق ضمن لوحة الخطأ، افتح
public/service-worker.js
.وكما يوحي الاسم، ستضيف رمزًا إلى التطبيق لتسجيل هذا الملف كأحد عمال الخدمة.
على الرغم من أنّ التطبيق لا يستخدم الملف بعد، إلا أنّه يحتوي على بعض الرموز البرمجية الافتتاحية التي ستطبع رسالة في وحدة التحكّم عند تفعيل الخدمة.
وعليك إضافة الرمز إلى "
public/service-worker.js
" للتعامل مع الإشعارات عندما يستلمها مشغّل الخدمات.
تسجيل مشغّل الخدمات
في هذه الخطوة، ستكتب رمزًا برمجيًا يتم تنفيذه
عندما ينقر المستخدم على تسجيل عامل الخدمة في واجهة مستخدم التطبيق.
سيسجّل هذا الرمز public/service-worker.js
كمشغّل خدمات.
في محرِّر Glitch المضمّن، افتح
public/index.js
. استبدِل الدالةregisterServiceWorker
بالرمز البرمجي التالي:// Use the Service Worker API to register a service worker.
async function registerServiceWorker() {
await navigator.serviceWorker.register('./service-worker.js')
updateUI();
}يُرجى العِلم أنّ
registerServiceWorker
يستخدم بيانasync function
لتسهيل التعامل مع الوعود. يتيح لك ذلكawait
القيمة التي تم حلها لـPromise
. على سبيل المثال، تنتظر الدالة أعلاه نتيجة تسجيل مشغّل خدمة قبل تعديل واجهة المستخدم. اطّلِع علىawait
على MDN للحصول على مزيد من المعلومات.والآن بعد أن أصبح بإمكان المستخدم تسجيل عامل خدمة، يمكنك الحصول على إشارة إلى عنصر تسجيل عامل الخدمة. في
public/index.js
، استبدِل الدالةgetRegistration
بالرمز البرمجي التالي:// Get the current service worker registration.
function getRegistration() {
return navigator.serviceWorker.getRegistration();
}تستخدِم الدالة أعلاه Service Worker API للحصول على تسجيل مشغّل الخدمة الحالي، في حال توفّره. وهو يسهّل عليك الإشارة إلى تسجيل مشغّل الخدمات.
لإكمال وظيفة تسجيل مشغّل الخدمة، أضِف رمزًا لإلغاء تسجيل مشغّل الخدمة. استبدِل الدالة
unRegisterServiceWorker
بالرمز البرمجي التالي:// Unregister a service worker, then update the UI.
async function unRegisterServiceWorker() {
// Get a reference to the service worker registration.
let registration = await getRegistration();
// Await the outcome of the unregistration attempt
// so that the UI update is not superceded by a
// returning Promise.
await registration.unregister();
updateUI();
}
في علامة التبويب التي تعرض التطبيق المباشر، أعِد تحميل الصفحة. من المفترض أن يعمل الزرّان تسجيل مشغّل الخدمات وإلغاء تسجيل مشغّل الخدمات الآن.
إرسال إشعارات إلى الخدمة العاملة
في هذه الخطوة، ستكتب رمزًا سيتم تنفيذه عندما ينقر المستخدم على إرسال إشعار في واجهة مستخدم التطبيق. سينشئ هذا الرمز إشعارًا ويتحقّق من تسجيل عامل خدمة، ثم يرسل الإشعار إلى عامل الخدمة باستخدام طريقة postMessage
.
في محرِّر Glitch المضمّن، افتح public/index.js
واستبدِل الدالة sendNotification
بالرمز البرمجي التالي:
// Create and send a test notification to the service worker.
async function sendNotification() {
// Use a random number as part of the notification data
// (so you can tell the notifications apart during testing!)
let randy = Math.floor(Math.random() * 100);
let notification = {
title: 'Test ' + randy,
options: { body: 'Test body ' + randy }
};
// Get a reference to the service worker registration.
let registration = await getRegistration();
// Check that the service worker registration exists.
if (registration) {
// Check that a service worker controller exists before
// trying to access the postMessage method.
if (navigator.serviceWorker.controller) {
navigator.serviceWorker.controller.postMessage(notification);
} else {
console.log('No service worker controller found. Try a soft reload.');
}
}
}
في ما يلي ما تفعله هذه التعليمة البرمجية:
sendNotification
هي دالة غير متزامنة، لذا يمكنك استخدامawait
للحصول على إشارة إلى تسجيل الخدمة العاملة.تُرسِل طريقة
postMessage
الخاصة بعملية الخدمة البيانات من التطبيق إلى عملية الخدمة. راجِع مستندات MDN في postMessage للحصول على مزيد من المعلومات.يتحقّق الرمز من توفّر السمة
navigator.serviceWorker.controller
قبل محاولة الوصول إلى الدالةpostMessage
. ستكون قيمةnavigator.serviceWorker.controller
هيnull
إذا لم يتوفّر مشغّل خدمات نشط أو تم فرض إعادة تحميل الصفحة (Shift+
إعادة التحميل). يمكنك الاطّلاع على مستندات وحدة تحكّم ServiceWorker على MDN للحصول على مزيد من المعلومات.
معالجة الإشعارات في الخدمة العاملة
في هذه الخطوة، ستكتب رمزًا في عامل الخدمة سيتعامل مع الرسائل المنشورة عليه ويعرض إشعارات للمستخدم.
في أداة تعديل الأخطاء المضمّنة، افتح public/service-worker.js
. أضِف الرمز البرمجي التالي إلى نهاية الملف:
// Show notification when received
self.addEventListener('message', (event) => {
let notification = event.data;
self.registration.showNotification(
notification.title,
notification.options
).catch((error) => {
console.log(error);
});
});
وفي ما يلي شرح سريع:
إنّ
self
هو مرجع إلى مشغّل الخدمات نفسه.على الرغم من أنّ الخدمة العاملة تتعامل الآن مع عرض الإشعارات، لا تزال واجهة المستخدم الرئيسية للتطبيق مسؤولة عن الحصول على إذن الإشعارات من المستخدم. في حال عدم منح الإذن، يتم رفض الوعد الذي يعرضه
showNotification
. يستخدم الرمز البرمجي أعلاه مجموعةcatch
لتجنُّب حدوث خطأ رفضPromise
غير معروف، والتعامل مع هذا الخطأ بشكل أكثر سلاسة.
إذا واجهت مشكلة، يمكنك الانتقال إلى glitch.com/edit/#!/codelab-notifications-service-worker-completed للاطّلاع على الرمز البرمجي المكتمل.
انتقِل إلى ورشة رموز البرمجة التالية في هذه السلسلة: إنشاء خادم إشعارات فورية.