初級

文字列メソッドは元の文字列を変更せず新しい文字列を返す

toUpperCase()のような文字列メソッドは、呼び出し元の文字列そのものを書き換えるのではなく、変換後の新しい文字列を戻り値として返します。戻り値を使わずに呼び出しただけでは何も変わりません。

なぜエラーが出ないのか

出力: hello

（エラーなし）

TypeScriptは何も報告しません。型検査も構文も正しいためです

出力: hello

実際の挙動 — 期待した結果と食い違っている箇所

見つけ方

エラーが出ないので、出力を目で確かめるか、コードを目で追うしかありません。この種の誤りが最も発見が遅れます

このエラーが出る典型パターン

 1  let s: string = "hello";
 2  s.toUpperCase();    
              ^
 3  console.log(s);

 1  let name: string = "  Al  ";
 2  name.trim();       
             ^
 3  console.log(`[${name}]`);

 1  let text: string = "a-b-c";
 2  text.replace("-", "_");       
                   ^
 3  console.log(text);

 1  let s: string = "world";
 2  s.toUpperCase();    
              ^
 3  console.log(s);

 1  let t: string = " Hi ";
 2  t.trim();    
          ^
 3  console.log(`[${t}]`);

よくある誤解

「メソッドを呼べば元の変数の中身が変わるはず」という思い込みは、TypeScript・JavaScriptの文字列（プリミティブ値）には当てはまりません。文字列は不変（immutable）なので、変更後の値を使うには戻り値を代入し直す必要があります。

実務での勘所

配列にはpushやsortのように「自分自身を変更した上で何かを返す」メソッドが存在しますが、文字列の型定義(lib.d.ts)には、そもそも中身を書き換えるメソッドが1つも用意されていません。toUpperCaseもreplaceも、必ず新しい文字列を作って返すメソッドとして定義されています。配列の場合は「変更するメソッドの戻り値を誤解する」ことが問題になりますが、文字列の場合はそもそも「変更するメソッド」という選択肢自体が型定義の時点で存在しません。

演習をはじめる

関連するエラー

• Array.prototype.sort()が数値を文字列として並べ替える理由比較関数を渡さないsort()は、number[]という型が付いていても要素を文字列に変換してUnicodeコードポイント順に並べ替えます。
• 文字列と数値の+の左結合で意図しない連結になる文字列と数値を+で連続してつなげると、最初の+で文字列に変換され、それ以降の+はすべて文字列連結として扱われます。