本文へ移動
プログラミング大全動かして、比べて、理解する。

JavaScript / コードを試す

String.prototype.replace() と replaceAll()

replace() は文字列を渡すと最初の1つしか置き換えません。全部置き換える書き方、 $ が特別扱いされる落とし穴、関数で置き換える方法までを実行して確かめます。

固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。

元の教材を読む(別タブ)

コードを編集して試す

ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。

playground.js

8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。

パネルを開くと編集できます。

現在の入力は未実行です。

今回の実行結果
JavaScriptUTF-8 · LF

実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。

replace() に文字列を渡すと、最初に見つかった1つだけが置き換わります。 全部置き換えたいなら replaceAll() です。

example.js

const text = 'a-b-c';

console.log(text.replace('-', '+'));
console.log(text.replaceAll('-', '+'));
console.log(text);
固定例の期待出力 · Node 24.22.3
a+b-c
a+b+c
a-b-c
表示用コードUTF-8 · LF

元の文字列は変わりません。戻り値を受け取ってください。

上のコードは書き換えて実行できます。'-' を 'b' にしてみてください。

何を渡せるか

第1引数 置き換わる数
文字列(replace) 最初の1つだけ
文字列(replaceAll) 全部
正規表現(g なし) 最初の1つだけ
正規表現(g あり) 全部
example.js

const text = 'a-b-c';

console.log(text.replace(/-/, '+'));
console.log(text.replace(/-/g, '+'));
console.log(text.replaceAll(/-/g, '+'));
固定例の期待出力 · Node 24.22.3
a+b-c
a+b+c
a+b+c
表示用コードUTF-8 · LF

replaceAll() に正規表現を渡すときは g が必須です。 無いと例外になります。

javascript失敗・注意の例

console.log('a-b'.replaceAll(/-/, '+'));
固定例の期待出力 · Node 24.22.3
TypeError: String.prototype.replaceAll called with a non-global RegExp argument
表示用コードUTF-8 · LF

$ が特別扱いされる

置き換える側の文字列に $ があると、そのまま入りません。 $& は「一致した部分」という意味を持ちます。

javascript失敗・注意の例

