GlobalNN 2 IE 3 ECMA 1

L´objet Global est présent dans tous les cadres et fenêtres d´un navigateur activé JavaScript (il est automatiquement créé pour vous). Vous ne faites jamais référence à l´objet explicitement, mais vous référencez ses propriétés et ses méthodes pour réaliser des t ches telles que la conversion de chaînes en nombres (par le biais des méthodes parseInt() ou parseFloat()). Les propriétés se comportent comme des constantes et s´évaluent donc elles-mêmes. En tant qu´objet avec une portée globale, il présente ses éléments aux instructions de script dans l´ensemble de la page.

 
Propriétés
 
InfinityNaNundefined
 
Méthodes
 
atob()btoa()decodeURI()
decodeURIComponent()encodeURI()encodeURIComponent()
escape()eval()GetObject()
isFinite()isNaN()parseInt()
parseFloat()ScriptEngine()ScriptEngineBuildVersion()
ScriptEngineMajorVersion()ScriptEngineMinorVersion()unescape()
unwatch()watch()
InfinityNN 4 IE 4 ECMA 1

Lecture seule

Fournit une infinité numérique positive (ou rendue négative avec l´opérateur -). Entendons-nous bien, il s´agit d´une infinité pratique, pas théorique. Tout nombre plus petit que Number.MIN_VALUE ou plus grand que Number.MAX_VALUE est une valeur infinie dans l´univers JavaScript. Intéressant, non ?

 
Exemple
 
var authorEgo = Infinity;
 
Valeur

Infinity

NaNNN 3 IE 4 ECMA 1

Lecture seule

Il s´agit d´une valeur autre qu'un nombre. JavaScript renvoie cette valeur lorsqu'une opération numérique produit un résultat non numérique en raison d'une erreur de l'un des opérandes. Si vous voulez vérifier si une valeur n'est pas un nombre, utilisez la fonction globale isNaN() au lieu d'effectuer une comparaison avec la valeur de cette propriété. Cette propriété globale est la valeur à laquelle Number.NaN est évaluée.

 
Valeur

NaN

undefinedNN 6 IE 5.5(Win) ECMA 2

Lecture seule

Bien que le type de données undefined soit présent dans ECMAScript et dans les navigateurs depuis les tout débuts, ce n´est que récemment qu´il est devenu une propriété officielle de l´objet Global. Bien que sa compatibilité soit considérée comme récente, vous pouvez utiliser son type de données (à laquelle on accède sous forme de chaîne par le biais de l´opérateur typeof) dans les anciens navigateurs.

 
Valeur

undefined

decodeURI()NN 6 IE 5.5(Win) ECMA 3

decodeURI("encodedURI")

Renvoie une chaîne avec la plupart des valeurs codées URI dans le paramètre restaurées à leurs symboles d´origine. Ne fonctionne que sur les caractères codés qui peuvent l´être par le biais de la méthode encodeURI().

 
Paramètres
 
  • Une chaîne contenant un URI codé complet ou relatif.
 
Valeur renvoyée

Chaîne.

atob(), btoa()NN 4 IE s.o. ECMA s.o.

atob("base64EncodedData") btoa("stringToBeEncoded")

