Navigator

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

L'interface Navigator 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 instanciant Navigator peut être récupéré grâce à la propriété en lecture seule window.navigator.

Propriétés

Propriétés standard

Fournit un objet NetworkInformation contenant des informations quant à la connection réseau de l'appareil.

Renvoie un booléen indiquant si l'ajout d'un cookie sera pris en compte.

Renvoie l'interface CredentialsContainer 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.

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.

Indique le choix de l'utilisateur fournit pour la préférence do-not-track. Lorsque cette valeur vaut "1", l'application web ne devrait pas pister l'utilisateur.

Renvoie un objet Geolocation permettant l'accès à l'emplacement géographique de l'appareil.

Renvoie le nombre de cœurs logiques du processeur.

Renvoie le booléen false.

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.

Renvoie une chaîne de caractères DOMString 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 null est renvoyée si cette information est inconnue.

Renvoie un tableau de chaînes DOMString qui représente les langues connues de l'utilisateur, triées par ordre de préférence.

Renvoie un objet LockManager qui fournit des méthodes pour demander un nouvel objet Lock ou s'enquérir d'un objet Lock existant.

Renvoie le nombre maximum de points de toucher simultanés possible pour l'appareil courant.

Renvoie un objet MediaCapabilities qui peut exposer des informations sur le décodage/l'encodage d'un format donné.

Renvoie une référence vers un objet MediaDevices 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 via MediaDevices.getUserMedia().

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).

Renvoie une liste MimeTypeArray des types MIME pris en charge par le navigateur.

Renvoie un booléen indiquant si le navigateur est en ligne.

Renvoie un objet Permissions pouvant être utilisé pour demander ou mettre à jour les informations de permissions pour les API couvertes par l'API Permissions.

Renvoie une liste PluginArray indiquant les plugins installés sur le navigateur.

Renvoie une référence à l'API Presentation .

Renvoie un objet Serial représentant le point d'entrée vers l'API Web Serial qui permet de contrôler les ports série.

Renvoie un objet ServiceWorkerContainer qui permet d'enregistrer, de supprimer, de mettre à jour ou de communiquer avec des objets ServiceWorker pour le document associé.

Renvoie le singleton StorageManager utilisé pour la persistence des permissions et la gestion du stockage disponible site par site/application par application.

Renvoie la chaîne de caractères de l'agent utilisateur pour le navigateur courant.

Renvoie le nom de l'éditeur du navigateur courant (par exemple "Netscape6").

Indique si l'agent utilisateur est contrôlé par un outil automatisé.

Renvoie un objet XRSystem qui représente le point d'entrée sur l'API WebXR.

Propriétés non-standard

Renvoie l'identifiant de build du navigateur. Les navigateurs renvoient un horodatage fixe pour éviter le pistage (par exemple 20181001000000 à partir de Firefox 64).

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.

Renvoie une chaîne de caractères vide. Netscape 4.7x renvoyait "US & CA domestic policy" ou "Export policy".

Renvoie un booléen indiquant si le navigateur s'exécute en mode standalone. Uniquement disponible sur Safari pour iOS.

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

Renvoie le nom de code interne du navigateur. Ne vous attendez pas à ce que cette propriété renvoie une valeur correcte.

Renvoie une chaîne DOMString contenant le nom officiel du navigateur. Ne vous attendez pas à ce que cette propriété renvoie une valeur correcte.

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.

Renvoie un tableau contenant chaque objet VRDisplay actuellement utilisé pour afficher (autrement dit, pour chaque objet où VRDisplay.ispresenting vaut true).

Renvoie un objet BatteryManager permettant d'avoir des informations sur le statut de charge de la batterie.

Renvoie une chaîne de caractères qui représente le système d'exploitation courant.

Renvoie une chaîne de caractères représentant la plateforme du navigateur. N'utilisez pas cette fonction afin d'obtenir une valeur significative.

Renvoie toujours 'Gecko' quel que soit le navigateur. Cette propriété est uniquement conservée à des fins de compatibilité.

Renvoie le numéro de build précis du navigateur (par exemple "20060909").

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 par NavigatorID, NavigatorContentUtils, NavigatorUserMedia, and NavigatorStorageUtils.

Renvoie true si un appel à Navigator.share() réussirait.

Permet aux sites web de s'enregistrer afin de gérer un protocole donné.

Renvoie une promesse (Promise) qui se résout en un objet MediaKeySystemAccess.

Transfère, de façon asynchrone, une petite quantité de donnée avec HTTP depuis l'agent utilisateur vers un serveur web.

