JavaScript toUpperCase()

概要: このチュートリアルでは、JavaScript String.prototype.toUpperCase() メソッドを使用して、文字列のすべての文字を大文字に変換する方法について説明します。

JavaScript toUpperCase() メソッドの紹介

toUpperCase() メソッドは、文字列のすべての文字を大文字に変換した新しい文字列を返します。以下は toUpperCase() メソッドの構文です。

str.toUpperCase()Code language: CSS (css)

たとえば

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

console.log(newMessage);Code language: JavaScript (javascript)

出力

HELLO

文字列は不変であることに注意することが重要です。したがって、toUpperCase() メソッドは元の文字列を変更しません。代わりに、文字列のすべての文字を大文字に変換した新しい文字列を返します。

undefined または null に toUpperCase メソッドを呼び出す

toUpperCase() メソッドを null または undefined に呼び出すと、メソッドは TypeError 例外を スロー します。たとえば、次の getUserRanking() 関数は、id が 0 より大きい場合、文字列を返します。それ以外の場合は undefined を返します

const getUserRanking = (id) => {
  if (id > 0) {
    return 'Standard';
  }
};Code language: JavaScript (javascript)

関数は、明示的に値を返さない場合、デフォルトで undefined を返すことに注意してください。

getUserRanking() 関数の結果に対して toUpperCase() メソッドを呼び出すと、id が 0 または負の場合に TypeError が発生します

console.log(getUserRanking(-1).toUpperCase());Code language: CSS (css)

エラー

TypeError: Cannot read properties of undefined (reading 'toUpperCase')Code language: JavaScript (javascript)

エラーを回避するには、省略可能なチェーン演算子 ?. を次のように使用できます

console.log(getUserRanking(-1)?.toUpperCase());Code language: CSS (css)

出力

undefinedCode language: JavaScript (javascript)

文字列以外の文字列への変換

toUpperCase() メソッドは、それ自身の this 値を文字列以外の値に設定した場合、文字列以外の値を文字列に変換します。たとえば

const completed = true;
const result = String.prototype.toUpperCase.call(completed);

console.log(result);Code language: JavaScript (javascript)

出力

TRUECode language: PHP (php)

この例では、completed はブール値である true です。completed 変数に対して toUpperCase() メソッドを呼び出し、toUpperCase() の this を completed に設定すると、メソッドはブール値 true を文字列 'TRUE' に変換します。

まとめ

• toUpperCase() メソッドを使用して、文字列のすべての文字を大文字に変換した文字列を返します。