String.prototype.toLocaleLowerCase()
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.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
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
Compatibilidade de navegador
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.