Compruebe si un texto contiene una subcadena

Devuelve un resultado booleano y la posición, comenzando desde cero, de la primera coincidencia, o -1 si no existe ninguna. Puede conservar la distinción exacta entre mayúsculas y minúsculas o ignorarla. El resultado es determinista, fácil de probar y útil cuando un flujo necesita una condición de búsqueda rápida sin expresiones regulares ni coincidencias aproximadas.

Compruebe una subcadena con un resultado inequívoco

Introduzca el valor completo en text y la secuencia que desea localizar en substring. La respuesta incluye contains, que vale true cuando existe una coincidencia, y position, que indica dónde comienza la primera. Las posiciones empiezan en cero, de modo que una subcadena situada al principio devuelve la posición 0. Si no aparece, el resultado es false y la posición es -1; así se distingue claramente la ausencia de una coincidencia al inicio. Esta combinación resulta cómoda tanto para una persona como para el software que aplica una condición. La operación busca una subcadena literal y contigua. Los espacios, la puntuación y los caracteres repetidos se tratan como texto normal, no como patrones, por lo que no hace falta escapar símbolos de expresiones regulares. Si la subcadena aparece varias veces, solo se informa de la primera posición. Es especialmente útil para validar si aparece un marcador esperado y determinar dónde podría empezar un análisis posterior. Se rechaza una subcadena vacía porque, técnicamente, cualquier cadena la contiene y ese resultado sería confuso y poco útil.

Decida si deben distinguirse mayúsculas y minúsculas

La opción case_sensitive tiene el valor true de forma predeterminada. En ese modo, las letras mayúsculas y minúsculas deben coincidir exactamente: buscar «Ready» no encuentra «ready». La comparación exacta es apropiada para identificadores, marcadores de protocolos, códigos de productos y cualquier contenido donde el uso de mayúsculas tenga significado. Establezca la opción en false cuando prefiera una comprobación práctica que trate esas variantes como equivalentes, por ejemplo para localizar una palabra de estado en notas introducidas por usuarios o verificar que un encabezado contiene una frase. El modo que no distingue mayúsculas normaliza de forma coherente el texto y la subcadena antes de buscar, aunque la posición informada sigue perteneciendo al texto original. La capacidad no elimina espacios de los extremos ni modifica la puntuación, por lo que ambos siguen siendo significativos. Tampoco aplica equivalencia de acentos, lematización, transliteración, coincidencia aproximada ni detección de palabras completas. Por ejemplo, «cat» puede coincidir con las tres primeras letras de «catalog». Estas reglas limitadas mantienen el resultado reproducible y evitan suposiciones lingüísticas silenciosas.

Utilice la posición de forma segura en sus validaciones

Un flujo habitual envía un valor candidato, comprueba contains y decide la siguiente acción sin tener que interpretar el campo numérico. Cuando existe una coincidencia, position puede servir para diagnósticos, vistas previas o un paso de análisis posterior. Por ejemplo, una importación puede confirmar que un encabezado incluye un elemento obligatorio y registrar dónde empieza; una prueba puede verificar que un texto generado incorpora una frase aprobada; o una herramienta de soporte puede detectar un marcador conocido en una línea de registro pegada. Interprete siempre la posición como un índice de cadena de JavaScript, medido en unidades de código UTF-16. En textos latinos corrientes coincide con el recuento habitual de caracteres, pero algunos emoji y símbolos Unicode menos comunes ocupan dos unidades. Se devuelve deliberadamente el índice nativo de la plataforma para que el navegador y la API se comporten igual y usted pueda emplearlo directamente con los métodos de corte de JavaScript. Esta es una búsqueda literal, no un saneador de seguridad ni un clasificador. Valide la estructura por separado para formatos sensibles y utilice un analizador específico cuando importen los límites, las reglas de escape o todas las coincidencias.