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

JavaScript / コードを試す

テンプレートリテラル — 値を埋める・改行する・加工する

バッククォートで囲むと値を埋め込め、改行もそのまま書けます。何を入れても文字列になること、オブジェクトが [object Object] になること、タグ付きテンプレートの仕組みまで実行して確かめます。

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

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

コードを編集して試す

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

playground.js

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

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

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

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

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

バッククォートで囲むと、${} の中に式を書けます。

example.js

const name = '猫';
const count = 3;

console.log(`${name}が${count}匹`);
console.log(`1 + 1 = ${1 + 1}`);
console.log(`1行目
2行目`);
固定例の期待出力 · Node 24.22.3
猫が3匹
1 + 1 = 2
1行目
2行目
表示用コードUTF-8 · LF
  • 式が書けます。変数だけでなく計算も関数呼び出しも入ります
  • 改行をそのまま書けます。 \n を書く必要はありません

何を入れても文字列になる

example.js

for (const value of [null, undefined, [1, 2], { a: 1 }, true]) {
  console.log(`値: ${value}`);
}
固定例の期待出力 · Node 24.22.3
値: null
値: undefined
値: 1,2
値: [object Object]
値: true
表示用コードUTF-8 · LF

null も undefined もそのまま文字になります。 「無いから空にしたい」なら、自分で書いてください。

example.js

const missing = null;

console.log(`値: ${missing ?? '(未設定)'}`);
固定例の期待出力 · Node 24.22.3
値: (未設定)
表示用コードUTF-8 · LF

→ ?. と ??

オブジェクトは [object Object] になる

javascript失敗・注意の例

const user = { name: 'あ' };

console.log(`ユーザー: ${user}`);
固定例の期待出力 · Node 24.22.3
ユーザー: [object Object]
表示用コードUTF-8 · LF

ログに出したつもりで、中身が消えます。 見たいなら JSON.stringify() を挟んでください。

example.js

const user = { name: 'あ' };

console.log(`ユーザー: ${JSON.stringify(user)}`);
固定例の期待出力 · Node 24.22.3
ユーザー: {"name":"あ"}
表示用コードUTF-8 · LF

配列はカンマで繋がりますが、これも join() が呼ばれているだけです。 → join() — 配列を1本の文字列にする

入れ子と条件

${} の中に、もう1つテンプレートリテラルを書けます。

example.js

const items = ['a', 'b'];

console.log(`<ul>${items.map((item) => `<li>${item}</li>`).join('')}</ul>`);
固定例の期待出力 · Node 24.22.3
<ul><li>a</li><li>b</li></ul>
表示用コードUTF-8 · LF

条件は三項演算子で書きます。

example.js

const count = 0;

console.log(`件数: ${count > 0 ? `${count}件` : 'なし'}`);
固定例の期待出力 · Node 24.22.3
件数: なし
表示用コードUTF-8 · LF

if 文は書けません。 式だけです。 入れ子が2段を超えたら、先に変数へ出してください。 読めなくなります。

+ と比べて

example.js

const name = 'あ';
const age = 20;

console.log('名前: ' + name + ' / 年齢: ' + age + '歳');
console.log(`名前: ${name} / 年齢: ${age}歳`);
固定例の期待出力 · Node 24.22.3
名前: あ / 年齢: 20歳
名前: あ / 年齢: 20歳
表示用コードUTF-8 · LF

結果は同じです。ですが + は、数と混ざったときに足し算になります。

javascript失敗・注意の例

const price = 100;

console.log('合計: ' + price + 50 + '円');
console.log(`合計: ${price + 50}円`);
固定例の期待出力 · Node 24.22.3
合計: 10050円
合計: 150円
表示用コードUTF-8 · LF

混ぜるならテンプレートリテラルです。 → 文字列の基本 — 作る・つなぐ・数える

タグ付きテンプレート

関数名をバッククォートの直前に書くと、分解された状態で受け取れます。

example.js

function tag(strings, ...values) {
  console.log(strings);
  console.log(values);
  return strings.raw.join('|');
}

const x = 1;

console.log(tag`a${x}b${x + 1}c`);
固定例の期待出力 · Node 24.22.3
[ 'a', 'b', 'c' ]
[ 1, 2 ]
a|b|c
表示用コードUTF-8 · LF
  • 第1引数 … ${} で切られた文字の並び
  • 第2引数以降 … 埋め込まれた値

必ず「文字・値・文字・値・文字」の順で、 文字のほうが1つ多くなります。

これを使うと、埋め込む値だけをまとめて加工できます。

example.js

function escapeHtml(strings, ...values) {
  return strings.reduce((out, part, i) => {
    if (i === 0) return part;
    const escaped = String(values[i - 1]).replace(/</g, '&lt;').replace(/>/g, '&gt;');
    return out + escaped + part;
  }, '');
}

const input = '<script>';

console.log(escapeHtml`入力: ${input}`);
固定例の期待出力 · Node 24.22.3
入力: &lt;script&gt;
表示用コードUTF-8 · LF

これは仕組みを示すための最小の例です。実際の画面では、自分で組み立てず、枠組みの側の仕組みに任せてください。属性の中や URL の中では、必要な変換が違います。

String.raw

\ をそのままの文字として扱いたいときに使います。

example.js

console.log(String.raw`C:\new\table`);
console.log(`C:\new\table`.length);
固定例の期待出力 · Node 24.22.3
C:\new\table
10
表示用コードUTF-8 · LF

String.raw を付けないと、\n は改行、\t はタブとして扱われます。 正規表現やファイルパスを書くときに効きます。

よくある間違い:SQL やコマンドを組み立てる

javascript
const query = `SELECT * FROM users WHERE name = '${input}'`;
表示用コードUTF-8 · LF

これはやらないでください。 input に ' が入るだけで壊れ、意図しない命令が混ざります。

文字列として組み立てるのではなく、値は値として渡す仕組みを使ってください。 テンプレートリテラルは見やすくするためのもので、安全にするものではありません。

まとめ

  • ${} には式が書ける。改行はそのまま書ける
  • 何を入れても文字列になる。 null も undefined もそのまま出る
  • オブジェクトは [object Object] に化ける。JSON.stringify() を挟む
  • + と違い、数と混ざっても足し算にならない
  • タグ付きにすると、文字の並びと埋めた値を分けて受け取れる
  • String.raw は \ をそのままにする
  • SQL やコマンドを組み立てるのに使わない

出典

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