Network Information API : guide avec repli
Utilisez les indications réseau facultatives pour choisir des ressources réversibles, avec des limites de normes, de confidentialité et de BotBrowser.
BotBrowser Team
Vous voulez la documentation structurée pour Plateforme ?
Cet article fait partie de la bibliothèque éditoriale. Pour les étapes de configuration, la référence et les mises à jour continues, passez directement à la section docs.
La Network Information API de WICG et MDN décrit navigator.connection comme une indication navigateur facultative et grossière, pas comme un test de débit ni un identifiant. BotBrowser peut configurer des valeurs déclarées telles que RTT et downlink dans un profil, mais ne garantit ni le débit réel de la route ni la disponibilité universelle de l'API. La réponse sûre consiste à rendre d'abord une base complète, vérifier chaque propriété et rendre les changements facultatifs réversibles.
Résumé
- Traitez
effectiveType,rtt,downlinketsaveDatacomme des estimations ou préférences. - Gardez contenu obligatoire, permissions et décisions de compte indépendants de l'API.
- Utilisez des politiques comme
baselineetreduced, mesurez les résultats et prévoyez la récupération. - Expliquez les changements importants, respectez les choix explicites et évitez les valeurs brutes persistantes.
- BotBrowser configure des valeurs rapportées pour les tests, pas le débit physique.
Sommaire
- Ce que fournit l'API
- Règle de décision réversible
- Changements, confidentialité et repli
- Tests et limites de BotBrowser
- Conclusion
Ce que fournit l'API
NetworkInformation peut exposer effectiveType, rtt, downlink, saveData et parfois type. Le premier regroupe les conditions en slow-2g, 2g, 3g et 4g; les deux suivants sont des estimations; saveData exprime une demande de réduire les données. W3C/WICG définit l'interface et MDN documente sa disponibilité. Les valeurs peuvent être arrondies, absentes, anciennes ou modifiées.
Considérez l'API comme une capacité facultative. Si l'objet manque, si une propriété vaut undefined, si le type vaut unknown ou si la valeur est inattendue, le texte, les contrôles et la navigation essentiels restent utilisables. N'inférez ni pays, ni appareil, ni identité, ni débit garanti d'une seule catégorie.
Règle de décision réversible
Commencez par une politique fonctionnant sans indication. Nommez le comportement plutôt qu'un appareil supposé et donnez priorité aux choix explicites.
const connection = navigator.connection;
const reduced = Boolean(
connection && (connection.saveData || connection.effectiveType === 'slow-2g' || connection.effectiveType === '2g')
);
const policy = reduced ? 'reduced' : 'baseline';
// Travail facultatif et réversible uniquement; le contenu essentiel reste.
| Question | Règle | Repli attendu |
|---|---|---|
| Précharger un article facultatif ? | Utiliser temporairement saveData ou un type prudent. | Sauter le préchargement, garder le lien. |
| Lancer un aperçu automatique ? | Combiner politique, préférence de lecture et état. | Afficher une affiche et un bouton de lecture. |
| Livrer un document essentiel ? | Ne jamais le bloquer sur cette API. | Le charger et expliquer les améliorations. |
4g ne garantit pas une grosse transmission, et une valeur absente ne prouve pas la lenteur. Observez la fin, les erreurs de décodage, l'annulation, le délai d'entrée et la récupération de la requête réelle.
Changements, confidentialité et repli
L'objet peut émettre change. Utilisez-le pour suspendre ou annuler une amélioration en attente, jamais pour supprimer un contenu déjà disponible. Appliquez un debounce, limitez les reprises, retirez les écouteurs à la destruction et offrez une reprise claire. Préservez formulaires, espace de mise en page, clavier et états accessibles.
Les indications peuvent renforcer une empreinte avec d'autres signaux. Utilisez-les brièvement et préférez une étiquette comme reduced aux valeurs brutes dans identifiants, journaux durables ou analyses. Une image réduite ou un préchargement différé est un choix de produit, pas une autorisation de collecter davantage. Requêtes, permissions, autorisation et comptes restent indépendants. Pour approfondir ce que révèlent ces indications et comment prévoir un repli sans elles, consultez Network Information API : confidentialité et replis.
Images responsive, chargement différé, backpressure, caches bornés, annulation et HTML de base rendu côté serveur restent utiles sans API. Expliquez un coût notable avant le transfert et laissez demander la pleine résolution.
Tests et limites de BotBrowser
Testez l'absence de navigator.connection, des propriétés partielles, saveData: true et un événement change pendant un transfert facultatif interrompu. Testez aussi unknown. Vérifiez que le texte, le clavier et la récupération restent corrects sans boucle.
BotBrowser prend en charge les politiques de profil pour les valeurs rapportées, notamment RTT et downlink, afin d'examiner la réaction de l'application. Cette capacité change les valeurs visibles dans le contexte de test; la limite est qu'elle ne change pas le débit du proxy, ne mesure pas la route physique, ne garantit pas l'API et ne décide pas du classement d'un site.
Consultez la spécification Network Information, la référence MDN NetworkInformation et la vue d'ensemble MDN. Voir aussi les guides empreinte Network Information et empreinte Client Hints.
Conclusion
Utilisez Network Information comme entrée temporaire d'une politique réversible. Gardez une base complète, respectez l'intention, mesurez la requête réelle et conservez le minimum d'éléments. Exécutez ensuite l'exemple sans API avant d'activer l'amélioration adaptative.
FAQ
downlink est-il un test de vitesse ?
Non. C'est une estimation arrondie, périssable et influencée par d'autres trafics. Le résultat de la requête est plus pertinent.
Quelle est la prochaine action sûre ?
Ajoutez la détection de capacité, une fixture de base et une reprise bornée. Faites valider la politique par les responsables accessibilité et confidentialité avant de mesurer.
Comment récupérer une amélioration annulée ?
Conservez la base et affichez une reprise unique. Ne rechargez pas toute la page à chaque changement d'estimation.
Comment traiter le cache ?
Utilisez une variante produit explicite, jamais une empreinte réseau détaillée comme clé. Prévoyez une réponse complète sans indication.
Quand revoir la politique ?
Après un changement de navigateur, de médias ou de charge. Rejouez les tests d'API absente, propriétés partielles, unknown, saveData et transfert interrompu.
L'absence d'API impose-t-elle un contenu réduit ?
Non. C'est un état inconnu. Gardez la base et réduisez seulement un travail facultatif, expliqué et réversible.
BotBrowser garantit-il une route lente ou rapide ?
Non. Il configure des valeurs rapportées pour les tests, pas le débit physique, le proxy, la disponibilité universelle ou la réponse du site.
Que faut-il journaliser ?
La politique, la version, la fin, l'annulation et la récupération. Évitez les valeurs brutes et supprimez les diagnostics temporaires.
Sources
Cet article fait partie du guide : Surfaces de la plateforme web : carte de revue
Articles Connexes
Network Information API : confidentialité et replis
EmpreinteFingerprinting de la Network Information API : revue de politique
PlateformeCompute Pressure API : charges adaptatives et vie privée
EmpreinteDevice Memory API et performances web : indication mémoire
Plateformenavigator.languages et localisation : choisir la bonne locale
PlateformePréférences des media queries : respecter les choix des utilisateurs
Exécutez la même vérification dans BotBrowser
Chargez un profil, gardez dans le navigateur les signaux que vous venez de lire, puis confirmez le résultat sur votre propre machine avant le déploiement.