This page was translated from English by the community.Learn more and join the MDN Web Docs community.
Object.hasOwn()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2022년 3월.
명시된 객체에 자체 속성으로 지정된 속성이 있는 경우Object.hasOwn() 정적 메서드는true를 반환합니다. 속성이 상속되었거나 존재하지 않으면 이 메서드는false를 반환합니다.
참고 :Object.hasOwn()은Object.prototype.hasOwnProperty()를 대체하기 위한 것입니다.
시도해 보기
const object1 = { prop: "exists",};console.log(Object.hasOwn(object1, "prop"));// 예상 출력 값: trueconsole.log(Object.hasOwn(object1, "toString"));// 예상 출력 값: falseconsole.log(Object.hasOwn(object1, "undeclaredPropertyValue"));// 예상 출력 값: false구문
Object.hasOwn(obj, prop)매개변수
반환 값
지정된 객체가 직접 명시된 속성을 정의했다면true. 그렇지 않으면false
설명
명시된 속성이 값이null 혹은undefined일 경우일지라도 객체의 직접적인 속성인 경우Object.hasOwn() 메서드는true를 반환합니다. 속성이 상속되었거나 전혀 선언되지 않은 경우 이 메서드는false를 반환합니다.in 연산자와는 달리, 이 메서드는 객체의 프로토타입 체인에서 지정된 속성을 확인하지 않습니다.
이 메서드는null 프로토타입 객체 및 상속된hasOwnProperty() 메서드를 재정의한 객체에 대해 작동하므로Object.prototype.hasOwnProperty()보다 권장됩니다.Object.prototype.hasOwnProperty.call(obj, prop)와 같은 외부 객체에서Object.prototype.hasOwnProperty()를 호출하여 이러한 문제를 해결할 수 있지만,Object.hasOwn()을 사용하는 것이 더 직관적입니다.
예제
속성의 존재를 시험하기 위한 Object.hasOwn() 사용하기
다음 코드는example 객체에prop이라는 속성의 포함 여부를 확인하는 방법을 보여줍니다.
const example = {};Object.hasOwn(example, "prop"); // false - 'prop'이 정의되지 않았습니다example.prop = "exists";Object.hasOwn(example, "prop"); // true - 'prop' 이 정의되었습니다example.prop = null;Object.hasOwn(example, "prop"); // true - 자체 속성이 null 값으로 존재합니다example.prop = undefined;Object.hasOwn(example, "prop"); // true - 자체 속성이 undefined 값으로 존재합니다직접 vs 상속된 속성
다음 예제에서는 직접적인 속성과 프로토타입 체인을 통해 상속된 속성을 구분합니다.
const example = {};example.prop = "exists";// `hasOwn` 은 오직 직접적인 속성만 true를 반환합니다.Object.hasOwn(example, "prop"); // trueObject.hasOwn(example, "toString"); // falseObject.hasOwn(example, "hasOwnProperty"); // false// `in` 연산자는 직접적인 속성 혹은 상속된 속성이 있을 경우 true를 반환합니다."prop" in example; // true"toString" in example; // true"hasOwnProperty" in example; // true객체의 속성을 순회하기
객체의 열거 가능한 속성을 순회하기 위해서는 반드시 아래와 같이 사용해야 합니다.
const example = { foo: true, bar: true };for (const name of Object.keys(example)) { // …}그러나for...in을 사용해야 하는 경우Object.hasOwn()을 사용하여 상속된 속성을 건너뛸 수 있습니다.
const example = { foo: true, bar: true };for (const name in example) { if (Object.hasOwn(example, name)) { // … }}배열 인덱스의 존재여부 확인하기
Array의 요소는 직접적인 속성으로 정의되기 때문에hasOwn() 메서드를 사용하여 특정 인덱스의 존재 여부를 확인할 수 있습니다.
const fruits = ["Apple", "Banana", "Watermelon", "Orange"];Object.hasOwn(fruits, 3); // true ('Orange')Object.hasOwn(fruits, 4); // false - 정의되지 않았습니다hasOwnProperty의 문제 사례
이 섹션에서는hasOwn()이hasOwnProperty에 영향을 미치는 문제에 영향을 받지 않는다는 것을 보여줍니다. 첫 번째로,hasOwnProperty()를 재구현한 객체와 함께 사용할 수 있습니다. 아래 예제에서 재구현된hasOwnProperty() 메서드는 모든 속성에 대해 거짓을 반환하지만Object.hasOwn() 동작은 변함없이 유지됩니다.
const foo = { hasOwnProperty() { return false; }, bar: "The dragons be out of office",};console.log(foo.hasOwnProperty("bar")); // falseconsole.log(Object.hasOwn(foo, "bar")); // true또한null-프로토타입 객체와 함께 사용할 수도 있습니다. 이는Object.prototype에서 상속되지 않으므로hasOwnProperty()에 접근할 수 없습니다.
const foo = Object.create(null);foo.prop = "exists";console.log(foo.hasOwnProperty("prop"));// Uncaught TypeError: foo.hasOwnProperty is not a functionconsole.log(Object.hasOwn(foo, "prop")); // true명세서
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-object.hasown |