0

0

如何利用WeakMap和WeakSet实现私有属性,以及它们与普通Map和Set在内存管理上的区别?

betcha

betcha

发布时间:2025-09-22 20:24:01

|

759人浏览过

|

来源于php中文网

原创

WeakMap和WeakSet的核心机制是弱引用,其键或元素不会阻止垃圾回收,当对象仅被WeakMap/WeakSet引用时可被回收,从而避免内存泄漏;而Map和Set持有强引用,会阻止对象回收。根本区别在于引用强度:WeakMap/WeakSet用于关联元数据或标记对象,随对象生命周期自动管理;Map/Set用于持久存储数据,需手动管理。WeakMap适合实现私有属性,通过模块作用域闭包将实例作为键存储私有数据,外部无法访问且自动清理;WeakSet适用于标记场景,如跟踪已处理对象、防止重复遍历等,不存值只判属,二者均在对象生命周期管理中优于传统方案。

如何利用weakmap和weakset实现私有属性,以及它们与普通map和set在内存管理上的区别?

利用

WeakMap
WeakSet
可以巧妙地实现JavaScript中的“私有”属性,而它们与普通的
Map
Set
在内存管理上的核心区别在于对键(或元素)的引用强度:
WeakMap
WeakSet
持有的是弱引用,这意味着如果其键对象(或元素对象)在其他地方不再被引用,垃圾回收器就可以将其回收,并自动从
WeakMap
/
WeakSet
中移除对应的条目,从而有效避免内存泄漏。而
Map
Set
则持有强引用,只要它们自身存在,其键或元素就不会被垃圾回收。

解决方案

要利用

WeakMap
WeakSet
实现私有属性,我们通常会选择
WeakMap
,因为它允许我们为每个对象实例关联一个私有的数据对象。

想象一下,我们想为一个类的实例存储一些外部无法直接访问的数据。我们可以在模块作用域内声明一个

WeakMap
,将每个类实例作为键,将一个包含所有私有属性的对象作为值。这样一来,只有能够访问到这个
WeakMap
的闭包(通常是类的内部方法)才能访问到这些私有数据。当一个类的实例被垃圾回收时,由于
WeakMap
对键持有的是弱引用,该实例在
WeakMap
中的对应条目也会自动被清除,避免了内存泄漏。

// module scope
const _privateData = new WeakMap();

class MyClass {
    constructor(publicProp, privateProp1, privateProp2) {
        this.publicProp = publicProp;
        // 将私有数据存储在WeakMap中
        _privateData.set(this, {
            privateProp1: privateProp1,
            privateProp2: privateProp2,
            _internalCounter: 0 // 甚至可以有内部状态
        });
    }

    getPrivateProp1() {
        const privateProps = _privateData.get(this);
        return privateProps ? privateProps.privateProp1 : undefined;
    }

    incrementCounter() {
        const privateProps = _privateData.get(this);
        if (privateProps) {
            privateProps._internalCounter++;
            console.log(`Internal counter for this instance: ${privateProps._internalCounter}`);
        }
    }

    // 尝试直接访问私有属性会失败
    // console.log(instance._privateData); // undefined
}

const instance1 = new MyClass("Hello", "Secret1", "Hidden1");
const instance2 = new MyClass("World", "Secret2", "Hidden2");

console.log(instance1.publicProp); // "Hello"
console.log(instance1.getPrivateProp1()); // "Secret1"
instance1.incrementCounter(); // Internal counter for this instance: 1
instance1.incrementCounter(); // Internal counter for this instance: 2

console.log(instance2.getPrivateProp1()); // "Secret2"
instance2.incrementCounter(); // Internal counter for this instance: 1

// 外部无法直接访问_privateData这个WeakMap,也无法通过实例访问私有属性
// console.log(_privateData.get(instance1)); // 在模块外部是访问不到_privateData的

这个模式确保了私有数据的封装性,同时利用

WeakMap
的弱引用特性,保证了实例被回收时,其关联的私有数据也会被一并清理,避免了传统闭包方案可能导致的内存泄漏问题。

WeakMap和WeakSet在内存管理上的核心机制是什么,以及与普通Map和Set的根本区别?

在我看来,理解

WeakMap
WeakSet
最关键的一点就是“弱引用”这个概念。它不是说引用强度弱到随时会断,而是指它不会阻止垃圾回收器回收被引用的对象。这和我们平时用的
Map
Set
有着本质的区别。

