上級

プライベートフィールド外部アクセスの構文エラー原因

#で始まるプライベートフィールドを、宣言したクラスの外からドットで直接読み書きしようとしたときに出るエラーです。他のエラーと違い、実行前の構文解析の段階で検出されます。

エラーメッセージの読み方

main.js:6

main.js

ファイル名

6

行番号 — Node.jsが構文解析を諦めた位置

SyntaxError

エラークラス — 実行前の構文チェックで検出されました

Private field '#balance' must be declared in an enclosing class

内容 — 期待していたもの、または受け付けられなかったもの

このエラーが出る典型パターン

 1  class Account {
 2    #balance = 100;
 3    getBalance() { return this.#balance; }
 4  }
 5  const acc = new Account();
 6  console.log(acc.#balance    );
                        ^

 1  class Wallet {
 2    #balance = 500;
 3    deposit(amount) { this.#balance += amount; }
 4    getBalance() { return this.#balance; }
 5  }
 6  const w = new Wallet();
 7  w.deposit(100);
 8  console.log(w.#balance    );
                       ^

 1  class Timer {
 2    #seconds = 0;
 3    tick() { this.#seconds++; }
 4    getSeconds() { return this.#seconds; }
 5  }
 6  const t = new Timer();
 7  t.tick();
 8  t.tick();
 9  console.log(t.#seconds    );
                       ^

 1  class Vault {
 2    #code = "1234";
 3    verify(input) { return input === this.#code; }
 4  }
 5  const v = new Vault();
 6  console.log(v.#code         );
                        ^

 1  class Score {
 2    #points = 0;
 3    add(n) { this.#points += n; }
 4    getPoints() { return this.#points; }
 5  }
 6  const s = new Score();
 7  s.add(5);
 8  console.log(s.#points    );
                      ^

よくある誤解

プライベートフィールドへのアクセス制限は、実行時にチェックされる通常のエラー（TypeErrorなど）だと思われがちですが、実際には構文としてその場に存在してはいけないものとして扱われ、SyntaxErrorになります。クラスの外に公開したい値は、getterやメソッド経由で提供する必要があります。

実務での勘所

以前のJavaScriptには本当の意味でのプライベートは無く、_fieldのようにアンダースコアを先頭に付けて「触らないでください」という合図を送るだけの、強制力の無い命名規約に頼っていました。#で始まるプライベートフィールドは、TC39(仕様策定団体)が導入した本物の言語機能で、そのクラスの外では#という文字自体が構文として認識されないため、実行時のチェックではなく構文解析の段階で弾かれます。命名規約とは違い、外部から迂回してアクセスする方法が原理的に存在しません。

演習をはじめる

関連するエラー

• インスタンス全体で共有したい値をstaticにし忘れるクラスのインスタンスをまたいで値を共有したい場合はstaticフィールドが必要です。
• 括弧の閉じ忘れで出る SyntaxError の原因と直し方丸括弧・波括弧・角括弧の閉じ忘れで出る構文エラーです。