javascriptのドキュメント更新

public/docs/javascript/0-intro/2-0-environment.md

@@ -15,7 +15,7 @@ JavaScriptはどこで動くのでしょうか？ かつてはブラウザの中
   * **Webブラウザ (クライアントサイド):**
 
       * DOM (Document Object Model) 操作により、HTML/CSSを動的に書き換えます。
-      * `window` オブジェクトがグローバルスコープです。
+      * `window` [[オブジェクト]]がグローバルスコープです。
       * セキュリティ上の制約（サンドボックス）があり、ローカルファイルへの直接アクセスなどは制限されています。
 
   * **Node.js (サーバーサイド):**

public/docs/javascript/0-intro/4-1-repl.md

@@ -22,4 +22,5 @@ undefined
 3
 ```
 
-※ `undefined` は `console.log` 関数の戻り値が表示されています。
+> [!TIP]
+> [[`undefined`]] は `console.log` 関数の戻り値が表示されています。

public/docs/javascript/0-intro/4-3-browser.md

@@ -26,5 +26,6 @@ question:
 
 ブラウザの開発者ツール（Consoleタブ）にメッセージが表示され、ポップアップウィンドウが出れば成功です。
 
-my.code(); のチュートリアルでは主にJavaScriptの文法や基本的な機能を中心に扱います。
+> [!NOTE]
+> my.code(); のチュートリアルでは主にJavaScriptの文法や基本的な機能を中心に扱います。
 HTMLやCSSとあわせたウェブアプリケーション開発の基礎については [ut.code(); Learn](https://learn.utcode.net) で学ぶことができます。

public/docs/javascript/1-basics/1-0-variable.md

@@ -8,6 +8,11 @@ question:
   - varを使うべきではないとありますが、varを使うとどのような悪いことが起こるのですか？
   - 巻き上げ（Hoisting）とは、具体的にどのような現象ですか？
   - '`console.log("let output:", blockScoped);` がReferenceErrorになるのはなぜですか？'
+term:
+  - let
+  - const
+  - var
+  - 変数
 ---
 
 ## 変数宣言: let, const, var
@@ -20,8 +25,9 @@ ES6（2015年）で導入された `const` と `let` は、C++やJava、C\#な
   * **const**: 再代入不可能な変数を宣言します。定数だけでなく、再代入しない変数はすべてこれで宣言します。
   * **let**: 再代入可能な変数を宣言します。ループカウンタや、状態が変わる値に使用します。
 
-
-なぜ `var` を使うべきではないのでしょうか。それは `var` が**関数スコープ**であり、意図しない変数の共有や「巻き上げ（Hoisting）」によるバグを引き起こしやすいからです。
+> [!WARNING]
+> もう一つの変数を宣言する古いキーワードとして `var` があります。
+> `var` は**関数スコープ**であり、意図しない変数の共有や「巻き上げ（Hoisting）」によるバグを引き起こしやすいため、現在は `const` や `let` を使うことが推奨されています。
 
 以下のコードで、スコープの違いを確認してみましょう。
 

public/docs/javascript/1-basics/2-0-primitive-type.md

@@ -6,11 +6,14 @@ question:
   - プリミティブ型とは、ざっくり言うとどういう値のことですか？
   - プリミティブ型がイミュータブル（変更不可）というのは、どういう状態を指しますか？
   - SymbolやBigIntは、通常の開発でどのくらいの頻度で使うものですか？
+term:
+  - プリミティブ
+  - プリミティブ型
 ---
 
 ## データ型: プリミティブ型
 
-JavaScriptは動的型付け言語であり、変数は特定の型に紐付きませんが、値自体は型を持っています。JavaScriptの値は大きく分けて「プリミティブ型」と「オブジェクト（参照）型」に分類されます。
+JavaScriptは動的型付け言語であり、[[変数]]は特定の型に紐付きませんが、値自体は型を持っています。JavaScriptの値は大きく分けて「プリミティブ型」と「オブジェクト（参照）型」に分類されます。
 
 プリミティブ型はイミュータブル（変更不可）であり、以下の7種類が存在します。
 
@@ -19,7 +22,7 @@ JavaScriptは動的型付け言語であり、変数は特定の型に紐付き
 3.  **Boolean**: `true` または `false`
 4.  **undefined**: 「値が未定義である」ことを表す型
 5.  **null**: 「値が存在しない」ことを意図的に示す型
-6.  **Symbol**: 一意で不変な識別子（主にオブジェクトのプロパティキー用途）
+6.  **Symbol**: 一意で不変な識別子（主に[[オブジェクト]]のプロパティキー用途）
 7.  **BigInt**: `Number`型では表現できない巨大な整数を扱う型（末尾に `n`）
 
 この章では、まず最もよく使う `String` / `Number` / `Boolean` / `undefined` / `null` を順に見ていきます。`Symbol` と `BigInt` は用途が限定的なため、ここでは「プリミティブ型の一種」であることだけ押さえれば十分です。

public/docs/javascript/1-basics/2-1-string.md

@@ -6,13 +6,18 @@ question:
   - シングルクォートとダブルクォートで文字列を囲むことの違いは何ですか？
   - テンプレートリテラルは、どんな場面で使うと便利ですか？
   - テンプレートリテラルの `${}` の中に計算式を書けますか？
+term:
+  - 文字列
+  - String
+  - string
+  - テンプレートリテラル
 ---
 
 ### 文字列（String）
 
 JavaScriptの文字列は、シングルクォート (`'`) またはダブルクォート (`"`) で作成します。
 
