本指南著重於說明 Workbox 6.0 中引入的破壞性變更，並提供從 Workbox 5.0 升級時需要進行的變更範例。
破壞性變更
工作箱核心
workbox-core 中的 skipWaiting() 方法將不再加入 install 處理常式，且等同於只呼叫 self.skipWaiting()。
skipWaiting() 可能會在 Workbox v7 中移除，因此建議您從現在起改用 self.skipWaiting()。
workbox-precaching
- 針對與 HTTP 重新導向相對應的網址，跨來源 HTML 文件無法再用於滿足
workbox-precaching的導覽要求。這種情況通常十分罕見。 - 現在查詢特定要求的預先快取回應時，
workbox-precaching將會忽略fbclid網址查詢參數。 PrecacheController建構函式現在會使用具有特定屬性的物件做為參數，而非字串。這個物件支援下列屬性：cacheName(用途與在 v5 中傳入建構函式的字串相同)、plugins(取代 v5 中的addPlugins()方法)，以及fallbackToNetwork(取代 v5 中傳送至createHandler()和 `createHandlerBoundToURL() 的類似選項)。PrecacheController的install()和activate()方法現在只會採用一個參數，且應分別設為對應的InstallEvent或ActivateEvent。addRoute()方法已從PrecacheController中移除。並運用新的PrecacheRoute類別建立可以註冊的路徑。precacheAndRoute()方法已從PrecacheController中移除。(它仍會以workbox-precaching模組匯出的靜態輔助程式方法形式存在)。你改用PrecacheRoute，因此已遭移除。createMatchCalback()方法已從PrecacheController中移除。您可以改用新的PrecacheRoute。createHandler()方法已從PrecacheController中移除。您可以改用PrecacheController物件的strategy屬性來處理要求。createHandler()靜態匯出項目已從workbox-precaching模組中移除。開發人員應改為建構PrecacheController例項，並使用其strategy屬性。- 使用
precacheAndRoute()註冊的路徑現在是「實際」路徑，會在背景中使用workbox-routing的Router類別。如果交錯呼叫registerRoute()和precacheAndRoute()，這可能會導致路徑的評估順序不同。
工作箱路徑
setDefaultHandler() 方法現在會使用選用的第二個參數，對應於所套用的 HTTP 方法，預設為 'GET'。
- 如果您使用
setDefaultHandler()，且所有要求都是GET，則不需要進行任何變更。 - 如果您有任何非
GET(POST、PUT等) 的要求，setDefaultHandler()將不再導致這些要求相符。
版本設定
workbox-build 和 workbox-cli 不再支援 getManifest 和 injectManifest 模式的 mode 選項，我們已將其移除。這不適用於 workbox-webpack-plugin，因為其 InjectManifest 外掛程式支援 mode。
建構工具需要 Node.js v10 以上版本
workbox-webpack-plugin、workbox-build 或 workbox-cli 不再支援第 10 版之前的 Node.js 版本。如果您執行的 Node.js 版本低於 v8，請將執行階段更新至支援的版本。
最新改進項目
workbox-strategies
Workbox 6.0 推出了第三方開發人員定義自身 Workbox 策略的新方法。這可確保第三方開發人員能夠根據自身需求，擴充 Workbox 的功能。
新增策略基礎類別
在 6.0 版中，所有 Workbox 策略類別都必須擴充新的 Strategy 基礎類別。我們已重新編寫所有內建策略，以便支援這項功能。
Strategy 基本類別負責兩項主要工作：
- 叫用所有策略處理常見的外掛程式生命週期回呼 (例如開始、回應和結束時)。
- 建立「處理程序」例項，可管理策略處理的每項個別要求狀態。
新的「handler」類別
我們先前有內部模組呼叫 fetchWrapper 和 cacheWrapper，這兩者 (如其名稱所示) 會將各種擷取和快取 API 包裝在生命週期中。這項功能目前可讓外掛程式正常運作，但不會向開發人員公開。
新的「處理程序」類別 StrategyHandler 會公開這些方法，讓自訂策略可以呼叫 fetch() 或 cacheMatch()，並自動叫用已新增至策略例項的任何外掛程式。
這個類別還可讓開發人員新增自訂的生命週期回呼，這些回呼可能會與其策略相關，並且會與現有的外掛程式介面「相容」。
新的外掛程式生命週期狀態
在 Workbox v5 中，外掛程式為無狀態。也就是說，如果 /index.html 的要求同時觸發 requestWillFetch 和 cachedResponseWillBeUsed 回呼，這兩個回呼就無法互相通訊，甚至無法得知是由同一個要求觸發。
在 v6 中，所有外掛程式回呼也會傳遞新的 state 物件。這個狀態物件將是此特定外掛程式物件和此特定策略叫用 (即對 handle() 的呼叫) 專屬。這可讓開發人員編寫外掛程式，讓一個回呼可根據同一個外掛程式中的另一個回呼所執行的動作，有條件地執行某些動作 (例如，計算執行 requestWillFetch 和 fetchDidSucceed 或 fetchDidFail 之間的時間差異)。
新的外掛程式生命週期回呼
我們新增了新的外掛程式生命週期回呼，讓開發人員充分利用外掛程式生命週期狀態：
handlerWillStart：在任何處理常式邏輯開始執行前呼叫。這個回呼可用於設定初始處理常態 (例如記錄開始時間)。handlerWillRespond：在策略handle()方法傳回回應前呼叫。這個回呼可用於修改回應，然後再傳回至路徑處理常式或其他自訂邏輯。handlerDidRespond：在策略的handle()方法傳回回應後呼叫。這個回呼可用於記錄任何最終回應詳細資料，例如其他外掛程式所做的變更。handlerDidComplete：在從這個策略的叫用新增至事件的所有延長生命週期承諾已完成後呼叫。這個回呼可用於回報任何需要等待處理程序完成才能計算的資料 (例如快取命中狀態、快取延遲、網路延遲)。handlerDidError：如果處理程序無法從任何來源提供有效回應，就會呼叫此方法。這個回呼可用於提供「備用」內容，做為網路錯誤的替代方案。
實作自訂策略的開發人員不必擔心要自行叫用這些回呼，因為這項工作會由新的 Strategy 基礎類別處理。
為處理常式提供更準確的 TypeScript 類型
各種回呼方法的 TypeScript 定義已正規化。這可為使用 TypeScript 並自行編寫程式碼來實作或呼叫處理常式的開發人員提供更優質的體驗。
workbox-window
新版 messageSkipWaiting() 方法
messageSkipWaiting() 這個新方法已新增至 workbox-window 模組，簡化通知「等待中」服務工作程式啟動程序的過程。這項功能帶來以下改善：
- 它會使用實際的標準訊息主體
{type: 'SKIP_WAITING'}呼叫postMessage()，Workbox 產生的服務工作者會檢查{type: 'SKIP_WAITING'}，以觸發skipWaiting()。 - 它會選擇正確的「等待中」Service Worker 來發布這則訊息，即使該工作站並非
workbox-window註冊時使用的 Service Worker 也一樣。
移除「external」事件，改用 isExternal 屬性
workbox-window 中的所有「外部」事件都已移除，並以「一般」事件取代，且 isExternal 屬性設為 true。這樣一來，有需要的開發人員仍可偵測到差異，而不需要知道的開發人員則可忽略該屬性。
清理「為使用者提供網頁重新載入功能」的最佳化方
由於上述兩項異動，「為使用者提供網頁重新載入」的最佳化調整程序可以簡化：
MULTI_LINE_CODE_PLACEHOLDER_0
workbox-routing
新的布林參數 sameOrigin 會傳遞至 workbox-routing 中使用的 matchCallback 函式。如果要求是針對相同來源網址，則設為 true；否則設為 false。
這麼做可簡化一些常見的模板：
MULTI_LINE_CODE_PLACEHOLDER_1
workbox-expiration 中的 matchOptions
您現在可以在 workbox-expiration 中設定 matchOptions，其之後會以 CacheQueryOptions 的形式傳遞給基礎 cache.delete() 呼叫。(大多數開發人員不需要這麼做)。
workbox-precaching
使用 workbox-strategies
workbox-precaching 已重新編寫，以便使用 workbox-strategies 做為基礎。這項變更不應導致任何重大變更，且應可改善兩個模組存取網路和快取的方式，讓兩者在長期內保持一致。
預先快取現在會逐一處理項目，而非大量處理
workbox-precaching 已更新，因此系統只會一次要求及快取預先快取資訊清單中的一個項目，而不會嘗試一次要求及快取所有項目 (讓瀏覽器自行決定如何節流)。
這麼做可降低預先快取時發生 net::ERR_INSUFFICIENT_RESOURCES 錯誤的可能性，並減少預先快取與網頁應用程式同時提出的請求之間的頻寬爭用情形。
PrecacheFallbackPlugin 可讓您更輕鬆地使用離線備用機制
workbox-precaching 現在包含 PrecacheFallbackPlugin，可實作 v6 中新增的 handlerDidError 生命週期方法。
如此一來，如果無法取得回應，您就能輕鬆將已快取的網址指定為特定策略的「備用」網址。外掛程式會負責為友善快取網址正確建構正確的快取金鑰，包括任何所需的修訂版本參數。
以下範例說明如何在 NetworkOnly 策略無法產生導覽要求的回應時 (也就是顯示自訂離線 HTML 網頁)，透過友善載入的 /offline.html 回應：
MULTI_LINE_CODE_PLACEHOLDER_2
precacheFallback 在執行階段快取
如果您使用 generateSW 為您建立服務工作者，而不是手動編寫服務工作者，則可使用 runtimeCaching 中的新 precacheFallback 設定選項來完成相同的工作：
{
// ... other generateSW config options...
runtimeCaching: [{
urlPattern: ({request}) => request.mode === 'navigate',
handler: 'NetworkOnly',
options: {
precacheFallback: {
// This URL needs to be included in your precache manifest.
fallbackURL: '/offline.html',
},
},
}],
}
取得協助
我們預期大部分遷移作業都會很簡單。如果您遇到本指南未涵蓋的問題，請在 GitHub 上提出問題，讓我們瞭解實際狀況。