Reflect.getOwnPropertyDescriptor()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.
Phương thức tĩnh Reflect.getOwnPropertyDescriptor() giống như Object.getOwnPropertyDescriptor(). Nó trả về property descriptor của thuộc tính đã cho nếu nó tồn tại trên đối tượng, undefined nếu không.
Try it
const object = {
property1: 42,
};
console.log(Reflect.getOwnPropertyDescriptor(object, "property1").value);
// Expected output: 42
console.log(Reflect.getOwnPropertyDescriptor(object, "property2"));
// Expected output: undefined
console.log(Reflect.getOwnPropertyDescriptor(object, "property1").writable);
// Expected output: true
Cú pháp
Reflect.getOwnPropertyDescriptor(target, propertyKey)
Tham số
target-
Đối tượng target trong đó tìm kiếm thuộc tính.
propertyKey-
Tên của thuộc tính cần lấy property descriptor riêng.
Giá trị trả về
Một đối tượng property descriptor nếu thuộc tính tồn tại như thuộc tính riêng của target; nếu không, undefined.
Ngoại lệ
TypeError-
Được ném ra nếu
targetkhông phải là đối tượng.
Mô tả
Reflect.getOwnPropertyDescriptor() cung cấp ngữ nghĩa phản chiếu của việc lấy property descriptor của một đối tượng. Sự khác biệt duy nhất với Object.getOwnPropertyDescriptor() là cách xử lý các target không phải đối tượng. Reflect.getOwnPropertyDescriptor() ném ra TypeError nếu target không phải là đối tượng, trong khi Object.getOwnPropertyDescriptor() ép kiểu nó về đối tượng.
Reflect.getOwnPropertyDescriptor() gọi phương thức nội tại [[GetOwnProperty]] của đối tượng trên target.
Ví dụ
Sử dụng Reflect.getOwnPropertyDescriptor()
Reflect.getOwnPropertyDescriptor({ x: "hello" }, "x");
// {value: "hello", writable: true, enumerable: true, configurable: true}
Reflect.getOwnPropertyDescriptor({ x: "hello" }, "y");
// undefined
Reflect.getOwnPropertyDescriptor([], "length");
// {value: 0, writable: true, enumerable: false, configurable: false}
Khác biệt với Object.getOwnPropertyDescriptor()
Nếu đối số target cho phương thức này không phải là đối tượng (một giá trị nguyên thủy), thì nó sẽ gây ra TypeError. Với Object.getOwnPropertyDescriptor, đối số đầu tiên không phải đối tượng sẽ được ép kiểu về đối tượng trước.
Reflect.getOwnPropertyDescriptor("foo", 0);
// TypeError: "foo" is not non-null object
Object.getOwnPropertyDescriptor("foo", 0);
// { value: "f", writable: false, enumerable: true, configurable: false }
Đặc tả kỹ thuật
| Specification |
|---|
| ECMAScript® 2027 Language Specification # sec-reflect.getownpropertydescriptor |