StringNN 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
 
constructorlongueurprototype
 
Méthodes
 
anchor()big()blink()bold()
charAt()charCodeAt()concat()fixed()
fontcolor()fontsize()fromCharCode()indexOf()
italics()lastIndexOf()link()localeCompare()
match()replace()search()slice()
small()split()strike()sub()
substr()substring()sup()toLocaleLowerCase()
toLocaleUpperCase()toLowerCase()toString()toUpperCase()
valueOf()
 
Création d'un objet String
 
var myValue = "someString";
var myValue = new String("someString");
constructorNN 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.

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

prototypeNN 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
 
  • Chaîne à utiliser comme valeur de l'attribut name.
 
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
 
  • Nombre entier à base zéro.
 
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
 
  • Nombre entier à base zéro.
 
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
 
  • Toute chaîne de texte.
 
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
 
  • Chaîne à utiliser comme valeur de l'attribut color.
 
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
 
  • Nombre entier à utiliser comme valeur de l'attribut size.
 
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
 
  • Un ou plusieurs nombres entiers, sans guillemets, séparés par des virgules dans une liste.
 
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
 
  • Chaîne à rechercher dans la chaîne considérée.
  • Nombre entier à base zéro reflétant la position, dans la chaîne considérée, où doit débuter la recherche du premier paramètre.
 
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
 
  • Chaîne à rechercher dans la chaîne considérée.
  • Nombre entier à base zéro reflétant la position, dans la chaîne considérée, où doit débuter la recherche du premier paramètre. Bien que la recherche commence à partir de la fin de la chaîne, cette valeur de paramètre se réfère au début de la chaîne.
 
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
 
  • Chaîne à utiliser comme valeur de l'attribut href.
 
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
 
  • Toute chaîne de texte.
 
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
 
  • Objet expression régulière. Voir l'objet expression régulière pour en connaître la syntaxe.
 
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
 
  • Objet expression régulière. Si vous voulez que la méthode replace() agisse globalement sur la chaîne, définissez le commutateur global (g) sur l´expression régulière. Voir l'objet expression régulière pour en connaître la syntaxe.
  • Chaîne qui doit se substituer à toutes les correspondances de l'regexpression dans la chaîne considérée.
 
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
 
  • Objet expression régulière. Voir l'objet expression régulière pour en connaître la syntaxe.
 
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
 
  • Renvoie un nombre entier à base zéro indiquant la position, dans la chaîne considérée, où doit commencer la copie des caractères.
  • Renvoie un nombre entier à base zéro indiquant la position, dans la chaîne considérée, où doit se terminer la copie des caractères. Nombre de valeurs négatives de la fin au début de la chaîne.
 
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
 
  • Chaîne ou expression régulière qui définit à quel emplacement la chaîne principale est divisée en éléments repris dans le tableau.
  • Nombre entier facultatif qui détermine le nombre d'éléments convertis en éléments de tableau.
 
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
 
  • Renvoie un nombre entier à base zéro indiquant la position, dans la chaîne considérée, où doit commencer la copie des caractères.
  • Nombre entier facultatif de caractères à extraire, en commençant par le caractère que désigne le paramètre
 
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
 
  • Renvoie un nombre entier à base zéro indiquant la position, dans la chaîne considérée, où doit commencer la copie des caractères.
  • Renvoie un nombre entier à base zéro indiquant la position, dans la chaîne considérée, où doit se terminer la copie des caractères. En d´autres termes, la copie est faite à partir de startPositionIndex jusqu´à, mais sans l´inclure, le caractère à la position endPositionIndex.
 
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.