String | NN 2 IE 3 ECMA 1 | |||||||||||||||||||||||||||||||||||
Un objet String représente une séquence de zéro ou plusieurs caractères qui doit être traitée comme du texte au sens strict (c'est-à-dire sans opération mathématique). Une vaste bibliothèque de méthodes comprend deux catégories. La première catégorie entoure les chaînes à l'aide de diverses paires de balises HTML de mise en forme. Ces méthodes sont essentiellement utilisées pour contrôler les instructions qui utilisent document.write() afin de créer du contenu de façon dynamique, mais leur fonctionnalité est désormais remplacée par les feuilles de style. Dans la deuxième catégorie essentielle figurent les méthodes plus traditionnelles d'analyse et de manipulation de chaînes qui facilitent la recherche et la copie de caractères et de sous-chaînes, les changements de casse et la conversion de listes de chaînes en tableaux JavaScript. |
||||||||||||||||||||||||||||||||||||
Autrement dit, tout ce que vous devez faire, pour créer une chaîne, c'est affecter une valeur de chaîne entre guillemets: var myString = "howdy"; |
||||||||||||||||||||||||||||||||||||
Il peut néanmoins être utile de créer une chaîne à l'aide du constructeur de l'objet statique String. La préparation des valeurs sous forme de chaîne qui seront ensuite passées à des appliquettes Java requiert généralement ce type d'opération de génération de chaîne: var myString = new String("howdy"); |
||||||||||||||||||||||||||||||||||||
Toutes les propriétés et méthodes autres que le constructeur, la propriété prototype et la méthode fromCharCode(), sont utilisées avec des instances de l'objet String plutôt qu'avec l'objet String statique. |
||||||||||||||||||||||||||||||||||||
Propriétés | ||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||
Méthodes | ||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||
Création d'un objet String | ||||||||||||||||||||||||||||||||||||
var myValue = "someString"; var myValue = new String("someString"); |
constructor | NN 4 IE 4 ECMA 1 |
Lecture/écriture | |
Il s´agit d´une référence à la fonction qui a créé l´instance d´un objet String: la fonction constructeur String() d´origine dans les navigateurs. |
|
Exemple | |
if (myVar.constructor == String) { // process native string } |
|
Valeur | |
Référence de l´objet de fonction. |
length | NN 2 IE 3 ECMA 1 |
Lecture seule | |
Fournit le nombre de caractères de la chaîne. Les valeurs sous forme de chaîne changent de longueur de façon dynamique en cas d'affectation de nouvelles valeurs ou de concaténation de chaînes. |
|
Exemple | |
for (var i = 0; i < myString.length; i++) { ... } |
|
Valeur | |
Nombre entier. |
prototype | NN 3 IE 4 ECMA 1 |
Lecture/écriture | |
Propriété de l'objet String statique. Utilisez la propriété prototype pour affecter de nouvelles propriétés et méthodes aux instances ultérieures d'une valeur String créée dans le document considéré. Pour des exemples, voir la description de la propriété Array.prototype. |
|
Exemple | |
String.prototype.author = "DG"; |
|
Valeur | |
N´importe quelle donnée, y compris des références à des fonctions. |
anchor() | NN 2 IE 3 ECMA s.o. |
anchor("anchorName") | |
Renvoie une copie de la chaîne imbriquée dans un jeu de balises d'ancre (<a>). La valeur transmise comme paramètre est affectée à l'attribut name de la balise. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Chaîne contenue dans un élément a. |
big() | NN 2 IE 3 ECMA s.o. |
Renvoie une copie de la chaîne incorporée dans un jeu de balises <big>. |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Chaîne contenue dans un élément big. |
blink() | NN 2 IE 3 ECMA s.o. |
Renvoie une copie de la chaîne imbriquée dans un jeu de balises <blink>. |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Chaîne contenue dans un élément blink. |
bold() | NN 2 IE 3 ECMA s.o. |
Renvoie une copie de la chaîne imbriquée dans un jeu de balises <b>. |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Chaîne contenue dans un élément b. |
charAt() | NN 2 IE 3 ECMA 1 |
charAt() | |
Renvoie une chaîne contenant uniquement le caractère se trouvant à la position de l'index à base zéro passé en paramètre. Utilisez cette méthode de préférence à substring() lorsqu'un seul caractère d'une position connue d'une chaîne suffit. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Chaîne contenant un seul caractère. Dans les navigateurs récents, une chaîne vide est renvoyée lorsque la valeur du paramètre pointe sur un caractère au-delà de la longueur de la chaîne. |
charCodeAt() | NN 4 IE 4 ECMA 1 |
charCodeAt() | |
Renvoie une valeur Unicode décimale du caractère se trouvant à la position de l'index à base zéro passé en paramètre. Pour les caractères alphanumériques communs, les valeurs Unicode correspondent aux valeurs ASCII. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Tout entier positif. Renvoie NaN si la valeur du paramètre pointe sur un caractère au-delà de la longueur de la chaîne. |
concat() | NN 4 IE 4 ECMA s.o. |
concat(chaîne2) | |
Renvoie une chaîne qui ajoute la chaîne du paramètre à l'objet chaîne considéré. Cette méthode équivaut à concaténer des chaînes à l'aide des opérateurs add (+) ou add-by-value (+=). Ni la méthode ni les opérateurs n'insèrent d'espaces entre les deux chaînes. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Chaîne. |
fixed() | NN 2 IE 3 ECMA s.o. |
Renvoie une copie de la chaîne imbriquée dans un jeu de balises <tt>. |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Chaîne contenue dans un élément tt. |
fontcolor() | NN 2 IE 3 ECMA s.o. |
fontColor(couleur) | |
Renvoie une copie de la chaîne imbriquée dans un jeu de balises de police (<font>). La valeur transmise comme paramètre est affectée à l'attribut color de la balise. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Chaîne contenue dans un élément font. |
fontsize() | NN 2 IE 3 ECMA s.o. |
fontSize(taille) | |
Renvoie une copie de la chaîne imbriquée dans un jeu de balises de police (<font>). La valeur transmise comme paramètre est affectée à l'attribut size de la balise. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Chaîne contenue dans un élément font. |
fromCharCode() | NN 4 IE 4 ECMA 1 |
fromCharCode(nombre1, [, nombre2,[...nombreN]]) | |
Méthode statique qui renvoie une chaîne d'un ou plusieurs caractères dont les valeurs Unicode sont transmises en tant que liste de paramètres séparés par des virgules. Par exemple, l'expression: String.fromCharCode(120, 121, 122) |
|
renvoie "xyz". |
|
Paramètres | |
|
|
Valeur renvoyée | |
Chaîne. |
indexOf() | NN 2 IE 3 ECMA 1 |
indexOf([, ]) | |
Renvoie un nombre entier à base zéro qui reflète la position de début du paramètre searchString dans la chaîne considérée. Généralement, la recherche commence par le premier caractère (index zéro); pour faire en sorte qu'elle commence plus loin dans la chaîne, il faut spécifier le deuxième paramètre facultatif désignant la valeur d'index de l'endroit où doit commencer la recherche. En l'absence de correspondance, la valeur renvoyée est -1. Il s´agit d´une méthode rapide et assurant la compatibilité ascendante pour découvrir si une chaîne en contient une autre: Si la valeur renvoyée est -1, cela indique que la chaîne de plus grande taille ne contient pas searchString. Si la valeur renvoyée est un autre nombre (quelle que soit sa valeur), cela signifie que la chaîne de plus grande taille contient . Dans les navigateurs qui prennent les expressions régulières en charge, la méthode search() de l'objet String joue un rôle équivalent. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Nombre entier. |
italics() | NN 2 IE 3 ECMA s.o. |
Renvoie une copie de la chaîne imbriquée dans un jeu de balises <i>. |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Chaîne contenue dans un élément i. |
lastIndexOf() | NN 2 IE 3 ECMA 1 |
lastIndexOf([, ]) | |
Renvoie un nombre entier à base zéro indiquant la position de début du paramètre dans la chaîne considérée. Cette méthode fonctionne comme la méthode indexOf() mais elle commence toutes les recherches à partir de la fin de la chaîne ou d'une position d'index déterminée. Bien que la recherche commence à partir de la fin de la chaîne, le paramètre se base sur le début de la chaîne tout comme la valeur renvoyée. En l'absence de correspondance, la valeur renvoyée est -1. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Nombre entier. |
link() | NN 2 IE 3 ECMA s.o. |
link(URL) | |
Renvoie une copie de la chaîne imbriquée dans un jeu de balises d'ancre (<a>). La valeur transmise comme paramètre est affectée à l'attribut href de la balise. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Chaîne contenue dans un élément a. |
localeCompare() | NN 6 IE 5.5(Win) ECMA 3 |
localeCompare(string2) | |
Renvoie un nombre indiquant si la chaîne considérée est triée avant, en même temps que ou après la chaîne de paramètre, d´après la localisation des chaînes dépendant du navigateur et du système. Si la chaîne considérée est triée avant la chaîne de paramètre, la valeur renvoyée est un nombre négatif; si elles sont identiques, la valeur renvoyée est 0, et si la chaîne en question est triée après la chaîne de paramètre, la valeur renvoyée est un nombre positif. |
|
Utilisez cette méthode avec précautions si la chaîne contient des caractères n´appartenant pas au jeu de caractères latins car chaque navigateur peut déterminer quelles égalités de localisation sont en place. De plus, ils calculent les valeurs renvoyées différemment. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Nombre entier |
match() | NN 4 IE 4 ECMA 3 |
match() | |
Renvoie un tableau de chaînes se trouvant dans la chaîne considérée, qui correspondent à l'expression régulière transmise comme paramètre. Par exemple, si vous passez une expression régulière qui spécifie un nombre à cinq chiffres, la valeur de la méthode match() renvoyée est un tableau de tous les nombres à cinq chiffres (sous forme de chaîne) que contient la chaîne principale. Cette opération a une incidence sur les propriétés de l'objet statique RegExp. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Tableau de chaînes. |
replace() | NN 4 IE 4 ECMA 3 |
replace(, ) | |
Renvoie la nouvelle chaîne résultant du remplacement des correspondances du paramètre regexpression par le paramètre replaceString. La chaîne d´origine reste intacte, vous devez donc capturer la valeur renvoyée dans une variable pour préserver les modifications. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Chaîne. |
search() | NN 4 IE 4 ECMA 3 |
search() | |
Renvoie la valeur d'index à base zéro du premier caractère de la chaîne considérée correspondant au modèle du paramètre . Cette méthode est semblable à la méthode indexOf(), à la différence près que la recherche s'effectue à partir d'une expression régulière et pas d'une chaîne brute. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Nombre entier. |
slice() | NN 4 IE 4 ECMA 3 |
slice([, ]) | |
Renvoie une sous-chaîne de la chaîne considérée. La sous-chaîne est copiée à partir de la chaîne principale, en débutant à la valeur d'index à base zéro du caractère de la chaîne principale. A défaut de deuxième paramètre, la sous-chaîne s'étend jusqu'à la fin de la chaîne principale. Le deuxième paramètre, facultatif, peut être une autre valeur d'index à base zéro marquant la fin de la sous-chaîne. Il peut également s'agir d'une valeur négative allant de la fin au début de la chaîne. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Chaîne. |
small() | NN 2 IE 3 ECMA s.o. |
Renvoie une copie de la chaîne incorporée dans un jeu de balises <small>. |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Chaîne contenue dans un élément small. |
split() | NN 3 IE 4 ECMA 1 |
split(delimiter [, limitInteger]) | |
Renvoie un nouvel objet tableau dont les éléments sont des segments de la chaîne considérée. La chaîne considérée se compose d'entrées de tableau correspondant à chaque instance du séparateur sous forme de chaîne défini comme premier paramètre de la méthode. Le séparateur n'est pas inclus dans le tableau. Ne déclarez pas le tableau avant d'avoir obtenu les résultats de la méthode split(). Par exemple, si une chaîne comprend une liste de noms séparés par des virgules, vous pouvez convertir cette liste en un tableau de la façon suivante: var listArray = stringList.split(","); |
|
Vous pouvez également utiliser une expression régulière en guise de paramètre pour diviser la chaîne à l'aide d'une combinaison de caractères au lieu d'un caractère fixe. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Tableau. |
strike() | NN 2 IE 3 ECMA s.o. |
Renvoie une copie de la chaîne imbriquée dans un jeu de balises <strike>. |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Chaîne contenue dans un élément strike. |
sub() | NN 2 IE 3 ECMA s.o. |
Renvoie une copie de la chaîne incorporée dans un jeu de balises <sub>. |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Chaîne contenue dans un élément sub. |
substr() | NN 4 IE 4 ECMA s.o. |
substr(startPositionIndex [, length]) | |
Renvoie une copie d'un extrait de la chaîne considérée. L'extrait commence à la position d'index à base zéro de la chaîne considérée spécifiée par le premier paramètre de la méthode. A défaut d'autre paramètre, l'extrait continue jusqu'à la fin de la chaîne principale. Le deuxième paramètre peut désigner un nombre entier de caractères à extraire de la chaîne principale. En revanche, les paramètres de la méthode substring() pointent sur les valeurs d'index de position de début et de fin de la chaîne principale. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Chaîne. |
substring() | NN 2 IE 3 ECMA 1 |
substring([, ]) | |
Renvoie une copie d'un extrait de la chaîne considérée. L'extrait commence à la position d'index à base zéro de la chaîne considérée, spécifié par le premier paramètre de la méthode, et se termine juste avant le caractère dont l'index est determiné par le deuxième paramètre. Par exemple, "Frobnitz".substring(0,4) renvoie la sous-chaîne des positions 0 à 3: Frob. En revanche, les paramètres de la méthode substr() pointent sur la position de début de la chaîne principale et le nombre de caractères (longueur) à extraire. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Chaîne. |
sup() | NN 2 IE 3 ECMA s.o. |
Renvoie une copie de la chaîne incorporée dans un jeu de balises <sup>. |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Chaîne contenue dans un élément sup. |
toLocaleLowerCase(), toLocaleUpperCase() | NN 6 IE 5.5 ECMA 3 |
Renvoie une copie de la chaîne considérée en lettres majuscules ou minuscules. Fonctionne de la même façon que l´expression régulière, à l´exception de certains alphabets non latins avec des mappages de caractères qui peuvent nécessiter un traitement interne spécial. |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Chaîne. |
toLowerCase(), toUpperCase() | NN 2 IE 3 ECMA 1 |
Renvoie une copie de la chaîne considérée en lettres majuscules ou minuscules. Si vous voulez remplacer la casse de la chaîne considérée, affectez le résultat de la méthode à la même chaîne: myString = myString.toUpperCase( ); |
|
Le recours à l'une de ces méthodes est fréquent pour établir une comparaison non sensible à la casse, entre deux chaînes. C'est particulièrement commode lorsque l'utilisateur saisit l'une des chaînes à comparer, car il ne doit plus se soucier de la casse: if (document.forms[0].entry.value.toLowerCase( ) == compareValue) { ... } |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Chaîne. |
toString(), valueOf() | NN 4 IE 4 ECMA 1 |
Renvoient la valeur de l'objet sous forme de chaîne. |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Valeur de chaîne. |