navigatorNN 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
 
  • navigator
  • [window.]navigator
 
Propriétés spécifiques à l´objet
 
appCodeNameappMinorVersionappNameappVersion
browserLanguagecookieEnabledcpuClasslangage
mimeTypes[]onLineoscpuplatform
pluginsSQUAREBRACproductproductSubsecurityPolicy
systemLanguageuserAgentuserLanguageuserProfile
vendorvendorSub
 
Méthodes spécifiques à l´objet
 
javaEnabled()preference()taintEnabled()
 
Propriétés de gestionnaire d´événements spécifiques à l´objet

Aucune.

appCodeNameNN 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

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

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

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

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

cookieEnabledNN 6 IE 4 DOM s.o.

Lecture seule

Renvoie une information indiquant si le navigateur permet la lecture et l'écriture de données de cookie.

 
Exemple
 
if (cookieEnabled) {
    setCookieData(data);
}
 
Valeur

Valeur booléenne: true | false.

 
Par défaut

Varie en fonction du paramétrage de préférences du navigateur.

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

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

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

onLineNN 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

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

platformNN 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, productSubNN 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.

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

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

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

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

userProfileNN 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, vendorSubNN 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
 
  • Nom de la préférence, sous forme de chaîne, tel que general.always_load_images.
  • Valeur facultative permettant de définir la préférence nommée.
 
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.