Navigator

Baseline Widely available *

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

L'interfaceNavigator 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.

Un objet instanciantNavigator peut être récupéré grâce à la propriété en lecture seulewindow.navigator.

Propriétés

Cette interface n'hérite d'aucune propriété mais implémente celles définies parNavigatorID,NavigatorLanguage,NavigatorOnLine,NavigatorContentUtils,NavigatorStorage,NavigatorStorageUtils,NavigatorConcurrentHardware,NavigatorPlugins etNavigatorUserMedia.

Propriétés standard

Navigator.connectionLecture seuleExpérimental: Fournit un objet NetworkInformation contenant des informations quant à la connection réseau de l'appareil.
Navigator.cookieEnabledLecture seule: Renvoie un booléen indiquant si l'ajout d'un cookie sera pris en compte.
Navigator.credentialsLecture seule: Renvoie l'interfaceCredentialsContainer 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.
Navigator.deviceMemoryLecture seuleExpérimental: 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.
Navigator.doNotTrackLecture seuleExpérimental: Indique le choix de l'utilisateur fournit pour la préférencedo-not-track. Lorsque cette valeur vaut "1", l'application web ne devrait pas pister l'utilisateur.
Navigator.geolocationLecture seule: Renvoie un objetGeolocation permettant l'accès à l'emplacement géographique de l'appareil.
NavigatorConcurrentHardware.hardwareConcurrencyLecture seule: Renvoie le nombre de cœurs logiques du processeur.
NavigatorPlugins.javaEnabledLecture seule: Renvoie le booléenfalse.
Navigator.keyboardLecture seuleExpérimental: Renvoie un objet Keyboard 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.
NavigatorLanguage.languageLecture seule: Renvoie une chaîne de caractèresDOMString 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 valeurnull est renvoyée si cette information est inconnue.
NavigatorLanguage.languagesLecture seuleExpérimental: Renvoie un tableau de chaînes DOMString qui représente les langues connues de l'utilisateur, triées par ordre de préférence.
Navigator.locksLecture seuleExpérimental: Renvoie un objet LockManager qui fournit des méthodes pour demander un nouvel objetLock ou s'enquérir d'un objetLock existant.
Navigator.maxTouchPointsLecture seule: Renvoie le nombre maximum de points de toucher simultanés possible pour l'appareil courant.
Navigator.mediaCapabilitiesLecture seuleExpérimental: Renvoie un objet MediaCapabilities qui peut exposer des informations sur le décodage/l'encodage d'un format donné.
Navigator.mediaDevicesLecture seule: Renvoie une référence vers un objetMediaDevices permettant d'obtenir des informations à propos des appareils médias disponibles (MediaDevices.enumerateDevices()), de déterminer les propriétés et contraintes prises en charge pour les médias sur cet agent utilisateur et cet ordinateur (MediaDevices.getSupportedConstraints()), de demander l'accès au média viaMediaDevices.getUserMedia().
Navigator.mediaSessionLecture seuleExpérimental: Renvoie un objet MediaSession 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).
NavigatorPlugins.mimeTypesLecture seuleObsolète: Renvoie une liste MimeTypeArray des types MIME pris en charge par le navigateur.
NavigatorOnLine.onLineLecture seule: Renvoie un booléen indiquant si le navigateur est en ligne.
Navigator.permissionsLecture seuleExpérimental: Renvoie un objet Permissions pouvant être utilisé pour demander ou mettre à jour les informations de permissions pour les API couvertes par l'APIPermissions.
NavigatorPlugins.pluginsLecture seuleObsolète: Renvoie une liste PluginArray indiquant les plugins installés sur le navigateur.
Navigator.presentationLecture seuleExpérimental: Renvoie une référence à l'API Presentation .
Navigator.serialLecture seule: Renvoie un objetSerial représentant le point d'entrée vers l'APIWeb Serial qui permet de contrôler les ports série.
Navigator.serviceWorkerLecture seule: Renvoie un objetServiceWorkerContainer qui permet d'enregistrer, de supprimer, de mettre à jour ou de communiquer avec des objetsServiceWorker pour ledocument associé.
NavigatorStorage.storageLecture seule: Renvoie le singletonStorageManager utilisé pour la persistence des permissions et la gestion du stockage disponible site par site/application par application.
NavigatorID.userAgentLecture seule: Renvoie la chaîne de caractères de l'agent utilisateur pour le navigateur courant.
Navigator.vendorLecture seule: Renvoie le nom de l'éditeur du navigateur courant (par exemple "Netscape6").
Navigator.webdriverLecture seuleExpérimental: Indique si l'agent utilisateur est contrôlé par un outil automatisé.
Navigator.xrLecture seuleExpérimental: Renvoie un objet XRSystem qui représente le point d'entrée sur l'APIWebXR.

