JavaScript Tips | 文字列操作：改行コードを統一する

改行コードを統一するとは

業務システムやWebアプリケーションでは、メモ欄、メール本文、CSVデータ、ログファイル、テキストファイルなどの文字列を扱う機会が非常に多くあります。 その際に意外と問題になるのが「改行コードの違い」です。

見た目では同じ改行に見えても、実際にはOSや環境によって異なる文字が使用されています。 この違いを放置すると、文字列比較の失敗、検索不一致、ファイル出力トラブル、システム間連携エラーなどの原因になります。

そのため実務では、文字列処理の前段階として「改行コードを統一する」という正規化処理を行うことが非常に重要です。

まずは改行コードの種類を理解しよう

改行には主に3種類あります。

例えば同じ文章でも内部データは次のようになります。

JavaScript
Utility
Guide

Windows環境では内部的に次のようになります。

JavaScript\r\nUtility\r\nGuide

Linux環境では次のようになります。

JavaScript\nUtility\nGuide

人間には同じ文章に見えますが、コンピュータから見ると異なる文字列として扱われます。

なぜ改行コードを統一する必要があるのか

文字列比較が失敗する場合がある

例えば次の2つの文字列を比較してみましょう。

const text1 = "JavaScript\r\nGuide";
const text2 = "JavaScript\nGuide";

console.log(text1 === text2);

const text1 = "JavaScript\r\nGuide";
const text2 = "JavaScript\nGuide";

console.log(text1 === text2);

実行結果

false

見た目は同じでも改行コードが異なるため一致しません。

実務ではCSV比較、設定ファイル比較、ログ比較などでよく発生します。

検索処理に影響する

改行コードが異なることで検索条件が一致しない場合があります。

const savedText = "JavaScript\r\nGuide";
const inputText = "JavaScript\nGuide";

const savedText = "JavaScript\r\nGuide";
const inputText = "JavaScript\nGuide";

このまま比較すると一致しません。

検索前に改行コードを統一することで問題を防げます。

外部システム連携でトラブルになる

業務システムでは他システムとのデータ連携が頻繁に行われます。

• CSV出力
• API通信
• バッチ処理
• ログ収集
• ファイルアップロード

これらの場面で改行コードの違いによる不具合が発生することがあります。

基本的な改行コード統一方法

もっとも一般的な方法は、すべての改行コードをLF（\n）へ統一する方法です。

// サンプル文字列
const text = "JavaScript\r\nUtility\rGuide\nSample";

// 改行コードをLFへ統一
const result = text.replace(/\r\n|\r/g, "\n");

console.log(result);

// サンプル文字列
const text = "JavaScript\r\nUtility\rGuide\nSample";

// 改行コードをLFへ統一
const result = text.replace(/\r\n|\r/g, "\n");

console.log(result);

実行後はすべての改行がLFになります。

正規表現の意味を理解しよう

/\r\n|\r/g

/\r\n|\r/g

各要素の意味は次の通りです。

• \r\n → Windows形式（CRLF）
• | → または
• \r → CR形式
• g → 文字列全体を対象

つまりWindows形式と旧Mac形式をLFへ変換しています。

Windows形式（CRLF）へ統一する方法

アプリケーションによってはWindows形式を要求されることがあります。

その場合は一度LFへ統一してからCRLFへ変換します。

// 改行をWindows形式へ統一
const result = text
    .replace(/\r\n|\r/g, "\n")
    .replace(/\n/g, "\r\n");

console.log(result);

// 改行をWindows形式へ統一
const result = text
    .replace(/\r\n|\r/g, "\n")
    .replace(/\n/g, "\r\n");

console.log(result);

この方法なら混在している改行コードでも安全に統一できます。

ステップバイステップで処理の流れを理解しよう

変換前

JavaScript\r\nUtility\rGuide\nSample

ステップ1：LFへ統一

JavaScript\nUtility\nGuide\nSample

ステップ2：必要に応じてCRLFへ変換

JavaScript\r\nUtility\r\nGuide\r\nSample

実務ではまずLFへ統一する考え方を覚えておくと分かりやすいです。

業務で使えるテンプレート関数

LFへ統一する関数

/**
 * 改行コードをLFへ統一する
 *
 * @param {string} text 対象文字列
 * @returns {string} LF統一後文字列
 */
function normalizeLineFeed(text) {

    // null対策
    if (text == null) {
        return "";
    }

    return String(text)
        .replace(/\r\n|\r/g, "\n");
}

// 使用例
const result =
    normalizeLineFeed(
        "JavaScript\r\nUtility\rGuide\nSample"
    );

