JavaScriptの文字列操作でよくあるエラーと解決法まとめ！初心者でもわかる対処法

1. undefinedやnullにアクセスしてしまう

1. undefinedやnullにアクセスしてしまう

JavaScriptでは、文字列がundefinedやnullの状態でlengthやcharAtを使うとエラーになります。

let str;
console.log(str.length); // エラー

Uncaught TypeError: Cannot read property 'length' of undefined

対処法：文字列が定義されているか確認してから操作します。

let str = "Hello";
if (str) {
  console.log(str.length); // 5
}

5

2. インデックスの範囲外を指定する

2. インデックスの範囲外を指定する

文字列のインデックスは0から始まります。存在しない位置にアクセスするとundefinedが返ります。

const str = "JavaScript";
console.log(str[20]); // undefined

undefined

対処法：文字列の長さをlengthで確認してからアクセスします。

const str = "JavaScript";
if (str.length > 5) {
  console.log(str[5]); // c
}

c

3. splitで空文字や予期しない文字を使う

3. splitで空文字や予期しない文字を使う

splitは文字列を指定した区切り文字で分割しますが、空文字や間違った文字を指定すると予期しない結果になることがあります。

const str = "Hello World";
console.log(str.split("")); // 文字ごとの配列
console.log(str.split(",")); // ["Hello World"]

["H","e","l","l","o"," ","W","o","r","l","d"]
["Hello World"]

対処法：分割したい文字を正しく指定し、空文字の場合の挙動を理解しておくことが大切です。

4. replaceで正規表現と文字列の違いを理解していない

4. replaceで正規表現と文字列の違いを理解していない

replaceはデフォルトでは最初に見つかった文字列だけを置き換えます。全て置換したい場合は正規表現の/gフラグを使います。

let str = "abc abc";
console.log(str.replace("abc", "xyz")); // xyz abc
console.log(str.replace(/abc/g, "xyz")); // xyz xyz

xyz abc
xyz xyz

対処法：全置換する場合は正規表現を使い、意図しない部分だけ置換されないように注意します。

5. trimや文字列結合で型を意識していない

5. trimや文字列結合で型を意識していない

trimは文字列型でしか使えません。数値やnullに対して使うとエラーになります。また、文字列結合で数値と文字列を混ぜる場合は意図通りの型変換がされるか確認が必要です。

let num = 123;
console.log(num.trim()); // エラー

Uncaught TypeError: num.trim is not a function

対処法：文字列型かどうかを確認するか、String()で変換してから操作します。

let num = 123;
console.log(String(num).trim()); // "123"

123

6. 文字列操作時の総合対策

6. 文字列操作時の総合対策

文字列操作のエラーを避けるには、次のポイントを押さえましょう。

• 文字列がnullやundefinedでないか確認する
• インデックスの範囲内か確認する
• 関数の使い方（split, replace, trimなど）を正しく理解する
• 数値や他の型と混在する場合は型変換を意識する

これらの基本を押さえておくと、文字列操作のエラーを大幅に減らせます。

この記事を読んだ人からの質問

この記事を読んだ人からの質問

プログラミング初心者からのよくある疑問／質問を解決します

C++のビルド管理とは、具体的にどのような作業を指すのでしょうか？

C++におけるビルド管理とは、複数のプログラムの部品を正しい順番で自動的に組み立て、実行可能な形式にする仕組みのことです。プログラミング初心者の方向けに分かりやすく料理で例えると、レシピを見ながら材料を切り、焼き、盛り付けるという一連の流れを、パソコンに記憶させて自動化する役割を持っています。C++はファイル数が増えやすいため、手作業で翻訳作業（コンパイル）を行うとミスが起こりやすくなります。そこで、MakefileやCMakeといった専用のツールを活用して、効率的かつ安全にプログラムを完成させるのが、開発におけるベストプラクティスとされています。