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.

O método toLocaleLowerCase() retorna o valor da string em minúsculas, de acordo com qualquer mapeamento de caixa de texto específico da localidade.

Experimente

const dotted = "İstanbul";

console.log(`EN-US: ${dotted.toLocaleLowerCase("en-US")}`);
// Expected output: "i̇stanbul"

console.log(`TR: ${dotted.toLocaleLowerCase("tr")}`);
// Expected output: "istanbul"

Sintaxe

str.toLocaleLowerCase()
str.toLocaleLowerCase(locale)
str.toLocaleLowerCase([locale, locale, ...])

Parâmetros

locale

Opcional. O parâmetro locale indica o local a ser usado para converter para minúsculas de acordo com qualquer mapeamento de caixa de texto específico da localidade. Se várias localidades forem fornecidas em um Array, a melhor localidade disponível é usada. A localidade padrão é a localidade atual do ambiente do host.

Valor retornado

Uma nova string que representa a string original convertida em minúsculas, de acordo com qualquer mapeamento da caixa de texto específico da localidade.

Exceções

  • Um RangeError (" invalid language tag: xx_yy ") é lançado se um argumento locale não for uma tag de idioma válido.
  • Um TypeError (" invalid element in locales argument ") é lançado se um elemento do array não for do tipo string.

Descrição

O método toLocaleLowerCase() retorna o valor da string convertida em minúsculas de acordo com qualquer mapeamento da caixa de texto específico da localidade. toLocaleLowerCase() não afeta o valor da string original. Na maioria dos casos, ele produzirá o mesmo resultado que toLowerCase(), mas para alguns locais, como turco, cujos mapeamentos da caixa de texto não seguem o mapeamento padrão em Unicode, pode haver um resultado diferente.

Exemplos

Usando toLocaleLowerCase()

js
"ALFABETO".toLocaleLowerCase(); // 'alfabeto'

"\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

Especificações

Specification
ECMAScript® 2025 Language Specification
# sec-string.prototype.tolocalelowercase
ECMAScript® 2025 Internationalization API Specification
# sup-string.prototype.tolocalelowercase

Compatibilidade com 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.

Veja também