CKTIS / JavaScript
Intl.Collator: sensibilidad y reglas de ordenación regionales
Compara y ordena cadenas según la configuración regional seleccionada. La opción `sensitivity` indica qué diferencias afectan a la comparación.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
new Intl.Collator(locales, { sensitivity: "base" | "accent" | "case" | "variant", usage: "sort" | "search" })
collator.compare(a, b)
strings.sort(collator.compare)
Intl.Collator.supportedLocalesOf(locales)
collator.resolvedOptions()
The `|` notation lists alternatives; pass one string value per option. Both constructor arguments and both shown options are optional.Con Intl.Collator, las reglas de ordenación de la configuración regional efectiva determinan qué se considera una letra base. Según la ordenación alemana predeterminada, ä es una variante de a; en sueco es una letra distinta. Por eso, con "base", ambas cadenas pueden ser equivalentes en de, pero no en sv.
Las letras base distintas se distinguen con cualquier valor de sensitivity. Entre variantes de una misma letra base, "base" ignora los diacríticos y las diferencias entre mayúsculas y minúsculas; "accent" distingue los diacríticos, pero no las mayúsculas de las minúsculas; "case" hace lo contrario; y "variant" distingue ambos aspectos y puede distinguir otros. Un valor fuera de la lista, como "ignore", provoca un RangeError.
Con el modo predeterminado usage: "sort", la sensibilidad predeterminada es "variant". Con usage: "search", depende de la configuración regional; en ese modo, usa compare(a, b) === 0 para comprobar coincidencias, no para ordenar. Al ordenar, un resultado negativo indica que a va antes que b, uno positivo indica que va después y cero indica que la comparación las considera equivalentes. No esperes exactamente -1 o 1. La función collator.compare está vinculada a la instancia, así que puedes pasarla directamente a sort(). Un resultado de 0 no implica que a === b.
Solicita explícitamente una configuración regional: si no se puede usar ninguna de las solicitadas, el entorno usa la predeterminada. Intl.Collator.supportedLocalesOf() comprueba la compatibilidad sin recurrir a la configuración predeterminada del entorno, y resolvedOptions().locale muestra la configuración efectiva. Los datos de ordenación pueden variar entre entornos y versiones incluso con las mismas opciones efectivas.
Ejemplos
{
const locales = ["en", "de", "sv"];
if (typeof Intl === "undefined" || typeof Intl.Collator !== "function" ||
Intl.Collator.supportedLocalesOf(locales).length !== locales.length) {
console.log("Intl.Collator or required locales unavailable");
} else {
for (const sensitivity of ["base", "accent", "case", "variant"]) {
const { compare } = new Intl.Collator("en", { sensitivity });
console.log(`${sensitivity}: ${compare("a", "á") === 0}, ${compare("a", "A") === 0}`);
}
for (const locale of ["de", "sv"]) {
const { compare } = new Intl.Collator(locale, { sensitivity: "base" });
console.log(`${locale}: ${compare("a", "ä") === 0}`);
}
}
}Resultado
base: true, true accent: false, true case: true, false variant: false, false de: true sv: false
En las cuatro primeras líneas, `true` significa que el par se considera equivalente: primero `a` y `á`, luego `a` y `A`. Las dos últimas líneas comparan `a` con `ä` usando `"base"` en `de` y `sv`. La salida mostrada presupone que se admiten esas configuraciones y `en`, con las reglas de ordenación predeterminadas descritas.
Lecciones relacionadas
- JavaScript · Lección 24 · Intermedio · Versión: 3