String.prototype.toLowerCase()

Renvoie une copie de la chaîne convertie en minuscules. Utile pour les comparaisons et la normalisation des données.

Renvoie
Une nouvelle chaîne avec les lettres converties en minuscules.
Modifie l’original
Non
Sur cette page

Exemple

#
JavaScript
const email = '  Léa.Dupont@Example.COM '

console.log(email.trim().toLowerCase())
console.log('ÉTÉ'.toLowerCase())
Console
léa.dupont@example.com
été

Définition et utilisation

#

La méthode toLowerCase() renvoie une nouvelle chaîne dans laquelle toutes les majuscules sont converties en minuscules. Les caractères qui ne sont pas des lettres restent inchangés, et la chaîne d’origine reste telle qu’elle était. La méthode ne prend aucun argument.

C’est le moyen le plus simple de normaliser un texte avant de le comparer ou de le rechercher. Une adresse e-mail saisie comme Lea.Dupont@Example.com et lea.dupont@example.com est, en pratique, la même adresse ; mieux vaut donc la convertir en minuscules avant de l’enregistrer ou de la vérifier.

Comme toUpperCase(), la méthode s’appuie sur des règles Unicode universelles. Pour les langues aux règles différentes, comme le turc, il existe toLocaleLowerCase(), qui prend un code de langue.

Syntaxe

#
Syntaxe
string.toLowerCase()

Plus d’exemples

#
Recherche sans tenir compte de la casse
JavaScript
const courses = ['JavaScript pour débutants', 'React avancé', 'Python pour débutants']
const query = 'REACT'

const results = courses.filter((course) => course.toLowerCase().includes(query.toLowerCase()))

console.log(results)
Console
['React avancé']
Une adresse au format slug
JavaScript
const title = 'Boucles En JavaScript'
const slug = title.toLowerCase().replaceAll(' ', '-')

console.log(slug)
Console
boucles-en-javascript

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Normalisez les données en un seul endroit, par exemple lors de l’enregistrement d’une adresse e-mail, plutôt que de penser à toLowerCase() à chaque comparaison.
  • Quand les accents et les règles de la langue comptent aussi dans la comparaison, localeCompare() est le meilleur outil.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.