CKTIS / JavaScript
String.prototype.toUpperCase() — converter letras para maiúsculas
O método toUpperCase() devolve um texto com as letras convertidas para maiúsculas segundo as regras Unicode predefinidas. Não altera o original, não aceita argumentos e pode alterar o comprimento do resultado.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
string.toUpperCase()String.prototype.toUpperCase() devolve um valor do tipo string com as letras convertidas para maiúsculas segundo o algoritmo Unicode predefinido. Chame-o como string.toUpperCase(), sem argumentos. O texto original permanece inalterado; para utilizar o texto convertido, guarde ou transmita o valor devolvido.
A conversão não se limita a ASCII. Um ponto de código pode dar origem a vários, pelo que o comprimento do resultado pode mudar: ß passa a SS. Os algarismos e a pontuação do exemplo permanecem inalterados. Converter para maiúsculas e, em seguida, para minúsculas não garante que se recupere o original.
O método não tem em conta um idioma ou uma região selecionados. Se precisar de regras de maiúsculas específicas de um idioma, considere toLocaleUpperCase(). Por si só, toUpperCase() não é um mecanismo geral para comparar textos sem distinguir maiúsculas de minúsculas.
Também pode chamar o método com value como recetor através de String.prototype.toUpperCase.call(value). O método lança um TypeError para null e undefined antes da conversão. Nos restantes casos, recorre à operação ToString, que lança um TypeError para um valor primitivo do tipo Symbol. Faz parte da biblioteca padrão ECMAScript, não do DOM; a especificação da linguagem não é uma tabela de compatibilidade dos browsers.
Exemplos
const original = "Straße 123!";
const upper = original.toUpperCase();
console.log(original);
console.log(upper);
console.log(original.length, upper.length);Resultado
Straße 123! STRASSE 123! 11 12
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.