Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

String.prototype.endsWith — comprobar el final de una cadena

String.prototype.endsWith comprueba si una cadena termina con el texto indicado y devuelve true o false. Distingue entre mayúsculas y minúsculas, no modifica la cadena y permite especificar un límite final anterior para la comprobación.

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

Sintaxis

str.endsWith(searchString[, endPosition])

String.prototype.endsWith compara searchString con el final de una cadena y devuelve true o false sin modificar el original. La comparación distingue entre mayúsculas y minúsculas y opera con unidades de código UTF-16, sin normalización Unicode. Es un método de la biblioteca estándar de ECMAScript, no una API del navegador.

El parámetro opcional endPosition establece un límite final exclusivo: el método comprueba el final del prefijo que llega hasta ese límite, no una subcadena que empieza ahí. Si se omite el argumento o se pasa undefined, se usa la longitud completa. Tras convertir el valor a un entero, se limita al intervalo entre 0 y la longitud de la cadena; los valores negativos no cuentan hacia atrás desde el final. Las posiciones se miden en unidades de código UTF-16.

Si searchString está vacío, el método devuelve true, incluso en el límite 0, siempre que la conversión de endPosition, cuando sea necesaria, se complete correctamente. La conversión se realiza antes de comprobar la coincidencia: pasar 0n como valor de endPosition provoca un TypeError aunque searchString esté vacío. El argumento searchString se convierte en una cadena, así que, si se omite, se usa el texto "undefined". Un argumento reconocido como expresión regular provoca un TypeError. Llamar al método con null o undefined como valor de this también provoca un TypeError.

En el ejemplo, el límite 10 queda justo después de report.txt, por lo que comprobar .txt devuelve true, aunque la cadena completa termine en .bak. Comprobar .BAK devuelve false porque cambia el uso de mayúsculas y minúsculas.

Ejemplos

const filename = "report.txt.bak";
console.log(filename.endsWith(".bak"));
console.log(filename.endsWith(".txt", 10));
console.log(filename.endsWith(".BAK"));
console.log(filename.endsWith("", 0));

Resultado

true
true
false
true

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes