Clase 05 · Módulo 06
Qué pasa cuando no hay conexión
Qué pasa cuando no hay conexión
Qué logras en esta clase
Tu app deja de quedarse en blanco sin señal: muestra lo último que supo y le dice al usuario qué está pasando.
- Detectas el estado de la red y conoces sus trampas.
- Guardas la caché de consultas para verla sin conexión.
- Diseñas qué ve el usuario en cada situación.
02
Sin señal es lo normal
Un teléfono pierde conexión todos los días: en el metro, en un ascensor, en un estacionamiento subterráneo, en un cerro, con el wifi saturado de un café.
Y hay un caso peor que no tener red: tenerla tan lenta que nada termina de cargar.
Si tu app solo fue probada con el wifi de tu casa, no sabes cómo se comporta en la mitad de los lugares donde se va a usar.
03
Cómo se ve desde afuera
Una app que se queda en blanco sin señal parece rota, aunque no lo esté.
04
Tres niveles de trabajo sin conexión
| Nivel | Qué hace | Cuándo |
|---|---|---|
| 1 | Muestra lo último conocido | Casi siempre vale la pena |
| 2 | Guarda cambios simples y los envía después | Si escribir sin señal es frecuente |
| 3 | Sincroniza todo y resuelve conflictos | Si la app se usa sin señal por diseño |
Esta clase cubre el nivel 1. Los niveles 2 y 3 son la clase 6.
05
Detectar la red: dos librerías
expo-network | NetInfo | |
|---|---|---|
| Origen | Expo | Comunidad de React Native |
| Paquete | expo-network | @react-native-community/netinfo |
| Uso en pantalla | Hook useNetworkState | Hook y suscripción propios |
Las dos sirven, y la documentación de TanStack Query muestra cómo conectar cualquiera. Elige una sola. Se instalan con npx expo install.
06
Leer la red en una pantalla
const red = useNetworkState()
const sinRed = red.isConnected === falseEl hook de expo-network entrega el estado actual y se actualiza solo cuando cambia. Sus campos pueden venir sin valor al arrancar, antes de la primera lectura.
07
Conectado no significa con internet
isConnected dice que hay una red activa, no que internet responda. El wifi de un hotel que exige iniciar sesión cuenta como conectado.
Existe isInternetReachable, pensado para eso, con una limitación documentada: en iOS siempre vale lo mismo que isConnected.
08
La única prueba real
La única prueba real de que hay internet es que un pedido a tu servidor responda.
09
Avisarle a TanStack Query
En la clase 3 quedó pendiente un cable: el de la red. Se conecta una vez al arrancar, pasándole a onlineManager el estado que entrega la librería elegida.
Con eso, la app no gasta reintentos cuando no hay red y recarga sola al recuperarla, sin que el usuario tenga que tirar la lista.
10
Pausado no es lo mismo que cargando
Una consulta tiene dos estados distintos: si tiene datos (status) y qué está haciendo (fetchStatus). Sin red, una consulta nueva queda sin datos y en pausa.
11
Tres modos de red
La opción networkMode define qué hace una consulta sin conexión:
| Modo | Comportamiento | Para qué |
|---|---|---|
online | No pide sin red; pausa y reanuda | Datos del servidor. Es el modo por defecto |
always | Pide siempre | Funciones que no usan red, como leer SQLite |
offlineFirst | Intenta una vez y luego pausa | Casos con caché intermedia |
Para una app con Supabase, el modo por defecto es el correcto.
12
Mostrar lo último conocido
La caché de TanStack Query vive en memoria: al cerrar la app se pierde. Para verla sin conexión al día siguiente, se guarda en disco con el complemento de persistencia.
PersistQueryClientProviderreemplaza al proveedor normal en el layout raíz.- Un «persister» dice dónde guardar; para AsyncStorage existe
createAsyncStoragePersister.
Al abrir, la caché se restaura y las pantallas dibujan con ella. Los pedidos esperan a que termine la restauración.
13
Dos tiempos que deben calzar
| Opción | Qué controla | Por defecto |
|---|---|---|
maxAge | Antigüedad máxima de la caché guardada | 24 horas |
gcTime | Cuánto vive en memoria una copia sin uso | 5 minutos |
Si gcTime es menor que maxAge, las copias se descartan antes de tiempo y la caché restaurada llega vacía. La documentación pide que gcTime sea igual o mayor.
14
El dato viejo necesita fecha
Dato viejo con fecha es útil. Dato viejo sin fecha es una trampa.
15
Qué decirle al usuario
- Un aviso discreto y fijo mientras dure: «Sin conexión».
- La antigüedad de lo que ve: «Actualizado hace 2 horas».
- Los botones que necesitan red, desactivados y con el motivo a la vista.
- Al volver la señal, el aviso desaparece solo.
Evita la ventana emergente que bloquea la pantalla: el usuario no puede arreglar la red, y lo que sí puede hacer es seguir leyendo.
16
Qué mostrar en cada situación
| Situación | Qué mostrar |
|---|---|
| Sin red, con copia guardada | La copia, su antigüedad y el aviso |
| Sin red, sin copia | Mensaje claro y botón para reintentar |
| Vuelve la red | Recarga automática, sin interrumpir |
| Con red, el servidor falla | Error distinto: «Tuvimos un problema» |
La segunda fila es la que más se olvida: la pantalla que el usuario nunca había abierto antes de perder la señal.
17
Sin red no es lo mismo que falla del servidor
Para el usuario la diferencia importa: si no hay señal, puede moverse o esperar; si falló el servidor, no depende de él.
- Sin red: «Sin conexión. Te mostramos lo último guardado.»
- Falla del servidor: «No pudimos cargar esto. Intenta de nuevo en un momento.»
Culpar a la conexión del usuario cuando el problema es tuyo le hace perder tiempo y confianza.
18
Qué no debe quedar guardado
La caché persistida en AsyncStorage no está cifrada (clase 4).
- Las consultas con datos sensibles se dejan fuera de la persistencia.
- Al cerrar sesión se vacían la caché en memoria y la guardada en disco.
19
Las imágenes también cuentan
Una lista restaurada desde la caché con todas sus fotos en gris se ve a medio funcionar.
expo-image (módulo 5) guarda en el teléfono las imágenes que ya descargó, así que las que el usuario vio antes pueden aparecer sin red.
Las que nunca se cargaron no estarán. Define una imagen de reemplazo para ese caso, en vez de dejar un espacio vacío.
20
Cómo probarlo de verdad
- En un teléfono real, usa la app con conexión y recorre las pantallas principales.
- Activa el modo avión y cierra la app por completo.
- Ábrela: ¿ves contenido y el aviso?
- Entra a una pantalla que no habías visitado.
- Intenta una acción que necesita red.
- Quita el modo avión: ¿se actualiza sola?
Repite con una red muy lenta, que es donde aparecen los indicadores eternos.
21
Lo bueno y lo malo del nivel 1
- A favor: poco trabajo sobre lo que ya tienes con TanStack Query, y la app abre al instante porque dibuja desde la copia.
- En contra: el usuario puede ver datos viejos; hay más estados que diseñar por pantalla; hay algo más que limpiar al cerrar sesión.
- No alcanza: si el usuario necesita registrar cosas sin señal. Eso es la clase siguiente.
22
Lo que te llevas
- Sin señal es una situación normal y se diseña como cualquier otra.
- «Conectado» no garantiza internet; la prueba es que el servidor responda.
onlineManagerpausa y reanuda las consultas según la red.- Persistir la caché permite mostrar lo último conocido, siempre con su antigüedad.
- Sin red, sin copia y con falla del servidor son tres mensajes distintos.
23
Hazlo ahora
En 15 minutos, sobre la pantalla que hiciste en la clase 3:
- Pídele a Claude Code que conecte la red a
onlineManagery que persista la caché. - Pide un aviso «Sin conexión» y el texto «Actualizado hace…».
- Ejecuta los seis pasos de la lámina «Cómo probarlo de verdad».
- Anota qué pantalla se vio peor y qué le faltó.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026