שני ממשקי API ממלאים תפקיד חיוני ביצירת אפליקציות אינטרנט אמינות: קובץ שירות (service worker) ואחסון המטמון. אבל להשתמש בהם ביעילות — בלי להכניס באגים עדינים או להיתקל בבעיות במקרים מסוימים, יכול להיות מאתגר. לדוגמה, שגיאות בקוד של Service Worker עשויות לגרום לבעיות בשמירה במטמון; יכול להיות שלמשתמשים מוצג תוכן לא עדכני או פגום קישורים.
תיבת העבודה היא ערכת הכלים של קובץ שירות (service worker) מבוססת על Service Worker ו-Cache Storage ממשקי API. הוא מספק קבוצה מוכנה לייצור של ספריות להוספת תמיכה אופליין אפליקציות אינטרנט. ערכת הכלים מחולקת לשתי אוספים: כלים שעוזרים לנהל את הקוד שרץ בתוך ה-Service Worker, וכלים שמשתלבים עם תהליך ה-build.
קוד זמן ריצה
זהו הקוד שרץ בתוך הסקריפט של ה-Service Worker ושולט באופן הפעולה שלו הוא מיירט בקשות יוצאות ויוצר אינטראקציה עם Cache Storage API. בתיבת העבודה יש בסך הכול עשרות מודולים של ספרייה, שכל אחת מהן מטפלת במגוון של תרחישים לדוגמה ספציפיים. המודולים החשובים ביותר לקבוע אם התגובה של קובץ השירות (service worker) Routing) ואיך הוא יגיב אסטרטגיית שמירה במטמון).
יצירת שילוב
מבצעים של Workbox שורת הפקודה, מודול Node.js, וגם הפלאגין של Webpack כלים שמספקים דרכים חלופיות לביצוע שני דברים:
- יצירת סקריפט של Service Worker שמבוסס על הגדרות אישיות אפשרויות. קובץ השירות (service worker) שנוצר משתמש בספריות זמן הריצה של Workbox "מאחורי הקלעים" כדי ליישם את אסטרטגיות השמירה במטמון שאתם מגדירים.
- ליצור רשימה של כתובות URL "precached", על סמך תבניות הניתנות להגדרה כדי לכלול ולהחריג קבצים שנוצרו בתהליך ה-build.
למה כדאי להשתמש ב-Workbox?
לא חובה להשתמש ב-Workbox כשמפתחים את Service Worker — יש כמה של המדריכים אסטרטגיות נפוצות לשמירה במטמון מ"וניל" של Service Worker. אם תחליטו להשתמש ב-Workbox, הנה כמה מהיתרונות שלו.
ניהול המטמון
תיבת העבודה מטפלת בעדכוני המטמון עבורכם, המשויכים לתהליך ה-build שלכם באמצעות שמירה מראש במטמון, או באמצעות מדיניות גודל/גיל שניתן להגדיר בזמן השימוש בסביבת זמן ריצה שמירה במטמון. ה-API הבסיסי של Cache Storage הוא חזק, אבל אין לו תמיכה מובנית במועד תפוגת המטמון. כלים כמו Workbox משלימים את הפער הזה.
רישום מקיף ביומן ודיווח על שגיאות
אם אתם מתחילים לעבוד עם עובדי שירות, אתם מבינים למה משהו
נשמר במטמון (או, גם מתסכל, למה לא לשמור במטמון) זה מאתגר.
תיבת העבודה מזהה באופן אוטומטי מתי פועלת גרסת פיתוח של
באתר ב-localhost, ומפעילה את הרישום של ניפוי הבאגים ב-JavaScript של הדפדפן
במסוף.
מעקב אחרי הודעות ביומן מאפשר לכם להגיע לרמה הבסיסית (root) של כל הרבה יותר מהר מאשר שהייתם צריכים רק אותו.
בסיס קוד שנבדק בכל הדפדפנים
תיבת העבודה פותחת על בסיס חבילת בדיקות חוצת-דפדפנים, וכשהדבר אפשרי, חוזרים באופן אוטומטי להטמעות חלופיות של תכונות שחסרים בדפדפנים מסוימים.
-
workbox-broadcast-cache-update moduleמשתמשת ב Broadcast Channel API כשזמין, ולחזור אל מבוססת עלpostMessage()בדפדפנים שבהם אין תמיכה. - מודול workbox-background-sync משתמשת ב Background Sync API אם הדבר אפשרי, ואם לא, יתבצע ניסיון חוזר של האירועים בתור בכל פעם ה-service worker יופעל.
איך משתמשים ב-Workbox?
שילוב עם Framework
אם אתם מתחילים פרויקט חדש מאפס, תוכלו ליהנות אפשר למצוא שילוב של תיבת עבודה בערכות פופולריות שונות לתחילת פעולה ויישומי פלאגין לתוספים:
הוספת Workbox לתהליך ה-build הקיים
אם כבר יש לכם תהליך build לאתר, הולם שורת הפקודה, מודול Node.js, או הפלאגין של Webpack ייתכן שהוא כל מה שצריך כדי להתחיל להשתמש ב-Workbox.
באופן ספציפי, ממשק שורת הפקודה של Workbox מאפשר להפעיל
פועל, כולל מצב wizard שיבדוק את ההתפתחות המקומית שלך
ולהציע הגדרות ברירת מחדל סבירות לשימוש
המשך:
workbox wizard
? What is the root of your web app (i.e. which directory do you deploy)? src/
? Which file types would you like to precache? css, js, html
? Where would you like your service worker file to be saved? build/sw.js
? Where would you like to save these configuration options? workbox-config.js
כדי ליצור קובץ שירות (service worker), מריצים את workbox generateSW workbox-config.js
כחלק מתהליך build. פרטים נוספים זמינים במאמרי העזרה בנושא generateSW.
אפשר לבצע שינויים ב-workbox-config.js כדי להתאים אישית את Service Worker.
פרטים נוספים זמינים במסמכי התיעוד של האפשרויות.
שימוש ב-Workbox בזמן ריצה ב-Service Worker קיים
אם יש לכם קובץ שירות (service worker) קיים ואתם רוצים לנסות את סביבת זמן הריצה של Workbox של הספריות, ייבוא של Workbox מה-CDN הרשמי שלה ולהתחיל להשתמש בו לשמירה במטמון של סביבת זמן הריצה באופן מיידי. השימוש הזה אז לא תוכלו לנצל את היתרון של שמירה במטמון דורש שילוב בזמן build), אבל הוא כלי מצוין ליצירת אב טיפוס ולהתנסות אסטרטגיות שונות לשמירה במטמון תוך כדי תנועה.
// Replace 3.6.3 with the current version number of Workbox.
importScripts('https://storage.googleapis.com/workbox-cdn/releases/3.6.3/workbox-sw.js');
workbox.routing.registerRoute(
new RegExp('\.png$'),
workbox.strategies.cacheFirst({
cacheName: 'images-cache',
})
);