FetchEvent
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2018.
Experimental: Esta es una tecnología experimental
Comprueba la Tabla de compabilidad de navegadores cuidadosamente antes de usarla en producción.
Este es el tipo de evento para eventos "fetch
" despachados en el scope global del service worker. Contiene información sobre la búsqueda (fetch), incluyendo la petición (request) y cómo el receptor tratará la respuesta (response).
Provee el método event.respondWith()
, el cúal nos permite proporcionar una respuesta a esta búsqueda (fetch).
Constructor
new FetchEvent()
-
Crea un nuevo objecto
FetchEvent
. Este constructor no se usa normalmente. El propio navegador crea estos objetos y los proporciona a los callbacks de eventos "fetch
".
Propiedades
Hereda propiedades del ancestro, Event
.
fetchEvent.clientId
Read onlyfetchEvent.preloadResponse
Read only-
Un
Promise
para unResponse
, o vacío si este no es una navegación, o navigation preload no esta habilitado. fetchEvent.request
Read only-
La
Request
que el navegador intenta crear.
Métodos
Herada métodos del padre, ExtendableEvent
.
fetchEvent.respondWith()
-
Evita el manejo de búsqueda predeterminado del navegador y proporciona (una promesa) una respuesta usted mismo.
extendableEvent.waitUntil()
-
Extiende el tiempo de vida del evento. Se usa para notificar al navegador las tareas que van más allá de la devolución de una respuesta, como la transmisión y el almacenamiento en caché.
Ejemplos
Este evento fetch, permite al navegador hacer esta acción por defecto para peticiones non-GET. Para peticiones GET esto intenta retornar una coincidencia en el cache, y vuelve de nuevo a la red. Si busca una concidencia en el cache, actualiza asincronicamente el cache para la próxima vez.
addEventListener("fetch", (event) => {
// Permite al navegador hacer este asunto por defecto
// para peticiones non-GET.
if (event.request.method != "GET") return;
// Evita el valor predeterminado, y manejar solicitud nosostros mismos.
event.respondWith(
(async function () {
// Intenta obtener la respuesta de el cache.
const cache = await caches.open("dynamic-v1");
const cachedResponse = await cache.match(event.request);
if (cachedResponse) {
// Si encontramos una coincidencia en el cache, lo devuelve, pero también
// actualizar la entrada en el cache en segundo plano.
event.waitUntil(cache.add(event.request));
return cachedResponse;
}
// Si no encontramos una coincidencia en el cache, usa la red.
return fetch(event.request);
})(),
);
});
Especificaciones
Specification |
---|
Service Workers # fetchevent-interface |
Compatibilidad con navegadores
BCD tables only load in the browser