Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

RegExp — expressions régulières

RegExp décrit des motifs servant à rechercher dans du texte. Découvrez les indicateurs, les groupes, les classes de caractères, les quantificateurs et les champs du résultat de exec(), notamment les captures nommées, les plages d’indices et le comportement avec état de lastIndex.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

/pattern/flags; new RegExp("pattern", "flags"); regexp.exec(text); regexp.test(text)

RegExp représente un motif textuel. Créez-en un avec /pattern/flags ou new RegExp("pattern", "flags") ; les chaînes passées au constructeur nécessitent un niveau supplémentaire d’échappement des barres obliques inverses : /\d+/ correspond à new RegExp("\\d+"). test() renvoie un booléen ; exec() renvoie un tableau de correspondance ou null. Cette entrée traite des indicateurs RegExp, des groupes, des classes, des quantificateurs et des champs du résultat.

Indicateurs : g permet les correspondances successives, i ignore la casse, m fait reconnaître à ^ et $ les limites de ligne, s permet à . de correspondre aux terminateurs de ligne, u active le mode Unicode, v étend ce mode avec des opérations sur les ensembles de caractères, y exige une correspondance exactement à lastIndex et d ajoute des plages d’indices. u et v sont incompatibles ; les indicateurs répétés ou inconnus provoquent un SyntaxError.

Les classes comme [a-z], [^0-9] et \d sélectionnent des caractères ; \d désigne les chiffres ASCII. Les groupes (…) capturent du texte, (?<name>…) nomme une capture et (?:…) ne capture pas. Les quantificateurs *, +, ? et {n,m} signifient zéro ou plusieurs, un ou plusieurs, zéro ou un, et entre n et m répétitions. Ils sont gourmands par défaut ; un ? final les rend non gourmands.

Un résultat de exec() contient la correspondance complète à [0], les captures à partir de [1], la position de départ dans index, le texte d’origine dans input et les captures nommées dans groups, ou undefined en l’absence de groupes nommés. Les captures sans correspondance valent undefined. Le tableau de correspondance ne contient le tableau indices qu’avec l’indicateur d : indices[0] est la paire d’indices de la correspondance complète, et les éléments suivants contiennent les paires des captures correspondantes ou undefined pour celles qui n’ont pas participé à la correspondance. Chaque paire définit une plage [start,end) (borne de fin exclue) mesurée en unités de code UTF-16, comme index et lastIndex. Si le motif ne contient aucune capture nommée, indices.groups vaut undefined. Sinon, c’est un objet qui associe à chaque nom de capture sa paire d’indices ou undefined si cette capture n’a pas participé à la correspondance.

Avec g ou y, exec() et test() modifient tous deux lastIndex : en cas de réussite, il prend la fin de la correspondance ; en cas d’échec, il est remis à zéro. Une correspondance vide ne le fait pas avancer automatiquement dans exec(), une boucle peut donc ne pas se terminer. Les groupes nommés datent d’ES2018, d d’ES2022 et v d’ES2024. Ce sont des fonctionnalités ECMAScript, et non des API Web ; vérifiez leur prise en charge dans le navigateur cible, indépendamment de Node 24 du dépôt.

Exemples

const re = /(?<key>[a-z]+)=(\d{2})/dg;
const text = "id=42";
const m = re.exec(text);
if (m === null) throw new Error("Expected a match");
console.log(JSON.stringify({
  match: m[0],
  captures: [m[1], m[2]],
  key: m.groups.key,
  index: m.index,
  input: m.input,
  span: m.indices[0],
  keySpan: m.indices.groups.key,
  lastIndex: re.lastIndex
}));

Résultat

{"match":"id=42","captures":["id","42"],"key":"id","index":0,"input":"id=42","span":[0,5],"keySpan":[0,2],"lastIndex":5}

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources