CARVIEW |
Select Language
HTTP/2 200
content-type: text/html
x-guploader-uploadid: AAwnv3LBXogTSXe7EA6H1hrMuHksxjP4d1Ndn2Z1RHdIdwk50Dt5UuwMDM6wIHr8ZXtdX8_y
cache-control: public, max-age=3600
expires: Sun, 12 Oct 2025 03:31:55 GMT
last-modified: Fri, 10 Oct 2025 01:12:12 GMT
etag: W/"03c3366a4e39c14f9c94e05f1d7c7e43"
x-goog-generation: 1760058732566878
x-goog-metageneration: 1
x-goog-stored-content-encoding: identity
x-goog-stored-content-length: 167565
x-goog-meta-goog-reserved-file-mtime: 1760057128
x-goog-hash: crc32c=yIIwUw==, md5=A8M2ak45wU+clOBfHXx+Qw==
x-goog-storage-class: STANDARD
accept-ranges: none
alt-svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
alt-svc: clear
referrer-policy: strict-origin-when-cross-origin
x-content-type-options: nosniff
strict-transport-security: max-age=63072000
content-security-policy: default-src 'self'; script-src 'report-sample' 'self' 'wasm-unsafe-eval' https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/js assets.codepen.io production-assets.codepen.io https://js.stripe.com 'sha256-XNBp89FG76amD8BqrJzyflxOF9PaWPqPqvJfKZPCv7M=' 'sha256-YCNoU9DNiinACbd8n6UPyB/8vj0kXvhkOni9/06SuYw=' 'sha256-PZjP7OR6mBEtnvXIZfCZ5PuOlxoDF1LDZL8aj8c42rw='; script-src-elem 'report-sample' 'self' 'wasm-unsafe-eval' https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/js assets.codepen.io production-assets.codepen.io https://js.stripe.com 'sha256-XNBp89FG76amD8BqrJzyflxOF9PaWPqPqvJfKZPCv7M=' 'sha256-YCNoU9DNiinACbd8n6UPyB/8vj0kXvhkOni9/06SuYw=' 'sha256-PZjP7OR6mBEtnvXIZfCZ5PuOlxoDF1LDZL8aj8c42rw='; style-src 'report-sample' 'self' 'unsafe-inline'; object-src 'none'; base-uri 'self'; connect-src 'self' developer.allizom.org bcd.developer.allizom.org bcd.developer.mozilla.org updates.developer.allizom.org updates.developer.mozilla.org https://*.google-analytics.com https://*.analytics.google.com https://*.googletagmanager.com https://incoming.telemetry.mozilla.org https://observatory-api.mdn.allizom.net https://observatory-api.mdn.mozilla.net https://api.github.com/search/issues stats.g.doubleclick.net https://api.stripe.com; font-src 'self'; frame-src 'self' interactive-examples.mdn.mozilla.net interactive-examples.mdn.allizom.net mdn.github.io live-samples.mdn.mozilla.net live-samples.mdn.allizom.net *.mdnplay.dev *.mdnyalp.dev *.play.test.mdn.allizom.net https://v2.scrimba.com https://scrimba.com jsfiddle.net www.youtube-nocookie.com codepen.io survey.alchemer.com https://js.stripe.com; img-src 'self' data: *.githubusercontent.com *.googleusercontent.com *.gravatar.com mozillausercontent.com firefoxusercontent.com profile.stage.mozaws.net profile.accounts.firefox.com developer.mozilla.org mdn.dev interactive-examples.mdn.mozilla.net interactive-examples.mdn.allizom.net wikipedia.org upload.wikimedia.org https://mdn.github.io/shared-assets/ https://mdn.dev/ https://*.google-analytics.com https://*.googletagmanager.com www.gstatic.com; manifest-src 'self'; media-src 'self' archive.org videos.cdn.mozilla.net https://mdn.github.io/shared-assets/; child-src 'self'; worker-src 'self';
x-frame-options: DENY
origin-trial: AxVILwizhbMjxFeHOn1P3R8niO1RJY/smaK4B4d1rLzc1gTaxtXMSaTi+FoigYgCw40uFRDwFcEAeqDR+vVLOW4AAABfeyJvcmlnaW4iOiJodHRwczovL2RldmVsb3Blci5tb3ppbGxhLm9yZyIsImZlYXR1cmUiOiJQcml2YXRlQXR0cmlidXRpb25WMiIsImV4cGlyeSI6MTc0MjA3OTYwMH0=
x-cloud-trace-context: fae3098e6f7107184fe47360b6f4bc6d
date: Sun, 12 Oct 2025 02:31:56 GMT
server: Google Frontend
via: 1.1 google
vary: Accept-Encoding
content-encoding: gzip
x-cache: miss
handler.ownKeys() - JavaScript | MDN
Toggle sidebar
>
このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。
handler.ownKeys()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2016年9月.
handler.ownKeys()
メソッドは、オブジェクトの [[OwnPropertyKeys]]
内部メソッドに対するトラップです。 Object.keys()
, Reflect.ownKeys()
などの操作で使用されます。
試してみましょう
const monster = {
_age: 111,
[Symbol("secret")]: "I am scared!",
eyeCount: 4,
};
const handler = {
ownKeys(target) {
return Reflect.ownKeys(target);
},
};
const proxy = new Proxy(monster, handler);
for (const key of Object.keys(proxy)) {
console.log(key);
// 予想される結果: "_age"
// 予想される結果: "eyeCount"
}
構文
js
new Proxy(target, {
ownKeys(target) {
}
})
引数
次の引数は ownKeys()
メソッドに渡されます。 this
はハンドラーにバインドされます。
target
-
ターゲットオブジェクトです。
返値
ownKeys()
メソッドは 配列風オブジェクトを返す必要があります。それぞれの要素は String
または Symbol
であり、重複するアイテムを含んではいけません。
解説
>介入
このトラップは下記の操作に介入できます。
他にも、[[OwnPropertyKeys]]
内部メソッドを呼び出すあらゆる操作に介入できます。
不変条件
プロキシーの [[OwnPropertyKeys]]
内部メソッドでは、ハンドラー定義が以下の不変条件のいずれかに違反する場合、TypeError
が発生します。
- 結果が
Object
である。 - キーのリストには重複する値が含まれていない。
- それぞれのキーの型が
String
またはSymbol
のどちらかである。 - 結果リストには、ターゲットオブジェクトのすべての構成不可の自己プロパティのキーが含まれていなければならない。つまり、ターゲットオブジェクトに対して
Reflect.ownKeys()
が返すすべてのキーについて、そのキーがReflect.getOwnPropertyDescriptor()
によってconfigurable: false
を返す場合、そのキーは結果リストに含まれていなければならない。 - 対象オブジェクトが拡張不可の場合、結果リストには対象オブジェクトの自己プロパティのすべてのキーが含まれ、それ以外の値は含まれてはいけない。つまり、
Reflect.isExtensible()
がtarget
でfalse
を返す場合、結果リストにはReflect.ownKeys()
をtarget
に適用した結果と同じ値が含まれなければならない。
例
>getOwnPropertyNames のトラップ
次のコードでは Object.getOwnPropertyNames()
をトラップします。
js
const p = new Proxy(
{},
{
ownKeys(target) {
console.log("called");
return ["a", "b", "c"];
},
},
);
console.log(Object.getOwnPropertyNames(p));
// "called"
// [ 'a', 'b', 'c' ]
次のコードでは不変条件に違反します。
js
const obj = {};
Object.defineProperty(obj, "a", {
configurable: false,
enumerable: true,
value: 10,
});
const p = new Proxy(obj, {
ownKeys(target) {
return [123, 12.5, true, false, undefined, null, {}, []];
},
});
console.log(Object.getOwnPropertyNames(p));
// TypeError: proxy [[OwnPropertyKeys]] must return an array
// with only string and symbol elements
仕様書
Specification |
---|
ECMAScript® 2026 Language Specification> # sec-proxy-object-internal-methods-and-internal-slots-ownpropertykeys> |
ブラウザーの互換性
Loading…