console.log('価格'.replace('価格', '$&$&'));
console.log('a'.replace('a', '$$'));
console.log('a'.replace('a', '100$'));
固定例の期待出力 · Node 24.22.3
価格価格
$
100$
表示用コードUTF-8 · LF
書き方 入るもの
$$ $ 1文字
$& 一致した部分
$` 一致した部分より前
$' 一致した部分より後ろ
$1 $2 … キャプチャした部分

利用者が入力した文字を置き換える側に渡すときは、これが事故になります。

javascript失敗・注意の例

const userInput = "$&$&$&";

console.log('ここ'.replace('ここ', userInput));
固定例の期待出力 · Node 24.22.3
ここここここ
表示用コードUTF-8 · LF

入れたはずの文字と違うものが出ました。

直しかた

関数を渡します。 関数の戻り値はそのまま入ります。

example.js

const userInput = "$&$&$&";

console.log('ここ'.replace('ここ', () => userInput));
固定例の期待出力 · Node 24.22.3
$&$&$&
表示用コードUTF-8 · LF

$ を自分で書ける形にしたいなら、$$ に置き換えてから渡します。

example.js

const userInput = "100$";

console.log('X'.replace('X', userInput.replaceAll('$', '$$$$')));
固定例の期待出力 · Node 24.22.3
100$
表示用コードUTF-8 · LF

$$$$ が $$ 2つぶんで、結果として $ 1文字になります。読みにくいので、関数を渡すほうを勧めます。

関数で置き換える

関数には一致した文字列が渡ります。位置ごとに違う結果を返せます。

example.js

const text = 'a1b22c333';

console.log(text.replace(/\d+/g, (m) => `[${m.length}桁]`));
固定例の期待出力 · Node 24.22.3
a[1桁]b[2桁]c[3桁]
表示用コードUTF-8 · LF

キャプチャした部分は2つ目以降の引数で受け取ります。

example.js

const text = '2026-09-07';

console.log(text.replace(/(\d{4})-(\d{2})-(\d{2})/, (m, y, mo, d) => `${y}年${mo}月${d}日`));
固定例の期待出力 · Node 24.22.3
2026年09月07日
表示用コードUTF-8 · LF

09 と 07 のまま出ています。関数の中で好きに直せるのが、文字列で書く場合との違いです。

example.js

const text = '2026-09-07';

console.log(text.replace(/(\d{4})-(\d{2})-(\d{2})/, (m, y, mo, d) => `${y}年${Number(mo)}月${Number(d)}日`));
固定例の期待出力 · Node 24.22.3
2026年9月7日
表示用コードUTF-8 · LF

文字列で書くなら $1 $2 を使います。こちらのほうが短く読めます。

example.js

console.log('2026-09-07'.replace(/(\d{4})-(\d{2})-(\d{2})/, '$1年$2月$3日'));
固定例の期待出力 · Node 24.22.3
2026年09月07日
表示用コードUTF-8 · LF

名前付きキャプチャ

数字より、名前のほうが読めます。

example.js

const text = '2026-09-07';
const re = /(?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2})/;

console.log(text.replace(re, '$<year>/$<month>/$<day>'));
console.log(text.match(re).groups.year);
固定例の期待出力 · Node 24.22.3
2026/09/07
2026
表示用コードUTF-8 · LF

正規表現の特殊文字に気をつける

利用者の入力を第1引数に渡すときも注意が要ります。 replaceAll() に文字列を渡すぶんには安全ですが、正規表現にすると意味が変わります。

javascript失敗・注意の例

const keyword = 'a.c';

console.log('abc axc a.c'.replaceAll(keyword, '■'));
console.log('abc axc a.c'.replace(new RegExp(keyword, 'g'), '■'));
固定例の期待出力 · Node 24.22.3
abc axc ■
■ ■ ■
表示用コードUTF-8 · LF

. が任意の1文字として扱われ、abc も axc も消えました。

文字列で済むなら replaceAll() に文字列を渡してください。 正規表現にする必要があるなら、先に逃がします。

example.js

function escapeRe(s) {
  return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
}

const keyword = 'a.c';

console.log(escapeRe(keyword));
console.log('abc axc a.c'.replace(new RegExp(escapeRe(keyword), 'g'), '■'));
固定例の期待出力 · Node 24.22.3
a\.c
abc axc ■
表示用コードUTF-8 · LF

大文字と小文字を無視する

i フラグを付けます。文字列を渡す方法ではできません。

example.js

const text = 'Apple apple APPLE';

console.log(text.replaceAll('apple', '■'));
console.log(text.replace(/apple/gi, '■'));
固定例の期待出力 · Node 24.22.3
Apple ■ APPLE
■ ■ ■
表示用コードUTF-8 · LF

g フラグ付きの正規表現を使い回さない

g を付けた正規表現は内部に位置を覚えます。 replace() は使うたびに戻しますが、test() や exec() は戻しません。

javascript失敗・注意の例

const re = /a/g;

console.log(re.test('abc'));
console.log(re.test('abc'));
console.log(re.lastIndex);
固定例の期待出力 · Node 24.22.3
true
false
0
表示用コードUTF-8 · LF

同じ文字列を調べたのに、2回目は falseです。 1回目で位置が進み、2回目は最後まで行って 0 に戻ったところです。

判定に使うなら g を外すか、毎回作り直してください。

example.js

console.log(/a/.test('abc'));
console.log(/a/.test('abc'));
固定例の期待出力 · Node 24.22.3
true
true
表示用コードUTF-8 · LF

分割の話は String.prototype.split() にまとめてあります。

置き換えではなく「探すだけ」「分けるだけ」で足りる場面も多くあります。判断の目安はこちらです。 → 文字列を探す・分ける・置き換える

出典

この教材の原文(Markdown・別タブ)