-また、バッククォート (`` ` ``) で囲む**テンプレートリテラル**を使うと、変数や式を文字列に埋め込めます。文字列の連結（`+`）より読みやすくなることが多いため、こちらを使うのが一般的です。
+また、バッククォート (`` ` ``) で囲む**テンプレートリテラル**を使うと、[[変数]]や式を文字列に埋め込めます。文字列の連結（`+`）より読みやすくなることが多いため、こちらを使うのが一般的です。
 
 ```js-repl
 > const name = "Ada";

public/docs/javascript/1-basics/2-2-number.md

@@ -6,6 +6,10 @@ question:
   - JavaScriptで整数と小数を区別しないのは、どういう意味ですか？
   - 除算や剰余など、基本的な計算はどのように書けば良いですか？
   - 小数計算で誤差が出ることがあるのはなぜですか？
+term:
+  - 数値
+  - Number
+  - number
 ---
 
 ### 数値（Number）
@@ -35,4 +39,5 @@ undefined
 0.30000000000000004
 ```
 
-`0.1 + 0.2` のような小数計算で誤差が出るのは、JavaScriptが数値を内部的に2進数の浮動小数点として扱うためです。
+> [!TIP]
+> `0.1 + 0.2` のような小数計算で誤差が出るのは、JavaScriptが数値を内部的に2進数の浮動小数点として扱うためです。

public/docs/javascript/1-basics/2-3-boolean.md

@@ -5,6 +5,12 @@ level: 3
 question:
   - Boolean型はどんな場面で使いますか？
   - '`true` / `false` は文字列の `"true"` / `"false"` と何が違いますか？'
+term:
+  - 真偽値
+  - Boolean
+  - boolean
+  - "true"
+  - "false"
 ---
 
 ### 真偽値（Boolean）

public/docs/javascript/1-basics/2-4-undefined-null.md

@@ -6,13 +6,16 @@ question:
   - undefinedとnullは、どう使い分けるのが良いですか？
   - 変数を宣言しただけの状態がundefinedになるのはなぜですか？
   - '`typeof null` が `''object''` になるのは本当に正しいのですか？'
+term:
+  - "undefined"
+  - "null"
 ---
 
 ### undefined と null
 
 他言語経験者が最初に混乱しやすいのが、この `undefined` と `null` の違いです。
 
-- **undefined**: JavaScriptエンジンが「値がまだない」ことを示すときに現れます（例: 宣言だけして代入していない変数）。
+- **undefined**: JavaScriptエンジンが「値がまだない」ことを示すときに現れます（例: 宣言だけして代入していない[[変数]]）。
 - **null**: プログラマが「ここには値がない」と明示したいときに代入します。
 
 ```js-repl
@@ -28,4 +31,5 @@ undefined
 'object'
 ```
 
