FetchEvent
Baseline
Ampliamente disponible
*
Esta característica está consolidada y funciona en muchos dispositivos y versiones de navegador. Está disponible en todos los navegadores desde abril de 2018.
* Algunas partes de esta característica pueden tener distintos niveles de compatibilidad.
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.clientIdRead onlyfetchEvent.preloadResponseRead only-
Un
Promisepara unResponse, o vacío si este no es una navegación, o navigation preload no esta habilitado. fetchEvent.requestRead only-
La
Requestque 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
| Especificación |
|---|
| Service Workers Nightly> # fetchevent-interface> |