varキーワードを用いた変数宣言の仕組みと現在の推奨される代替方法についてわかりやすく解説

スポンサーリンク
スポンサーリンク
amazon
スマイルSALE
--:--:--
~
ad. 価格範囲を指定して商品を探せます

varの概要

変数宣言 JavaScript予約語

var

概要 var(バー)は、JavaScriptの黎明期(ECMAScript 5以前)から存在する、変数を宣言するためのキーワードです。
かつては唯一の変数宣言手段でしたが、独特なスコープ規則や挙動(巻き上げなど)が原因で大規模開発におけるバグの温床となりやすかったため、ES2015(ES6)以降は、より厳格で安全な let や const に主役の座を譲りました。現代のモダン開発においては、意図的に使用する理由がほぼ存在しない「非推奨(レガシー)」な機能と位置づけられています。

わかりやすく説明 varは、ルールが緩すぎて「どこからでも中身を書き換えたり、同じ名前で何度も作り直せてしまう」少し危なっかしい変数の箱です。現在は、よりルールがしっかりした let や const を使うのが鉄則です。

  • 「関数スコープ(関数内全体が境界線)」を基準に動くため、if 文や for 文の波括弧(ブロック)を突き破って外部に影響を及ぼします。
  • 同じスコープ内で、全く同じ変数名を使って何度も上書き宣言(再宣言)することが許されてしまいます。
  • 宣言の記述より手前でその変数にアクセスしてもエラーにならず、undefined が返る「ホイスティング(変数の巻き上げ)」という特殊な現象を引き起こします。

varの基本的な使い方とリスク

var の持つ「制約の緩さ」は、一見すると便利に思えますが、コードの規模が大きくなるとタイポや意図しない上書きに気づけなくなる重大な欠陥へと変わります。

// 1. 基本的な変数宣言と値の代入
var message = "こんにちは";
console.log(message); // 出力: こんにちは

// 2. 値の書き換え(再代入)が可能
message = "こんばんは";
console.log(message); // 出力: こんばんは

// 3. ⚠️ 危険:同じ名前での「再宣言」がエラーにならず通ってしまう
var message = "おはよう"; 
console.log(message); // 出力: おはよう (エラーを出さずに前のデータを完全に破壊する)

varのスコープ特性(関数スコープ vs ブロックスコープ)

var が非推奨となった最大の原因は、スコープ(変数の有効範囲)の広さにあります。let や const が if や for のブロック({})に閉じ込められるのに対し、var はブロックを無視して関数全体に広がります。

// A. varによるスコープの「突き破り」現象
function testVar() {
    var x = 10;
    
    if (true) {
        var x = 20; // ⚠️ 別個に作ったつもりが、関数全体に広がるため上の「x」と同じものを上書きしている
        console.log("ブロック内(var):", x); // 出力: 20
    }
    
    console.log("ブロック外(var):", x); // 出力: 20 ❌ 10のままにしておきたかったデータが汚染されている
}
testVar();

// B. letによる正常なカプセル化(モダンなアプローチ)
function testLet() {
    let x = 10;
    
    if (true) {
        let x = 20; // ⭕ ブロック内だけの「完全に独立した別のx」が生まれる
        console.log("ブロック内(let):", x); // 出力: 20
    }
    
    console.log("ブロック外(let):", x); // 出力: 10 ⭕ ブロック外のオリジナルの値が安全に守られている
}
testLet();

現代の標準:letとconstの使い分け

モダンなJavaScript開発では、var は一切封印し、再代入の有無に応じて let と const を使い分けます。

// 値を後から変更したい場合は「let」を使用
let counter = 0;
counter += 1; // ⭕ 再代入可能

// 値を固定し、予期せぬ変更を防ぎたい場合は「const」を使用(基本はこちらを最優先)
const maxLimit = 100;
// maxLimit = 200; // 🛑 エラーが発生し、開発者のミスを即座にブロックする

