Volver al Centro de conocimiento
Plataforma

Network Information API para contenido adaptable: guía con respaldo

Usa indicios de red opcionales para elegir recursos reversibles, con límites de estándares, privacidad y BotBrowser.

BotBrowser Team

Documentación

Quieres la documentación estructurada de Plataforma?

Este artículo forma parte de la biblioteca editorial. Para pasos de configuración, material de referencia y actualizaciones continuas, entra en la sección de docs.

La API Network Information de WICG y MDN describen navigator.connection como un indicio opcional y aproximado del navegador, no como una prueba de ancho de banda ni una señal de identidad. BotBrowser puede configurar valores declarados de red, como RTT y downlink, en un perfil, pero no garantiza el caudal real de la ruta ni la disponibilidad universal de la API. La respuesta segura es mostrar primero una base completa, detectar cada propiedad y hacer reversibles los cambios opcionales.

Resumen

  • Trata effectiveType, rtt, downlink y saveData como estimaciones o preferencias.
  • Mantén contenido obligatorio, permisos y decisiones de cuenta independientes de la API.
  • Usa políticas pequeñas como baseline y reduced, mide resultados y ofrece recuperación.
  • Explica cambios importantes, respeta elecciones explícitas y evita conservar valores crudos.
  • BotBrowser configura valores reportados para pruebas; no simula el caudal físico.

Contenido

Flujo con respaldo para usar indicios de red al elegir contenido adaptable

Qué expone la API

NetworkInformation puede exponer effectiveType, rtt, downlink, saveData y, en algunas implementaciones, type. El primero agrupa condiciones observadas como slow-2g, 2g, 3g y 4g; los dos siguientes son estimaciones; saveData expresa una petición de reducir datos. W3C/WICG define la interfaz y MDN documenta su disponibilidad. Los valores pueden estar redondeados, ser antiguos, faltar o cambiar.

Usa la API como capacidad opcional. Si falta el objeto, una propiedad es undefined, el tipo es unknown o el valor es inesperado, el texto, los controles y la navegación obligatorios deben seguir funcionando. No deduzcas país, dispositivo, identidad ni rendimiento garantizado de un solo grupo.

Regla de decisión reversible

Empieza con una política que funcione sin indicios. Usa nombres de comportamiento, no etiquetas de dispositivo, y da prioridad a elecciones explícitas.

const connection = navigator.connection;
const reduced = Boolean(
  connection && (connection.saveData || connection.effectiveType === 'slow-2g' || connection.effectiveType === '2g')
);
const policy = reduced ? 'reduced' : 'baseline';
// Solo trabajo opcional y reversible; el contenido obligatorio se muestra.
PreguntaReglaRespaldo esperado
¿Precargar un artículo opcional?Usa temporalmente saveData o un tipo conservador.Omite la precarga y conserva el enlace.
¿Iniciar una vista previa automática?Combina la política con preferencia de reproducción y estado.Muestra póster y control de reproducción.
¿Entregar un documento obligatorio?Nunca lo bloquees por esta API.Cárgalo y explica mejoras opcionales.

4g no garantiza que una transferencia grande termine, y la ausencia de un valor no demuestra lentitud. Observa finalización, errores de decodificación, cancelación, latencia de entrada y recuperación de la petición real.

Cambios, privacidad y respaldo

El objeto puede emitir change. Úsalo para pausar o cancelar mejoras pendientes, no para quitar contenido disponible. Aplica debounce, limita reintentos, elimina listeners al desmontar y ofrece un reintento claro. Conserva formularios, espacio de diseño, teclado y estados accesibles mientras un recurso espera.

Los indicios pueden aumentar una huella al combinarse con otras señales. Úsalos de forma efímera y prefiere una etiqueta como reduced frente a valores crudos en identificadores, registros duraderos o analítica. Una imagen menor o una precarga aplazada es una decisión de producto, no permiso para recopilar más datos. Las peticiones, permisos, autorizaciones y cuentas obligatorias son independientes. Para profundizar en lo que revelan estos indicios y cómo usar una alternativa sin ellos, consulta Network Information API: indicios, privacidad y alternativas.

Imágenes responsive, carga diferida, backpressure, cachés acotadas, cancelación y HTML base renderizado en servidor siguen siendo útiles sin la API. Explica un coste importante antes de iniciar la transferencia y permite pedir resolución completa.

Pruebas y límites de BotBrowser

Prueba ausencia de navigator.connection, propiedades parciales, saveData: true y un evento change durante una transferencia opcional interrumpida. Prueba también unknown. Verifica comportamiento: texto legible, controles de teclado y recuperación sin bucle infinito.

BotBrowser admite políticas de perfil para valores reportados, incluidos RTT y downlink, para revisar cómo responde la aplicación. Cambia valores observados en el contexto de prueba; no cambia el caudal del proxy, mide la ruta física, garantiza disponibilidad de API ni decide la clasificación de un sitio.

Consulta la especificación Network Information, la referencia NetworkInformation de MDN y la visión general de MDN. Lee también las guías de huella Network Information y huella Client Hints.

Conclusión

Usa Network Information como entrada temporal para una política reversible. Conserva una base completa, respeta la intención, mide la petición real y retén solo la evidencia mínima. El siguiente paso es ejecutar el ejemplo con la API ausente antes de activar mejoras adaptables.

Preguntas frecuentes

No. Es una estimación que puede redondearse, quedar obsoleta o verse afectada por otro tráfico. El resultado de la petición real es mejor evidencia.

¿Cuál es la siguiente acción segura?

Añade detección de características, una prueba de base y un reintento acotado. Obtén revisión de accesibilidad y privacidad antes de medir.

¿Cómo se recupera una mejora cancelada?

Conserva el contenido base y muestra un control de reintento único. No reinicies toda la página ni repitas la descarga por cada cambio de estimación.

¿Cómo debe tratarse el caché?

Usa variantes explícitas de producto y no una huella detallada de red como clave. Mantén una respuesta completa cuando no llegue ningún indicio.

¿Cuándo se revisa la política?

Después de cambiar navegador, conjunto de medios o carga. Repite las pruebas de API ausente, propiedades parciales, unknown, saveData y transferencia interrumpida.

¿La API ausente obliga a reducir contenido?

No. Es un estado desconocido. Conserva la base y reduce solo trabajo opcional explicado y reversible.

¿BotBrowser garantiza una ruta lenta o rápida?

No. Configura valores reportados para pruebas, no el caudal físico, el proxy, la disponibilidad universal o la respuesta del sitio.

¿Qué se debe registrar?

Política, versión de carga, finalización, cancelación y recuperación. Evita valores crudos y elimina diagnósticos temporales.

Fuentes

#Network Information API#Contenido Adaptable#effectiveType#Rendimiento Web#Privacidad

Este artículo forma parte de la guía: Superficies de la plataforma web: mapa de revisión

Ejecuta la misma comprobación en BotBrowser

Carga un perfil, mantén dentro del navegador las señales que acabas de leer y confirma el resultado en tu propia máquina antes del despliegue.