extract

La méthode extract() retourne les détails de la première correspondance d'un motif dans une chaîne, ou undefined si aucune correspondance n'est trouvée.

Exemple interactif

Syntaxe

Signature classique

function extract<
	GenericInput extends string
>(
	input: GenericInput, 
	pattern: string | RegExp
): ExtractResult | undefined;

Signature currifiée

function extract<
	GenericInput extends string
>(
	pattern: string | RegExp
): (input: GenericInput) => ExtractResult | undefined;

Paramètres

• input : La chaîne de caractères à rechercher.
• pattern : Le motif de recherche, qui peut être une chaîne de caractères ou une expression régulière.

Valeur de retour

Un objet ExtractResult lorsqu'une correspondance est trouvée, ou undefined lorsqu'il n'y a aucune correspondance.

ExtractResult contient :

• matchedValue : La sous-chaîne trouvée.
• groups : Un tableau des groupes capturés (hors correspondance complète).
• namedGroups : Un objet des groupes nommés si présents.
• offset : L'index de début de la correspondance.
• self : La chaîne d'entrée originale.

Voir aussi

• extractAll : Extrait les détails de toutes les correspondances.
• match : Recherche une correspondance avec une expression régulière.
• matchAll : Recherche toutes les correspondances avec une expression régulière.

Sources

• MDN Web Docs - String.prototype.match()