注意点

  • ホイスティング(変数の巻き上げ)に伴うバグ: var で宣言された変数は、内部的に「スコープの先頭で、中身が undefined の状態で箱だけが用意された」とみなされます。これにより、宣言文より手前で変数を呼び出してもエラー(ReferenceError)にならず、プログラムが中途半端に動き続けてしまう原因になります。
    // ⚠️ var特有のホイスティングの不自然な挙動
    console.log(tempData); // 出力: undefined ❌ エラーにならず通過してしまう
    var tempData = "秘密のデータ";
    
    // ⭕ let / const であれば実行前にエラーとなり、不健全なコードを未然に防げる
    // console.log(modernData); // 🛑 ReferenceError: Cannot access 'modernData' before initialization
    // let modernData = "安全なデータ";
    
  • グローバルオブジェクト(window)への自動登録: 関数の外(グローバルスコープ)で var を使って変数を宣言すると、ブラウザ環境ではその変数が自動的に window オブジェクトのプロパティとして追加されてしまいます。これは、外部のライブラリや他のスクリプトが持つ共通機能を予期せず破壊(グローバル汚染)するリスクを高めます。
    // ⚠️ varによるグローバル空間の汚染例
    var globalTaxRate = 0.1;
    console.log(window.globalTaxRate); // 出力: 0.1 ❌ windowオブジェクトに勝手に生えてしまう
    
    let safeTaxRate = 0.1;
    console.log(window.safeTaxRate);   // 出力: undefined ⭕ windowを汚さず安全に独立している
    

よくある質問

Q: for ループのカウンタ(i)を var で宣言すると、具体的にどのような問題が起きますか?
A: ループが終わった後も、カウンタ変数 i が消滅せずに外部に残ってしまい、周辺の他の処理を誤動作させる原因になります。また、ループ内で非同期処理(setTimeout やイベントリスナー)を挟んだ際、すべての非同期処理が「ループ終了後の最終的な i の値」を参照してしまうという、JavaScriptの歴史上で最も有名なスコープバグの原因にもなります。let を使えば、ループの1回転ごとに新しいスコープが生成されるため、この問題は100%解決します。

// ⚠️ varが引き起こす非同期ループの有名なバグ例
for (var i = 1; i <= 3; i++) {
    setTimeout(function() {
        console.log("varの出力:", i); // ❌ 1, 2, 3 ではなく「4」が3回出力されてしまう
    }, 100);
}

// ⭕ letに書き換えるだけで直感通りの挙動になる
for (let j = 1; j <= 3; j++) {
    setTimeout(function() {
        console.log("letの出力:", j); // ✨ 正しく「1」「2」「3」が順番に出力される
    }, 100);
}
Q: 開発中の古いプロジェクトに var が大量に残っています。これらは全て let や const に書き換えるべき(リファクタリングすべき)でしょうか?
A: 長期的にメンテナンスするプロジェクトであれば書き換えを推奨しますが、一括で機械的に置換するのは非常に危険です。
古いコードの中には、前述した var の「ブロックスコープを持たない緩さ」や「ホイスティング」を逆に前提として、アクロバティックに動いているロジックが存在する可能性があるからです。リファクタリングを行う際は、対象の関数に十分なユニットテストを用意した上で、1箇所ずつ挙動が変わらないか入念に検証しながら、安全に const(変更が必要な場所は let)へ移行してください。

まとめ

varキーワードは、JavaScriptの過去の設計思想(後方互換性)を維持するためだけに存続しているレガシーな変数宣言命令です。

  • 現代のECMAScript標準において、新しく書くコードで var を選択するメリットは皆無であり、ES2015以降のプロジェクトではコード規約やLinter(ESLintなど)で記述そのものを一律禁止にするのが一般的です。
  • 変数宣言の基本は「再代入を許さない const」をデフォルトとし、ループのカウンタや状態が変化するフラグなど、どうしても中身を上書きする必要があるシーンにのみ「ブロックスコープを持つ let」を限定投入するのがベストプラクティスです。
  • 関数スコープや巻き上げといった var 固有の歪んだ挙動を理解しておくことは、古いシステムのソースコードを解読・改修する際の強力なディフェンス知識となります。