-`typeof null` が `'object'` になるのは、JavaScript初期から残っている歴史的な仕様です。`null` 自体はオブジェクトではなく、プリミティブ型の値です。
+> [!INFO]
+> `typeof null` が `'object'` になるのは、JavaScript初期から残っている歴史的な仕様です。`null` 自体は[[オブジェクト]]ではなく、[[プリミティブ型]]の値です。

public/docs/javascript/1-basics/3-0-object.md

@@ -6,17 +6,19 @@ question:
   - オブジェクト（参照型）とプリミティブ型は、メモリ上で具体的にどのように違うのですか？
   - JavaScriptでは関数もオブジェクトとありますが、これはどういうメリットがありますか？
   - キーと値のペアの集合、というのは具体的にどんなものですか？
+term:
+  - オブジェクト
 ---
 
 ## データ型: オブジェクト型
 
-プリミティブ以外のすべての値は**オブジェクト（参照型）**です。これらはメモリ上のアドレス（参照）として扱われます。
+[[プリミティブ]]以外のすべての値は**オブジェクト（参照型）**です。これらはメモリ上のアドレス（参照）として扱われます。
 
 主なオブジェクト型には以下があります。
 
   * **Object**: キーと値のペアの集合（辞書、ハッシュマップに近い）。詳しくは[[./5]]で解説します。
   * **Array**: 順序付きリスト。詳しくは[[./7]]で解説します。
