Global | NN 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 | |||||||||||||||||||||
|
|||||||||||||||||||||
Méthodes | |||||||||||||||||||||
|
Infinity | NN 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 |
NaN | NN 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 |
undefined | NN 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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
Valeur renvoyée | |
Aucune. |