JavaScript toLowerCase()

サマリー: このチュートリアルでは、JavaScript String.prototype.toLowerCase() メソッドを使用して、すべての文字を小文字に変換した文字列を返す方法を学びます。

JavaScript の toLowerCase() メソッドの概要

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

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

たとえば

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

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

出力

hi

文字列は変更できないため、toLowerCase() メソッドは元の文字列を変更しません。代わりに、すべての文字を小文字に変換した新しい文字列を返します。

null または undefined に JavaScript toLowerCase() メソッドを呼び出す

null または undefined に toLowerCase() メソッドを呼び出すと、メソッドは throw TypeError 例外をスローします。

次の findUserById 関数は、id が 0 より大きい場合は文字列を返し、それ以外の場合は null を返します。

const findUserById = (id) => {
  if (id > 0) {
    // look up the user from the database
    // ...
    //
    return 'admin';
  }
  return null;
};Code language: JavaScript (javascript)

findUserById() 関数の結果に toLowerCase() メソッドを呼び出すと、id が 0 または負の値のときに TypeError がスローされます。

console.log(findUserById(-1).toLowerCase());Code language: CSS (css)

エラー

TypeError: Cannot read properties of null (reading 'toLowerCase')Code language: JavaScript (javascript)

安全にするために、以下のように オプションの連鎖演算子 ?. を使用できます。

console.log(findUserById(-1)?.toLowerCase());Code language: CSS (css)

出力

undefinedCode language: JavaScript (javascript)

文字列以外の値を文字列に変換する

toLowerCase() メソッドは、this の値を文字列以外の値に設定すると、文字列以外の値を文字列に変換します。たとえば

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

const username = String.prototype.toLowerCase.call(user);
console.log(username);
Code language: JavaScript (javascript)

出力

joe

この例では、call() メソッドを使用して、this を user オブジェクトに設定して toLowerCase() メソッドを呼び出します。toLowerCase() メソッドは、toString() メソッドを呼び出して user オブジェクトを文字列に変換します。

サマリー

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