Object

模块

• es.object.assign
• es.object.create
• es.object.define-getter
• es.object.define-property
• es.object.define-properties
• es.object.define-setter
• es.object.entries
• es.object.freeze
• es.object.from-entries
• es.object.get-own-property-descriptor
• es.object.get-own-property-descriptors
• es.object.get-own-property-names
• es.object.get-prototype-of
• es.object.has-own
• es.object.is
• es.object.is-extensible
• es.object.is-frozen
• es.object.is-sealed
• es.object.keys
• es.object.lookup-setter
• es.object.lookup-getter
• es.object.prevent-extensions
• es.object.proto
• es.object.to-string
• es.object.seal
• es.object.set-prototype-of
• es.object.values.

类型

interface Object {
  toString(): string; // ES2015+ 修复：对 @@toStringTag 的支持
  __defineGetter__(property: PropertyKey, getter: Function): void;
  __defineSetter__(property: PropertyKey, setter: Function): void;
  __lookupGetter__(property: PropertyKey): Function | void;
  __lookupSetter__(property: PropertyKey): Function | void;
  __proto__: Object | null; // 需要一种方式设置原型——不是在 IE10-，而是像 Deno 这样的现代引擎
}

interface ObjectConstructor {
  assign(target: Object, ...sources: Array<Object>): Object;
  create(
    prototype: Object | null,
    properties?: { [property: PropertyKey]: PropertyDescriptor }
  ): Object;
  defineProperties(
    object: Object,
    properties: { [property: PropertyKey]: PropertyDescriptor }
  ): Object;
  defineProperty(
    object: Object,
    property: PropertyKey,
    attributes: PropertyDescriptor
  ): Object;
  entries<T>(object: { [key: string]: T }): Array<[string, T]>;
  entries(object: Object): Array<[string, any]>;
  freeze(object: any): any;
  fromEntries<T>(iterable: Iterable<[PropertyKey, T]>): { [k: string]: T };
  getOwnPropertyDescriptor(
    object: any,
    property: PropertyKey
  ): PropertyDescriptor | void;
  getOwnPropertyDescriptors(object: any): {
    [property: PropertyKey]: PropertyDescriptor;
  };
  getOwnPropertyNames(object: any): Array<string>;
  getPrototypeOf(object: any): Object | null;
  hasOwn(object: object, key: PropertyKey): boolean;
  is(value1: any, value2: any): boolean;
  isExtensible(object: any): boolean;
  isFrozen(object: any): boolean;
  isSealed(object: any): boolean;
  keys(object: any): Array<string>;
  preventExtensions(object: any): any;
  seal(object: any): any;
  setPrototypeOf(target: any, prototype: Object | null): any; // 需要 __proto__ - IE11+
  values<T>(object: { [key: string]: T }): Array<T>;
  values(object: any): Array<any>;
}

入口点

core-js(-pure)/es|stable|actual|full/object
core-js(-pure)/es|stable|actual|full/object/assign
core-js(-pure)/es|stable|actual|full/object/is
core-js(-pure)/es|stable|actual|full/object/set-prototype-of
core-js(-pure)/es|stable|actual|full/object/get-prototype-of
core-js(-pure)/es|stable|actual|full/object/create
core-js(-pure)/es|stable|actual|full/object/define-property
core-js(-pure)/es|stable|actual|full/object/define-properties
core-js(-pure)/es|stable|actual|full/object/get-own-property-descriptor
core-js(-pure)/es|stable|actual|full/object/get-own-property-descriptors
core-js(-pure)/es|stable|actual|full/object/has-own
core-js(-pure)/es|stable|actual|full/object/keys
core-js(-pure)/es|stable|actual|full/object/values
core-js(-pure)/es|stable|actual|full/object/entries
core-js(-pure)/es|stable|actual|full/object/get-own-property-names
core-js(-pure)/es|stable|actual|full/object/freeze
core-js(-pure)/es|stable|actual|full/object/from-entries
core-js(-pure)/es|stable|actual|full/object/seal
core-js(-pure)/es|stable|actual|full/object/prevent-extensions
core-js/es|stable|actual|full/object/proto
core-js(-pure)/es|stable|actual|full/object/is-frozen
core-js(-pure)/es|stable|actual|full/object/is-sealed
core-js(-pure)/es|stable|actual|full/object/is-extensible
core-js/es|stable|actual|full/object/to-string
core-js(-pure)/es|stable|actual|full/object/define-getter
core-js(-pure)/es|stable|actual|full/object/define-setter
core-js(-pure)/es|stable|actual|full/object/lookup-getter
core-js(-pure)/es|stable|actual|full/object/lookup-setter

示例

示例:

let foo = { q: 1, w: 2 };
let bar = { e: 3, r: 4 };
let baz = { t: 5, y: 6 };
Object.assign(foo, bar, baz); // => foo = { q: 1, w: 2, e: 3, r: 4, t: 5, y: 6 }

Object.is(NaN, NaN); // => true
Object.is(0, -0); // => false
Object.is(42, 42); // => true
Object.is(42, "42"); // => false

function Parent() {}
function Child() {}
Object.setPrototypeOf(Child.prototype, Parent.prototype);
new Child() instanceof Child; // => true
new Child() instanceof Parent; // => true

let object = {
  [Symbol.toStringTag]: "Foo",
};

"" + object; // => '[object Foo]'

Object.keys("qwe"); // => ['0', '1', '2']
Object.getPrototypeOf("qwe") === String.prototype; // => true

Object.values({ a: 1, b: 2, c: 3 }); // => [1, 2, 3]
Object.entries({ a: 1, b: 2, c: 3 }); // => [['a', 1], ['b', 2], ['c', 3]]

for (let [key, value] of Object.entries({ a: 1, b: 2, c: 3 })) {
  console.log(key); // => 'a', 'b', 'c'
  console.log(value); // => 1, 2, 3
}

// 对原型和解释器浅拷贝：
let copy = Object.create(
  Object.getPrototypeOf(object),
  Object.getOwnPropertyDescriptors(object)
);
// Mixin:
Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));

const map = new Map([
  ["a", 1],
  ["b", 2],
]);
Object.fromEntries(map); // => { a: 1, b: 2 }

class Unit {
  constructor(id) {
    this.id = id;
  }
  toString() {
    return `unit${this.id}`;
  }
}

const units = new Set([new Unit(101), new Unit(102)]);

Object.fromEntries(units.entries()); // => { unit101: Unit { id: 101 }, unit102: Unit { id: 102 } }

Object.hasOwn({ foo: 42 }, "foo"); // => true
Object.hasOwn({ foo: 42 }, "bar"); // => false
Object.hasOwn({}, "toString"); // => false