NavigatorLanguage contient les méthodes et les propriétés de la langue du navigateur.
Il n'y a pas d'objet de type NavigatorLanguage, mais d'autres interfaces comme {{domxref("Navigator")}} ou {{domxref("WorkerNavigator")}} l'implémentent.
L'interface NavigatorLanguage n'hérite d'aucune propriété.
null est retournée quand la langue est inconnue.L'interface NavigatorLanguage n'implémente et n'hérite d'aucune méthode.
| Spécifications | -Status | -Commentaire | -
|---|---|---|
| {{SpecName('HTML WHATWG', '#navigatorlanguage', 'NavigatorLanguage')}} | -{{Spec2('HTML WHATWG')}} | -Depuis la snapshot {{SpecName('HTML5 W3C')}}, la propriété languages a été ajoutée. |
-
| {{SpecName('HTML5 W3C', '#navigatorlanguage', 'NavigatorLanguage')}} | -{{Spec2('HTML5 W3C')}} | -Spécification initiale; snapshot de la version anticipé {{SpecName('HTML WHATWG')}}. | -
{{Compat("api.NavigatorLanguage")}}
- -La propriété en lecture seule NavigatorLanguage.language fournit une chaîne de caractère indiquant la langue préférée de l'utilisateur, généralement la langue de l'interface du navigateur.
const lang = navigator.language -- -
La constante lang contient une chaîne de caractère indiquant la langue défini dans BCP 47, par exemple "en", "en-US", "fr", "fr-FR", "es-ES", etc.
Notons que dans Safari sur iOS avant la version 10.2, le code du pays était en minuscule, par exemple: "en-us", "fr-fr" etc.
- -if (/^en\b/.test(navigator.language)) {
- doLangSelect(window.navigator.language);
-}
-
-
-| Spécifications | -Status | -Commentaire | -
|---|---|---|
| {{SpecName('HTML WHATWG', '#dom-navigator-language', 'NavigatorLanguage: language')}} | -{{Spec2('HTML WHATWG')}} | -Définition initiale | -
{{Compat("api.NavigatorLanguage.language")}}
- -{{APIRef("HTML DOM")}}{{SeeCompatTable}}
- -La propriété en lecture seule NavigatorLanguage.languages retourne un tableau de {{domxref("DOMString")}} représentant les langues préférées de l'utilisateur. Les étiquettes de langue utilisent les étiquettes de langages défini par BCP 47. Le tableau retourné est trié par ordre de préférence décroissante (la langue préférée en premier).
La valeur de {{domxref("NavigatorLanguage.language","navigator.language")}} est le premier élément du tableau retourné.
- -Quant la valeur change, notamment lorsque l'utilisateur modifie ses préférences de langues, un événement {{event("languagechange")}} est déclenché sur l'objet {{domxref("Window")}}.
- -L'entête HTTP Accept-Language présent dans chaque requête HTTP issu de la navigation de l'utilisateur contient les mêmes valeurs que navigator.languages, avec en plus un champ qvalues (valeur de qualité), par exemple: en-US;q=0.8.
preferredLanguages = globalObj.navigator.languages -- -
navigator.language //"en-US" -navigator.languages //["en-US", "zh-CN", "ja-JP"] -- -
| Spécifications | -Status | -Commentaire | -
|---|---|---|
| {{SpecName('HTML WHATWG', '#dom-navigator-languages', 'NavigatorLanguage: languages')}} | -{{Spec2('HTML WHATWG')}} | -Définition initiale | -
{{Compat("api.NavigatorLanguage.languages")}}
- -{{APIRef("HTML DOM")}}
- -L'interface NavigatorOnLine contient les méthodes et les propriétés concernant l'état de connexion du navigateur.
Il n'y a pas d'objet de type NavigatorOnLine, mais d'autres interfaces l'implémentent comme {{domxref("Navigator")}} ou {{domxref("WorkerNavigator")}}.
L'interface NavigatorOnLine n'hérite d'aucune propriété.
The NavigatorOnLine interface neither implements, nor inherit any method.
| Spécifications | -Status | -Commentaire | -
|---|---|---|
| {{SpecName('HTML WHATWG', '#navigatoronline', 'NavigatorOnLine')}} | -{{Spec2('HTML WHATWG')}} | -Pas de changement depuis la dernière version, {{SpecName('HTML5 W3C')}} | -
| {{SpecName('HTML5 W3C', '#navigatoronline', 'NavigatorOnLine')}} | -{{Spec2('HTML5 W3C')}} | -Version apportant la définition initiale: {{SpecName('HTML WHATWG')}} | -
{{Compat("api.NavigatorOnLine")}}
- -Renvoie l'état en ligne du navigateur. La propriété renvoie une valeur {{domxref ("Boolean", "Booléenne")}}, avec true signifiant en ligne et false signifiant hors ligne. La propriété envoie des mises à jour chaque fois que la capacité du navigateur à se connecter au réseau change. La mise à jour se produit lorsque l'utilisateur suit des liens ou lorsqu'un script demande une page distante. Par exemple, la propriété doit renvoyer false lorsque les utilisateurs cliquent sur des liens peu de temps après avoir perdu la connexion Internet.
Les navigateurs implémentent cette propriété différemment.
- -Dans Chrome et Safari, si le navigateur ne parvient pas à se connecter à un réseau local (LAN) ou à un routeur, il est hors ligne; toutes les autres conditions renvoient true. Ainsi, bien que vous puissiez supposer que le navigateur est hors ligne lorsqu'il renvoie une valeur false, vous ne pouvez pas supposer qu'une valeur vraie signifie nécessairement que le navigateur peut accéder à Internet. Vous pourriez obtenir de faux positifs, par exemple dans les cas où l'ordinateur exécute un logiciel de virtualisation doté d'adaptateurs Ethernet virtuels toujours «connectés». Par conséquent, si vous souhaitez vraiment déterminer l'état en ligne du navigateur, vous devez développer des moyens supplémentaires de vérification. Pour en savoir plus, consultez l'article HTML5 Rocks, Working Off the Grid.
Dans Firefox et Internet Explorer, le passage du navigateur en mode hors ligne envoie la valeur false. Jusqu'à Firefox 41, toutes les autres conditions renvoient une valeur vraie; tester le comportement réel sur Nightly 68 sous Windows montre qu'il ne recherche que la connexion LAN comme Chrome et Safari donnant de faux positifs.
Vous pouvez voir les changements dans l'état du réseau en écoutant les événements sur {{domxref ("Document/ononline", "window.ononline")}} et {{domxref ("Document/onoffline", "window.onoffline")}}.
- -window.navigator.onLine -- -
online est un {{domxref ("Boolean", "Booléen")}} true ou false.
Voir un exemple en direct.
- -Pour vérifier si vous êtes en ligne, interrogez window.navigator.onLine, comme dans l'exemple suivant:
console.log(navigator.onLine ? 'online' : 'offline') -- -
Si le navigateur ne prend pas en charge navigator.onLine, l'exemple ci-dessus apparaîtra toujours comme false / undefined.
Pour voir les modifications de l'état du réseau, utilisez addEventListener pour écouter les événements sur {{domxref ("Window/offline_event", "window.online")}} et {{domxref ("Window/offline_event", "window.offline")}}, comme dans l'exemple suivant:
- -window.addEventListener('offline', function(e) { ... })
-window.addEventListener('offline', (e) => { ... })
-
-window.addEventListener('online', function(e) { ... })
-window.addEventListener('online', (e) => { ... })
-
-
-| Spécification | -État | -Commentaire | -
|---|---|---|
| {{SpecName("HTML WHATWG", "browsers.html#dom-navigator-online", "navigator.onLine")}} | -{{Spec2("HTML WHATWG")}} | -Définition initiale | -
{{Compat("api.NavigatorOnLine.onLine")}}
- -Voir Événements en ligne / hors ligne pour une description plus détaillée de cette propriété ainsi que des nouvelles fonctionnalités hors ligne introduites dans Firefox 3.
- -Firefox 3 implémente les évènements online et offline de la spécification Web Applications 1.0 du WHATWG.
Afin de construire une bonne application Web capable de fonctionner hors ligne, il est nécessaire de savoir quand votre application est hors ligne. De même, vous devrez également savoir quand votre application est de nouveau en ligne. Concrètement, ce qui est nécessaire se résume à :
- -C'est ce processus que les évènements online et offline rendent presque trivial.
Votre application web peut également vouloir indiquer que certains documents doivent être maintenus dans le cache des ressources hors ligne. Pour en savoir plus sur la manière de préciser cette indication, consultez l'article Ressources hors ligne dans Firefox.
- -navigator.onLinenavigator.onLine est une propriété qui maintient une valeur true/false (true pour online, false pour offline). Cette propriété est mise à jour chaque fois que l'utilisateur passe en mode « Hors ligne » en sélectionnant l'entrée de menu correspondante (Fichier → Travailler hors connexion dans Firefox).
De plus, cette propriété doit être mise à jour dès que le navigateur n'arrive plus à se connecter au réseau. D'après la spécification :
- -L'attribut- -navigator.onLinedoit renvoyerfalsesi l'agent utilisateur ne va pas contacter le réseau lorsque l'utilisateur suit un lien ou lorsqu'un script demande une page distante (ou sait qu'une telle tentative échouerait)…
Firefox 2 met à jour cette propriété lors du passage en mode hors connexion du navigateur, et lors de la perte ou de la récupération de la connectivité réseau sous Windows et Linux.
- -Cette propriété existait dans de versions plus anciennes de Firefox et Internet Explorer (la spécification se base sur ces implémentations précédentes), vous pouvez donc immédiatement commencer à l'utiliser. La détection de l'état du réseau a été ajoutée dans Firefox 2.
- -online » et « offline »Firefox 3 introduit deux nouveaux évènements : « online » et « offline ». Ces deux évènements sont déclenchés sur l'élément <body> de chaque page lorsque le navigateur passe d'un mode à l'autre. De plus, les évènements se propagent depuis document.body, vers document, puis vers window. Aucun de ces deux évènements n'est annulable (il n'est pas possible d'empêcher l'utilisateur de passer en ligne ou hors ligne).
Vous pouvez ajouter des gestionnaires pour ces évènements selon les manières habituelles :
- -addEventListener sur window, document ou document.body.ononline ou .onoffline sur document ou document.body vers un objet JavaScript Function. (Note : l'utilisation de window.ononline ou window.onoffline ne fonctionnera pas, pour des raisons de compatibilité.)ononline="…" ou onoffline="…" à la balise <body> dans le balisage HTML.Un cas de test simple peut être exécuté pour vérifier que les évènements fonctionnent. XXX When mochitests for this are created, point to those instead and update this example -nickolay
- - <!doctype html>
- <html>
- <head>
- <script>
- function updateOnlineStatus(msg) {
- var status = document.getElementById("status");
- var condition = navigator.onLine ? "ONLINE" : "OFFLINE";
- status.setAttribute("class", condition);
- var state = document.getElementById("state");
- state.innerHTML = condition;
- var log = document.getElementById("log");
- log.appendChild(document.createTextNode("Évènement : " + msg + " ; état=" + condition + "\n"));
- }
- function loaded() {
- updateOnlineStatus("load");
- document.body.addEventListener("offline", function () {
- updateOnlineStatus("offline")
- }, false);
- document.body.addEventListener("online", function () {
- updateOnlineStatus("online")
- }, false);
- }
- </script>
- <style>...</style>
- </head>
- <body onload="loaded()">
- <div id="status"><p id="state"></p></div>
- <div id="log"></div>
- </body>
- </html>
-
-
-online et offline (en anglais){{ languages( { "en": "en/Online_and_offline_events", "es": "es/Eventos_online_y_offline", "ja": "ja/Online_and_offline_events", "pl": "pl/Zdarzenia_online_i_offline", "pt": "pt/Eventos_online_e_offline" } ) }}
diff --git a/files/fr/orphaned/web/api/navigatorstorage/index.html b/files/fr/orphaned/web/api/navigatorstorage/index.html deleted file mode 100644 index bc0ef8ba9279fd..00000000000000 --- a/files/fr/orphaned/web/api/navigatorstorage/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: NavigatorStorage -slug: orphaned/Web/API/NavigatorStorage -tags: - - API - - Interface - - Mixin - - Navigator - - NavigatorStorage - - NeedsTranslation - - Reference - - Secure context - - Storage - - Storage Standard - - TopicStub - - WorkerNavigator -translation_of: Web/API/NavigatorStorage -original_slug: Web/API/NavigatorStorage ---- -{{securecontext_header}}{{APIRef("Storage")}}
- -The NavigatorStorage {{Glossary("mixin")}} adds to the {{domxref("Navigator")}} and {{domxref("WorkerNavigator")}} interfaces the {{domxref("Navigator.storage")}} property, which provides access to the {{domxref("StorageManager")}} singleton used for controlling the persistence of data stores as well as obtaining information
{{AvailableInWorkers}}
- -There are many APIs which provide ways for Web content to store data on a user's computer, including {{Glossary("cookies")}}, the Web Storage API ({{domxref("Window.localStorage")}} and {{domxref("Window.sessionStorage")}}), and IndexedDB. The Storage Standard is designed to serve as a common basis for the implementation of all of those APIs and storage technologies, so that their constraints and configurations can be understood and controlled using a common set of methods and properties.
- -The NavigatorStorage mixin has no methods.
| Specification | -Status | -Comment | -
|---|---|---|
| {{SpecName('Storage')}} | -{{Spec2('Storage')}} | -Initial definition. | -
{{Compat("api.NavigatorStorage")}}
- -{{securecontext_header}}{{APIRef("Storage")}}
- -La propriété en lecture seule NavigatorStorage.storage renvoie le singleton {{domxref("StorageManager")}} utilisé pour accéder aux capacités globales de stockage du navigateur pour le site actuel ou l’application actuelle. L’objet renvoyé permet d’examiner et de configurer la persistance des stockages de données, et savoir approximativement combien d’espace est encore disponible dans le navigateur pour utiliser le stockage local.
var storageManager = navigator.storage; -- -
Un objet {{domxref("StorageManager")}} permettant de maintenir la persistance des données stockées, et de déterminer grossièrement combien d’espace est disponible pour stocker des données.
- -| Spécification | -Statut | -Commentaire | -
|---|---|---|
| {{SpecName('Storage', '#navigatorstorage', 'navigator.storage')}} | -{{Spec2('Storage')}} | -Définition initiale. | -
{{Compat("api.NavigatorStorage.storage")}}
- -La méthode Node.getUserData()renvoie tout {{domxref("DOMUserData")}} d'utilisateur défini précédemment sur le noeud donné par {{domxref("Node.setUserData()")}}.
Les méthodes Node.setUserData et {{domxref("Node.getUserData")}} ne sont plus disponibles pour le contenu à partir du web. {{domxref("Element.dataset")}} ou WeakMap peuvent être utilisés à la place.
userData = someNode.getUserData(userKey);- -
userKey est la clé pour choisir les données spécifiques recherchées pour le nœud donné. Plus d'une clé peuvent avoir été assignées sur un nœud donné, contenant leurs propres valeurs.var d = document.setUserData('key', 15, null);
-console.log(document.getUserData('key')); // 15
-
-| Spécification | -Statut | -Commentaire | -
|---|---|---|
| {{SpecName('DOM WHATWG', '#interface-node', 'Node')}} | -{{Spec2('DOM WHATWG')}} | -Supprimée de la spécification. | -
| {{SpecName('DOM3 Core', 'core.html#Node3-getUserData', 'Node.getUserData()')}} | -{{Spec2('DOM3 Core')}} | -Définition initiale. | -
{{Compat("api.Node.getUserData")}}
- -La méthode Node.setUserData() permet à un utilisateur de joindre (ou supprimer) des données à un élément, sans avoir besoin de modifier le DOM. Notez que ces données ne seront pas conservées lors de l'importation via {{domxref("Node.importNode")}}, comme avec les opérations {{domxref("Node.cloneNode()")}} et {{domxref("Node.renameNode()")}} (bien que {{domxref("Node.adoptNode")}} conserve l'information), et les tests d'égalité dans {{domxref("Node.isEqualNode()")}} ne prennent pas en compte les données de l'utilisateur lors de l'évaluation.
Cette méthode offre l'avantage d'associer des données à des noeuds spécifiques sans nécessiter de modification de la structure du document et de façon standard, mais cela signifie aussi que des étapes supplémentaires peuvent être nécessaires si l'on souhaite sérialiser l'information ou l'inclure sur un clone, importer ou renommer des opérations.
- -Les méthodes Node.getUserData et {{domxref("Node.setUserData")}} ne sont plus disponibles depuis le contenu Web. {{domxref("HTMLElement.dataset")}} ou WeakMap peuvent être utilisées à la place.
var prevUserData = someNode.setUserData(userKey, userData, handler);- -
userKey est utilisé comme une clé par laquelle on peut ensuite obtenir les données stockées. Plus d'une clé peuvent être définies pour un nœud donné.handler est un rappel qui sera appelé à chaque fois que le noeud est cloné, importé, renommé, supprimé ou adopté ; une fonction peut être utilisée ou un objet mettant en œuvre la méthode handle (partie de l'interface {{domxref("UserDataHandler")}}). Le gestionnaire recevra 5 arguments : un entier (integer) représentant le type d'opération (tel que 1 pour indiquer une opération de clonage), la clé utilisateur, les données sur le noeud, le noeud source (null s'il a été supprimé), le noeud de destination (le nouveau noeud créé ou null si aucun). Si aucun gestionnaire n'est souhaité, il faut spécifier null.userData est l'objet à associer à userKey sur someNode. Si null, tout objet précédemment enregistré et l'UserDataHandler associé à userKey sur ce noeud seront supprimés.var d = document.implementation.createDocument('', 'test', null);
-d.documentElement.setUserData('key', 15, {handle:function (o, k, d, s, ds) {console.log(o+'::'+k+'::'+d+'::'+s+'::'+ds)}}); // 2::key::15::[object Element]::[object Element]
-console.log(d.documentElement.getUserData('key')); // 15
-var e = document.importNode(d.documentElement, true); // provoque l'appel du gestionnaire
-console.log(e.getUserData('key')); // null puisque les données utilisateur ne sont pas copiées.
-
-
-| Spécification | -Statut | -Commentaire | -
|---|---|---|
| {{SpecName('DOM WHATWG', '#interface-node', 'Node')}} | -{{Spec2('DOM WHATWG')}} | -Supprimé de la spécification. | -
| {{SpecName('DOM3 Core', 'core.html#Node3-setUserData', 'Node.setUserData()')}} | -{{Spec2('DOM3 Core')}} | -Définition initiale. | -
{{Compat("api.Node.setUserData")}}
- -Représente une notation DTD (définition de type de document) en lecture seule. Peut déclarer le format d'une entité non analysée ou déclarer formellement les cibles d'instruction de traitement du document. Hérite des méthodes et des propriétés de Node. Son nodeName est le nom de la notation. N'a pas de parent.
| Spécification | -Statut | -Commentaire | -
|---|---|---|
| {{SpecName("DOM3 Core", "core.html#ID-5431D1B9", "Notation")}} | -{{Spec2("DOM3 Core")}} | -Pas de changement. | -
| {{SpecName("DOM2 Core", "core.html#ID-5431D1B9", "Notation")}} | -{{Spec2("DOM2 Core")}} | -Pas de changement. | -
| {{SpecName('DOM1', 'level-one-core.html#ID-5431D1B9', 'Notation')}} | -{{Spec2('DOM1')}} | -Définition initiale. | -
{{Compat("api.Notation")}}
diff --git a/files/fr/web/api/navigator/language/index.md b/files/fr/web/api/navigator/language/index.md new file mode 100644 index 00000000000000..38a86f2f3a5a36 --- /dev/null +++ b/files/fr/web/api/navigator/language/index.md @@ -0,0 +1,36 @@ +--- +title: Navigator.language +slug: Web/API/Navigator/language +translation_of: Web/API/Navigator/language +browser-compat: api.Navigator.language +--- +{{APIRef("HTML DOM")}} + +La propriété en lecture seule **`Navigator.language`** renvoie une chaîne de caractères qui représente la langue préférée de l'utilisatrice ou de l'utilisateur. Il s'agit généralement de la langue utilisée pour l'interface utilisateur du navigateur. + +## Valeur + +Une chaîne de caractères [`DOMString`](/fr/docs/Web/API/DOMString). Le format de cette chaîne de caractères est défini par [la RFC 5646, aussi connu sous le nom de balise BCP 47](https://datatracker.ietf.org/doc/html/rfc5646). Voici quelques exemples de codes de langue valides : `"en"`, `"en-US"`, `"fr"`, `"fr-FR"`, `"es-ES"`, etc. + +On notera que Safari pour iOS, avant la version 10.2, renvoyait le code du pays en minuscules : `"en-us"`, `"fr-fr"`, etc. + +## Exemples + +```js +if (/^en\b/.test(navigator.language)) { + choisirLangue(window.navigator.language); +} +``` + +## Spécifications + +{{Specifications}} + +## Compatibilité des navigateurs + +{{Compat}} + +## Voir aussi + +- [`navigator.languages`](/fr/docs/Web/API/Navigator/languages) +- [`navigator`](/fr/docs/Web/API/Navigator) diff --git a/files/fr/web/api/navigator/languages/index.md b/files/fr/web/api/navigator/languages/index.md new file mode 100644 index 00000000000000..08ad0a2645e280 --- /dev/null +++ b/files/fr/web/api/navigator/languages/index.md @@ -0,0 +1,39 @@ +--- +title: Navigator.languages +slug: Web/API/Navigator/languages +browser-compat: api.Navigator.languages +--- +{{APIRef("HTML DOM")}}{{SeeCompatTable}} + +La propriété en lecture seule **`Navigator.languages`** renvoie un tableau de chaînes de caractères [`DOMString`](/fr/docs/Web/API/DOMString) qui représente les langues préférées de l'utilisatrice ou de l'utilisateur. Les langues sont représentées au format défini par [la RFC 5646, aussi connu sous le nom de balise BCP 47](https://datatracker.ietf.org/doc/html/rfc5646). Les éléments du tableau sont triés par ordre de préférence, la langue préférée étant située en première. + +La valeur de [`navigator.language`](/fr/docs/Web/API/Navigator/language) correspond au premier élément du tableau. + +Lorsque les langues préférées sont modifiées, la valeur de cette propriété change et un évènement [`languagechange`](/fr/docs/Web/API/Window/languagechange_event) est déclenché sur l'objet [`Window`](/fr/docs/Web/API/Window). + +Pour chaque requête HTTP du navigateur, l'en-tête HTTP `Accept-Language` utilise la même valeur que `navigator.languages` si on omet les champs de valeurs de qualité (`qvalues`) (par exemple `en-US;q=0.8`). + +## Valeur + +Un tableau de chaînes de caractères. + +## Exemples + +```js +navigator.language // "en-US" +navigator.languages // ["en-US", "zh-CN", "ja-JP"] +``` + +## Spécifications + +{{Specifications}} + +## Compatibilité des navigateurs + +{{Compat}} + +## Voir aussi + +- [`Navigator.language`](/fr/docs/Web/API/Navigator/language) +- [`Navigator`](/fr/docs/Web/API/Navigator) +- L'évènement [`languagechange`](/fr/docs/Web/API/Window/languagechange_event) diff --git a/files/fr/web/api/navigator/online/index.md b/files/fr/web/api/navigator/online/index.md new file mode 100644 index 00000000000000..fd0c6243214c5c --- /dev/null +++ b/files/fr/web/api/navigator/online/index.md @@ -0,0 +1,55 @@ +--- +title: Navigator.onLine +slug: Web/API/Navigator/onLine +translation_of: Web/API/Navigator/onLine +browser-compat: api.Navigator.onLine +--- +{{ApiRef("HTML DOM")}} + +La propriété en lecture seule **`Navigator.onLine`** est un booléen indiquant le statut de connectivité du navigateur. `true` indique que le navigateur accède au réseau et `false` indique que le navigateur est hors ligne. Cette propriété est mise à jour lorsque la connectivité réseau change. La mise à jour se produit lorsque la personne suit un lien ou qu'un script effectue une requête vers une page distante. Ainsi, la propriété peut renvoyer `false` lorsqu'une personne clique sur un lien après avoir perdu l'accès à Internet. + +L'implémentation de cette propriété varie entre les navigateurs. + +Pour Chrome et Safari, si le navigateur n'est pas en mesure de se connecter à un réseau local (LAN) ou à un routeur, il est hors ligne. Toutes les autres conditions renvoient `true`. Aussi, même si on peut prendre comme hypothèse que le navigateur est hors ligne lorsque la propriété a la valeur `false`, on ne peut pas présupposer que `true` implique que le navigateur accède à Internet. En effet, on pourrait avoir des faux positifs (par exemple dans le cas où le navigateur est exécuté au sein d'une machine virtuelle dont les adaptateurs réseau virtuels sont toujours connectés). Si on veut vérifier l'accès du navigateur à Internet, il faudra donc ajouter d'autres méthodes de contrôle. + +Pour Firefox et Internet Explorer jusqu'à Firefox 41, il fallait passer le navigateur en mode hors ligne pour que la propriété soit `false`. Elle valait `true` sinon. Cela a été modifié dans Firefox ensuite pour correspondre au comportement de Chrome et Safari. + +Il est possible de surveiller les changements relatifs à la connectivité réseau en écoutant les évènements [`online`](/fr/docs/Web/API/Window/online_event) et [`offline`](/fr/docs/Web/API/Window/offline_event). + +## Valeur + +Un booléen. + +## Exemples + +### Utilisation simple + +Pour vérifier que le réseau est accessible, on pourra utiliser `navigator.onLine`, comme dans cet exemple : + +```js +if (navigator.onLine) { + console.log('connecté'); +} else { + console.log('hors ligne'); +} +``` + +Si le navigateur ne prend pas en charge `navigator.onLine`, l'exemple précédent tombera toujours dans le cas `false`/`undefined`. + +### Surveiller les changements de connectivité + +Pour gérer les changements liés à l'état du réseau, on pourra utiliser la méthode [`addEventListener()`](/fr/docs/Web/API/EventTarget/addEventListener) afin de créer des gestionnaires d'évènements pour `online` et `offline`, comme dans l'exemple qui suit : + +```js +window.addEventListener('offline', function(e) { console.log('hors ligne'); }); + +window.addEventListener('online', function(e) { console.log('connecté'); }); +``` + +## Spécifications + +{{Specifications}} + +## Compatibilité des navigateurs + +{{Compat}} diff --git a/files/fr/web/api/navigator/storage/index.md b/files/fr/web/api/navigator/storage/index.md new file mode 100644 index 00000000000000..b89f06a0033de4 --- /dev/null +++ b/files/fr/web/api/navigator/storage/index.md @@ -0,0 +1,26 @@ +--- +title: Navigator.storage +slug: Web/API/Navigator/storage +translation_of: Web/API/Navigator/storage +browser-compat: api.Navigator.storage +--- +{{securecontext_header}}{{APIRef("Storage")}} + +La propriété en lecture seule **`Navigator.storage`** renvoie l'objet singleton [`StorageManager`](/fr/docs/Web/API/StorageManager) qui permet d'accéder aux différentes fonctionnalités de stockage du navigateur pour le site ou l'application courante. L'objet renvoyé permet d'examiner et de configurer la persistance des magasins de données et de connaître approximativement l'espace disponible restant pour le stockage local du navigateur. + +## Valeur + +Un objet [`StorageManager`](/fr/docs/Web/API/StorageManager) qui peut être utilisé pour gérer la persistance des données enregistrées et qui permet de connaître approximativement l'espace restant pour le stockage des données. + +## Spécifications + +{{Specifications}} + +## Compatibilité des navigateurs + +{{Compat}} + +## Voir aussi + +- [`StorageManager`](/fr/docs/Web/API/StorageManager) +- [`Navigator`](/fr/docs/Web/API/Navigator)