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

CKTIS / JavaScript

String.prototype.localeCompare — comparación de texto según reglas lingüísticas

String.prototype.localeCompare compara dos cadenas según reglas de ordenación lingüísticas. El signo del resultado determina su orden; locales y options permiten personalizar la comparación en entornos compatibles con ECMA-402.

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

string.localeCompare(compareString, locales?, options?)

String.prototype.localeCompare compara la cadena receptora con compareString. Un resultado negativo indica que va antes que la otra cadena; uno positivo, que va después; y 0 indica equivalencia en esa comparación, no necesariamente que el texto sea idéntico. Comprueba el signo del resultado, no los valores exactos -1 y 1.

En entornos con ECMA-402, locales solicita un idioma preferido, como "en"; si se omite, se usan los valores predeterminados del entorno. options personaliza la comparación: numeric: true ordena las secuencias de dígitos según su valor numérico. Las reglas dependen de los datos de idioma disponibles; sin ECMA-402, no se puede confiar en que estos argumentos sean compatibles.

Para ordenar, pasa (a, b) => a.localeCompare(b, "en", options). No pases el método por sí solo como función de comparación: necesita el receptor this correcto. En el ejemplo, numeric: true coloca item2 antes de item10; la línea esperada es item1, item2, item10.

Ejemplos

const labels = ["item10", "item2", "item1"];
const options = { numeric: true };
labels.sort((a, b) => a.localeCompare(b, "en", options));
console.log(labels.join(", "));

Resultado

item1, item2, item10

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