L'interface Navigator
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.
Un objet Navigator
peut être récupéré en utilisant la propriété en lecture seule Window.navigator
.
Propriétés
N'hérite d'aucune propriété, mais implémente celles définies dans NavigatorID
, NavigatorLanguage
, NavigatorOnLine
, NavigatorContentUtils
, NavigatorStorage
, NavigatorStorageUtils
, NavigatorConcurrentHardware
, NavigatorPlugins
et NavigatorUserMedia
.
Standard
Navigator.activeVRDisplays
Lecture seule- Retourne un tableau contenant chaque objet
VRDisplay
qui est actuellement en train d'être présenté (VRDisplay.ispresenting
est true (vrai)
).
NavigatorID.appCodeName
Lecture seule- Retourne le nom de "code" interne du navigateur actuel. Ne vous fiez pas à cette propriété pour renvoyer la valeur correcte.
NavigatorID.appName
Lecture seule- Retourne une
DOMString
(chaîne de caractères) avec le nom officiel du navigateur. Ne vous fiez pas à cette propriété pour renvoyer la valeur correcte. NavigatorID.appVersion
Lecture seule- Retourne la version du navigateur en tant que
DOMString
(chaîne de caractères). Ne vous fiez pas à cette propriété pour renvoyer la valeur correcte. Navigator.battery
Lecture seule- Retourne un objet
BatteryManager
que vous pouvez utiliser pour récupérer des information sur l'état de chargement de la batterie. Navigator.connection
Lecture seule- Fournit un objet
NetworkInformation
contenant les informations sur la connection réseau du matériel. Navigator.cookieEnabled
Lecture seule- Retourne "false" (faux) si la définition d'un cookie est ignorée et "true" (vrai) dans le cas contraire.
NavigatorGeolocation.geolocation
Lecture seule- Retourne un objet
Geolocation
permettant d'accéder à la géolocalisation de l'appareil. NavigatorConcurrentHardware.hardwareConcurrency
Lecture seule- Retourne le nombre de processeurs logiques disponibles
NavigatorPlugins.javaEnabled
Lecture seule- Retourne une marque ("flag")
Boolean
indiquant si java est activé ou non. NavigatorLanguage.language
Lecture seule- Retourne une
DOMString
(chaîne de caractères) représentant la langue préférée de l'utilisateur, généralement celle de l'interface utilisateur du navigateur. La valeurNull
est retournée quand elle est inconnue. NavigatorLanguage.languages
Lecture seule- Retourne un tableau de
DOMString
représentant les langues connues par l'utilisateur, par ordre de préférence. NavigatorPlugins.mimeTypes
Lecture seule- Retourne un
MimeTypeArray
listant les types MIME supportés par le navigateur. NavigatorOnLine.onLine
Lecture seule- Retourne un
Boolean
indiquant si le navigateur fonctionne avec une connexion internet. Navigator.oscpu
- Retourne une chaîne de caractères représentant le système d'exploitation utilisé.
Navigator.permissions
Lecture seule- Retourne un objet
Permissions
qui peut être utilisé pour interroger et mettre à jour les permissions des API couvertes par Permissions API.
NavigatorID.platform
Lecture seule- 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.
NavigatorPlugins.plugins
Lecture seule- Retourne un
PluginArray
listant les modules installés sur le navigateur. NavigatorID.product
Lecture seule- Retourne toujours
'Gecko'
, sur n'importe quel navigateur. Cette propriété est gardée juste dans un but de compatibilité.
Navigator.serviceWorker
Lecture seule- Retourne un objet
ServiceWorkerContainer
, contenant l'accès à l'enregistrement, la suppression, la mise à jour et la communication avec l'objetServiceWorker
pour les documents associés. Navigator.storage
Lecture seule- Retourne un objet unique
StorageManager
utilisé pour gérer les autorisations de persistance et estimer l'espace disponible sur une base site par site / application par application.
NavigatorID.userAgent
Lecture seule- Retourne la chaîne de caractères de l'agent utilisateur du navigateur actuel.
Non-standard
Les périphériques Firefox OS ajoutent d'autres propriétés non standard. Vous pouvez les consulter sur l'article Firefox OS Navigator extensions
Navigator.buildID
- Retourne l'identifiant constructeur du navigateur (par exemple, "2006090803").
Navigator.cookieEnabled
- Retourne un booléen indicant si les cookies sont activés dans le navigateur ou pas.
Navigator.credentials
- Retourne une interface
CredentialsContainer
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. navigator.doNotTrack
- Indique la valeur de la préférence de non-suivi de l'utilisateur. Lorsque cette valeur est "oui", votre site Web ou votre application ne doit pas suivre l'utilisateur.
Navigator.id
- Retourne l'objet
id
que vous pouvez utiliser pour ajouter le support pour BrowserID vers votre site web. Navigator.mediaDevices
- Renvoie une référence à un objet
MediaDevices
qui peut ensuite être utilisée pour obtenir des informations sur les périphériques multimédia disponiblesMediaDevices.enumerateDevices ()
, trouver quelles propriétés contraignantes sont supportées par les médias de l'ordinateur de l'utilisateur et l'agent utilisateurMediaDevices.getSupportedConstraints ()
), et demander l'accès aux médias à l'aide deMediaDevices.getUserMedia ()
Navigator.mozNotification
Obsolète depuis Gecko 22
Navigator.webkitNotification
- Retourne un objet
notification
utilisable pour délivrer des notifications à l'utilisateur depuis l'application web. Navigator.mozSocial
- Les objets retournés par la propriété
navigator.mozSocial
sont disponibles dans le panneau du fournisseur de médias sociaux pour fournir les fonctionnalités dont il peut avoir besoin. Navigator.presentation
- Retourne une référence vers l'API
Presentation
Navigator.productSub
- Retourne le nombre constructeur du navigateur actuel (par exemple, "20060909").
Navigator.securitypolicy
- Retourne une chaîne vide. Dans Netscape 4.7x, retourne "US & CA domestic policy" (politique américaine) ou "Export policy" (politique d'exportation).
Navigator.standalone
- Retourne un booléen indiquant si le navigateur fonctionne en mode autonome. Disponible uniquement sur le Safari iOS d'Apple.
Navigator.storageQuota
Lecture seule- Retourne une interface
StorageQuota
qui fournit des moyens d'interroger et de demander des informations sur l'utilisation de l'espace de stockage et les quotas. Navigator.vendor
- Retourne le nom du fournisseur du navigateur courant (par exemple, "Netscape6").
Navigator.vendorSub
- Retourne le numéro de version du fournisseur (par exemple, "6.1").
Navigator.webkitPointer
- Retourne un objet PointerLock (verrou du pointeur) pour l'API Mouse Lock.
Méthodes
N'hérite d'aucune méthode, mais met en oeuvre celles définies par NavigatorID
, NavigatorContentUtils
, NavigatorUserMedia
et NavigatorStorageUtils
.
Standard
Navigator.getVRDisplays()
- Retourne une annonce qui résout un tableau d'objets
VRDisplay
représentant tous les périphériques VR disponibles connectés à l'ordinateur. Navigator.getUserMedia()
- 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.
Navigator.registerContentHandler()
- Permet aux sites Web de s'inscrire eux-mêmes comme un gestionnaire possible pour un type MIME donné.
Navigator.registerProtocolHandler()
- Permet aux sites Web de s'inscrire eux-mêmes comme un gestionnaire possible pour un protocole donné.
Navigator.requestMediaKeySystemAccess()
- Retourne une
Promise
pour un objet " MediaKeySystemAccess ". Navigator.sendBeacon()
- Utilisé pour transférer de manière asynchrone une petite quantité de données à l'aide de HTTP de l'agent utilisateur vers un serveur Web.
Navigator.share()
- Appelle le mécanisme de partage natif de la plateforme actuelle.
NavigatorID.taintEnabled()
Obsolète depuis Gecko 1.7.8 Obsolète depuis Gecko 9.0- Retourne
false
(faux). Fonctions JavaScript taint / untaint supprimées dans JavaScript 1.2. Navigator.vibrate()
- Provoque des vibrations sur les appareils avec support. Ne fait rien si le support de vibration n'est pas disponible.
Non standard
Les appareils Firefox OS ajoutent d'autres méthodes non standard. Elles peuvent être consultées dans l'article Firefox OS Navigator extensions.
Navigator.mozIsLocallyAvailable()
- Permet de vérifier le code pour voir si le document d'un URI donné est disponible sans utiliser le réseau.
Navigator.mozPay()
- Permet le paiement dans l'application.