Aller au contenu
FrAIFlow

Solutions / Texte & Code

Pourquoi les signes dollar modifient votre texte de remplacement JavaScript

Votre outil de recherche et remplacement transforme le texte de remplacement lui-même. Même avec une recherche fondée sur une simple chaîne, JavaScript interprète certaines séquences commençant par un dollar dans l’argument de remplacement. Si l’utilisateur souhaite insérer le texte tel quel, renvoyez-le depuis une fonction.

Une valeur, deux interprétations
Illustration explicative fondée sur l’exemple conservé, et non capture d’application.

Repérez les modèles de remplacement avant de modifier la saisie

Imaginez remplacer un emplacement réservé par une explication tarifaire contenant $&. L’utilisateur attend ces deux caractères, mais l’ancien emplacement réapparaît. Ce n’est pas nécessairement un problème d’encodage. L’argument de remplacement possède son propre petit langage de modèles, même lorsque la recherche porte sur une chaîne ordinaire plutôt que sur une expression régulière.

Partez d’une copie du texte et d’une seule correspondance. Si une séquence dollar se transforme, remplacez l’argument de remplacement par une fonction de rappel, puis comparez les résultats. Gardez la même recherche pour cette comparaison. Modifier les deux paramètres en même temps compliquerait l’identification de la règle responsable.

Dans un signalement public de 2012, remplacer une chaîne entière par $' produisait un résultat vide. Cette séquence désigne le suffixe situé après la correspondance. Comme la correspondance occupait toute la chaîne, il n’y avait aucun suffixe.

const input = "as";
const replacement = "$'";
input.replace("as", replacement);       // ""
input.replace("as", () => replacement); // "$'"

Le test conservé sous Node.js v24.19.0 a reproduit les deux résultats. D’autres séquences de remplacement comprennent $$ pour insérer un dollar, $& pour la correspondance entière et des références de capture comme $1 lorsque le motif possède le groupe concerné. Il existe aussi des formes pour le préfixe et les captures nommées. Un signe dollar isolé n’a pas systématiquement de sens spécial.

Distinguer clairement les deux modes
Illustration explicative fondée sur l’exemple conservé, et non capture d’application.

Utilisez une fonction de rappel lorsque le texte doit rester littéral

const draft = "Price: TOKEN. Repeat: TOKEN.";
const typedReplacement = "$& costs $$";

console.log(draft.replaceAll("TOKEN", typedReplacement));
// Price: TOKEN costs $. Repeat: TOKEN costs $.

console.log(draft.replaceAll("TOKEN", () => typedReplacement));
// Price: $& costs $$. Repeat: $& costs $$.

Dans le premier appel, la chaîne de remplacement est interprétée. Dans le second, la fonction renvoie la valeur littérale de l’utilisateur pour chaque correspondance. Cette valeur est insérée sans nouvelle interprétation comme modèle de remplacement. C’est utile pour un outil qui promet une recherche et un remplacement ordinaires : l’utilisateur ne devrait pas avoir à apprendre un échappement spécial des dollars pour coller son texte.

Ne contournez pas le problème en construisant automatiquement une expression régulière à partir de la recherche saisie. En mode littéral, une recherche comme a.b doit généralement trouver un vrai point, pas n’importe quel caractère. Si vous proposez aussi les captures regex et les modèles de remplacement, gardez un mode avancé distinct et clairement nommé. Un modèle comme $1 y est utile et ne doit pas devenir soudainement littéral sans explication.

La chaîne de remplacement interprète les séquences dollar ; la fonction de rappel conserve exactement le texte saisi.
Comparaison avant/après créée pour expliquer l’exemple synthétique Node.js exact ci-dessus. Ce n’est pas une capture d’un éditeur de texte. Ouvrez l’image pour voir les détails en grand.
function replaceLiteralOnce(text, search, value) {
  return text.replace(search, () => value);
}
function replaceLiteralAll(text, search, value) {
  if (search === "") throw new Error("Search must not be empty");
  return text.replaceAll(search, () => value);
}

Ces fonctions attendent des chaînes fournies par l’application. L’une remplace la première occurrence ; l’autre remplace toutes les occurrences correspondantes. Seule replaceLiteralAll refuse une recherche vide pour éviter les insertions entre les unités de code. Avec une recherche vide, replaceLiteralOnce insère le texte de remplacement au début de la chaîne. Si votre produit prend volontairement en charge les modèles de capture, conservez ce mode et indiquez-le clairement plutôt que d’en changer silencieusement le sens.

Prévisualisez toute la modification dans son contexte final

Montrez le texte original et le texte modifié, surtout pour « Tout remplacer ». Testez un remplacement contenant un dollar seul, deux dollars, une séquence désignant la correspondance et une chaîne vide. Vérifiez aussi le cas sans correspondance. Un remplacement vide représente une suppression légitime ; une recherche vide exige une décision explicite, car elle peut insérer du texte entre les positions sur toute la chaîne.

Vérifiez enfin comment le résultat est affiché. Renvoyer du texte littéral depuis une fonction de remplacement ne rend pas le HTML sûr. Pour du texte non fiable, l’aperçu doit utiliser un textarea ou textContent afin d’afficher une balise collée au lieu de l’exécuter. N’enregistrez ou n’envoyez le résultat qu’après avoir vérifié que l’aperçu correspond à l’intention de l’utilisateur, et conservez une possibilité d’annulation pour les modifications en masse.

Les jeux de test enregistrés ont conservé exactement $&, $', $$ et $1 lorsque ces valeurs étaient renvoyées par la fonction de rappel. Ajoutez des exemples similaires à vos tests de non-régression, notamment plusieurs correspondances et un remplacement vide. Conservez la source et prévisualisez les modifications en masse.

Remplacement mesuré : l’argument chaîne produit un résultat vide ; la fonction renvoie littéralement le dollar et l’apostrophe.
Explication d’origine conservée.
Résultat enregistré d’un test synthétique expliquant l’interprétation des dollars dans les remplacements JavaScript
Résultat enregistré du remplacement de chaînes sous Node.js avec du texte contenant des dollars littéraux. Cette image présente le résultat du test, pas l’application de l’auteur du signalement. Ouvrir l’image de preuve en grand.

Sources et lectures complémentaires