עד עכשיו הסברנו איך לרשום משתמש ואיך לשלוח הודעת Push. השלב הבא הוא לקבל את הודעת ה-Push הזו במכשיר של המשתמש ולהציג התראה (וגם לבצע כל פעולה אחרת שאנחנו רוצים).
אירוע הפוש
כשמתקבלת הודעה, נשלח אירוע התראה ב-Service Worker.
הקוד להגדרת רכיב event listener של אירוע דחיפה אמור להיות דומה מאוד לכל רכיב event listener אחר שכותבים ב-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.');
}
});
החלק הכי מוזר בקוד הזה לרוב המפתחים שחדשים ב-Service Worker הוא המשתנה self. self משמש בדרך כלל ב-Web Workers, ו-Service Worker הוא אחד מהם. self מתייחס להיקף הגלובלי, בדומה ל-window בדף אינטרנט. אבל ב-Web Workers וב-Service Workers, הערך של self מתייחס ל-worker עצמו.
בדוגמה שלמעלה, אפשר לחשוב על self.addEventListener() כהוספה של רכיב event listener ל-service worker עצמו.
בדוגמה של אירוע ההתראה, אנחנו בודקים אם יש נתונים ומדפיסים משהו במסוף.
יש דרכים אחרות לנתח נתונים מאירוע דחיפה:
// 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 listener של התראות ואיך ניגשים לנתונים, אבל חסרות בה שתי פונקציות חשובות מאוד. היא לא מציגה התראה ולא משתמשת ב-event.waitUntil().
המתנה עד
אחד הדברים שחשוב להבין לגבי קובצי Service Worker הוא שאין לכם הרבה שליטה על מתי הקוד של ה-Service Worker יפעל. הדפדפן מחליט מתי להפעיל אותו ומתי להפסיק אותו. הדרך היחידה להודיע לדפדפן שהדף עסוק בביצוע פעולות חשובות היא להעביר הבטחה ל-method event.waitUntil(). כך הדפדפן ימשיך להפעיל את קובץ השירות (service worker) עד שההבטחה שהעברתם תתממש.
באירועי דחיפה, יש דרישה נוספת: צריך להציג התראה לפני שה-promise שהעברתם יתקבל.
דוגמה בסיסית להצגת התראה:
self.addEventListener('push', function(event) {
const promiseChain = self.registration.showNotification('Hello, World.');
event.waitUntil(promiseChain);
});
הקריאה ל-self.registration.showNotification() היא השיטה (method) שבה מוצגת התראה למשתמש, והיא מחזירה הבטחה (promise) שתתממש אחרי שההתראה תוצג.
כדי שהדוגמה הזו תהיה ברורה ככל האפשר, הקציתי את ההבטחה הזו למשתנה שנקרא promiseChain. המידע הזה מועבר אל event.waitUntil(). אני יודע שזה הסבר ארוך מאוד, אבל ראיתי כמה בעיות שנגרמו כתוצאה מאי הבנה לגבי מה שצריך להעביר אל waitUntil() או כתוצאה משרשראות הבטחות שבורות.
דוגמה מורכבת יותר, עם בקשה לאחזור נתונים מהרשת ומעקב אחרי אירוע ההתראה באמצעות Analytics, יכולה להיראות כך:
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(),
שלצורך הדוגמה, אנחנו יכולים להניח שהיא תשלח בקשה לאחזור מהרשת
לספק שירותי הניתוח שלנו. אנחנו גם שולחים בקשה לאחזור מהרשת, מקבלים את התגובה ומציגים התראה באמצעות נתוני התגובות לכותרת ולהודעה של ההתראה.
כדי לוודא ש-service worker יישאר פעיל בזמן ששתי המשימות האלה מתבצעות, אפשר לשלב את ההבטחות האלה עם Promise.all(). ה-promise שנוצר מועבר אל event.waitUntil(),
כלומר הדפדפן ימתין עד ששני ה-promises יסתיימו לפני שיבדוק אם הוצגה התראה
ויסיים את ה-service worker.
הסיבה שצריך לשים לב ל-waitUntil() ולאופן השימוש בו היא שאחת הבעיות הנפוצות ביותר שמפתחים נתקלים בהן היא שכאשר שרשרת ה-Promise שגויה או שבורה, Chrome יציג את ההתראה "ברירת המחדל" הזו:
Chrome יציג את ההתראה "האתר הזה עודכן ברקע" רק כשמתקבלת הודעת Push ואירוע ה-Push ב-Service Worker לא מציג התראה אחרי שה-Promise שהועבר אל event.waitUntil() הסתיים.
הסיבה העיקרית לכך שמפתחים נתקלים בבעיה הזו היא שהקוד שלהם קורא לעיתים קרובות ל-self.registration.showNotification(), אבל הם לא עושים שום דבר עם ה-promise שהוא מחזיר. כתוצאה מכך, לפעמים מוצגת ההתראה שמוגדרת כברירת מחדל. לדוגמה, אם נסיר את ההחזרה של 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);
});
קל לפספס את זה.
חשוב לזכור: אם ההתראה הזו מופיעה, צריך לבדוק את שרשראות ה-Promise ואת event.waitUntil().
בקטע הבא נראה מה אפשר לעשות כדי לעצב התראות ואיזה תוכן אפשר להציג.
לאן ממשיכים מכאן
- סקירה כללית על התראות מאפליקציות אינטרנט
- איך פועל Push
- רישום משתמש
- חוויית המשתמש של ההרשאות
- שליחת הודעות באמצעות ספריות של Web Push
- פרוטוקול Web Push
- טיפול באירועי Push
- הצגת התראה
- התנהגות ההתראות
- תבניות נפוצות של התראות
- שאלות נפוצות בנושא התראות
- בעיות נפוצות ודיווח על באגים