Object 静态方法

是什么，为什么存在

Object 静态方法是挂在 Object 构造函数上的对象操作，例如 Object.keys(value)、Object.assign(target, source) 和 Object.freeze(value)。 它们不是任意对象都能安全调用的实例方法；调用形式中的第一个实参明确指出要检查或修改哪个对象。

JavaScript 对象以属性键保存数据。属性键只能是字符串或 Symbol，而属性还可能来自对象自身或 原型链（prototype chain） ，并带有是否可枚举等元数据。 因此，「取得对象的所有字段」并不是一个完整需求：调用方必须先说明需要哪些类别的属性。

这些方法解决四类常见问题：把对象投影成键值列表、从键值列表构造对象、精确读取或定义属性行为， 以及限制对象能否新增、删除或改写属性。配置合并、API 数据投影、库边界和调试工具中经常会遇到它们。

这一组 API 并不提供统一的「复制对象」语义。复制普通数据、保留访问器、保留原型，以及复制整个 对象图是不同契约。选错方法时，代码表面上得到一个新对象，实际却可能丢失元数据、调用 getter， 或继续与来源共享嵌套对象。

删除属性仍使用 delete 运算符，检查原型链使用 in，需要统一反射接口时则使用 Reflect。 Object 方法与这些语言能力相邻，但不能互相替代。

工作原理

三个选择维度

枚举相关 API 主要沿三个维度筛选属性：属性是否属于对象自身、是否可枚举，以及键是字符串还是 Symbol。先写清这三个条件，比凭方法名猜测结果可靠。

表中的「不可枚举键」表示该操作是否可能包含这类键。Object.values() 和 Object.entries() 与 Object.keys() 使用相同键集合，只是返回形状不同。即使某个 Symbol 属性设为可枚举，前三个 Object 方法仍会忽略它。

Object.hasOwn(object, key) 只回答某个键是否为自有属性，不受可枚举性影响，也支持 Symbol。 它比 object.hasOwnProperty(key) 更稳妥，因为目标可能覆盖该方法，或者根本没有 Object.prototype。

属性描述符控制行为

每个自有属性都有一个 属性描述符（property descriptor） 。 数据描述符使用 value 和 writable；访问器描述符使用 get 和 set。两类描述符都可以使用 enumerable 与 configurable，但不能在同一描述符中同时指定数据字段和访问器字段。

对象字面量或普通赋值创建的属性通常可写、可枚举、可配置。Object.defineProperty() 的省略值 完全不同：未指定的布尔标志默认为 false。因此只写 { value: 1 } 会得到不可写、不可枚举、 不可配置的属性。

Object.getOwnPropertyDescriptor() 返回一个描述符快照，修改返回对象不会改动原属性。 Object.getOwnPropertyDescriptors() 返回全部自有字符串键与 Symbol 键的描述符，可与 Object.create() 组合，建立保留自有属性行为与原型的新外层对象。

复制与转换仍是浅层的

Object.assign(target, ...sources) 从左到右读取每个来源的可枚举自有字符串键和 Symbol 键， 再把值写入目标。后面的来源会覆盖前面的同名键，目标会被原地修改，返回值仍是该目标。

该操作产生的是 浅拷贝（shallow copy） 。属性值若是对象，复制的 只是同一个对象引用；嵌套对象不会递归合并。来源属性若是 getter，复制时还会执行 getter，目标 得到的是本次读取的值，而不是原访问器描述符。

Object.entries() 把对象投影为字符串键值对数组，便于使用数组方法过滤或映射； Object.fromEntries(iterable) 再从键值对构造普通对象。两者组合适合数据转换，但不是无损往返： Symbol 键、不可枚举属性、描述符和原型都不会由 Object.entries() 保留。

完整性级别只约束一层

Object.preventExtensions()、Object.seal() 与 Object.freeze() 都修改并返回传入对象。它们逐级 限制对象自身的结构，但不会递归处理属性值所引用的对象。

seal() 会让所有自有属性不可配置；freeze() 还会让自有数据属性不可写。访问器属性没有 writable 标志，所以冻结对象后 getter 仍可执行，已有 setter 也仍可能修改其他状态。 「已冻结」因此是对象自身的完整性状态，不等于任意对象图都不可变。

直接赋值、delete 与完整性限制冲突时，严格模式会抛出 TypeError，非严格脚本可能静默失败。 Reflect.set() 和 Reflect.deleteProperty() 则用布尔值报告这类普通失败，适合在示例中明确展示结果。

示例

以下四个示例依次验证属性选择、键值转换、描述符复制与完整性级别。所有输出都来自本地 Node 24.14.0。

选择准确的属性集合

这个对象同时包含继承属性、不可枚举属性和 Symbol 属性。把各类键放在一个样本中，能直接看出 常用 API 的边界。

Object.keys() 的结果只有 name，不是因为其他属性不存在，而是它们没有同时满足「自有、可枚举、 字符串键」三个条件。in 会沿原型链查找，所以最后两行针对同一个键给出不同答案。

当边界需要允许列表时，不要先取得「所有键」再删除已知危险项。直接按允许的字段名读取，并用 Object.hasOwn() 区分缺失字段与继承字段，契约会更稳定。

转换并合并普通数据

第一个转换删除内部字段。接着的配置合并展示两个独立事实：后出现的来源覆盖前面的键，而且嵌套 limits 对象整体替换，不会递归合并。

const flags = {
  checkout: true,
  internalNote: 'remove',
  retries: 0,
};

const publicFlags = Object.fromEntries(
  Object.entries(flags).filter(([key]) => !key.startsWith('internal')),
);
console.log(JSON.stringify(publicFlags));