Invoque la fonctionnalité native de partage pour la plateforme courant.

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

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.

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.

Permet aux sites web de s'enregistrer pour gérer certains types MIME.

Renvoie false. 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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
Navigator
activeVRDisplays
DeprecatedNon-standard
Secure context required
DeprecatedNon-standard
adAuctionComponents
Experimental
appCodeName
Deprecated
appName
Deprecated
appVersion
Deprecated
audioSession
Experimental
authentication
Experimental
bluetooth
Experimental
buildID
Non-standard
canLoadAdAuctionFencedFrame
Experimental
canShare
data.files parameter
data.text parameter
clearAppBadge
clearOriginJoinedAdInterestGroups
Experimental
clipboard
connection
contacts
Experimental
cookieEnabled
createAuctionNonce
Experimental
credentials
deprecatedReplaceInURN
Experimental
deprecatedRunAdAuctionEnforcesKAnonymity
Experimental
deviceMemory
devicePosture
Experimental
doNotTrack
DeprecatedNon-standard
geolocation
Secure context required
getAutoplayPolicy
Experimental
getBattery
Secure context required
Experimental
getGamepads
Secure context required
Experimental
getInstalledRelatedApps
Experimental
getInterestGroupAdAuctionData
Experimental
getUserMedia
Deprecated
getVRDisplays
DeprecatedNon-standard
globalPrivacyControl
Experimental
gpu
Experimental
hardwareConcurrency
hid
Experimental
ink
Experimental
javaEnabled
Deprecated
joinAdInterestGroup
Experimental
keyboard
Experimental
language
languages
leaveAdInterestGroup
Experimental
locks
login
Experimental
managed
Experimental
maxTouchPoints
mediaCapabilities
mediaDevices
Secure context required
mediaSession
mimeTypes
Deprecated
Returns MIME types from plugins rather than hard-coded PDF values
DeprecatedNon-standard
ml
Experimental
onLine
oscpu
Deprecated
pdfViewerEnabled
permissions
platform
Deprecated
plugins
Deprecated
Returns plugins rather than hard-coded PDF plugin values
DeprecatedNon-standard
presentation
product
Deprecated
productSub
Deprecated
protectedAudience
Experimental
registerProtocolHandler
scheme parameter supports bitcoin
scheme parameter supports cabal
ExperimentalNon-standard
scheme parameter supports dat
ExperimentalNon-standard
scheme parameter supports did
ExperimentalNon-standard
scheme parameter supports dweb
ExperimentalNon-standard
scheme parameter supports ethereum
ExperimentalNon-standard
scheme parameter supports ftp
Experimental
scheme parameter supports ftps
Experimental
scheme parameter supports geo
scheme parameter supports hyper
ExperimentalNon-standard
scheme parameter supports im
scheme parameter supports ipfs
ExperimentalNon-standard
scheme parameter supports ipns
ExperimentalNon-standard
scheme parameter supports irc
scheme parameter supports ircs
scheme parameter supports magnet
scheme parameter supports mailto
scheme parameter supports matrix
scheme parameter supports mms
scheme parameter supports news
scheme parameter supports nntp
scheme parameter supports openpgp4fpr
scheme parameter supports sftp
Experimental
scheme parameter supports sip
scheme parameter supports sms
scheme parameter supports smsto
scheme parameter supports ssb
ExperimentalNon-standard
scheme parameter supports ssh
scheme parameter supports tel
scheme parameter supports urn
scheme parameter supports webcal
scheme parameter supports wtai
scheme parameter supports xmpp
Secure context required
requestMIDIAccess
Secure context required
requestMediaKeySystemAccess
runAdAuction
Experimental
scheduling
Experimental
sendBeacon
serial
Experimental
serviceWorker
setAppBadge
share
data.files parameter
data.text parameter
storage
storageBuckets
Experimental
taintEnabled
Deprecated
unregisterProtocolHandler
updateAdInterestGroups
Experimental
usb
userActivation
userAgent
userAgentData
Experimental
Secure context required
Experimental
vendor
Deprecated
vendorSub
Deprecated
vibrate
virtualKeyboard
Experimental
wakeLock
webdriver
windowControlsOverlay
xr
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
In development. Supported in a pre-release version.
In development. Supported in a pre-release version.
No support
No support
Experimental. Expect behavior to change in the future.
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.
User must explicitly enable this feature.
Requires a vendor prefix or different name for use.
Has more compatibility info.