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 null
ou undefined
, o método lançará uma exceção TypeError
. Por exemplo, a getUserRanking()
função a seguir retorna uma string se id
for maior que zero ou undefined
caso contrário:
const getUserRanking = (id) => {
if (id > 0) {
return 'Standard';
}
};
Linguagem de código: JavaScript ( javascript )
Observe que uma função retorna undefined
por 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á TypeError
quando 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:
undefined
Linguagem 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 this
valor 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:
TRUE
Linguagem de código: PHP ( php )
Neste exemplo, completed
is true
, que é um valor booleano. Quando chamamos o toUpperCase()
método na completed
variável e definimos o this
como toUpperCase()
, completed
o método converte o valor booleano true
em string 'TRUE'
.
Resumo
- Use o
toUpperCase()
método para retornar uma string com todos os caracteres convertidos em letras maiúsculas.