const defaults = { theme: 'light', limits: { requests: 100 } };
const input = { theme: 'dark', limits: { burst: 10 } };
const merged = Object.assign({}, defaults, input);

console.log(JSON.stringify(merged));
console.log(merged === defaults, merged.limits === input.limits);

const nestedMerge = {
  ...defaults,
  ...input,
  limits: { ...defaults.limits, ...input.limits },
};
console.log(JSON.stringify(nestedMerge));

{"checkout":true,"retries":0}
{"theme":"dark","limits":{"burst":10}}
false true
{"theme":"dark","limits":{"requests":100,"burst":10}}

把空对象作为 Object.assign() 的目标，避免了修改 defaults，但没有让嵌套值独立。第三行中的 true 说明 merged.limits 与 input.limits 仍是同一个对象。

显式展开 limits 适用于已经知道数据形状的配置。通用「深合并」必须另外定义数组、循环引用、 访问器、危险键和不同对象类型的策略，不能从 Object.assign() 自然推导出来。

定义并保留属性描述符

这个示例先展示 defineProperty() 的默认标志，再比较普通赋值复制与描述符复制。来源 getter 的 读取次数让副作用可见。

'use strict';

const account = {};
Object.defineProperty(account, 'id', {
  value: 'A-17',
  enumerable: true,
});

const idDescriptor = Object.getOwnPropertyDescriptor(account, 'id');
console.log(JSON.stringify({
  writable: idDescriptor.writable,
  enumerable: idDescriptor.enumerable,
  configurable: idDescriptor.configurable,
}));

let reads = 0;
Object.defineProperty(account, 'balance', {
  get() {
    reads += 1;
    return 42;
  },
  enumerable: true,
  configurable: true,
});

const assigned = Object.assign({}, account);
const exact = Object.create(
  Object.getPrototypeOf(account),
  Object.getOwnPropertyDescriptors(account),
);

console.log(assigned.balance, reads);
console.log(typeof Object.getOwnPropertyDescriptor(assigned, 'balance').get);
console.log(typeof Object.getOwnPropertyDescriptor(exact, 'balance').get);

{"writable":false,"enumerable":true,"configurable":false}
42 1
undefined
function

Object.assign() 为了取得 balance 的值执行了一次 getter，并在目标上创建普通数据属性。 Object.getOwnPropertyDescriptors() 读取的是访问器函数本身，所以建立 exact 时没有再次执行 getter。

这里的 exact 只表示外层原型和自有属性描述符得到保留。属性值仍共享引用，带有内部槽或私有字段 的内建对象与类实例也不能靠这段组合变成通用的精确克隆。

比较三个完整性级别

使用 Reflect 可以在不依赖严格模式报错文本的情况下观察每次操作是否成功。最后两行还验证了 冻结只作用于外层对象。

const extensible = { count: 1 };
Object.preventExtensions(extensible);
console.log(
  Reflect.set(extensible, 'count', 2),
  Reflect.set(extensible, 'extra', true),
  Reflect.deleteProperty(extensible, 'count'),
);

const sealed = Object.seal({ count: 1 });
console.log(
  Reflect.set(sealed, 'count', 2),
  Reflect.set(sealed, 'extra', true),
  Reflect.deleteProperty(sealed, 'count'),
);

const preferences = { theme: 'light' };
const frozen = Object.freeze({ count: 1, preferences });
console.log(
  Reflect.set(frozen, 'count', 2),
  Reflect.deleteProperty(frozen, 'count'),
  Object.isFrozen(frozen),
);

preferences.theme = 'dark';
console.log(frozen.preferences.theme);
console.log(Object.isFrozen(frozen.preferences));

true false true
true false false
false false true
dark
false

不可扩展对象仍能修改和删除现有属性；密闭对象仍能修改原本可写的值；冻结对象连这种写入也拒绝。 三种操作都不跟随 preferences 引用，所以嵌套对象保持可变。

调用 Object.isFrozen() 只能回答传入的那个对象是否冻结。若契约声称整个输入图不可变，测试必须 继续检查每个相关嵌套对象，或者采用明确拥有不可变数据的建模方式。

陷阱

把 Object.keys() 当成所有属性

修复方法： 按需求选择键集合。需要全部自有键时使用 Reflect.ownKeys()；需要判断单个自有键时 使用 Object.hasOwn()；确实需要沿原型链枚举时，再明确使用 for...in 并过滤。

让 Object.assign() 修改共享默认值

修复方法： 普通数据合并使用新的目标，例如 Object.assign({}, defaults, input)，并单独处理需要 合并的嵌套字段。若输入不可信，应按允许列表构造结果，而不是把所有可枚举键直接写入普通对象。

把浅拷贝当成独立副本

修复方法： 先写出哪些层级必须拥有独立标识，再只复制这些层级。需要复制一般对象图时使用 符合数据类型契约的机制，并用共享引用、循环引用和不受支持的值测试它，而不是套用 JSON 往返。

忘记描述符的默认值

修复方法： 显式写出业务依赖的每个标志，并用 Object.getOwnPropertyDescriptor() 断言结果。 不可配置是很强的单向决定；设置前先确认后续是否需要改写描述符或删除属性。

假设冻结会递归或阻止访问器

修复方法： 把冻结描述为外层完整性约束，并测试嵌套标识与访问器副作用。若要递归冻结，先定义 如何处理循环、Symbol 键、访问器、Proxy、类型化数组和带私有状态的实例。

延伸阅读

• MDN：Object
• MDN：属性的可枚举性与所有权
• MDN：Object.defineProperty()
• MDN：Object.freeze()
• ECMAScript 语言规范：Object 对象