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 un Array, 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 argumento locale 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()

js
"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® 2025 Language Specification
# sec-string.prototype.tolocalelowercase
ECMAScript® 2025 Internationalization API Specification
# sup-string.prototype.tolocalelowercase

Compatibilidad con navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
toLocaleLowerCase
locales parameter

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
Has more compatibility info.

Vea también