diff options
author | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-03-22 20:19:09 +0100 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-03-22 20:19:09 +0100 |
commit | 33984e116c31c184a8b7511cc29d50c17405aa6e (patch) | |
tree | 532b8cf5eeed4fd4d3470630ccfdf17f4ce76103 | |
parent | 4afbe3f2eba9b28e2a92cc5bf7f04141317f55fe (diff) | |
download | translated-content-33984e116c31c184a8b7511cc29d50c17405aa6e.tar.gz translated-content-33984e116c31c184a8b7511cc29d50c17405aa6e.tar.bz2 translated-content-33984e116c31c184a8b7511cc29d50c17405aa6e.zip |
Fixes #217 - Update window.navigator and Navigator interface page (#286)
* Updated window.navigator to parity w/ en-US 11a98a5
* Title typofix
* Update of Navigator interface page to parity w/ en-US as of commit 229f090
-rw-r--r-- | files/fr/web/api/navigator/index.html | 272 | ||||
-rw-r--r-- | files/fr/web/api/window/navigator/index.html | 161 |
2 files changed, 185 insertions, 248 deletions
diff --git a/files/fr/web/api/navigator/index.html b/files/fr/web/api/navigator/index.html index e8e395d3e7..6c258f9873 100644 --- a/files/fr/web/api/navigator/index.html +++ b/files/fr/web/api/navigator/index.html @@ -3,162 +3,176 @@ title: Navigator slug: Web/API/Navigator tags: - API - - DOM4 + - DOM - Interface - - Navigateur - - Références(2) + - Navigator + - Reference - Web + - Web Performance translation_of: Web/API/Navigator --- -<p>{{ APIRef("DOM4") }}</p> +<div>{{APIRef("DOM")}}</div> -<p>L'interface <code><strong>Navigator</strong></code> représente l'état et l'identité de l'agent utilisateur. Elle permet aux scripts de l'interroger et de s'enregister eux-mêmes pour poursuivre certaines tâches.</p> +<p>L'interface <code><strong>Navigator</strong></code> représente l'état et l'identité de l'agent utilisateur courant. Elle permet aux scripts de consulter ces informations et de s'enregistrer en vue de certaines activités.</p> -<p>Un objet <code>Navigator</code> peut être récupéré en utilisant la propriété en lecture seule {{domxref("Window.navigator")}}.</p> +<p>Un objet instanciant <code>Navigator</code> peut être récupéré grâce à la propriété en lecture seule <a href="/fr/docs/Web/API/Window/navigator"><code>window.navigator</code></a>.</p> -<h2 id="Propriétés">Propriétés</h2> +<h2 id="Properties">Propriétés</h2> -<p><em>N'hérite d'aucune propriété, mais implémente celles définies dans </em> <em>{{domxref("NavigatorID")}}, {{domxref("NavigatorLanguage")}}, {{domxref("NavigatorOnLine")}}, {{domxref("NavigatorContentUtils")}}, {{domxref("NavigatorStorage")}}, {{domxref("NavigatorStorageUtils")}}, {{domxref("NavigatorConcurrentHardware")}}, {{domxref("NavigatorPlugins")}}</em> <em> et </em> <em>{{domxref("NavigatorUserMedia")}}.</em></p> +<p><em>Cette interface n'hérite d'aucune propriété mais implémente celles définies par <a href="/fr/docs/Web/API/NavigatorID"><code>NavigatorID</code></a>, <a href="/fr/docs/Web/API/NavigatorLanguage"><code>NavigatorLanguage</code></a>, <a href="/fr/docs/Web/API/NavigatorOnLine"><code>NavigatorOnLine</code></a>, <a href="/fr/docs/Web/API/NavigatorContentUtils"><code>NavigatorContentUtils</code></a>, <a href="/fr/docs/Web/API/NavigatorStorage"><code>NavigatorStorage</code></a>, <a href="/fr/docs/Web/API/NavigatorStorageUtils"><code>NavigatorStorageUtils</code></a>, <a href="/fr/docs/Web/API/NavigatorConcurrentHardware"><code>NavigatorConcurrentHardware</code></a>, <a href="/fr/docs/Web/API/NavigatorPlugins"><code>NavigatorPlugins</code></a> et <a href="/fr/docs/Web/API/NavigatorUserMedia"><code>NavigatorUserMedia</code></a>.</em></p> -<h3 id="Standard">Standard</h3> +<h3 id="Standard_properties">Propriétés standard</h3> <dl> - <dt>{{domxref("Navigator.activeVRDisplays")}} {{readonlyInline}}{{experimental_inline}}</dt> - <dd>Retourne un tableau contenant chaque objet {{domxref("VRDisplay")}} qui est actuellement en train d'être présenté ({{domxref("VRDisplay.ispresenting")}} <code>est true <em>(vrai)</em></code>).</dd> + <dt><a href="/fr/docs/Web/API/Navigator/connection"><code>Navigator.connection</code></a> {{readonlyInline}} {{experimental_inline}}</dt> + <dd>Fournit un objet <a href="/fr/docs/Web/API/NetworkInformation"><code>NetworkInformation</code></a> contenant des informations quant à la connection réseau de l'appareil.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/cookieEnabled"><code>Navigator.cookieEnabled</code></a> {{readonlyinline}}</dt> + <dd>Renvoie un booléen indiquant si l'ajout d'un cookie sera pris en compte.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/credentials"><code>Navigator.credentials</code></a> {{readonlyInline}}</dt> + <dd>Renvoie l'interface <a href="/fr/docs/Web/API/CredentialsContainer"><code>CredentialsContainer</code></a> qui expose des méthodes pour la demande d'informations d'authentification et qui notifie l'agent utilisateur lors d'évènements particuliers tels que les connexions ou déconnexions.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/deviceMemory"><code>Navigator.deviceMemory</code></a> {{readonlyInline}} {{experimental_inline}}</dt> + <dd>Renvoie la quantité de mémoire de l'appareil, exprimée en gigaoctets. Cette valeur est une approximation calculée en prenant la plus proche puissance de 2 puis en divisant le résultat par 1024.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/doNotTrack"><code>Navigator.doNotTrack</code></a> {{readonlyInline}} {{experimental_inline}}</dt> + <dd>Indique le choix de l'utilisateur fournit pour la préférence <i>do-not-track</i>. Lorsque cette valeur vaut "1", l'application web ne devrait pas pister l'utilisateur.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/geolocation"><code>Navigator.geolocation</code></a> {{readonlyInline}}</dt> + <dd>Renvoie un objet <a href="/fr/docs/Web/API/Geolocation"><code>Geolocation</code></a> permettant l'accès à l'emplacement géographique de l'appareil.</dd> + <dt><a href="/fr/docs/Web/API/NavigatorConcurrentHardware.hardwareConcurrency"><code>NavigatorConcurrentHardware.hardwareConcurrency</code></a> {{readonlyInline}}</dt> + <dd>Renvoie le nombre de cœurs logiques du processeur.</dd> + <dt><a href="/fr/docs/Web/API/NavigatorPlugins.javaEnabled"><code>NavigatorPlugins.javaEnabled</code></a> {{readonlyInline}}</dt> + <dd>Renvoie le booléen <code>false</code>.</dd> + <dt><a href="/fr/docs/Web/API/Navigator.keyboard"><code>Navigator.keyboard</code></a> {{readonlyinline}} {{experimental_inline}}</dt> + <dd>Renvoie un objet <a href="/fr/docs/Web/API/Keyboard"><code>Keyboard</code></a> qui permet d'accéder à des fonctions pour récupérer des informations sur la disposition du clavier et la capture de touches du clavier physique.</dd> + <dt><a href="/fr/docs/Web/API/NavigatorLanguage.language"><code>NavigatorLanguage.language</code></a> {{readonlyInline}}</dt> + <dd>Renvoie une chaîne de caractères <a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a> indiquant la langue préférée de l'utilisateur (qui correspond généralement à la langue utilisée pour l'interface utilisateur du navigateur). La valeur <code>null</code> est renvoyée si cette information est inconnue.</dd> + <dt><a href="/fr/docs/Web/API/NavigatorLanguage.languages"><code>NavigatorLanguage.languages</code></a> {{readonlyInline}} {{experimental_inline}}</dt> + <dd>Renvoie un tableau de chaînes <a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a> qui représente les langues connues de l'utilisateur, triées par ordre de préférence.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/locks"><code>Navigator.locks</code></a> {{readonlyinline}} {{experimental_inline}}</dt> + <dd>Renvoie un objet <a href="/fr/docs/Web/API/LockManager"><code>LockManager</code></a> qui fournit des méthodes pour demander un nouvel objet <a href="/fr/docs/Web/API/Lock"><code>Lock</code></a> ou s'enquérir d'un objet <a href="/fr/docs/Web/API/Lock"><code>Lock</code></a> existant.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/maxTouchPoints"><code>Navigator.maxTouchPoints</code></a> {{readonlyInline}}</dt> + <dd>Renvoie le nombre maximum de points de toucher simultanés possible pour l'appareil courant.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/mediaCapabilities"><code>Navigator.mediaCapabilities</code></a> {{readonlyinline}} {{experimental_inline}}</dt> + <dd>Renvoie un objet <a href="/fr/docs/Web/API/MediaCapabilities"><code>MediaCapabilities</code></a> qui peut exposer des informations sur le décodage/l'encodage d'un format donné.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/mediaDevices"><code>Navigator.mediaDevices</code></a> {{readonlyinline}}</dt> + <dd>Renvoie une référence vers un objet <a href="/fr/docs/Web/API/MediaDevices"><code>MediaDevices</code></a> permettant d'obtenir des informations à propos des appareils médias disponibles (<a href="/fr/docs/Web/API/MediaDevices.enumerateDevices()"><code>MediaDevices.enumerateDevices()</code></a>), de déterminer les propriétés et contraintes prises en charge pour les médias sur cet agent utilisateur et cet ordinateur (<a href="/fr/docs/Web/API/MediaDevices.getSupportedConstraints()"><code>MediaDevices.getSupportedConstraints()</code></a>), de demander l'accès au média via <a href="/fr/docs/Web/API/MediaDevices.getUserMedia()"><code>MediaDevices.getUserMedia()</code></a>.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/mediaSession"><code>Navigator.mediaSession</code></a> {{readonlyinline}} {{experimental_inline}}</dt> + <dd>Renvoie un objet <a href="/fr/docs/Web/API/MediaSession"><code>MediaSession</code></a> pouvant être utilisé afin de fournir des métadonnées utilisées par le navigateur afin de présenter des informations sur le média en cours de lecture (par exemple pour les interfaces utilisateurs générales de contrôle des médias).</dd> + <dt><a href="/fr/docs/Web/API/NavigatorPlugins.mimeTypes"><code>NavigatorPlugins.mimeTypes</code></a> {{readonlyInline}}{{deprecated_inline}}</dt> + <dd>Renvoie une liste <a href="/fr/docs/Web/API/MimeTypeArray"><code>MimeTypeArray</code></a> des types MIME pris en charge par le navigateur.</dd> + <dt><a href="/fr/docs/Web/API/NavigatorOnLine.onLine"><code>NavigatorOnLine.onLine</code></a> {{readonlyInline}}</dt> + <dd>Renvoie un booléen indiquant si le navigateur est en ligne.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/permissions"><code>Navigator.permissions</code></a> {{readonlyinline}} {{experimental_inline}}</dt> + <dd>Renvoie un objet <a href="/fr/docs/Web/API/Permissions"><code>Permissions</code></a> pouvant être utilisé pour demander ou mettre à jour les informations de permissions pour les API couvertes par l'API <a href="/en-US/docs/Web/API/Permissions_API">Permissions</a>.</dd> + <dt><a href="/fr/docs/Web/API/NavigatorPlugins.plugins"><code>NavigatorPlugins.plugins</code></a> {{readonlyInline}}{{deprecated_inline}}</dt> + <dd>Renvoie une liste <a href="/fr/docs/Web/API/PluginArray"><code>PluginArray</code></a> indiquant les plugins installés sur le navigateur.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/presentation"><code>Navigator.presentation</code></a> {{readonlyInline}} {{experimental_inline}}</dt> + <dd>Renvoie une référence à l'API <a href="/fr/docs/Web/API/Presentation"><code>Presentation</code></a> .</dd> + <dt><a href="/fr/docs/Web/API/Navigator/serial"><code>Navigator.serial</code></a> {{readonlyInline}}</dt> + <dd>Renvoie un objet <a href="/fr/docs/Web/API/Serial"><code>Serial</code></a> représentant le point d'entrée vers l'API <a href="/fr/docs/Web/API/Web Serial API"><code>Web Serial</code></a> qui permet de contrôler les ports série.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/serviceWorker"><code>Navigator.serviceWorker</code></a> {{readonlyInline}}</dt> + <dd>Renvoie un objet <a href="/fr/docs/Web/API/ServiceWorkerContainer"><code>ServiceWorkerContainer</code></a> qui permet d'enregistrer, de supprimer, de mettre à jour ou de communiquer avec des objets <a href="/fr/docs/Web/API/ServiceWorker"><code>ServiceWorker</code></a> pour le <a href="https://html.spec.whatwg.org/multipage/browsers.html#concept-document-window">document associé</a>.</dd> + <dt><a href="/fr/docs/Web/API/NavigatorStorage.storage"><code>NavigatorStorage.storage</code></a> {{readonlyinline}}</dt> + <dd>Renvoie le singleton <a href="/fr/docs/Web/API/StorageManager"><code>StorageManager</code></a> utilisé pour la persistence des permissions et la gestion du stockage disponible site par site/application par application.</dd> + <dt><a href="/fr/docs/Web/API/NavigatorID/userAgent"><code>NavigatorID.userAgent</code></a> {{readonlyInline}}</dt> + <dd>Renvoie la chaîne de caractères de l'agent utilisateur pour le navigateur courant.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/vendor"><code>Navigator.vendor</code></a> {{readonlyInline}}</dt> + <dd>Renvoie le nom de l'éditeur du navigateur courant (par exemple "Netscape6").</dd> + <dt><a href="/fr/docs/Web/API/Navigator/webdriver"><code>Navigator.webdriver</code></a> {{readonlyInline}} {{experimental_inline}}</dt> + <dd>Indique si l'agent utilisateur est contrôlé par un outil automatisé.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/xr"><code>Navigator.xr</code></a> {{readonlyInline}} {{experimental_inline}}</dt> + <dd>Renvoie un objet <a href="/fr/docs/Web/API/XRSystem"><code>XRSystem</code></a> qui représente le point d'entrée sur l'API <a href="/en-US/docs/Web/API/WebXR_Device_API">WebXR</a>.</dd> </dl> -<dl> - <dt>{{domxref("NavigatorID.appCodeName")}} {{readonlyInline}}{{experimental_inline}}</dt> - <dd>Retourne le nom de "code" interne du navigateur actuel. Ne vous fiez pas à cette propriété pour renvoyer la valeur correcte.</dd> - <dt>{{domxref("NavigatorID.appName")}} {{readonlyInline}}{{experimental_inline}}</dt> - <dd>Retourne une {{domxref("DOMString")}} <em>(chaîne de caractères)</em> avec le nom officiel du navigateur. Ne vous fiez pas à cette propriété pour renvoyer la valeur correcte.</dd> - <dt>{{domxref("NavigatorID.appVersion")}} {{readonlyInline}}{{experimental_inline}}</dt> - <dd>Retourne la version du navigateur en tant que {{domxref("DOMString")}} <em>(chaîne de caractères)</em>. Ne vous fiez pas à cette propriété pour renvoyer la valeur correcte.</dd> - <dt>{{domxref("Navigator.battery")}} {{readonlyInline}}</dt> - <dd>Retourne un objet {{domxref("BatteryManager")}} que vous pouvez utiliser pour récupérer des information sur l'état de chargement de la batterie.</dd> - <dt>{{domxref("Navigator.connection")}} {{readonlyInline}}{{experimental_inline}}</dt> - <dd>Fournit un objet {{domxref("NetworkInformation")}} contenant les informations sur la connection réseau du matériel.</dd> - <dt>{{domxref("Navigator.cookieEnabled")}} {{readonlyinline}}</dt> - <dd>Retourne "false" <em>(faux)</em> <span id="result_box" lang="fr"><span>si la définition d'un cookie est ignorée et "true" <em>(vrai)</em> dans le cas contraire.</span></span></dd> - <dt>{{domxref("NavigatorGeolocation.geolocation")}} {{readonlyInline}}</dt> - <dd>Retourne un objet {{domxref("Geolocation")}} permettant d'accéder à la géolocalisation de l'appareil.</dd> - <dt>{{domxref("NavigatorConcurrentHardware.hardwareConcurrency")}} {{readOnlyInline}}</dt> - <dd>Retourne le nombre de processeurs logiques disponibles</dd> - <dt>{{domxref("NavigatorPlugins.javaEnabled")}} {{readonlyInline}}{{experimental_inline}}</dt> - <dd>Retourne une marque ("flag") {{domxref("Boolean")}} indiquant si java est activé ou non.</dd> - <dt>{{domxref("NavigatorLanguage.language")}} {{readonlyInline}}</dt> - <dd>Retourne une {{domxref("DOMString")}} <em>(chaîne de caractères)</em> représentant la langue préférée de l'utilisateur, généralement celle de l'interface utilisateur du navigateur. La valeur <code>Null</code> est retournée quand elle est inconnue.</dd> - <dt>{{domxref("NavigatorLanguage.languages")}} {{readonlyInline}}</dt> - <dd>Retourne un tableau de {{domxref("DOMString")}} représentant les langues connues par l'utilisateur, par ordre de préférence.</dd> - <dt>{{domxref("NavigatorPlugins.mimeTypes")}} {{readonlyInline}}{{experimental_inline}}</dt> - <dd>Retourne un {{domxref("MimeTypeArray")}} listant les types MIME supportés par le navigateur.</dd> - <dt>{{domxref("NavigatorOnLine.onLine")}} {{readonlyInline}}</dt> - <dd>Retourne un {{domxref("Boolean")}} indiquant si le navigateur fonctionne avec une connexion internet.</dd> - <dt>{{domxref("Navigator.oscpu")}}</dt> - <dd>Retourne une chaîne de caractères représentant le système d'exploitation utilisé.</dd> - <dt>{{domxref("Navigator.permissions")}} {{readonlyinline}}{{experimental_inline}}</dt> - <dd>Retourne un objet {{domxref("Permissions")}} qui peut être utilisé pour interroger et mettre à jour les permissions des API couvertes par <a href="https://developer.mozilla.org/en-US/docs/Web/API/Permissions_API">Permissions API</a>.</dd> -</dl> +<h3 id="Non-standard_properties">Propriétés non-standard</h3> <dl> - <dt>{{domxref("NavigatorID.platform")}} {{readonlyInline}}{{experimental_inline}}</dt> - <dd>Retourne une chaîne de caractères représentant la plateforme du navigateur. Ne pas attendre de cette fonction qu'elle retourne une valeur significative.</dd> - <dt>{{domxref("NavigatorPlugins.plugins")}} {{readonlyInline}}{{experimental_inline}}</dt> - <dd>Retourne un {{domxref("PluginArray")}} listant les modules installés sur le navigateur.</dd> - <dt>{{domxref("NavigatorID.product")}} {{readonlyInline}} {{experimental_inline}}</dt> - <dd>Retourne toujours <code>'Gecko'</code>, sur n'importe quel navigateur. Cette propriété est gardée juste dans un but de compatibilité.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/buildID"><code>Navigator.buildID</code></a> {{non-standard_inline}}</dt> + <dd>Renvoie l'identifiant de build du navigateur. Les navigateurs renvoient un horodatage fixe pour éviter le pistage (par exemple <code>20181001000000</code> à partir de Firefox 64).</dd> + <dt><a href="/fr/docs/Web/API/Navigator/contacts"><code>Navigator.contacts</code></a> {{readonlyInline}} {{non-standard_inline}}</dt> + <dd>Renvoie une interface <a href="/fr/docs/Web/API/ContactsManager"><code>ContactsManager</code></a> qui permet à l'utilisateur de sélectionner certaines entrées dans la liste des contacts afin de partager certains détails limités avec une application web.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/securitypolicy"><code>Navigator.securitypolicy</code></a> {{non-standard_inline}}</dt> + <dd>Renvoie une chaîne de caractères vide. Netscape 4.7x renvoyait "US & CA domestic policy" ou "Export policy".</dd> + <dt><a href="/fr/docs/Web/API/Navigator/standalone"><code>Navigator.standalone</code></a> {{non-standard_inline}}</dt> + <dd>Renvoie un booléen indiquant si le navigateur s'exécute en mode <i>standalone</i>. Uniquement disponible sur Safari pour iOS.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/wakeLock"><code>Navigator.wakeLock</code></a> {{readonlyInline}} {{non-standard_inline}}</dt> + <dd>Renvoie une interface <a href="/fr/docs/Web/API/WakeLock"><code>WakeLock</code></a> pouvant être utilisée afin de demander un verrou sur l'écran afin de l'empêcher d'entrer en veille, de s'estomper ou de s'éteindre.</dd> </dl> -<dl> - <dt>{{domxref("Navigator.serviceWorker")}} {{readonlyInline}}</dt> - <dd>Retourne un objet {{domxref("ServiceWorkerContainer")}}, contenant l'accès à l'enregistrement, la suppression, la mise à jour et la communication avec l'objet {{domxref("ServiceWorker")}} pour les <a href="https://html.spec.whatwg.org/multipage/browsers.html#concept-document-window">documents associés</a>.</dd> - <dt>{{domxref("Navigator.storage")}} {{readonlyinline}}</dt> - <dd>Retourne un objet unique {{domxref('StorageManager')}} utilisé pour gérer les autorisations de persistance et estimer l'espace disponible sur une base site par site / application par application.</dd> -</dl> +<h3 id="Deprecated_properties">Propriétés dépréciées</h3> <dl> - <dt>{{domxref("NavigatorID.userAgent")}} {{readonlyInline}}</dt> - <dd>Retourne la chaîne de caractères de l'agent utilisateur du navigateur actuel.</dd> + <dt><a href="/fr/docs/Web/API/NavigatorID/appCodeName"><code>NavigatorID.appCodeName</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> + <dd>Renvoie le nom de code interne du navigateur. Ne vous attendez pas à ce que cette propriété renvoie une valeur correcte.</dd> + <dt><a href="/fr/docs/Web/API/NavigatorID/appName"><code>NavigatorID.appName</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> + <dd>Renvoie une chaîne <a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a> contenant le nom officiel du navigateur. Ne vous attendez pas à ce que cette propriété renvoie une valeur correcte.</dd> + <dt><a href="/fr/docs/Web/API/NavigatorID/appVersion"><code>NavigatorID.appVersion</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> + <dd>Renvoie la version du navigateur sous la forme d'une chaîne <a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a>. Ne vous attendez pas à ce que cette propriété renvoie une valeur correcte.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/activeVRDisplays"><code>Navigator.activeVRDisplays</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> + <dd>Renvoie un tableau contenant chaque objet <a href="/fr/docs/Web/API/VRDisplay"><code>VRDisplay</code></a> actuellement utilisé pour afficher (autrement dit, pour chaque objet où <a href="/fr/docs/Web/API/VRDisplay.ispresenting"><code>VRDisplay.ispresenting</code></a> vaut <code>true</code>).</dd> + <dt><a href="/fr/docs/Web/API/Navigator/battery"><code>Navigator.battery</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> + <dd>Renvoie un objet <a href="/fr/docs/Web/API/BatteryManager"><code>BatteryManager</code></a> permettant d'avoir des informations sur le statut de charge de la batterie.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/oscpu"><code>Navigator.oscpu</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> + <dd>Renvoie une chaîne de caractères qui représente le système d'exploitation courant.</dd> + <dt><a href="/fr/docs/Web/API/NavigatorID/platform"><code>NavigatorID.platform</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> + <dd>Renvoie une chaîne de caractères représentant la plateforme du navigateur. N'utilisez pas cette fonction afin d'obtenir une valeur significative.</dd> + <dt><a href="/fr/docs/Web/API/NavigatorID/product"><code>NavigatorID.product</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> + <dd>Renvoie toujours <code>'Gecko'</code> quel que soit le navigateur. Cette propriété est uniquement conservée à des fins de compatibilité.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/productSub"><code>Navigator.productSub</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> + <dd>Renvoie le numéro de <i>build</i> précis du navigateur (par exemple "20060909").</dd> + <dt><a href="/fr/docs/Web/API/Navigator/vendorSub"><code>Navigator.vendorSub</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> + <dd>Renvoie le numéro de version de l'éditeur (e.g. "6.1").</dd> </dl> -<h3 id="Methods" name="Methods">Non-standard</h3> +<h2 id="Methods">Méthodes</h2> -<div class="note"> -<p><span id="result_box" lang="fr"><span>Les périphériques Firefox OS ajoutent d'autres propriétés non standard.</span> <span>Vous pouvez les consulter sur l'article </span></span> <a href="https://developer.mozilla.org/fr/docs/Mozilla/Firefox_OS/API/Navigator">Firefox OS Navigator extensions</a></p> -</div> +<p><em>Cette interface n'hérite d'aucune méthode mais implémente celles définies par <a href="/fr/docs/Web/API/NavigatorID"><code>NavigatorID</code></a>, <a href="/fr/docs/Web/API/NavigatorContentUtils"><code>NavigatorContentUtils</code></a>, <a href="/fr/docs/Web/API/NavigatorUserMedia"><code>NavigatorUserMedia</code></a>, and <a href="/fr/docs/Web/API/NavigatorStorageUtils"><code>NavigatorStorageUtils</code></a>.</em></p> <dl> - <dt>{{domxref("Navigator.buildID")}} {{non-standard_inline}}</dt> - <dd>Retourne l'identifiant constructeur du navigateur (par exemple, "2006090803").</dd> - <dt>{{domxref("Navigator.cookieEnabled")}} {{non-standard_inline}}</dt> - <dd>Retourne un booléen indicant si les cookies sont activés dans le navigateur ou pas.</dd> - <dt>{{domxref("Navigator.credentials")}} {{non-standard_inline}}</dt> - <dd>Retourne une interface {{domxref("CredentialsContainer")}} <span id="result_box" lang="fr"><span>qui expose des méthodes pour demander des informations d'identification et avertir l'agent utilisateur lorsque des événements intéressants se produisent, tels que la connexion réussie ou la déconnexion.</span></span></dd> - <dt>{{domxref("navigator.doNotTrack")}} {{non-standard_inline}}</dt> - <dd><span id="result_box" lang="fr"><span>Indique la valeur de la préférence de non-suivi de l'utilisateur.</span> <span>Lorsque cette valeur est "oui", votre site Web ou votre application ne doit pas suivre l'utilisateur.</span></span></dd> - <dt>{{domxref("Navigator.id")}} {{non-standard_inline}}</dt> - <dd>Retourne l'objet {{domxref("window.navigator.id", "id")}} <span id="result_box" lang="fr"><span>que vous pouvez utiliser pour ajouter le support pour</span></span> <a href="/en-US/docs/BrowserID" title="BrowserID">BrowserID</a> vers votre site web.</dd> - <dt>{{domxref("Navigator.mediaDevices")}} {{non-standard_inline}}</dt> - <dd><span id="result_box" lang="fr"><span>Renvoie une référence à un objet {{domxref ("MediaDevices")}} qui peut ensuite être utilisée pour obtenir des informations sur les périphériques multimédia disponibles {{domxref ("MediaDevices.enumerateDevices ()")}}</span>, trouver</span><span id="result_box" lang="fr"><span> quelles propriétés contraignantes sont supportées par les médias de l'ordinateur de l'utilisateur et l'agent utilisateur {{domxref ("MediaDevices.getSupportedConstraints ()")}}), et demander l'accès aux médias à l'aide de {{domxref ("MediaDevices.getUserMedia ()</span> <span>")}}.</span></span></dd> - <dt>{{domxref("Navigator.mozNotification")}} {{deprecated_inline("22")}} {{non-standard_inline}}<br> - {{domxref("Navigator.webkitNotification")}}</dt> - <dd>Retourne un objet {{domxref("navigator.mozNotification", "notification")}} utilisable pour délivrer des notifications à l'utilisateur depuis l'application web.</dd> - <dt>{{domxref("Navigator.mozSocial")}} {{non-standard_inline}}</dt> - <dd>Les objets retournés par la propriété <code>navigator.mozSocial</code> sont <span id="result_box" lang="fr"><span>disponibles dans le panneau du fournisseur de médias sociaux pour fournir les fonctionnalités dont il peut avoir besoin.</span></span></dd> - <dt>{{domxref("Navigator.presentation")}} {{non-standard_inline}}</dt> - <dd>Retourne une référence vers l'API {{domxref("Presentation")}}</dd> - <dt>{{domxref("Navigator.productSub")}} {{non-standard_inline}}</dt> - <dd>Retourne le nombre constructeur du navigateur actuel (par exemple, "20060909").</dd> - <dt>{{domxref("Navigator.securitypolicy")}} {{non-standard_inline}}</dt> - <dd>Retourne une chaîne vide. Dans Netscape 4.7x, retourne "US & CA domestic policy" <em>(politique américaine)</em> ou "Export policy" <em>(politique d'exportation)</em>.</dd> - <dt>{{domxref("Navigator.standalone")}} {{non-standard_inline}}</dt> - <dd>Retourne un booléen indiquant si le navigateur fonctionne en mode autonome. <span class="short_text" id="result_box" lang="fr"><span>Disponible uniquement sur le Safari iOS d'Apple.</span></span></dd> - <dt>{{domxref("Navigator.storageQuota")}} {{readonlyinline}} {{experimental_inline}}</dt> - <dd>Retourne une interface {{domxref('StorageQuota')}} qui fournit des moyens d'interroger et de demander des informations sur l'utilisation de l'espace de stockage et les quotas.</dd> - <dt>{{domxref("Navigator.vendor")}} {{non-standard_inline}}</dt> - <dd>Retourne le nom du fournisseur du navigateur courant (par exemple, "Netscape6").</dd> - <dt>{{domxref("Navigator.vendorSub")}} {{non-standard_inline}}</dt> - <dd>Retourne le numéro de version du fournisseur (par exemple, "6.1").</dd> - <dt>{{domxref("Navigator.webkitPointer")}} {{non-standard_inline}}</dt> - <dd>Retourne un objet PointerLock <em>(verrou du pointeur)</em> pour l'API <a href="https://developer.mozilla.org/en-US/docs/API/Pointer_Lock_API" title="Mouse Lock API">Mouse Lock</a>.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/canShare()"><code>Navigator.canShare()</code></a></dt> + <dd>Renvoie <code>true</code> si un appel à <code>Navigator.share()</code> réussirait.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/registerProtocolHandler()"><code>Navigator.registerProtocolHandler()</code></a></dt> + <dd>Permet aux sites web de s'enregistrer afin de gérer un protocole donné.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/requestMediaKeySystemAccess()"><code>Navigator.requestMediaKeySystemAccess()</code></a></dt> + <dd>Renvoie une promesse (<a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise"><code>Promise</code></a>) qui se résout en un objet <code>MediaKeySystemAccess</code>.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/sendBeacon()"><code>Navigator.sendBeacon()</code></a></dt> + <dd>Transfère, de façon asynchrone, une petite quantité de donnée avec HTTP depuis l'agent utilisateur vers un serveur web.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/share()"><code>Navigator.share()</code></a></dt> + <dd>Invoque la fonctionnalité native de partage pour la plateforme courant.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/vibrate()"><code>Navigator.vibrate()</code></a></dt> + <dd>Permet de faire vibrer l'appareil si celui-ci prend en charge cette fonctionnalité. Aucun effet n'est produit s'il n'y a pas de compatibilité.</dd> </dl> -<h2 id="Methods" name="Methods">Méthodes</h2> - -<p><em>N'hérite d'aucune méthode, mais met en oeuvre celles définies par {{domxref("NavigatorID")}}, {{domxref("NavigatorContentUtils")}}, <em>{{domxref("NavigatorUserMedia")}} </em>et {{domxref("NavigatorStorageUtils")}}.</em></p> - -<h3 id="Standard_2">Standard</h3> +<h3 id="Deprecated_methods">Méthodes dépréciées</h3> <dl> - <dt>{{domxref("Navigator.getVRDisplays()")}} {{experimental_inline}}</dt> - <dd>Retourne <span id="result_box" lang="fr"><span>une annonce qui résout un tableau d'objets {{domxref ("VRDisplay")}} représentant tous les périphériques VR disponibles connectés à l'ordinateur.</span></span></dd> - <dt>{{domxref("Navigator.getUserMedia", "Navigator.getUserMedia()")}} {{experimental_inline}}</dt> - <dd><span id="result_box" lang="fr"><span>Après avoir demandé l'autorisation de l'utilisateur, renvoie le flux audio ou vidéo associé à une caméra ou un microphone sur l'ordinateur local.</span></span></dd> - <dt>{{domxref("Navigator.registerContentHandler()")}}</dt> - <dd><span id="result_box" lang="fr"><span>Permet aux sites Web de s'inscrire eux-mêmes comme un gestionnaire possible pour un type MIME donné.</span></span></dd> - <dt>{{domxref("Navigator.registerProtocolHandler()")}}</dt> - <dd><span id="result_box" lang="fr"><span>Permet aux sites Web de s'inscrire eux-mêmes comme un gestionnaire possible pour un protocole donné.</span></span></dd> - <dt>{{domxref("Navigator.requestMediaKeySystemAccess()")}} {{experimental_inline}}</dt> - <dd>Retourne une <span style="line-height: 19.0909080505371px;">{{jsxref("Promise")}}</span> pour un objet " <span style="line-height: 19.0909080505371px;">MediaKeySystemAccess</span> ".</dd> - <dt>{{domxref("Navigator.sendBeacon()")}}{{experimental_inline}}</dt> - <dd><span id="result_box" lang="fr"><span>Utilisé pour transférer de manière asynchrone une petite quantité de données à l'aide de </span></span> {{Glossary("HTTP")}} <span lang="fr"><span> de l'agent utilisateur vers un serveur Web.</span></span></dd> - <dt>{{domxref("Navigator.share()")}}{{experimental_inline}}</dt> - <dd><span id="result_box" lang="fr"><span>Appelle le mécanisme de partage natif de la plateforme actuelle.</span></span></dd> - <dt>{{domxref("NavigatorID.taintEnabled()")}} {{deprecated_inline("1.7.8")}} {{obsolete_inline("9.0")}} {{experimental_inline}}</dt> - <dd>Retourne <code>false</code><em>(faux)</em>. <span id="result_box" lang="fr"><span>Fonctions JavaScript taint / untaint supprimées dans JavaScript 1.2.</span></span></dd> - <dt>{{domxref("Navigator.vibrate()")}} {{gecko_minversion_inline("11.0")}}</dt> - <dd><span id="result_box" lang="fr"><span>Provoque des vibrations sur les appareils avec support.</span> <span>Ne fait rien si le support de vibration n'est pas disponible.</span></span></dd> + <dt><a href="/fr/docs/Web/API/Navigator/getVRDisplays()"><code>Navigator.getVRDisplays()</code></a> {{deprecated_inline}}</dt> + <dd>Renvoie une promesse qui se résout en un tableau d'objets <a href="/fr/docs/Web/API/VRDisplay"><code>VRDisplay</code></a> représentant chacun un appareil de réalité virtuelle connecté à l'ordinateur.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/getUserMedia()"><code>Navigator.getUserMedia()</code></a> {{deprecated_inline}}</dt> + <dd>Après avoir demandé la permission à l'utilisateur, renvoie le flux audio ou vidéo associé à une caméra ou à un micro sur l'ordinateur local.</dd> + <dt><a href="/fr/docs/Web/API/Navigator/registerContentHandler()"><code>Navigator.registerContentHandler()</code></a> {{deprecated_inline}}</dt> + <dd>Permet aux sites web de s'enregistrer pour gérer certains types MIME.</dd> + <dt><a href="/fr/docs/Web/API/NavigatorID/taintEnabled()"><code>NavigatorID.taintEnabled()</code></a> {{deprecated_inline}}</dt> + <dd>Renvoie <code>false</code>. Les fonctions JavaScript jouant sur cet aspect ont été retirées avec JavaScript 1.2.</dd> </dl> -<h3 id="Specification" name="Specification">Non standard</h3> - -<div class="note"> -<p>Les appareils Firefox OS ajoutent d'autres méthodes non standard. Elles peuvent être consultées dans l'article <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/API/Navigator">Firefox OS Navigator extensions</a>.</p> -</div> - -<dl> - <dt>{{domxref("Navigator.mozIsLocallyAvailable()")}} {{non-standard_inline}}</dt> - <dd><span id="result_box" lang="fr"><span>Permet de vérifier le code pour voir si le document d'un URI donné est disponible sans utiliser le réseau.</span></span></dd> - <dt>{{domxref("Navigator.mozPay()")}} {{non-standard_inline}}</dt> - <dd><span class="short_text" id="result_box" lang="fr"><span>Permet le paiement dans l'application.</span></span></dd> -</dl> +<h2 id="Specifications">Spécifications</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Spécification</th> + <th scope="col">Statut</th> + <th scope="col">Commentaires</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', '#the-navigator-object', 'the Navigator object')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> + +<div>{{Compat("api.Navigator")}}</div> diff --git a/files/fr/web/api/window/navigator/index.html b/files/fr/web/api/window/navigator/index.html index 585b643de5..2f763caa88 100644 --- a/files/fr/web/api/window/navigator/index.html +++ b/files/fr/web/api/window/navigator/index.html @@ -1,125 +1,48 @@ --- -title: window.navigator +title: Window.navigator slug: Web/API/Window/navigator tags: - - DOM - - DOM_0 - - Référence_du_DOM_Gecko + - API + - HTML DOM + - Property + - Read-only + - Reference + - Window translation_of: Web/API/Window/navigator --- -<p>{{ ApiRef() }}</p> -<h3 id="R.C3.A9sum.C3.A9" name="R.C3.A9sum.C3.A9">Résumé</h3> -<p>Renvoie une référence à l'objet - <i> - navigator</i> - , qui peut être interrogé pour obtenir des informations concernant l'application exécutant le script.</p> -<h3 id="Exemple" name="Exemple">Exemple</h3> -<pre class="eval">alert("Vous utilisez " + navigator.appName); +<div>{{APIRef}}</div> + +<p>La propriété en lecture-seule <strong><code>Window.navigator</code></strong> renvoie une référence à un objet qui est une instance de {{domxref("Navigator")}} et possède des méthodes et propriétés à propos de l'application qui exécute le script.</p> + +<h2 id="Syntax">Syntaxe</h2> + +<pre class="brush: js"><var>navigatorObject</var> = window.navigator</pre> + +<h2 id="Example">Exemple</h2> + +<pre class="brush: js">var sUsrAg = navigator.userAgent; +console.log("Voici l'agent utilisateur du navigateur courant", sUsrAg); </pre> -<h3 id="Notes" name="Notes">Notes</h3> -<p>L'objet navigator est utilisé pour connaître le navigateur en cours d'utilisation. Il fournit des propriétés permettant d'obtenir des informations sur le navigateur lui-même. Toutes les propriétés et méthodes disponibles depuis window.navigator peuvent également être référencées simplement avec navigator.</p> -<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s">Propriétés</h3> -<dl> - <dt> - <a href="fr/DOM/window.navigator.appcodeName">navigator.appCodeName</a></dt> - <dd> - Renvoie le nom de code interne du navigateur courant.</dd> - <dt> - <a href="fr/DOM/window.navigator.appName">navigator.appName</a></dt> - <dd> - Renvoie le nom officiel du navigateur.</dd> - <dt> - <a href="fr/DOM/window.navigator.appVersion">navigator.appVersion</a></dt> - <dd> - Renvoie la version du navigateur sous la forme d'une chaîne.</dd> - <dt> - <a href="fr/DOM/window.navigator.buildID">navigator.buildID</a></dt> - <dd> - Renvoie l'identifiant de compilation du navigateur (par exemple « 2006090803 »)</dd> - <dt> - <a href="fr/DOM/window.navigator.cookieEnabled">navigator.cookieEnabled</a></dt> - <dd> - Renvoie un booléen indiquant si les cookies sont activés ou non dans le navigateur.</dd> - <dt> - <a href="fr/DOM/window.navigator.language">navigator.language</a></dt> - <dd> - Renvoie une chaîne représentant la langue utilisée par le navigateur.</dd> - <dt> - <a href="fr/DOM/window.navigator.mimeTypes">navigator.mimeTypes</a></dt> - <dd> - Renvoie une liste des types MIME gérés par le navigateur.</dd> - <dt> - <a href="fr/DOM/window.navigator.onLine">navigator.onLine</a></dt> - <dd> - Renvoie un booléen indiquant si le navigateur est en mode en ligne.</dd> - <dt> - <a href="fr/DOM/window.navigator.oscpu">navigator.oscpu</a></dt> - <dd> - Renvoie une chaîne indiquant le système d'exploitation.</dd> - <dt> - <a href="fr/DOM/window.navigator.platform">navigator.platform</a></dt> - <dd> - Renvoie une chaîne représentant la plateforme du navigateur.</dd> - <dt> - <a href="fr/DOM/window.navigator.plugins">navigator.plugins</a></dt> - <dd> - Renvoie un tableau listant les plugins installés dans le navigateur.</dd> - <dt> - <a href="fr/DOM/window.navigator.product">navigator.product</a></dt> - <dd> - Renvoie le nom de produit du navigateur (par exemple « Gecko »)</dd> - <dt> - <a href="fr/DOM/window.navigator.productSub">navigator.productSub</a></dt> - <dd> - Renvoie le numéro de compilation du produit (par exemple « 20060909 »)</dd> - <dt> - <a href="fr/DOM/window.navigator.securityPolicy">navigator.securityPolicy</a></dt> - <dd> - Renvoie une chaîne vide. Dans Netscape 4.7x, renvoyait « US & CA domestic policy » ou « Export policy ».</dd> - <dt> - <a href="fr/DOM/window.navigator.userAgent">navigator.userAgent</a></dt> - <dd> - Renvoie la chaîne d'identification d'agent utilisateur pour le navigateur courant.</dd> - <dt> - <a href="fr/DOM/window.navigator.vendor">navigator.vendor</a></dt> - <dd> - Renvoie le nom du vendeur du navigateur (par exemple « Netscape6 »)</dd> - <dt> - <a href="fr/DOM/window.navigator.vendorSub">navigator.vendorSub</a></dt> - <dd> - Renvoie le numéro de version du vendeur (par exemple « 6.1 »)</dd> -</dl> -<h3 id="M.C3.A9thodes" name="M.C3.A9thodes">Méthodes</h3> -<dl> - <dt> - <a href="fr/DOM/window.navigator.javaEnabled">navigator.javaEnabled</a></dt> - <dd> - Indique si le navigateur hôte dispose de Java activé ou non.</dd> - <dt> - <a href="fr/DOM/window.navigator.isLocallyAvailable">navigator.isLocallyAvailable</a></dt> - <dd> - Permet de vérifier si le document à une URI donnée est disponible sans utiliser le réseau.</dd> - <dt> - <a href="fr/DOM/window.navigator.preference">navigator.preference</a></dt> - <dd> - Définit une préférence utilisateur. Cette méthode est <a class="external" href="http://www.faqts.com/knowledge_base/view.phtml/aid/1608/fid/125/lang/en">uniquement disponible pour du code privilégié</a>, et il est préférable d'utiliser l'<a href="fr/API_des_pr%c3%a9f%c3%a9rences">API des préférences</a> XPCOM à la place.</dd> - <dt> - <a href="fr/DOM/window.navigator.registerContentHandler">navigator.registerContentHandler</a></dt> - <dd> - Permet aux sites Web de s'enregistrer comme gestionnaires possibles pour un type MIME donné.</dd> - <dt> - <a href="fr/DOM/window.navigator.registerProtocolHandler">navigator.registerProtocolHandler</a></dt> - <dd> - Permet aux sites Web de s'enregistrer comme gestionnaires possibles pour un protocole donné.</dd> - <dt> - <a href="fr/DOM/window.navigator.taintEnabled">navigator.taintEnabled</a> {{ Obsolete_inline() }} </dt> - <dd> - Renvoie <code>false</code>. Les fonctions JavaScript taint/untaint ont été retirées de JavaScript dans sa version 1.2<a class="external" href="http://devedge-temp.mozilla.org/library/manuals/2000/javascript/1.3/reference/nav.html#1194117"> </a></dd> -</dl> -<h3 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"><a class="external" href="http://devedge-temp.mozilla.org/library/manuals/2000/javascript/1.3/reference/nav.html#1194117">Voir également </a></h3> -<p><a href="fr/R%c3%a9f%c3%a9rence_objet_crois%c3%a9e_des_clients_DOM/navigator">Référence objet croisée des clients DOM:navigator</a></p> -<h3 id="Sp.C3.A9cification" name="Sp.C3.A9cification">Spécification</h3> -<p>{{ DOM0() }}</p> -<div class="noinclude"> - </div> -<p>{{ languages( { "en": "en/DOM/window.navigator", "ja": "ja/DOM/window.navigator", "pl": "pl/DOM/window.navigator" } ) }}</p> + +<h2 id="Specifications">Spécifications</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Spécification</th> + <th scope="col">Statut</th> + <th scope="col">Commentaires</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', '#dom-navigator', 'Window: navigator')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> + +<p>{{Compat("api.Window.navigator")}}</p> |