Network Information API

par 1 contributeur :

Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

L'API Network Information (Informations réseau) fournit des informations sur la connection de l'appareil : la bande-passante, si la connexion est mesurée ou non. Elle peut être utilisée pour choisir entre du contenu en haute définition ou en basse définition selon la connexion de l'utilisateur. L'API ne représente qu'un seul objet, ajouté au DOM : window.navigator.connection.

Détecter les changements de connexion

Cet exemple permet de connaître les changements liés à la connexion d'un utilisateur. Cela ressemble notamment à la façon dont une application saura si l'utilisateur passe d'une connexion coûteuse à une autre connexion moins chère et pourra réduire la demande de bande passante afin de réduire les coûts pour l'utilisateur.

var connection = navigator.connection || navigator.mozConnection || navigator.webkitConnection;

function updateConnectionStatus() {
  alert("Bande passante de la connexion : " + connection.bandwidth + " MB/s");
  if (connection.metered) {
    alert("La connexion est mesurée !");
  }
}

connection.addEventListener("change", updateConnectionStatus);
updateConnectionStatus();

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple Pas de support 12.0 moz (voir les notes) Pas de support Pas de support Pas de support
Fonctionnalité Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple Pas de support 12.0 moz (voir les notes) Pas de support Pas de support Pas de support

Notes relatives à Gecko

  • L'API Network peut être désactivée en utilisant l'option dom.network.enabled.
  • L'attribut metered vaut false par défaut et peut être réglé avec l'option dom.network.metered (voir bug 716943 pour le marquage de la connexion en connexion mesurée lorsque des données sont en itinérance).
  • À partir de Gecko 12.0, l'API Network est seulement implémentée pour les systèmes Android. Les supports des systèmes Linux (bug 712442) et Windows (bug 721306) sont en cours de progression.
  • Avant Gecko 14.0, navigator.mozConnection n'était pas une instance de EventTarget, la méthode addEventListener() ne pouvait donc pas être appelée. Ceci a été réparé.

Voir aussi

Étiquettes et contributeurs liés au document

Étiquettes : 
Contributeurs à cette page : SphinxKnight
Dernière mise à jour par : SphinxKnight,