Vérifiez si un texte contient une sous-chaîne

Il renvoie un booléen et la position, comptée à partir de zéro, de la première correspondance, ou -1 si aucune n’existe. Vous pouvez respecter exactement les majuscules et minuscules ou les ignorer. Le résultat est déterministe, facile à tester et utile dès qu’un processus nécessite une condition de recherche rapide, sans expression régulière ni rapprochement approximatif.

Recherchez une sous-chaîne avec un résultat sans ambiguïté

Placez la valeur complète dans text et la séquence recherchée dans substring. La réponse contient contains, égal à true lorsqu’une correspondance existe, ainsi que position, qui indique le début de la première occurrence. Les positions commencent à zéro : une sous-chaîne située tout au début a donc la position 0. En cas d’absence, le résultat vaut false et la position -1, ce qui distingue clairement une absence d’une occurrence initiale. Cette association convient aussi bien à une lecture humaine qu’à un logiciel appliquant une condition. L’opération recherche une sous-chaîne littérale et contiguë. Les espaces, la ponctuation et les caractères répétés sont du texte ordinaire, pas des motifs ; aucun échappement d’expression régulière n’est nécessaire. Si la même séquence apparaît plusieurs fois, seule la première position est renvoyée. Ce comportement sert particulièrement à vérifier la présence d’un marqueur attendu et à déterminer où une analyse peut commencer. Une sous-chaîne vide est refusée, car toute chaîne la contient techniquement et produirait ainsi une validation trompeuse et peu exploitable.

Déterminez si la casse doit être respectée

L’option case_sensitive vaut true par défaut. Dans ce mode, majuscules et minuscules doivent correspondre exactement : « Ready » ne correspond pas à « ready ». Cette comparaison stricte convient aux identifiants, marqueurs de protocole, références de produits et contenus dont la capitalisation est significative. Choisissez false lorsque vous souhaitez une vérification textuelle pratique qui traite ces variantes de la même façon, par exemple pour repérer un statut dans des notes saisies par un utilisateur ou vérifier qu’un titre contient une expression. Le mode insensible à la casse normalise de façon cohérente le texte source et la sous-chaîne avant de chercher la première occurrence ; la position renvoyée désigne néanmoins toujours le texte d’origine. L’outil ne supprime pas les espaces en bordure et ne modifie pas la ponctuation, qui restent donc significatifs. Il n’effectue pas non plus de neutralisation des accents, de racinisation, de translittération, de recherche approximative ou de détection de mots entiers. Ainsi, « cat » peut correspondre aux trois premières lettres de « catalog ». Ces règles limitées garantissent un résultat reproductible sans hypothèse linguistique implicite.

Exploitez la position avec précaution dans vos validations

Un processus courant envoie une valeur candidate, examine contains, puis choisit une branche sans devoir interpréter le champ numérique. Lorsqu’une correspondance existe, position peut servir au diagnostic, à un aperçu ou à une analyse ultérieure. Un contrôle d’importation peut, par exemple, confirmer qu’un en-tête comprend un jeton obligatoire et mémoriser son point de départ ; un test peut vérifier qu’un texte généré contient une formule approuvée ; un outil d’assistance peut aussi détecter un marqueur connu dans une ligne de journal collée. Considérez toujours la position comme un indice de chaîne JavaScript mesuré en unités de code UTF-16. Pour un texte latin courant, cela correspond au comptage familier des caractères, mais certains emoji et symboles Unicode occupent deux unités. L’indice natif de la plateforme est volontairement renvoyé afin que le navigateur et l’API se comportent à l’identique et que vous puissiez l’utiliser directement avec les méthodes de découpage JavaScript. Il s’agit d’une recherche littérale, pas d’un filtre de sécurité ni d’un classificateur. Validez séparément la structure des formats sensibles et utilisez un analyseur spécialisé si les limites, l’échappement ou toutes les occurrences sont importants.