当前位置：首页 > article >正文

JavaScript 私有属性的实现方式及对比

article 2025/3/5 1:16:53

在 JavaScript 中，私有属性是指只能在类或对象内部访问的属性，外部无法直接访问或修改。随着 JavaScript 语言的发展，实现私有属性的方式也在不断演进。本文将介绍几种常见的实现私有属性的方法，并对比它们的优缺点，帮助开发者选择适合的方案。

1. 使用闭包（Closure）

闭包是 JavaScript 中实现私有属性的一种经典方式。通过闭包，我们可以在函数内部创建变量，这些变量对外部是不可见的。

示例代码：

function Person(name) {
    let _name = name; // 私有属性

    this.getName = function() {
        return _name;
    };

    this.setName = function(newName) {
        _name = newName;
    };
}

const person = new Person("Alice");
console.log(person.getName()); // 输出: Alice
console.log(person._name); // 输出: undefined (无法直接访问)

优点：

兼容性好，适用于所有 JavaScript 环境。
实现简单，易于理解。

缺点：

每个实例都会创建独立的方法，可能导致内存浪费。
代码结构不够直观，尤其是对于复杂的类。

2. 使用 Symbol

Symbol 是 ES6 引入的一种唯一标识符，可以用作对象的属性名，从而实现私有属性。

示例代码：

const _name = Symbol('name');

class Person {
    constructor(name) {
        this[_name] = name;
    }

    getName() {
        return this[_name];
    }
}

const person = new Person("Bob");
console.log(person.getName()); // 输出: Bob
console.log(person[_name]); // 可以访问，但需要知道 Symbol 值

优点：

属性名唯一，避免命名冲突。
代码结构清晰，适合 ES6 及以上的环境。

缺点：

通过 Object.getOwnPropertySymbols 仍然可以访问 Symbol 属性，并非真正私有。
需要额外管理 Symbol 变量。

3. 使用 WeakMap

WeakMap 是 ES6 引入的一种键值对集合，键必须是对象，可以用它来存储私有属性。

示例代码：

const _name = new WeakMap();

class Person {
    constructor(name) {
        _name.set(this, name);
    }

    getName() {
        return _name.get(this);
    }
}

const person = new Person("Charlie");
console.log(person.getName()); // 输出: Charlie
console.log(person._name); // 输出: undefined (无法直接访问)

优点：

真正实现私有属性，外部无法访问。
内存管理更高效，WeakMap 不会阻止垃圾回收。

缺点：

代码结构稍显复杂。
需要额外的 WeakMap 实例来存储属性。

4. 使用 # 语法（ES2022）

ES2022 引入了 # 语法，可以直接在类中定义私有属性。

示例代码：

class Person {
    #name; // 私有属性

    constructor(name) {
        this.#name = name;
    }

    getName() {
        return this.#name;
    }
}

const person = new Person("David");
console.log(person.getName()); // 输出: David
console.log(person.#name); // 报错: 无法访问私有属性

优点：

语法简洁，直观易用。
真正实现私有属性，外部无法访问。

缺点：

仅支持 ES2022 及以上环境，兼容性较差。
对于旧项目，可能需要使用 Babel 等工具进行转译。

方法对比总结

方法	兼容性	实现难度	内存效率	真正私有
闭包	所有环境	简单	较低	是
Symbol	ES6+	中等	较高	部分
WeakMap	ES6+	中等	较高	是
# 语法	ES2022+	简单	较高	是