Ces méthodes vous permettent de convertir des chaînes arbitraires (y compris les chaînes comportant des caractères représentant des données binaires et des valeurs Unicode) en un sous-ensemble de 65 caractères du jeu de caractères ASCII américain. Le codage dans ce système base64 permet à n´importe quelle donnée d´être transmise même le long du mécanisme de transport le plus rudimentaire. Vous pouvez consulter la logique et les mécanismes internes des conversions de codage/décodage dans RFC 1521 d´Internet Engineering Task Force (http://www.ietf.org/rfc/rfc2045.txt).

 

Utilisez la méthode btoa() pour coder les données de chaîne dans le système base64. Les données codées résultantes seront composées de caractères ASCII a-z, A-Z, 0-9, et de trois symboles (/, +, =). Utilisez la méthode atob() pour décoder les données codées en base64 et restaurer leur version d´origine.

 
Paramètres
 
  • Une chaîne contenant des données en base64 codées par le client ou reçues comme partie d´un document venant d´un serveur qui effectue son propre codage.
  • Des caractères de chaîne à coder en base64 pour une utilisation interne ou externe. Par exemple, une valeur codée pourrait être affectée à la propriété value d´un élément input afin de l´envoyer à un processus de serveur conçu pour recevoir des données base64.
 
Valeur renvoyée

Chaîne.

decodeURIComponent()NN 6 IE 5.5(Win) ECMA 3

decodeURIComponent("encodedURIComponent")

Renvoie une chaîne avec toutes les valeurs codées URI dans le paramètre restaurées à leurs symboles d´origine. Conçue pour être utilisée sur les portions de données d´un URI, à l´exception du protocole.

 
Paramètres
 
  • Une chaîne contenant un URI codé complet ou relatif ou des portions de cet URI.
 
Valeur renvoyée

Chaîne.

encodeURI()NN 6 IE 5.5(Win) ECMA 3

encodeURI("URIString")

Renvoie une chaîne avec la plupart des valeurs pouvant être codées URI dans le paramètre converties à leurs versions codées (par exemple, un espace est converti en %20). Cette méthode exclut les caractères suivants des conversions:

;  /  ?  :  @ &  =  +  $  ,  # 
 

Ces caractères sont des symboles valides tels quels dans les chaînes URI et ne doivent pas être convertis; leur conversion pourrait rendre l´URI invalide.

 
Paramètres
 
  • Une chaîne contenant un URI en clair complet ou relatif.
 
Valeur renvoyée

Chaîne.

encodeURIComponent()NN 6 IE 5.5(Win) ECMA 3

encodeURIComponent("URIComponentString")

Renvoie une chaîne avec tous les caractères sauf les lettres du jeu de caractères latins A à Z (minuscules et majuscules), les chiffres 0 à 9, et un jeu de symboles compatibles avec les URI (- _ . ! ~ * ( ) ' space) convertis à leur version codée (le symbole % suivi de la version hexadécimale de leur valeur Unicode). Conçue pour être utilisée sur les portions de données d´un URI, à l´exception du protocole.

 
Paramètres
 
  • Une chaîne contenant un URI en clair complet ou relatif ou des portions de cet URI.
 
Valeur renvoyée

Chaîne.

escape()NN 2 IE 3 ECMA |1|

escape("string"[, 1])

Renvoie une version codée sous forme d'adresse URL de la chaîne passée en paramètre à la fonction. Le codage URL convertit la plupart des caractères non alphanumériques (sauf * _ + - . / et, dans IE, @) en valeurs hexadécimales (telles que %20 pour le caractère d´espacement). En général, les chaînes codées sous forme d'adresse URL ne comprennent pas le signe +, qui est utilisé pour séparer les composants des chaînes de recherche. Si vous devez toutefois encoder le signe +, Navigator 4 (uniquement) propose un deuxième paramètre (le chiffre 1) pour activer ce commutateur. Remarque: Dans IE 5.5 pour Windows et Netscape 6, cette méthode a été délaissée au profit des méthodes encodeURI() et encodeURIComponent() . Cette méthode a été supprimée de la spécification ECMA 3.

 
Paramètres
 
  • Toute chaîne de texte.
 
Valeur renvoyée

Chaîne.

eval()NN 2 IE 3 ECMA 1

eval("string")

Renvoie une référence de l'objet décrit sous forme de chaîne dans le paramètre de la fonction. Par exemple, si un formulaire présente une suite de champs de texte appelés entry1, entry2, entry3, etc., vous pouvez utiliser une boucle for pour rechercher tous les éléments par leur nom si vous confiez à la fonction eval() le soin de convertir la représentation sous forme de chaîne de ces noms en des références d'objets:

for (var i = 1; i<=5; i++) {
    oneField = eval("document.forms[0].entry" + i);
    oneValue = oneField.value;
    ...
} 
 

Sachez cependant que la méthode eval() est peut-être la méthode la plus inefficace et la plus « gourmande » en termes de performance de tout le langage JavaScript. Il existe bien d´autres façons, beaucoup plus efficaces de référencer un objet de l´arborescence de documents lorsque vous n´avez que le nom ou l´ID sous forme de chaîne ID, comme document.getElementById() et, pour les navigateurs plus anciens, les index nommés des tableaux document.forms, document.images et document.formRef.elements.

 
Paramètres
 
  • Toute représentation de chaîne d'une référence d'objet.
 
Valeur renvoyée

Référence d´objet

GetObject()NN s.o. IE 5(Win) ECMA s.o.

GetObject("localPathName"[, appName.objectType])

Renvoie une référence à un objet ActiveX hébergé sur la machine client dont le script connaît le nom de chemin. C´est une solution qui peut remplacer la création d´un ActiveXObject. En plus de spécifier le nom de chemin du contrôle, vous pouvez nommer un fichier de données à ouvrir en même temps que l´application du contrôle. Ajoutez un point d´exclamation et le nom du fichier au paramètre localPathName. Pour en savoir plus sur l´invocation des objets ActiveX (aussi appelés objets d´automatisation), visitez: http://msdn.microsoft.com/scripting/jscript/doc/jsobjActiveXObject.htm.

 
Paramètres
 
  • Une chaîne contenant un nom de chemin complet (volume compris) à l´objet d´automatisation.
  • Syntaxe habituelle pour référencer une application et un type d´objet particuliers pris en charge par l´objet d´automatisation dont le chemin est spécifié dans le premier paramètre.
 
Valeur renvoyée

Référence d´objet

isFinite()NN 4 IE 4 ECMA 1

isFinite(expression)

Renvoie la valeur booléenne true si le nombre passé en paramètre se situe entre Number.MIN_VALUE et Number.MAX_VALUE. Si des valeurs de chaîne sont passées en paramètres, la fonction renvoie la valeur false.

 
Paramètres
 
  • Toute expression JavaScript.
 
Valeur renvoyée

Valeur booléenne: true | false.

isNaN()NN 2 IE 3 ECMA 1

isNaN(expression)

Renvoie la valeur booléenne true si l'expression passée en paramètre ne peut être évaluée comme valeur numérique. Pour toute expression qui est évaluée à NaN (comme l´exécution de parseInt() sur une chaîne ne commençant pas par une valeur numérique), la méthode isNaN() renvoie true.

 
Paramètres
 
  • Toute expression JavaScript.
 
Valeur renvoyée

Valeur booléenne: true | false.

parseInt()NN 2 IE 3 ECMA 1

parseInt("string "[, radix])

Renvoie un nombre entier (sous la forme d´un type de données numériques en base 8 ou en base 10) des chiffres de la chaîne transmise comme paramètre. La valeur de chaîne doit au moins commencer par un chiffre; sinon, le résultat est NaN. Si la chaîne commence par un chiffre mais se poursuit par des lettres ou inclut des espaces blancs, seuls les premiers chiffres jusqu´au premier caractère non numérique ou au premier espace blanc sont convertis en nombres entiers. Vous pouvez donc utiliser l'expression

 

pour extraire uniquement le numéro entier de version qui figure au début de la longue chaîne renvoyée par cette propriété.

 

Un paramètre facultatif permet de spécifier la base du nombre passé à la fonction. Une chaîne numérique qui commence par zéro est normalement traitée comme un nombre octal, ce qui donne une réponse erronée. Il est préférable d'utiliser une valeur en base 10 pour toutes les fonctions parseInt() si tous les traitements sont basés sur des nombres en base 10.

 
Paramètres
 
  • Toute chaîne commençant par un ou plusieurs chiffres.
  • Nombre entier de la base n, où n est le nombre transmis comme paramètre (par exemple 2, 8, 10, 16).
 
Valeur renvoyée

Nombre entier.

parseFloat()NN 2 IE 3 ECMA 1

parseFloat(string)

Renvoie une valeur numérique (un nombre entier ou en virgule flottante) des chiffres passés en paramètres dans la chaîne. La valeur de chaîne doit au moins commencer par un chiffre; sinon, le résultat est NaN. Si la chaîne commence par un chiffre mais se poursuit par des lettres, seuls les premiers chiffres sont convertis en nombres entiers. Vous pouvez donc utiliser l'expression

 

pour extraire uniquement le chiffre complet de la version (par exemple 4.03) figurant au début de la longue chaîne renvoyée par cette propriété.

 

Si la valeur convertie n'a pas de valeur autre que zéro à droite de la décimale, la valeur renvoyée est un nombre entier. Les valeurs en virgule flottante ne sont renvoyées que lorsque le chiffre l'exige.

 
Paramètres
 
  • Toute chaîne commençant par un ou plusieurs chiffres.
 
Valeur renvoyée

Nombre.

ScriptEngine(), ScriptEngineBuildVersion(), ScriptEngineMajorVersion(), ScriptEngineMinorVersion()NN s.o. IE 4 ECMA s.o.

Ces fonctions, disponibles uniquement dans Internet Explorer, donnent des informations sur le moteur de scripts (JScript, VBScript ou VBA) utilisé pour invoquer la méthode et la version installée de ce moteur de scripts. Pour JScript, la version fait référence à la version du fichier Jscript.dll installé parmi les fichiers de prise en charge du navigateur. La version principale est représentée par le numéro de version qui se trouve à gauche de la décimale; la version secondaire se trouve à droite de la décimale. Microsoft utilise également un numéro de version interne pour garder une trace des différentes versions lors du développement et de la commercialisation.

 
Paramètres

Aucune.

 
Valeur renvoyée

ScriptEngine() renvoie une chaîne de l'un des noms de moteur suivant: JScript | VBA | VBScript. Toutes les autres fonctions renvoient des nombres entiers.

unescape()NN 2 IE 3 ECMA |1|

unescape(string)

Renvoie une version décodée de la chaîne encodée sous forme d'adresse URL passée en paramètre à la fonction. Le codage URL convertit les caractères non alphanumériques (sauf * _ + - . / et, dans IE, @) en valeurs hexadécimales (telles que %20 pour le caractère d´espacement). Remarque: Dans IE 5.5 pour Windows et Netscape 6, cette méthode a été délaissée au profit des méthodes decodeURI() et decodeURIComponent() . Cette méthode a été supprimée de la spécification ECMA 3.

 
Paramètres
 
  • Toute valeur de chaîne encodée sous forme d'adresse URL.
 
Valeur renvoyée

Chaîne.

unwatch(), watch()NN 4 IE s.o. ECMA s.o.

unwatch(property) watch(property, funcHandler)

Ces fonctions, disponibles uniquement dans Navigator, sont principalement utilisées par les débogueurs JavaScript. Lorsqu'une instruction appelle la fonction watch() pour un objet, elle transmet en paramètres la propriété dont la valeur doit être surveillée et la référence à la fonction à appeler lorsque la valeur de la propriété est modifiée par une instruction d'affectation. Pour désactiver cette supervision, appelez la fonction unwatch() en lui passant en paramètre la propriété désignée précédemment.

 
Paramètres
 
  • Nom de la propriété d'objet à surveiller.
  • Nom de la fonction (sans parenthèses) à appeler en cas de modification de la valeur de la propriété surveillée.
 
Valeur renvoyée

Aucune.