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
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 umArray
, 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 argumentolocale
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()
"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 Language Specification # sec-string.prototype.tolocalelowercase |
ECMAScript Internationalization API Specification # sup-string.prototype.tolocalelowercase |
Compatibilidade com navegadores
BCD tables only load in the browser