Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

String.prototype.toLowerCase() — conversão para minúsculas

O método toLowerCase() devolve uma cadeia convertida para minúsculas segundo as regras Unicode, sem alterar a original. Não aceita parâmetros nem adapta o resultado à língua do utilizador.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

string.toLowerCase()

String.prototype.toLowerCase() devolve uma cadeia com as letras convertidas para minúsculas de acordo com as regras predefinidas de conversão de maiúsculas e minúsculas do Unicode. Chama o método sem argumentos como string.toLowerCase(). A cadeia original não é alterada; atribui o resultado a uma variável para o guardar.

A conversão não depende da região, mas pode depender do contexto dos caracteres. Não a consideres uma regra universal para comparar textos sem distinguir maiúsculas de minúsculas. Converter para maiúsculas e depois para minúsculas não produz necessariamente o mesmo resultado que chamar toLowerCase() diretamente.

Um carácter pode corresponder a vários pontos de código, pelo que o comprimento do resultado pode mudar. No exemplo, \u0130 transforma-se na sequência i\u0307, cuja propriedade length tem o valor 2.

O método é genérico: quando é invocado através de String.prototype.toLowerCase.call(value), rejeita primeiro null e undefined com um TypeError e, em seguida, converte os outros valores numa cadeia. Essa conversão também pode gerar um erro.

Exemplos

const original = "HELLO ŁÓDŹ";
const lower = original.toLowerCase();
console.log(lower);
console.log(original);

const expanded = "\u0130".toLowerCase();
console.log(expanded === "i\u0307");
console.log(expanded.length);

Resultado

hello łódź
HELLO ŁÓDŹ
true
2

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes