JavaScript para LowerCase()

Resumo : neste tutorial você aprenderá como usar o String.prototype.toLowerCase()método JavaScript para retornar uma string com todos os caracteres convertidos para letras minúsculas.

Introdução ao método JavaScript toLowerCase()

O toLowerCase()método retorna uma nova string com todos os caracteres convertidos em letras minúsculas. O seguinte mostra a sintaxe do toLowerCase()método:

str.toLowerCase()Linguagem de código:  CSS  ( css )

Por exemplo:

const message = 'Hi';
const newMessage = message.toLowerCase();

console.log(newMessage);Linguagem de código:  JavaScript  ( javascript )

Saída:

hi

Como uma string é imutável, o toLowerCase()método não altera a string original. Em vez disso, ele retorna uma nova string com todos os caracteres convertidos em letras minúsculas.

Chamando o método JavaScript toLowerCase() em nulo ou indefinido

Se você chamar o toLowerCase()método nullou undefined, o método lançará uma exceção TypeError.

A findUserByIdfunção a seguir retorna uma string se idfor maior que zero ou nullcaso contrário:

const findUserById = (id) => {
  if (id > 0) {
    // look up the user from the database
    // ...
    //
    return 'admin';
  }
  return null;
};Linguagem de código:  JavaScript  ( javascript )

Se você chamar o toLowerCase()método no resultado da findUserById()função, você obterá TypeErrorquando o id for zero ou negativo:

console.log(findUserById(-1).toLowerCase());Linguagem de código:  CSS  ( css )

Erro:

TypeError: Cannot read properties of null (reading 'toLowerCase')Linguagem de código:  JavaScript  ( javascript )

Para torná-lo seguro, você pode usar o operador de encadeamento opcional ?. da seguinte maneira:

console.log(findUserById(-1)?.toLowerCase());Linguagem de código:  CSS  ( css )

Saída:

undefinedLinguagem de código:  JavaScript  ( javascript )

Convertendo uma não-string em uma string

O toLowerCase()método converterá um valor que não seja de string em uma string se você definir seu thisvalor como um valor que não seja de string. Por exemplo:

const user = {
  username: 'JOE',
  toString() {
    return this.username;
  },
};

const username = String.prototype.toLowerCase.call(user);
console.log(username);
Linguagem de código:  JavaScript  ( javascript )

Saída:

joe

Neste exemplo, invocamos o toLowerCase()método com os thisconjuntos do userobjeto usando o call()método. O toLowerCase()método converte o userobjeto em uma string chamando seu toString()método.

Resumo

• Use o toLowerCase()método para retornar uma string com todos os caracteres convertidos em letras minúsculas.