> For the complete documentation index, see [llms.txt](https://lochiwei.gitbook.io/web/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lochiwei.gitbook.io/web/js/val/builtin/proxy/ex/id.md).

# identity (proxy)

[JS](/web/js.md) ⟩ [object](/web/js/val/obj.md) ⟩ [built-in](/web/js/val/builtin.md) ⟩ [Proxy](/web/js/val/builtin/proxy.md) ⟩ [example](/web/js/val/builtin/proxy/ex.md) ⟩ identity (proxy)

{% hint style="success" %}
an (proxy) object that appears to have an infinite number of read-only properties, where each property value is its key, that is, <mark style="color:yellow;">`identity[key] === key`</mark>.
{% endhint %}

{% tabs %}
{% tab title="💈範例" %}

* replit ⟩ [identity (proxy)](https://replit.com/@pegasusroe/proxy-identity#index.js)

```javascript
// identity (Proxy)
let identity = new Proxy({}, {

    // ------------------------------------
    // handler methods, triggered when ...
    // ------------------------------------
    
    // accessing `identity[key]`
    get(o, key, receiver) { return key; },    // identity[key] === key
    
    // testing if `key in identity`
    has(o, key) { return true; },             // always true
    
    // iterating through own keys of `identity`
    ownKeys(o) { 
        throw new RangeError("Infinite number of properties"); 
    },
    
    // accessing property descriptor of `identity[key]`
    getOwnPropertyDescriptor(o, key) {
        return {
            value: key,
            enumerable: false,    // non-writable/non-configurable/non-enumerable
            writable: false,
            configurable: false
        };
    },
    
    // setting `identity[key]`
    set(o, key, value, receiver) { return false },  // cannot set
    
    // deleting `identity[key]`
    deleteProperty(o, key) { return false },        // cannot delete
    
    // (re)defining properties of `identity`
    defineProperty(o, key, desc) { return false },  // cannot (re)define
    
    // testing if `identity` is extensible
    isExtensible(o) { return false },               // always false
    
    // getting prototype of `identity`
    getPrototypeOf(o) { return null },              // no prototype
    
    // setting prototype of `identity`
    setPrototypeOf(o, proto) { return false },      // cannot set
});

// test identity
identity.x,            // 'x'
identity.toString,     // 'toString'
identity[0],           // '0'

delete identity.x,        // ⛔ [TypeError] 'deleteProperty' on proxy: trap returned falsish for property 'x'
identity.x = 1,           // ⛔ [TypeError] 'set' on proxy: trap returned falsish for property 'x'
Object.keys(identity),    // ⛔ [RangeError] Infinite number of properties
for (let p of identity);, // ⛔ [TypeError] identity is not iterable
```

{% endtab %}

{% tab title="📗 參考" %}

* [ ] JS.info ⟩ [Proxy and Reflect](https://javascript.info/proxy)
* [ ] [JavaScript: The Definitive Guide](/web/master/ref/javascript-the-definitive-guide.md) ⟩&#x20;
  * [ ] 14.6 The Reflect API
  * [ ] 14.7 Proxy Objects
    {% endtab %}

{% tab title="📘 手冊" %}

* [Proxy](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy)
* [Reflect](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect)
  {% endtab %}
  {% endtabs %}