具体来说:

  1. 弱引用(Weak Reference)
    WeakMap
    的键和
    WeakSet
    的元素必须是对象。它们对这些对象持有的就是弱引用。这意味着如果一个对象除了被
    WeakMap
    作为键(或被
    WeakSet
    作为元素)引用外,在程序的其他任何地方都没有被强引用,那么这个对象就会被垃圾回收器视为“不可达”,从而被回收。一旦对象被回收,
    WeakMap
    中对应的键值对
    WeakSet
    中对应的元素就会自动从集合中移除。这是它们防止内存泄漏的核心机制。
  2. 强引用(Strong Reference)
    Map
    的键和
    Set
    的元素可以是任何数据类型(包括基本类型和对象)。它们对这些键或元素持有的是强引用。只要
    Map
    Set
    本身还存在,并且其中包含某个键或元素,那么这个键或元素就不会被垃圾回收器回收,即使程序中其他地方已经没有对它的引用了。这会导致一个常见的问题:如果你用对象作为
    Map
    的键,但忘记从
    Map
    中删除它,那么这个对象就会一直存在于内存中,造成内存泄漏。

所以,核心区别在于:

WeakMap
WeakSet
是为那些“附属”于其他对象的元数据或标记而设计的,它们允许这些元数据或标记随着宿主对象的生命周期而自动管理。而
Map
Set
则用于需要长期、稳定存储任意数据的场景,它们的生命周期管理需要开发者手动介入。

在实际开发中,如何利用WeakMap实现真正的‘私有’数据,并避免内存泄漏?

说实话,在JavaScript中实现“真正”的私有属性一直是个挑战。从早期的约定俗成(下划线前缀)、闭包、Symbol,到后来的私有类字段(

#
语法),每种方案都有其优缺点。而
WeakMap
提供了一种非常优雅且实用的方式,尤其是在需要将私有数据与实例生命周期紧密绑定时。

利用

WeakMap
实现私有数据,其精髓在于将
WeakMap
实例定义在一个闭包模块作用域内,使其无法从外部直接访问。然后,类的实例作为
WeakMap
的键,其对应的私有数据作为值。

拍我AI
拍我AI

AI视频生成平台PixVerse的国内版本

下载

实现步骤和原理:

  1. 模块级
    WeakMap
    声明
    :在一个JavaScript模块的顶层(或一个函数闭包内),声明一个
    WeakMap
    实例。这个
    WeakMap
    将是存储所有私有数据的“秘密保险箱”。由于它在模块外部无法访问,因此外部代码无法直接读取或修改私有数据。
  2. 构造函数中关联数据:在类的构造函数中,使用
    this
    (当前实例)作为
    WeakMap
    的键,将一个包含所有私有属性的对象作为值存入
    WeakMap
  3. 通过公共方法访问:在类的方法中,通过
    _privateData.get(this)
    来获取当前实例的私有数据对象,然后对其进行操作。这样,私有数据只能通过类提供的公共方法间接访问,实现了封装。
  4. 自动内存管理:当一个
    MyClass
    的实例不再被任何强引用指向时,它就会被垃圾回收。由于
    WeakMap
    对键持有弱引用,一旦实例被回收,
    WeakMap
    中对应的条目也会自动被清理掉,从而避免了内存泄漏。

代码示例(更贴近实际场景):

// user-profile.js 模块
const _userData = new WeakMap();

class UserProfile {
    constructor(id, username, email) {
        this.id = id; // 公开属性
        this.username = username; // 公开属性

        // 私有数据,只有UserProfile实例和这个模块内部能访问
        _userData.set(this, {
            email: email,
            lastLogin: null,
            _sessionToken: Math.random().toString(36).substring(2) // 更私密的内部状态
        });
    }

    getEmail() {
        const data = _userData.get(this);
        return data ? data.email : 'N/A';
    }

    updateLastLogin() {
        const data = _userData.get(this);
        if (data) {
            data.lastLogin = new Date();
            console.log(`User ${this.username} last logged in at: ${data.lastLogin}`);
        }
    }

    // 模拟一个内部方法,需要访问私有token
    _verifySession() {
        const data = _userData.get(this);
        if (data && data._sessionToken) {
            console.log(`Verifying session with token: ${data._sessionToken}`);
            return true;
        }
        return false;
    }
}

// 导出类
export default UserProfile;

