API de Background Synchronization - API web | MDN

Toggle sidebar

Theme

OS default
Light
Dark

Español

Remember language Learn more

API de Background Synchronization

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Contexto seguro: Esta función está disponible solo en contextos seguros (HTTPS), en algunos o todos los navegadores que lo soportan.

Nota: Esta característica está disponible en Web Workers.

La API de Background Synchronization habilita a una aplicación web pospongan tareas para que se puedan ejecutar en un service worker una vez el usuario tenga conexión de red estable.

Conceptos y uso

La API de Background Synchronization permite que las aplicaciones web pospongan la sincronización con el servidor a su service worker para que la gestione más tarde, si el dispositivo está sin conexión. Entre sus usos se incluye el envío de solicitudes en segundo plano si no se pudieron enviar mientras se usaba la aplicación.

Por ejemplo, una aplicación de cliente de correo puede dejar que sus usuarios envíen correos cuando quieran, incluso si el dispositivo no tiene conexión de red. El frontend de la aplicación se limita a registrar una solicitud de sincronización y el service worker recibe una alerta cuando la red vuelve a estar presente y se encarga de la sincronización.

La interfaz SyncManager está disponible a través de ServiceWorkerRegistration.sync. Una etiqueta identificadora única se establece para "nombrar" el evento de sincronización, que después se puede escuchar dentro del script ServiceWorker. Una vez el evento se reciba, puedes ejecutar cualquier funcionalidad disponible, como enviar solicitudes al servidor.

Como esta API depende de service workers, la funcionalidad proporcionada por esta API solo está disponible en un contexto seguro.

Interfaces

SyncManager

Registra las tareas que se ejecutarán en un serviceworker posteriormente con conectividad de red. Estas tareas se denominan solicitudes de sincronización en segundo plano.

SyncEvent

Representa un evento de sincronización, enviado al ámbito global de un ServiceWorker. Proporciona una manera de ejecutar tareas en el service worker una vez que el dispositivo tenga conectividad de red.

Extensiones a otras interfaces

Las siguientes adiciones a la API de Service Worker proporciona un punto de entrada para configurar la sincronización en segundo plano.

ServiceWorkerRegistration.sync Read only

Devuelve una referencia a la interfaz SyncManager para registrar tareas que se ejecutarán una vez que el dispositivo tenga conectividad de red.

Evento sync

Un controlador de eventos que se activa cuando se produce un evento sync. Esto ocurre en cuanto la red está disponible.

Ejemplos

Los siguientes ejemplos muestran cómo utilizar la interfaz.

Solicitar una sincronización en segundo plano

La siguiente función asincrónica registra una sincronización en segundo plano desde un contexto de navegación:

js
async function syncMessagesLater() {
  const registration = await navigator.serviceWorker.ready;
  try {
    await registration.sync.register("sync-messages");
  } catch {
    console.log("Background Sync could not be registered!");
  }
}

Verificar una sincronización en segundo plano por etiqueta

Este código verifica si una tarea de sincronización en segundo plano con una etiqueta determinada está registrada.

js
navigator.serviceWorker.ready.then((registration) => {
  registration.sync.getTags().then((tags) => {
    if (tags.includes("sync-messages")) {
      console.log("Messages sync already requested");
    }
  });
});

Escuchar una sincronización en segundo plano dentro de un Service Worker

El siguiente ejemplo muestra cómo responder a un evento de sincronización en segundo plano en el service worker.

js
self.addEventListener("sync", (event) => {
  if (event.tag === "sync-messages") {
    event.waitUntil(sendOutboxMessages());
  }
});

Presentamos la sincronización en segundo plano

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 18 jun 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content

API de Background Synchronization
Interfaces
1. SyncManager
2. SyncEvent
Propiedades
1. ServiceWorkerRegistration.sync
Eventos
1. ServiceWorkerGlobalScope: sync

API de Background Synchronization

In this article

Conceptos y uso

Interfaces

Extensiones a otras interfaces

Ejemplos

Solicitar una sincronización en segundo plano

Verificar una sincronización en segundo plano por etiqueta

Escuchar una sincronización en segundo plano dentro de un Service Worker

Especificaciones

Compatibilidad con navegadores

api.SyncManager

api.ServiceWorkerGlobalScope.sync_event

Véase también

Help improve MDN