NAMESPACE STATIC
VERSION V3.6.1

類

NavigationRoute

NavigationRoute可以輕松創建匹配瀏覽器navigation requests的Route。

它僅匹配mode設置為navigate的請求。

您可以只使用blacklist和whitelist參數中的一個或兩個，將此路由應用于導航請求中。

RegExpRoute

RegExpRoute可以輕松創建一個基于正則表達式的Route。

對于同源請求，正則只需要匹配部分URL。 對于針對第三方服務器的請求，您必須定義與URL的開頭匹配的正則。

有關信息，請參閱模塊文檔。

Route

Route包含match和handler回調函數。match回調決定路由是否通過handler來處理請求。當匹配時調用handler回調并且應該返回一個解析為Response的Promise。

Router

如果存在匹配的路由，Router可以通過一個或多個Routes來響應請求。

如果沒有匹配請求，在設置default的handle情況下會執行這個handle。

如果匹配的路由拋出錯誤，路由器將使用catch處理程序。如果定義了這個handle，它會執行并做出請求進行響應。

如果請求匹配多條路由，則最早注冊的路由將用于響應請求。

方法

registerNavigationRoute

STATIC

registerNavigationRoute(cachedAssetUrl, options)，返回workbox.routing.NavigationRoute

注冊導航請求路由，會返回預緩存文件。對于App Shell模式是非常有用的。

這個方法會生成一個NavigationRoute并調用Router.registerRoute()。

參數

cachedAssetUrl

String。

options

可選，Object，包含以下屬性：

• cacheName：可選，string。緩存名，用來存儲和獲取請求。默認緩存名由workbox-core.cacheNames提供。
• blacklist：可選，Array of RegExp。如果與任何一個匹配，則不會處理請求（即使白名單也匹配）。
• whitelist：可選，Array of RegExp。如果URL的pathname和查詢參數與任何一個匹配，則路由會處理請求（在黑名單未匹配的情況下）。

返回

workbox.routing.NavigationRoute 返回生成的路由。

registerRoute

STATIC

registerRoute(capture, handler, method)返回workbox.routing.Route。

使用緩存策略很輕松的注冊RegExp，string， function路由。

如果需要，此方法會生成Route并調用Router.registerRoute() 。

參數

capture

如果捕獲參數是Route，則將忽略所有其他參數。(RegExp，string，workbox.routing.Route~matchCallback，或者 workbox.routing.Route)

handler

workbox.routing.Route~handlerCallback
一個回調函數，它返回一個Response的Promise。

method

可選，string。用于匹配Route的HTTP方法。

返回

workbox.routing.Route，生成Route（對注銷很用）。

setCatchHandler

STATIC

setCatchHandler(handler)。

如果在處理請求期間路由拋出錯誤，那么將調用此處理程序，并可以做出請求響應。

參數

handler

一個回調函數，它返回一個Response的Promise。

setDefaultHandler

STATIC

setDefaultHandler(handler)。

定義當沒有路由匹配請求時調用的默認處理程序。

如果沒有默認處理程序，則不匹配的請求將通過網絡請求，就像沒有service worker一樣。

參數

handler

一個回調函數，它返回一個Response的Promise。

unregisterRoute

STATIC

unregisterRoute(route)。

注銷路由。

參數

route

注銷的路由。

---

博客名稱：王樂平博客

CSDN博客地址：http://blog.csdn.net/lecepin

本作品采用知識共享署名-非商業性使用-禁止演繹 4.0 國際許可協議進行許可。

總結

以上是生活随笔為你收集整理的Workbox.routing v3.x 中文版的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。