-  * **Function**: JavaScriptでは関数もオブジェクトであり、変数に代入したり引数として渡すことができます（第一級関数）。
+  * **Function**: JavaScriptでは関数もオブジェクトであり、[[変数]]に代入したり引数として渡すことができます（第一級関数）。
 
 ```js-repl
 > // Object: キーと値のペアの集合

public/docs/javascript/1-basics/3-1-const-object.md

@@ -10,7 +10,7 @@ question:
 
 ### const とオブジェクトの変更
 
-重要な点として、`const` で宣言した変数は「再代入」ができませんが、中身がオブジェクトの場合、**プロパティの変更は可能**です。これは `const` が「参照先のメモリアドレス」を固定するものであり、ヒープ領域にあるデータそのものを不変にするわけではないためです。
+重要な点として、[[`const`]] で宣言した変数は「再代入」ができませんが、中身が[[オブジェクト]]の場合、**プロパティの変更は可能**です。これは [[`const`]] が「参照先のメモリアドレス」を固定するものであり、ヒープ領域にあるデータそのものを不変にするわけではないためです。
 
 ```js:object_mutation.js
 const user = {

public/docs/javascript/1-basics/4-0-equality.md

@@ -7,6 +7,9 @@ question:
   - 「暗黙的な型変換」とは、具体的にJavaScriptが何をしているのですか？
   - '`1 == "1"` がtrueになるのは、どのようなプロセスでそうなるのですか？'
   - '`null == undefined` がtrueになるのは、特別なルールがあるのですか？'
+term:
+  - 等価演算子
+  - 厳密等価演算子
 ---
 
 ## 演算子と等価性 (== vs ===)

public/docs/javascript/1-basics/5-1-add-operator.md

@@ -12,7 +12,7 @@ question:
 
 JavaScriptは文脈に応じて勝手に型を変換しようとします。
 
-`+` 演算子は、数値の加算だけでなく文字列の連結にも使われます。片方が文字列であれば、もう片方も文字列に変換されて連結されます。
+`+` 演算子は、[[数値]]の加算だけでなく[[文字列]]の連結にも使われます。片方が[[文字列]]であれば、もう片方も文字列に変換されて連結されます。
 
 ```js-repl
 > 10 + 20

public/docs/javascript/1-basics/6-0-summary.md

@@ -7,7 +7,7 @@ question: []
 
 ## この章のまとめ
 
-  * 変数は `const` をデフォルトとし、再代入が必要な場合のみ `let` を使う。`var` は使用しない。
-  * プリミティブ型は値渡し、オブジェクト型（配列含む）は参照渡しである。
-  * `const` で宣言したオブジェクトの中身は変更可能である。
-  * 比較には必ず `===`（厳密等価演算子）を使用し、`==` による暗黙の型変換を避ける。
+  * [[変数]]は [[`const`]] をデフォルトとし、再代入が必要な場合のみ [[`let`]] を使う。[[`var`]] は使用しない。
+  * [[プリミティブ型]]は値渡し、[[オブジェクト]]型（配列含む）は参照渡しである。
+  * [[`const`]] で宣言した[[オブジェクト]]の中身は変更可能である。
+  * 比較には必ず `===`（[[厳密等価演算子]]）を使用し、`==` による暗黙の型変換を避ける。

public/docs/javascript/1-basics/6-1-practice1.md

@@ -9,7 +9,7 @@ question:
 
 ### 練習問題1: テンプレートリテラル
 
-`itemName` という変数に商品名（文字列）、`price` という変数に価格（数値）、`stock` という変数に在庫数（数値）をそれぞれ代入してください。その後、テンプレートリテラルを使って「商品: [商品名], 価格: [価格]円, 在庫: [在庫数]個」という形式の文字列を作り、`console.log()` で出力するコードを書いてみましょう。
+`itemName` という[[変数]]に商品名（[[文字列]]）、`price` という[[変数]]に価格（[[数値]]）、`stock` という[[変数]]に在庫数（[[数値]]）をそれぞれ代入してください。その後、[[テンプレートリテラル]]を使って「商品: [商品名], 価格: [価格]円, 在庫: [在庫数]個」という形式の[[文字列]]を作り、`console.log()` で出力するコードを書いてみましょう。
 
 ```js:practice2_1.js
 ```

public/docs/javascript/1-basics/6-2-practice2.md

@@ -9,8 +9,8 @@ question:
 
 ### 練習問題2: constとオブジェクトの変更
 
-`const` を使って、`name`（商品名・文字列）と `price`（価格・数値）を持つ商品オブジェクト `product` を作成してください。
-次に、`price` を別の値に変更し、さらに `stock`（在庫数・数値）プロパティを新たに追加してから、`console.log()` でオブジェクトの内容を出力してみましょう。
+[[`const`]] を使って、`name`（商品名・[[文字列]]）と `price`（価格・[[数値]]）を持つ商品[[オブジェクト]] `product` を作成してください。
+次に、`price` を別の値に変更し、さらに `stock`（在庫数・[[数値]]）プロパティを新たに追加してから、`console.log()` で[[オブジェクト]]の内容を出力してみましょう。
 
 ```js:practice2_2.js
 ```

public/docs/javascript/2-control/1-1-if-truthy.md

@@ -14,22 +14,24 @@ question:
 
 基本的な `if` 文の構造はC言語やJavaと同様です。しかし、条件式における評価はJavaScript特有の**Truthy（真と見なされる値）**と**Falsy（偽と見なされる値）**の概念を理解する必要があります。
 
-厳密な `true` / `false` だけでなく、あらゆる値が条件式の中で真偽判定されます。
+厳密な [[`true`]] / [[`false`]] だけでなく、あらゆる値が条件式の中で真偽判定されます。
 
-**Falsyな値（falseとして扱われるもの）:**
+**Falsyな値（[[false]]として扱われるもの）:**
 
-  * `false`
+  * [[`false`]]
   * `0`, `-0`, `0n` (BigInt)
   * `""` (空文字)
-  * `null`
-  * `undefined`
+  * [[`null`]]
+  * [[`undefined`]]
   * `NaN`
 
-**Truthyな値（trueとして扱われるもの）:**
+**Truthyな値（[[true]]として扱われるもの）:**
 
   * 上記Falsy以外すべて
-  * **注意:** 空の配列 `[]` や 空のオブジェクト `{}` は **Truthy** です（Pythonなどの経験者は注意が必要です）。
-  * 文字列の `"0"` や `"false"` もTruthyです。
+
+> [!WARNING]
+> * 空の配列 `[]` や 空の[[オブジェクト]] `{}` は **Truthy** です（Pythonなどの経験者は注意が必要です）。
+> * [[文字列]]の `"0"` や `"false"` もTruthyです。
 
 ```js-repl
 > if (0) { 'True'; } else { 'False'; }

public/docs/javascript/2-control/1-2-switch.md

@@ -11,7 +11,7 @@ question:
 
 ## `switch`文
 
-`switch` 文も標準的ですが、比較が **厳密等価演算子 (`===`)** で行われる点に注意してください。型変換は行われません。
+`switch` 文も標準的ですが、比較が **[[厳密等価演算子]] (`===`)** で行われる点に注意してください。型変換は行われません。
 
 ```js:switch_example.js
 const status = "200"; // 文字列

public/docs/javascript/2-control/3-0-iteration.md

@@ -13,5 +13,5 @@ question:
 
 | 構文 | 取得するもの | 対象 | 推奨ユースケース |
 | :--- | :--- | :--- | :--- |
-| **`for...in`** | **キー (Key)** | Object | オブジェクトのプロパティ調査 |
-| **`for...of`** | **値 (Value)** | Array, String, Map, Set | 配列やリストデータの処理 |
+| **`for...in`** | **キー (Key)** | Object | [[オブジェクト]]のプロパティ調査 |
+| **`for...of`** | **値 (Value)** | Array, [[String]], Map, Set | 配列やリストデータの処理 |

public/docs/javascript/2-control/3-1-for-in.md

@@ -9,8 +9,8 @@ question:
 
 ### `for...in` ループ（プロパティ名の列挙）
 
-`for...in` はオブジェクトの **キー（プロパティ名）** を列挙するために設計されています。
-配列に対して使用すると、インデックス（"0", "1", ...）が文字列として返ってくるだけでなく、プロトタイプチェーン上のプロパティまで列挙してしまうリスクがあるため、**配列への使用は推奨されません**。
+`for...in` は[[オブジェクト]]の **キー（プロパティ名）** を列挙するために設計されています。
+配列に対して使用すると、インデックス（"0", "1", ...）が[[文字列]]として返ってくるだけでなく、プロトタイプチェーン上のプロパティまで列挙してしまうリスクがあるため、**配列への使用は推奨されません**。
 
 ```js:for_in_example.js
 const user = {

public/docs/javascript/2-control/3-2-for-of.md

@@ -12,7 +12,7 @@ question:
 ### `for...of` ループ（反復可能オブジェクトの走査）
 
 ES2015 (ES6) で導入された `for...of` は、**値（Values）** を反復します。
-配列、文字列、Map、Setなどの **Iterable（反復可能）** なオブジェクトに対して使用します。配列の中身を順番に処理したい場合は、こちらが正解です。
+配列、[[文字列]]、Map、Setなどの **Iterable（反復可能）** な[[オブジェクト]]に対して使用します。配列の中身を順番に処理したい場合は、こちらが正解です。
 
 ```js:for_of_example.js
 const languages = ["JavaScript", "Python", "Go"];
@@ -37,11 +37,11 @@ A
 I
 ```
 
-> **Tips:** オブジェクトの中身を `for...of` で回したい場合は、`Object.keys()`, `Object.values()`, `Object.entries()` を使うのがモダンな手法です。
-
-```js
-const obj = { a: 1, b: 2 };
-for (const [key, val] of Object.entries(obj)) {
-    console.log(key, val);
-}
-```
+> [!TIP]
+> [[オブジェクト]]の中身を `for...of` で回したい場合は、`Object.keys()`, `Object.values()`, `Object.entries()` を使うのがモダンな手法です。
+> ```js
+> const obj = { a: 1, b: 2 };
+> for (const [key, val] of Object.entries(obj)) {
+>     console.log(key, val);
+> }
+>```

public/docs/javascript/2-control/4-2-throw.md

@@ -9,7 +9,7 @@ question:
 
 ### `throw` について
 
-JavaScriptでは `throw` で例外を投げることができます。`Error` オブジェクトを投げるのが一般的ですが、技術的には文字列や数値など、任意の値を投げることが可能です（ただし、スタックトレースが取れなくなるため推奨されません）。
+JavaScriptでは `throw` で例外を投げることができます。`Error` [[オブジェクト]]を投げるのが一般的ですが、技術的には[[文字列]]や[[数値]]など、任意の値を投げることが可能です（ただし、スタックトレースが取れなくなるため推奨されません）。
 
 ```js-repl
 > try { throw new Error("Something went wrong"); } catch (e) { console.log(e.message); }