navigator | NN 2 IE 3 DOM s.o. | |||||||||||||||||||||||
L'objet navigator représente, à maints égards, le navigateur du même nom. En tant que tel, le navigateur se situe hors du champ du modèle objet document. Malgré cela, l'objet navigator joue un rôle important sur le plan des scripts, dans la mesure où il leur permet d'identifier le navigateur et la version de navigateur qui les exécute. Outre les quelques propriétés clés qu'ont en commun Navigator et Internet Explorer, chaque navigateur étend la liste de propriétés de cet objet d'une manière qui bénéficie, en règle générale, à tous les navigateurs. IE duplique cet objet sous le nom d´objet clientInformation, mais pour des raisons de compatibilité avec tous les navigateurs, vous pouvez utiliser la référence d´objet navigator dans tous les navigateurs. |
||||||||||||||||||||||||
Référence de modèle d'objet | ||||||||||||||||||||||||
|
||||||||||||||||||||||||
Propriétés spécifiques à l´objet | ||||||||||||||||||||||||
|
||||||||||||||||||||||||
Méthodes spécifiques à l´objet | ||||||||||||||||||||||||
|
||||||||||||||||||||||||
Propriétés de gestionnaire d´événements spécifiques à l´objet | ||||||||||||||||||||||||
Aucune. |
appCodeName | NN 2 IE 3 DOM s.o. |
Lecture seule | |
Révèle le nom de code du navigateur. Tant Navigator qu'Internet Explorer renvoient Mozilla, qui est le nom de code d'une des premières versions de Navigator (contraction entre le nom du navigateur gratuiciel Mosaic et Godzilla). Le personnage Mozilla est la mascotte de Netscape, mais tous les navigateurs qui utilisent la technologie Mosaic sous licence (notamment IE) renvoie Mozilla. |
|
Exemple | |
var codeName = navigator.appCodeName; |
|
Valeur | |
Mozilla |
|
Par défaut | |
Mozilla |
appMinorVersion | NN s.o. IE 4 DOM s.o. |
Lecture seule | |
Dans les diverses générations de Microsoft Internet Explorer, cette propriété renvoie une gamme de valeurs très vaste, dont la plupart sont inutiles pour la détection de version typique. IE 5.x pour Windows renvoie une valeur appVersion de 4.0, avec appMinorVersion rapportant le premier chiffre à droite de la décimale. Dans IE 6 pour Windows, appMinorVersion renvoie une chaîne indiquant un numéro de code de rustine ou de version, tel que ;Q313675;. A utiliser avec d´extrêmes précautions. |
|
Exemple | |
var subVer = navigator.appMinorVersion; |
|
Valeur | |
Chaîne. |
|
Par défaut | |
Varie en fonction de la version du navigateur. |
appName | NN 2 IE 3 DOM s.o. |
Lecture seule | |
Révèle le nom de modèle du navigateur. |
|
Exemple | |
var isNav = navigator.appName == "Netscape"; |
|
Valeur | |
Valeurs sous forme de chaîne. NN: "Netscape"; IE: "Microsoft Internet Explorer". Certains autres navigateurs renvoient ces valeurs pour sembler compatibles avec l´un des navigateurs courants. |
|
Par défaut | |
Varie en fonction du navigateur. |
appVersion | NN 2 IE 3 DOM s.o. |
Lecture seule | |
Révèle le numéro de version du moteur du navigateur, ainsi qu'un minimum d'informations sur la plate-forme du système d'exploitation (sous-ensemble des informations renvoyées par userAgent). Voici des exemples de valeurs renvoyées: |
|
Internet Explorer: 4.0 (compatible; MSIE 6.0; Windows 98; Q312461) 4.0 (compatible; MSIE 5.0; Macintosh; I; PPC) |
|
Navigator: 4.04 [en] (Win95; I) 5.0 (Macintosh; en-US) |
|
Remarque: Le numéro de version au début de la valeur (jusqu´au premier espace blanc) n´est pas indicatif de la version d´application du navigateur, mais du moteur de base. Ainsi, l´application IE des versions 4 à 6 (et peut-être ultérieures) rapporte le moteur version 4.0; Netscape 6 est fondé sur le moteur de génération 5.0. Les informations de version d´application de navigateur se trouvent ailleurs, dans appVersion, userAgent ou autres propriétés de l´objet navigator. N´utilisez pas le premier mot de la valeur appVersion pour une détection de version de navigateur qui contribue à déterminer quelles fonctionnalités de DOM ou du langage JavaScript sont prises en charge par le navigateur. Dans les navigateurs jusqu´à la version 4, cette propriété représentait la version d´application correctement, mais ce n´est plus le cas. |
|
Bien qu´il puisse sembler que la version de Microsoft Internet Explorer précise soit imbriquée dans la valeur de cette propriété (sous la forme MSIE X.XX), il arrive que les correspondances soient erronées pour certaines versions. Pour passer en revue cette partie de la chaîne de version, la propriété navigator.userAgent est plus fiable. |
|
Exemple | |
var isVer4Min = parseInt(navigator.appVersion) >= 4; |
|
Valeur | |
Chaîne. |
|
Par défaut | |
Varie en fonction du navigateur. |
browserLanguage | NN s.o. IE 4 DOM s.o. |
Lecture seule | |
Fournit la langue écrite par défaut du navigateur. L'équivalent dans Navigator est la propriété navigator.language. |
|
Exemple | |
var browLangCode = navigator.browserLanguage; |
|
Valeur | |
Code linguistique sous forme de chaîne non sensible à la casse. |
|
Par défaut | |
Valeur par défaut du navigateur. |
cpuClass | NN s.o. IE 4 DOM s.o. |
Lecture seule | |
Renvoie une référence sous forme de chaîne indiquant le type de processeur de l'ordinateur client. Les microprocesseurs de type Intel ordinaires (c'est-à-dire les processeurs de classe Pentium et les processeurs Macintosh utilisant des émulateurs Windows) renvoient la chaîne x86, tandis que les PowerPC Macintosh renvoient la chaîne PPC. Cette valeur vous renseigne uniquement sur la classe matérielle de base, pas sur le système d'exploitation, la vitesse du processeur ou le modèle. |
|
Exemple | |
if (navigator.cpuClass == "PPC") { // statements specific to PowerPC clients } |
|
Valeur | |
Chaîne. |
|
Par défaut | |
Dépend du matériel du client. |
language | NN 4 IE s.o. DOM s.o. |
Lecture seule | |
Indique la langue écrite pour laquelle la version du navigateur a été créée. La langue est spécifiée dans la combinaison de code linguistique ISO 639 (par exemple en-us). Internet Explorer fournit ces informations via la propriété navigator.browserLanguage. |
|
Exemple | |
var mainLang = navigator.language; |
|
Valeur | |
Code linguistique sous forme de chaîne non sensible à la casse. |
|
Par défaut | |
Valeur par défaut du navigateur. |
mimeTypes | NN 4 IE 5(Mac) DOM s.o. |
Lecture seule | |
Renvoie un tableau des objets mimeType pris en charge par les plug-ins installés dans le navigateur. IE pour Windows fournit cette propriété pour assurer la compatibilité syntaxique, mais elle renvoie toujours un tableau de longueur zéro. Voir l'objet mimeType. |
|
Exemple | |
var videoPlugin = navigator.mimeTypes["video/mpeg"].enabledPlugin; |
|
Valeur | |
Tableau d´objets mimeType. |
|
Par défaut | |
Valeur par défaut du navigateur. |
onLine | NN s.o. IE 4 DOM s.o. |
Lecture seule | |
Indique si le navigateur est paramétré pour la navigation en ligne ou hors ligne (dans le menu Fichier de Microsoft Internet Explorer). Il est possible que certaines pages cherchent à invoquer des actions du serveur en temps réel lors de leur chargement en ligne mais évitent de le faire hors ligne. Utilisez cette propriété booléenne pour créer de telles instructions conditionnelles. |
|
Exemple | |
if (navigator.onLine) { document.write("<applet ...>"); ... } |
|
Valeur | |
Valeur booléenne: true | false. |
|
Par défaut | |
true |
oscpu | NN 6 IE s.o. DOM s.o. |
Lecture seule | |
Renvoie une chaîne contenant les informations de système d´exploitation ou d´unité centrale pour la machine client. Les valeurs varient énormément en fonction des différents systèmes. En gros, les clients Windows se divisent en deux catégories: non NT et NT. La première catégorie inclut Windows 95, 98 et ME (valeurs oscpu de Win95, Win98 et Win 9x 4.90, respectivement). La catégorie NT inclut Windows NT 4 (WinNT4.0) et Windows XP (Windows NT x.x). Les systèmes Macintosh rapportent tous le type d´unité centrale et l´absence ou la présence de Mac OS X (PPC ou PPC Mac OS X). Les systèmes Unix rapportent le type de système d´exploitation ET d´unité centrale. La valeur oscpu fait aussi partie de la valeur userAgent. Dans Internet Explorer, le formatage de ces informations est différent pour les propriétés cpuClass ou userAgent correspondantes. |
|
Exemple | |
if (navigator.oscpu.indexOf("Win") != -1) { document.write("You are running a Windows computer."); } |
|
Valeur | |
Chaîne. |
|
Par défaut | |
Dépend du système. |
platform | NN 4 IE 4 DOM s.o. |
Lecture seule | |
Renvoie le nom du système d'exploitation ou de la plate-forme matérielle du navigateur. Pour un PC Windows 95/NT, la valeur est Win32 et, pour un Macintosh équipé d'un processeur PowerPC, la valeur est MacPPC. Les valeurs renvoyées dans Navigator et Internet Explorer concordent pour les principales plates-formes testées. L'utilisation de cette propriété pour déterminer les capacités du client dans une expression conditionnelle permet d'optimiser la page en fonction du client. |
|
Exemple | |
if (navigator.platform == "Win32") { document.write("<link rel='stylesheet' type='text/css' href='css/stylePC.css'>"); } |
|
Valeur | |
Chaîne. |
|
Par défaut | |
Dépend du système. |
plugins[] | NN 3 IE 5(Mac) DOM s.o. |
Lecture seule | |
Renvoie une collection d´objets plug-in reconnus par le navigateur pour faciliter la détermination par script des supports externes pris en charge par le navigateur. IE 4 et versions ultérieures pour Windows implémentent cette propriété, mais seulement comme paramètre fictif qui renvoie toujours un tableau de longueur zéro. Voir les objets mimeType et plugin. |
|
Exemple | |
var plugInCount = navigator.plugins.length; |
|
Valeur | |
Tableau des références des objets plugin. |
|
Par défaut | |
Aucune. |
product, productSub | NN 6 IE s.o. DOM s.o. |
Lecture seule | |
Renvoie une chaîne qui identifie le moteur logiciel derrière le navigateur. Dans Netscape 6, la propriété product renvoie Gecko et la propriété productSub renvoie un numéro de version de développement (sous forme de chaîne). |
|
Exemple | |
var prod = navigator.product; |
|
Valeur | |
Chaîne. |
|
Par défaut | |
Dépend du navigateur. |
securityPolicy | NN 4 IE s.o. DOM s.o. |
Lecture seule | |
Renvoie une chaîne dans Navigator 4 révélant le niveau de cryptage du navigateur (c´est-à-dire la politique de cryptage intérieur ou d´exportation que le navigateur respecte). Avec le rel chement des lois américaines d´exportation sur le cryptage, Netscape 6 implémente un type de cryptage dans toutes les versions. Dans Netscape 6, cette propriété renvoie une chaîne vide. |
|
Valeur | |
Chaîne. |
|
Par défaut | |
Aucune. |
systemLanguage | NN s.o. IE 4 DOM s.o. |
Lecture seule | |
Spécifie le code de la langue écrite par défaut utilisée par le système d'exploitation. Si vous disposez d'un contenu multilingue, vous pouvez utiliser cette propriété pour insérer du contenu dans des langues spécifiques. |
|
Exemple | |
if (navigator.systemLanguage == "nl") {
// document.write() some Dutch content
}
|
|
Valeur | |
Code de langue insensible à la casse. |
|
Par défaut | |
Généralement, le paramétrage par défaut du navigateur (en pour la version anglaise de Microsoft Internet Explorer disponible aux Etats-Unis). |
userAgent | NN 2 IE 3 DOM s.o. |
Lecture seule | |
Fournit des informations sur le logiciel du navigateur, notamment sa version, son système d'exploitation et sa marque. Il s'agit de l'ensemble d'informations le plus complet sur le navigateur, tandis que les propriétés appVersion et appName fournissent un sous-ensemble de données (qui, en plus, ne sont pas toujours correctes). Pour IE et Navigator, voici à quoi ressemblent généralement les données obtenues gr ce à la propriété userAgent: Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461) Mozilla/5.0 (Macintosh; U; PPC; en-US; rv:0.9.4) Gecko/20011022 Netscape6/6.2 |
|
Ne vous fiez pas à la longueur ou à la position d'une partie de ces données; il peut y avoir des variations en fonction du navigateur, de la version et du serveur proxy utilisé côté client. Utilisez plutôt la méthode indexOf() pour vérifier la présence d'une chaîne souhaitée. Pour extraire uniquement le numéro de version de l´application pour IE, utilisez la fonction suivante: function readIEVersion( ) { var ua = navigator.userAgent; var IEOffset = ua.indexOf("MSIE "); return parseFloat(ua.substring(IEOffset + 5, ua.indexOf(";", IEOffset))); } |
|
Exemple | |
if (navigator.userAgent.indexOf("MSIE") != -1) { var isIE = true; } |
|
Valeur | |
Chaîne. |
|
Par défaut | |
Dépend du navigateur. |
userLanguage | NN s.o. IE 4 DOM s.o. |
Lecture seule | |
Langue par défaut du navigateur, déterminée sur la base du paramétrage du profil utilisateur du système d'exploitation (s'il existe). Par défaut, cette propriété est paramétrée sur browserLanguage. |
|
Exemple | |
var userLangCode = navigator.userLanguage; |
|
Valeur | |
Code linguistique sous forme de chaîne non sensible à la casse. |
|
Par défaut | |
Valeur par défaut du navigateur. |
userProfile | NN s.o. IE 4 DOM s.o. |
Lecture seule | |
La propriété userProfile est elle-même un objet permettant aux scripts de demander l'autorisation d'accéder aux informations personnelles stockées dans le profil utilisateur du visiteur (pour les versions Win32 de Microsoft Internet Explorer). Voir l'objet userProfile. |
|
Exemple | |
navigator.userProfile.addReadRequest("vcard.displayname"); navigator.userProfile.doReadRequest("3", "MegaCorp Customer Service"); var custName = navigator.userProfile.getAttribute("vcard.displayname"); navigator.userProfile.clearRequest(); if (custName) { ... } |
|
Valeur | |
Référence de l'objet userProfile. |
|
Par défaut | |
Valeur par défaut du navigateur. |
vendor, vendorSub | NN 6 IE s.o. DOM s.o. |
Lecture seule | |
Renvoie une chaîne qui identifie le produit de navigateur qui utilise le moteur Mozilla. Dans Netscape 6, la propriété vendor renvoie Netscape6, alors que Netscape 7 renvoie simplement Netscape. La propriété vendorSub renvoie le numéro de version exact (sous forme de chaîne). Si vous voulez tester pour une version minimum, convertissez la valeur navigator.vendorSub en nombre décimal à virgule flottante avant d´effectuer une comparaison par rapport à vos spécifications minimum. |
|
Exemple | |
if (parseFloat(navigator.vendorSub, 10) >= 6.2) { // OK, meets minimum NN requirement } |
|
Valeur | |
Chaîne. |
|
Par défaut | |
Dépend du navigateur. |
javaEnabled() | NN 3 IE 4 DOM s.o. |
Indique si Java est activé sur le navigateur. Cette propriété ne vous sera d'aucune utilité dans un navigateur ne prenant pas en charge les scripts (ou un navigateur prenant en charge les scripts, mais pas la propriété); en revanche, si les scripts sont activés, elle vous indique si Java est désactivé dans les préférences du navigateur. |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Valeur booléenne: true | false. |
preference() | NN 4 IE s.o. DOM s.o. |
preference(nom[, valeur]) | |
Dans Navigator 4, les scripts signés permettent d'accéder à un vaste éventail de paramètres de préférences utilisateur. Ceux-ci sont extrêmement détaillés, indiquant, par exemple, si l'utilisateur a choisi de pouvoir télécharger des images ou si les feuilles de style sont activées. La plupart de ces paramètres sont destinés aux scripts utilisés par les administrateurs réseau pour installer et contrôler les paramètres utilisateur du déploiement de Navigator à l'échelle d'une entreprise. Pour plus de détails sur ces paramètres de préférences, consultez le site Web de Netscape consacré aux développeurs (http://developer.netscape.com/docs/manuals/communicator/preferences/). Netscape 6 renvoie une exception de sécurité lors de l´appel de cette méthode (même avec les scripts signés), mais la méthode fonctionne avec les scripts signés dans Netscape 7. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Valeur de préférence pour toutes sortes de types de données. |
taintEnabled() | NN 3 IE 4 DOM s.o. |
Indique si l'option de corruption de données est activée dans le navigateur. Ce mécanisme de sécurité n'a jamais été pleinement implémenté dans Navigator; en revanche, la méthode servant à détecter sa présence est encore incluse dans les dernières versions, afin d'assurer la compatibilité ascendante. Internet Explorer l'inclut également, pour la même raison, même si la valeur renvoyée est toujours false. |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Valeur booléenne: true | false. |