// 在另一个文件 app.js 中
// import UserProfile from './user-profile.js';

// const user1 = new UserProfile(1, 'Alice', 'alice@example.com');
// console.log(user1.username); // Alice
// console.log(user1.getEmail()); // alice@example.com
// user1.updateLastLogin(); // User Alice last logged in at: ...

// // 尝试访问私有数据:
// // console.log(user1.email); // undefined
// // console.log(_userData.get(user1)); // ReferenceError: _userData is not defined (如果_userData在模块外不可访问)

// let user2 = new UserProfile(2, 'Bob', 'bob@example.com');
// // 假设user2对象不再被引用
// user2 = null; // 现在Bob的UserProfile实例可以被垃圾回收了
// // 此时,WeakMap中关于user2的条目也会自动被清理,无需手动操作

这种模式在封装性和内存效率之间取得了很好的平衡,是我个人在需要严格私有化且关心内存时,会优先考虑的方案。

WeakSet在哪些场景下能发挥独特作用,它与WeakMap的应用边界在哪里?

WeakSet
虽然不像
WeakMap
那样直接用于存储私有数据,但它在某些特定场景下能发挥独特而强大的作用,尤其是在需要“标记”对象或跟踪对象集合而不阻止其垃圾回收时。

WeakSet的独特作用场景:

  1. 标记已处理对象或访问过的对象
    • 防止循环引用和重复处理:在处理图结构、树结构或任何可能存在循环引用的数据结构时,
      WeakSet
      可以用来存储已经访问过的节点。例如,在深度优先遍历或广度优先遍历中,将访问过的对象添加到
      WeakSet
      中,下次遇到时可以跳过,避免无限循环。当这些节点对象被回收时,
      WeakSet
      中的标记也会自动消失,不会造成内存泄漏。
    • 缓存计算结果:如果你有一个昂贵的计算函数,它接受一个对象作为参数,并且你希望对同一个对象只计算一次。
      WeakSet
      可以用来记录哪些对象已经计算过。
  2. 跟踪“活动”或“已注册”的对象
    • 事件监听器的管理:虽然不常见,但理论上可以用来跟踪哪些对象已经注册了某个特定的事件监听器。当对象被回收时,其监听器也无需手动注销。
    • 权限或状态标记:比如,一个系统需要知道哪些用户对象当前处于“在线”状态,或者哪些文件对象已经被“锁定”。如果这些对象被回收了,它们就不应该再被视为在线或锁定。

WeakMap与WeakSet的应用边界:

理解它们各自的边界,其实就是理解“关联数据”和“标记集合”的区别。

  • WeakMap
    :它的核心功能是关联数据。你有一个对象(键),你想给这个对象附加一些额外的信息(值)。这个信息是键对象所特有的,并且随着键对象的生命周期而存在。
    • 适用场景:为对象添加私有属性、缓存与对象相关联的计算结果、存储DOM元素的元数据等。
    • 思考方式“这个对象有什么?” 或者 “这个对象对应着什么?”
  • WeakSet
    :它的核心功能是标记集合成员身份验证。你有一个对象,你只想知道它是否属于某个集合,或者它是否被标记为某种状态。你不需要为这个对象存储额外的数据,只需要知道它“是”或“不是”这个集合的成员。
    • 适用场景:跟踪已访问节点、防止对象重复处理、标记对象是否具有某种瞬时状态(如“已验证”、“已处理”)。
    • 思考方式“这个对象是不是这个组的一部分?” 或者 “这个对象是否具有这种标记?”

简单来说,如果你需要为每个对象存储独有的值,那就用

WeakMap
;如果你只是想知道一个对象是否属于某个集合,或者是否被标记过,而不需要存储额外的值,那就用
WeakSet
。两者都因为其弱引用特性,在处理对象生命周期和避免内存泄漏方面,提供了普通
Map
Set
无法比拟的优势。

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

557

2023.06.20

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

374

2023.07.04

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

754

2023.07.04

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

478

2023.09.01

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

454

2023.09.04

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

1031

2023.09.04

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

658

2023.09.12

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

553

2023.09.20

Java编译相关教程合集
Java编译相关教程合集

本专题整合了Java编译相关教程,阅读专题下面的文章了解更多详细内容。

9

2026.01.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 7.5万人学习

Django 教程
Django 教程

共28课时 | 3.3万人学习

AngularJS教程
AngularJS教程

共24课时 | 2.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号