JavaScript paraUpperCase()

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

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

O toUpperCase()método retorna uma nova string com todos os caracteres convertidos em letras maiúsculas. Aqui está a sintaxe do toUpperCase()método:

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

Por exemplo:

const message = 'Hello';
const newMessage = message.toUpperCase();

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

Saída:

HELLO

É importante notar que uma string é imutável. Portanto, o toUpperCase()método não altera a string original. Em vez disso, ele retorna uma nova string com todos os caracteres convertidos em letras maiúsculas.

Chamando o método toUpperCase em indefinido ou nulo

Se você chamar o toUpperCase()método nullou undefined, o método lançará uma exceção TypeError. Por exemplo, a getUserRanking()função a seguir retorna uma string se idfor maior que zero ou undefinedcaso contrário:

const getUserRanking = (id) => {
  if (id > 0) {
    return 'Standard';
  }
};Linguagem de código:  JavaScript  ( javascript )

Observe que uma função retorna undefinedpor padrão quando você não retorna explicitamente um valor dela.

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

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

Erro:

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

Para evitar o erro, você pode usar o operador de encadeamento opcional ?. assim:

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

Saída:

undefinedLinguagem de código:  JavaScript  ( javascript )

Convertendo uma não-string em uma string

O toUpperCase()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 completed = true;
const result = String.prototype.toUpperCase.call(completed);

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

Saída:

TRUELinguagem de código:  PHP  ( php )

Neste exemplo, completedis true, que é um valor booleano. Quando chamamos o toUpperCase()método na completedvariável e definimos o thiscomo toUpperCase(), completedo método converte o valor booleano trueem string 'TRUE'.

Resumo

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