JavaScript 中怎么使用 Proxy 实现对象的只读属性保护

酷辰吖_5530

酷辰吖_5530

2026-08-10

724人浏览

原创

javascript中用proxy实现对象只读保护的核心是拦截set、deleteproperty和defineproperty等操作并拒绝修改,通过代理层控制访问行为,不改变原对象;深度只读需在get中递归代理嵌套对象,注意循环引用和兼容性。

javascript 中怎么使用 proxy 实现对象的只读属性保护

JavaScript 中用 Proxy 实现对象只读保护,核心是拦截赋值(set)、删除(deleteProperty)和定义新属性(defineProperty)操作,并拒绝修改。它不改变原对象,而是创建一个“代理层”来控制访问行为。

拦截关键操作阻止写入

只读的关键不是让属性不可读,而是不让它们被修改、新增或删除。需在 handler 中覆盖以下陷阱方法:

  • set:拦截所有赋值操作(包括新增属性),返回 false 或抛出错误
  • deleteProperty:拦截 delete obj.prop,返回 false
  • defineProperty:拦截 Object.defineProperty 和直接添加属性(如 obj.newProp = 1),返回 false
  • (可选)setPrototypeOf 和 preventExtensions:防止原型篡改或扩展对象

基础只读代理示例

下面是一个简洁可靠的只读代理实现:

javascript-pro
javascript-pro

专注现代 ECMAScript、异步编程、性能优化和全栈的 JavaScript 专家,适用于现代开发

下载
function readonly(obj) {
  return new Proxy(obj, {
    set(target, key, value) {
      throw new TypeError(`Cannot assign to read-only property '${key}'`);
    },
    deleteProperty(target, key) {
      throw new TypeError(`Cannot delete property '${key}'`);
    },
    defineProperty(target, key, descriptor) {
      throw new TypeError(`Cannot define property '${key}'`);
    },
    // 防止通过 Object.setPrototypeOf 修改原型
    setPrototypeOf() {
      throw new TypeError('Cannot set prototype of a readonly object');
    },
    // 防止后续扩展(配合 preventExtensions 使用更严格)
    preventExtensions() {
      return true;
    }
  });
}

const data = { name: 'Alice', age: 30 };
const roData = readonly(data);

roData.name = 'Bob'; // TypeError
delete roData.age;   // TypeError
roData.city = 'Beijing'; // TypeError

深度只读:递归代理嵌套对象

上面的代理只保护顶层属性。若对象含嵌套对象,需递归包装——每次访问属性时,对返回值也做只读处理(在 get 拦截中判断并代理):

function deepReadonly(obj) {
  if (obj !== null && typeof obj === 'object') {
    // 已代理过,避免重复代理
    if (obj[Symbol.toStringTag] === 'ReadOnlyProxy') return obj;

    return new Proxy(obj, {
      get(target, key, receiver) {
        const val = Reflect.get(target, key, receiver);
        // 对对象类型(非 null)递归代理
        if (val !== null && typeof val === 'object') {
          return deepReadonly(val);
        }
        return val;
      },
      set() { throw new TypeError('Cannot modify readonly object'); },
      deleteProperty() { throw new TypeError('Cannot delete property'); },
      defineProperty() { throw new TypeError('Cannot define property'); },
      setPrototypeOf() { throw new TypeError('Cannot set prototype'); },
      preventExtensions() { return true; }
    });
  }
  return obj;
}

这样 roData.profile.address.zip 也会受保护,任何层级的修改都会报错。

兼容性与注意事项

Proxy 是 ES2015+ 特性,不支持 IE;现代浏览器和 Node.js ≥ 6 均可用。实际使用注意:

  • 代理对象与原对象不相等(roData !== data),但内容一致
  • 只读是运行时保护,不影响 TypeScript 类型检查(需额外类型标注)
  • 若需冻结已有属性的可写性,可先用 Object.freeze(),再加 Proxy 补强拦截(如防止 defineProperty 绕过)
  • 避免在 get 中无条件递归代理,防止循环引用导致栈溢出(可加缓存或 WeakMap 记录已代理对象)

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

javascript java proxy

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.06.20

4346

5

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

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

2023.07.04

1089

3

js四舍五入
js四舍五入

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

2023.07.04

4264

6

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

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

2023.09.01

860

4

JavaScript转义字符
JavaScript转义字符

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

2023.09.04

1756

5

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

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

2023.09.04

3145

4

如何启用JavaScript
如何启用JavaScript

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

2023.09.12

4093

6

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

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

2023.09.20

2640

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

868

7

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.6万人学习