js对象方法

November 12, 2022

https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object

属性描述符

注意：在严格模式下，违反属性描述符会抛出 TypeError 异常在非严格模式下则是静默失败

通过直接的赋值和属性初始化的属性，属性描述符都为 true

interface PropertyDescriptor {
    // 是否可配置，若设置为不可配置，则不能删除指定属性，且不能再修改属性描述符（除了将 writable: true 更改为 false）
    // 务必注意这里的不可修改，就是不能再次定义已经定义的属性描述符，但如果本来未定义（默认行为）则可以修改
    configurable?: boolean;
    // 是否可枚举，如 for..in 循环
    enumerable?: boolean;
    // 是否可写
    writable?: boolean;
    // value和writeable 与 getter和setter 只能二选一，否则抛出TypeError
    value?: any;
    get?(): any;
    set?(v: any): void;
}

interface PropertyDescriptorMap {
    [key: PropertyKey]: PropertyDescriptor;
}

两个方法可以设置属性描述符

const obj = {};

Object.defineProperty(obj, "foo", {
    enumerable: true,
    get() {
        return "foo";
    },
});

Object.defineProperty(obj, "bar", {
    enumerable: false,
    writable: true,
    value: "bar",
});

Object.defineProperty(obj, "bar", {
    writable: false, // 例外
    value: "baz",
});

Object.defineProperty(obj, "PI", {
    configurable: false,
    writable: false,
    enumerable: true,
    value: 3.14, // 相当于常量
});

for (const [k, v] of Object.entries(obj)) console.log("%s=%s", k, v);
// 输出
// foo=foo
// PI=3.14

对应的两个方法可以获取属性描述符

Object.getOwnPropertyDescriptor(obj, "foo");
Object.getOwnPropertyDescriptors(obj);

属性描述符在单个属性的级别上工作。

还有一些限制访问整个对象的方法：

// 阻止在对象上添加新属性
Object.preventExtensions(obj);
// 阻止在对象上添加新属性，并将所有现有属性标记为不可配置
Object.seal(obj);
// 阻止在对象上添加新属性，并将所有现有属性标记为不可配置、不可修改
Object.freeze(obj);

Object.isExtensible(obj);

Object.isSealed(obj);

Object.isFrozen(obj);

原型

// 设置对象的内部 [[Prototype]] 属性
Object.setPrototypeOf(obj, proto);

// 获取对象的内部 [[Prototype]] 属性
Object.getPrototypeOf(obj);

// 返回是否对象自身上具有指定属性，而不会从原型上查找
Object.hasOwn(instance, prop);

// 通过指定原型和可选的属性描述符映射创建新对象
Object.create(proto[, propertyDescriptorMap]);
// 请注意！这里属性描述符映射中的属性描述符默认全为 false！

枚举

https://developer.mozilla.org/docs/Web/JavaScript/Enumerability_and_ownership_of_properties

注意，for...in 循环遍历时，先遍历对象自身，再遍历原型

// 返回由给定对象 自身的 可枚举属性名组成的数组
Object.keys(obj);

// 返回由给定对象 自身的 可枚举属性值组成的数组
Object.values(obj);

// 返回由给定对象 自身的 可枚举属性键值对组成的数组
Object.entries(obj);

// 将键值对可迭代对象转换为一个对象
Object.fromEntries(iterable);
// https://developer.mozilla.org/docs/Web/JavaScript/Reference/Iteration_protocols

// 返回由给定对象 自身的 所有非 Symbol 属性名组成的数组
Object.getOwnPropertyNames(obj);

// 返回由给定对象 自身的 所有 Symbol 属性名组成的数组
Object.getOwnPropertySymbols(obj);

// 将（一个或多个）源对象自身的所有可枚举属性复制到目标对象上，然后返回目标对象
Object.assign(target, ...sources);

// 方法判断两个值是否为同一个值
Object.is(value1, value2);

// 演示
Object.is(+0, -0); // => false
+0 === -0; // => true
Object.is(NaN, NaN); // => true
NaN === NaN; // => false

原型链方法

Object.prototype 上定义的方法

// 判断当前对象自身的指定属性是否可枚举
Object.prototype.propertyIsEnumerable(prop);

// 判断当前对象自身是否具有指定的属性
Object.prototype.hasOwnProperty(prop);

// 判断当前对象是否在另一个对象的原型链上，与instanceof的区别在于后者判断的是构造函数，而不是原型对象本身
Object.prototype.isPrototypeOf(obj);

// 下面两个无参方法主要用于类型转换
// 参见：https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Symbol/toPrimitive
Object.prototype.valueOf();
Object.prototype.toString();

←Back to home