re:re:actable
Урок 073 минуты чтения

Приватные поля и методы класса

На этой странице
Кратко

Приватные члены класса объявляют с префиксом #: #balance, #validate(). Они доступны только внутри тела класса, где объявлены; обращение снаружи — SyntaxError еще на этапе разбора кода. Приватные поля не наследуются в смысле доступа: наследник не видит #field родителя, хотя поле существует в объекте. До ES2022 приватность имитировали соглашением _field, замыканиями или WeakMap.

Вопрос

Как объявить приватные свойства в классе? Можно ли обратиться к приватному свойству вне класса? Можно ли наследовать приватные свойства?

Объявление

class BankAccount {
  #balance = 0;                 // приватное поле
  static #rate = 0.05;          // приватное статическое поле
 
  constructor(owner) {
    this.owner = owner;
  }
 
  deposit(amount) {
    this.#validate(amount);
    this.#balance += amount;
  }
 
  get balance() {               // публичный доступ только на чтение
    return this.#balance;
  }
 
  #validate(amount) {           // приватный метод
    if (amount <= 0) throw new RangeError("Сумма должна быть положительной");
  }
}
 
const account = new BankAccount("Анна");
account.deposit(1000);
account.balance;   // 1000

Доступ снаружи

account.#balance;          // SyntaxError: Private field '#balance' must be declared in an enclosing class
account["#balance"];       // undefined — это обычное строковое свойство, а не приватное
Object.keys(account);      // ["owner"] — приватных полей нет
JSON.stringify(account);   // '{"owner":"Анна"}'

Приватные поля не видны в Object.keys, for...in, JSON.stringify, spread и Proxy. В DevTools браузер их показывает — для отладки.

Наследование

class SavingsAccount extends BankAccount {
  addInterest() {
    this.#balance *= 1.05; // SyntaxError — #balance не объявлен в SavingsAccount
  }
}

Поле #balance есть в объекте-наследнике (его создал родительский конструктор), но доступ к нему возможен только из кода класса BankAccount. Наследник работает через публичные или защищенные по соглашению методы родителя:

class BankAccount2 {
  #balance = 0;
  _changeBalance(delta) { this.#balance += delta; } // «protected» по соглашению
}

В JavaScript нет модификатора protected (он есть в TypeScript только на уровне типов).

Проверка наличия: brand check

class Money {
  #amount;
  constructor(a) { this.#amount = a; }
  static isMoney(obj) {
    return #amount in obj; // true только для настоящих экземпляров
  }
}

Сравнение способов приватности

СпособНастоящая приватностьНаследование доступаВидно в DevTools
#fieldданетда
_field (соглашение)нетдада
Замыкание в конструктореданетнет
WeakMap вне классадачерез общий модульнет
TypeScript privateтолько на этапе компиляциинетда

Что важно помнить

  • Обращение к #field у объекта, у которого его нет, бросает TypeError — это защита от подделки объектов.
  • Приватные поля несовместимы с Proxy: методы, обращающиеся к #field, ломаются, если this — прокси.
  • structuredClone и spread не копируют приватные поля.
  • Имена #x нельзя создавать динамически: this[#name] невозможен.

Мини-шпаргалка

  • #field, #method(), static #x — приватные члены.
  • Доступ только внутри тела объявившего класса.
  • Снаружи — SyntaxError.
  • Наследник не имеет доступа к #field родителя.
  • #field in obj — проверка подлинности экземпляра.

Документация

MDN: Приватные свойства, learn.javascript.ru: Приватные и защищённые методы и свойства.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам