String.prototype.toLocaleLowerCase()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.
El método toLocaleLowerCase()
retorna la cadena de texto desde la que se llama convertida en minúsculas, de acuerdo con cualquier localización específica de correspondencia de mayúsculas y minúsculas.
Pruébalo
Los fuentes para este ejemplo interactivo están almacenados en un repositorio GitHub. Si quieres contribuir en el proyecto de ejemplos interactivos, por favor clona https://github.com/mdn/interactive-examples
y envíanos un pull request.
Sintaxis
str.toLocaleLowerCase() str.toLocaleLowerCase(locale) str.toLocaleLowerCase([locale, locale, ...])
Parámetros
locale
Opcional-
El parámetro
locale
indica la localización que se utilizará para convertir a minúsculas de acuerdo con culalquier correspondencia de mayúsculas y minúsculas. Si se proporcionan múltiples locales en unArray
, se utiliza el mejor local disponible. La localización por defecto es la localización actual configurada en el host.
Valor retornado
Una nueva cadena que representa la cadena desde la que se llama convertida a minúsculas, de acuerdo con cualquier localización específica de correspondencia de mayúsculas y minúsculas.
Excepciones
- Una excepción de tipo
RangeError
("invalid language tag: xx_yy") se lanzará si el argumentolocale
no es una etiqueta válida de lenguaje. - Una excepción de tipo
TypeError
("invalid element in locales argument") se lanzará si un elemento del arreglo no es del tipo cadena.
Descripción
El método toLocaleLowerCase()
retorna la cadena de texto desde la que se llama convertida en minúsculas, de acuerdo con cualquier localización específica de correspondencia de mayúsculas y minúsculas. toLocaleLowerCase()
no afecta el valor de la cadena desde la que se llama. En la mayoría de los casos, producirá el mismo resultado que toLowerCase()
, pero para algunos locales, como el turco, cuyas correspondencias de mayúsculas y minúsculas no siguen las correpsondencias por defecto de Unicode, podría producir de un resultado diferente.
Ejemplos
Utilizando toLocaleLowerCase()
"ALPHABET".toLocaleLowerCase(); // 'alphabet'
"\u0130".toLocaleLowerCase("tr") === "i"; // true
"\u0130".toLocaleLowerCase("en-US") === "i"; // false
let locales = ["tr", "TR", "tr-TR", "tr-u-co-search", "tr-x-turkish"];
"\u0130".toLocaleLowerCase(locales) === "i"; // true
Especificaciones
Specification |
---|
ECMAScript Language Specification # sec-string.prototype.tolocalelowercase |
ECMAScript Internationalization API Specification # sup-string.prototype.tolocalelowercase |
Compatibilidad con navegadores
BCD tables only load in the browser