console.log(result);

/**
 * 改行コードをLFへ統一する
 *
 * @param {string} text 対象文字列
 * @returns {string} LF統一後文字列
 */
function normalizeLineFeed(text) {

    // null対策
    if (text == null) {
        return "";
    }

    return String(text)
        .replace(/\r\n|\r/g, "\n");
}

// 使用例
const result =
    normalizeLineFeed(
        "JavaScript\r\nUtility\rGuide\nSample"
    );

console.log(result);

CRLFへ統一する関数

/**
 * 改行コードをCRLFへ統一する
 *
 * @param {string} text 対象文字列
 * @returns {string} CRLF統一後文字列
 */
function normalizeCRLF(text) {

    // null対策
    if (text == null) {
        return "";
    }

    return String(text)
        .replace(/\r\n|\r/g, "\n")
        .replace(/\n/g, "\r\n");
}

// 使用例
const result =
    normalizeCRLF(
        "JavaScript\r\nUtility\rGuide\nSample"
    );

console.log(result);

/**
 * 改行コードをCRLFへ統一する
 *
 * @param {string} text 対象文字列
 * @returns {string} CRLF統一後文字列
 */
function normalizeCRLF(text) {

    // null対策
    if (text == null) {
        return "";
    }

    return String(text)
        .replace(/\r\n|\r/g, "\n")
        .replace(/\n/g, "\r\n");
}

// 使用例
const result =
    normalizeCRLF(
        "JavaScript\r\nUtility\rGuide\nSample"
    );

console.log(result);

実務でよくある活用例

CSVファイルの正規化

// CSVデータ読込
const csvText = fileContent;

// 改行コード統一
const normalized =
    csvText.replace(/\r\n|\r/g, "\n");

// CSVデータ読込
const csvText = fileContent;

// 改行コード統一
const normalized =
    csvText.replace(/\r\n|\r/g, "\n");

異なるOSで作成されたCSVを安全に処理できます。

APIレスポンスの比較

// APIレスポンス正規化
const normalizedResponse =
    responseText.replace(/\r\n|\r/g, "\n");

// APIレスポンス正規化
const normalizedResponse =
    responseText.replace(/\r\n|\r/g, "\n");

比較処理の前に正規化しておくことで誤判定を防げます。

ログ解析

// ログデータ正規化
const normalizedLog =
    logData.replace(/\r\n|\r/g, "\n");

// ログデータ正規化
const normalizedLog =
    logData.replace(/\r\n|\r/g, "\n");

ログファイルの解析処理が安定します。

情報セキュリティの観点で重要なポイント

入力データは必ず正規化する

セキュリティ対策では入力値の正規化が重要です。

改行コードの違いによって本来同じデータが別データとして扱われると、重複チェックやデータ整合性確認の精度が低下する可能性があります。

特に以下のような処理では正規化を推奨します。

• ユーザー登録
• 検索機能
• CSV取込
• ファイル比較
• 監査ログ保存

単純な置換に注意する

初心者の方がやりがちな失敗として、次のようなコードがあります。

text.replace(/\r/g, "");

text.replace(/\r/g, "");

この方法ではCRLFがLFへ変換されるため偶然うまく動く場合もありますが、意図が分かりにくく保守性が低下します。

実務では必ず「改行コードの統一」を明示的に行うコードを書くようにしましょう。

改行コード統一と改行削除の違い

よく混同されるので整理しておきましょう。

例えば次の文字列がある場合、

JavaScript
Utility
Guide

改行コード統一後は、

JavaScript
Utility
Guide

見た目は変わりません。

一方で改行削除すると、

JavaScriptUtilityGuide

になります。

目的に応じて使い分けることが重要です。

まとめ

改行コードの統一は、JavaScriptの文字列正規化処理の中でも実務利用頻度が非常に高いテクニックです。

• 改行コードにはLF、CRLF、CRの種類がある
• 異なるOSでは異なる改行コードが使用される
• 比較処理や検索処理の前には統一が重要
• LFへ統一する場合は「replace(/\r\n|\r/g, “\n”)」を利用する
• CSV、API、ログ解析などで頻繁に活用される
• 入力値の正規化は品質向上と保守性向上につながる

改行コードの統一は地味な処理に見えるかもしれません。しかし実務では、クロスプラットフォーム対応、データ品質向上、検索精度向上、システム連携の安定化に大きく貢献する重要な技術です。JavaScriptで文字列を扱う際の基本テクニックとして、ぜひ確実に身につけておきましょう。