Propriétés non-standard

Navigator.buildIDNon standard: Renvoie l'identifiant de build du navigateur. Les navigateurs renvoient un horodatage fixe pour éviter le pistage (par exemple20181001000000 à partir de Firefox 64).
Navigator.contactsLecture seuleNon standard: Renvoie une interface ContactsManager 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.
Navigator.securitypolicyNon standard: Renvoie une chaîne de caractères vide. Netscape 4.7x renvoyait "US & CA domestic policy" ou "Export policy".
Navigator.standaloneNon standard: Renvoie un booléen indiquant si le navigateur s'exécute en modestandalone. Uniquement disponible sur Safari pour iOS.
Navigator.wakeLockLecture seuleNon standard: Renvoie une interface WakeLock 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.

Propriétés dépréciées

NavigatorID.appCodeNameLecture seuleObsolète: Renvoie le nom de code interne du navigateur. Ne vous attendez pas à ce que cette propriété renvoie une valeur correcte.
NavigatorID.appNameLecture seuleObsolète: Renvoie une chaîne DOMString contenant le nom officiel du navigateur. Ne vous attendez pas à ce que cette propriété renvoie une valeur correcte.
NavigatorID.appVersionLecture seuleObsolète: Renvoie la version du navigateur sous la forme d'une chaîne DOMString. Ne vous attendez pas à ce que cette propriété renvoie une valeur correcte.
Navigator.activeVRDisplaysLecture seuleObsolète: Renvoie un tableau contenant chaque objet VRDisplay actuellement utilisé pour afficher (autrement dit, pour chaque objet oùVRDisplay.ispresenting vauttrue).
Navigator.batteryLecture seuleObsolète: Renvoie un objet BatteryManager permettant d'avoir des informations sur le statut de charge de la batterie.
Navigator.oscpuLecture seuleObsolète: Renvoie une chaîne de caractères qui représente le système d'exploitation courant.
NavigatorID.platformLecture seuleObsolète: Renvoie une chaîne de caractères représentant la plateforme du navigateur. N'utilisez pas cette fonction afin d'obtenir une valeur significative.
NavigatorID.productLecture seuleObsolète: Renvoie toujours'Gecko' quel que soit le navigateur. Cette propriété est uniquement conservée à des fins de compatibilité.
Navigator.productSubLecture seuleObsolète: Renvoie le numéro debuild précis du navigateur (par exemple "20060909").
Navigator.vendorSubLecture seuleObsolète: Renvoie le numéro de version de l'éditeur (e.g. "6.1").

Méthodes

Cette interface n'hérite d'aucune méthode mais implémente celles définies parNavigatorID,NavigatorContentUtils,NavigatorUserMedia, andNavigatorStorageUtils.

Navigator.canShare(): Renvoietrue si un appel àNavigator.share() réussirait.
Navigator.registerProtocolHandler(): Permet aux sites web de s'enregistrer afin de gérer un protocole donné.
Navigator.requestMediaKeySystemAccess(): Renvoie une promesse (Promise) qui se résout en un objetMediaKeySystemAccess.
Navigator.sendBeacon(): Transfère, de façon asynchrone, une petite quantité de donnée avec HTTP depuis l'agent utilisateur vers un serveur web.
Navigator.share(): Invoque la fonctionnalité native de partage pour la plateforme courant.
Navigator.vibrate(): 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é.

Méthodes dépréciées

Navigator.getVRDisplays()Obsolète: Renvoie une promesse qui se résout en un tableau d'objets VRDisplay représentant chacun un appareil de réalité virtuelle connecté à l'ordinateur.
Navigator.getUserMedia()Obsolète: 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.
Navigator.registerContentHandler()Obsolète: Permet aux sites web de s'enregistrer pour gérer certains types MIME.
NavigatorID.taintEnabled()Obsolète: Renvoiefalse. Les fonctions JavaScript jouant sur cet aspect ont été retirées avec JavaScript 1.2.

Spécifications

Specification
HTML # the-navigator-object

Compatibilité des navigateurs

Help improve MDN

Learn how to contribute

Cette page a été modifiée le17 déc. 2024 par lescontributeurs du MDN.

View this page on GitHub •Report a problem with this content

Movatterモバイル変換

Navigator

Help improve MDN