RegExp : proprit ignoreCase

Exemple interactif

const regex1 = /foo/;
const regex2 = /foo/i;

console.log(regex1.test("Football"));
// Rsultat attendu : false

console.log(regex2.ignoreCase);
// Rsultat attendu : true

console.log(regex2.test("Football"));
// Rsultat attendu : true

Description

RegExp.prototype.ignoreCase a la valeur true si l'indicateur i est utilis ; sinon, false. L'indicateur i indique que la casse doit tre ignore lors d'une tentative de correspondance dans une chane de caractres. La correspondance sans distinction de casse se fait en convertissant l'ensemble de caractres attendu et la chane de caractres correspondante dans la mme casse.

Si l'expression rationnelle est sensible l'Unicode, la conversion de casse s'effectue par le pliage simple de la casse dfini dans CaseFolding.txt (angl.). Cette conversion produit toujours un seul point de code, elle ne convertit donc pas, par exemple, (U+00DF LETTRE MINUSCULE LATINE S DUR) en ss (qui correspond au pliage complet de la casse, et non au pliage simple de la casse). Elle peut toutefois convertir des points de code extrieurs au bloc Latin de base en points de code appartenant ce bloc par exemple, (U+017F LETTRE MINUSCULE LATINE S LONG) se plie en s (U+0073 LETTRE MINUSCULE LATINE S) et (U+212A SIGNE KELVIN) se plie en k (U+006B LETTRE MINUSCULE LATINE K). Par consquent, /[a-z]/ui peut correspondre et .

Si l'expression rationnelle ne tient pas compte de l'Unicode, la conversion de casse utilise la conversion de casse par dfaut Unicode (angl.) le mme algorithme que celui utilis dans String.prototype.toUpperCase(). Cet algorithme empche la conversion de points de code extrieurs au bloc Latin de base en points de code appartenant ce bloc, donc et mentionns prcdemment ne correspondent pas /[a-z]/i.

Le pliage de casse sensible l'Unicode produit gnralement des minuscules, tandis que le pliage de casse qui ne tient pas compte de l'Unicode produit des majuscules. Ces deux oprations ne sont pas parfaitement inverses, elles prsentent donc de subtiles diffrences de comportement. Par exemple, (U+2126 SIGNE OHM) et (U+03A9 LETTRE MAJUSCULE GRECQUE OMGA) sont toutes deux converties en (U+03C9 LETTRE MINUSCULE GRECQUE OMGA) par le pliage simple de la casse, donc "\u2126" correspond /[\u03c9]/ui et /[\u03a9]/ui ; en revanche, la conversion de casse par dfaut convertit U+2126 en lui-mme, tandis qu'elle convertit les deux autres en U+03A9, donc "\u2126" ne correspond ni /[\u03c9]/i ni /[\u03a9]/i.

L'accesseur dfinit ignoreCase comme undefined. Vous ne vous pouvez pas modifier cette proprit directement.

Exemples

Utiliser ignoreCase

var regex = new RegExp("toto", "i");

console.log(regex.ignoreCase); // true

Spcifications

Compatibilit des navigateurs

Voir aussi

• La proprit RegExp.prototype.lastIndex
• La proprit RegExp.prototype.dotAll
• La proprit RegExp.prototype.global
• La proprit RegExp.prototype.hasIndices
• La proprit RegExp.prototype.multiline
• La proprit RegExp.prototype.source
• La proprit RegExp.prototype.sticky
• La proprit RegExp.prototype.unicode