Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

String.prototype.toLowerCase() — conversione in minuscolo

Il metodo toLowerCase() restituisce una stringa convertita in minuscolo secondo le regole Unicode, senza modificare l’originale. Non accetta parametri e non adatta il risultato alla lingua dell’utente.

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

Sintassi

string.toLowerCase()

String.prototype.toLowerCase() restituisce una stringa con le lettere convertite in minuscolo secondo le regole Unicode predefinite per la conversione tra maiuscole e minuscole. Chiamalo senza argomenti come string.toLowerCase(). La stringa originale resta invariata; assegna il risultato a una variabile per conservarlo.

La conversione non dipende dalle impostazioni locali, ma può dipendere dai caratteri circostanti. Non considerarla una regola universale per confrontare testi ignorando la distinzione tra maiuscole e minuscole. Convertire in maiuscolo e poi in minuscolo non produce necessariamente lo stesso risultato di una chiamata diretta a toLowerCase().

Un carattere può corrispondere a più punti di codice, quindi la lunghezza del risultato può cambiare. Nell’esempio, \u0130 diventa la sequenza i\u0307, la cui proprietà length vale 2.

Il metodo è generico: quando viene invocato tramite String.prototype.toLowerCase.call(value), rifiuta prima null e undefined con un TypeError, poi converte gli altri valori in una stringa. Anche questa conversione può generare un errore.

Esempi

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);

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti