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
navigator [window.]navigator
Propriétés spécifiques à l´objet
appCodeName | appMinorVersion | appName | appVersion
browserLanguage | cookieEnabled | cpuClass | langage
mimeTypes[] | onLine | oscpu | platform
pluginsSQUAREBRAC | product | productSub | securityPolicy
systemLanguage | userAgent | userLanguage | userProfile
vendor | vendorSub |  |
Méthodes spécifiques à l´objet
javaEnabled() | preference() | taintEnabled()
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.

cookieEnabled | NN 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.

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