בקשות-טווח-עבודה

כששולחים בקשה, אפשר להגדיר כותרת range שמנחה את השרת להחזיר רק חלק מהבקשה. זו אפשרות שימושית בקבצים מסוימים, כמו קובץ וידאו, שבהם המשתמש עשוי לשנות את נקודת ההפעלה של הסרטון.

מה המודול הזה עושה?

יכולים להיות תרחישים שבהם תרצו להציג קובץ שנשמר במטמון, אבל הדפדפן הגדיר את הכותרת range. בדרך כלל, המערכת תתעלם מהכותרת.

המודול הזה יקרא את התגובה שנשמרה במטמון ויחזיר את טווח הנתונים שצוין.

שימוש בסיסי

על מנת להשתמש בבקשות לטווח תאים ב-Workbox, מוסיפים את הפלאגין לאסטרטגיה שעבורה רוצים לבדוק אם יש בקשות לטווח.

import {registerRoute} from 'workbox-routing';
import {CacheFirst} from 'workbox-strategies';
import {RangeRequestsPlugin} from 'workbox-range-requests';

registerRoute(
  ({url}) => url.pathname.endsWith('.mp4'),
  new CacheFirst({
    plugins: [
      new RangeRequestsPlugin(),
    ],
  });
);

שימו לב: יש כמה שיקולים נוספים שצריך להביא בחשבון כשמציגים תוכן מדיה שנשמר במטמון. למידע נוסף, אפשר לקרוא מידע נוסף במתכון"הגשה של אודיו ווידאו שנשמר במטמון"

שימוש מתקדם

אם רוצים להשתמש בלוגיקה הזו מחוץ לפלאגין, אפשר להשתמש בפונקציה createPartialResponse().

import {createPartialResponse} from 'workbox-range-requests';

createPartialResponse(request, cachedResponse);

מידע נוסף זמין במסמכי העזר.

סוגים

RangeRequestsPlugin

בעזרת הפלאגין של בקשת הטווח, קל למלא בקשה עם כותרת 'טווח' באמצעות תגובה שנשמרה במטמון.

לשם כך, מתבצע יירוט של הקריאה החוזרת (callback) של הפלאגין cachedResponseWillBeUsed והחזרת קבוצת המשנה המתאימה של גוף התגובה שנשמר במטמון.

תכונות

• Constructor

  void

  הפונקציה constructor נראית כך:

  ()=> {...}

  • החזרות

    RangeRequestsPlugin

שיטות

createPartialResponse()

workbox-range-requests.createPartialResponse(
  request: Request,
  originalResponse: Response,
)

בהינתן אובייקט Request ו-Response כקלט, הפונקציה הזו תחזיר הבטחה ל-Response חדש.

אם השדה Response המקורי כבר מכיל תוכן חלקי (כלומר בעל סטטוס 206), ההנחה היא שהוא כבר עומד בדרישות של Range: ויחזיר אותו כפי שהוא.

פרמטרים

• בקשה

  בקשה

  בקשה, שאמורה להכיל כותרת טווח:

• originalResponse

  תשובה

  תשובה.

החזרות

• הבטחה<Response>

  תגובה 206 Partial Content, שבה גוף התגובה מוגדר לקטע התוכן שצוין על ידי הכותרת Range: של הבקשה, או תגובה 416 Range Not Satisfiable במקרה שלא ניתן לעמוד בתנאים של הכותרת Range:.