Question 1

How do I use harmony-reflect in an older Node.js project?

Accepted Answer

Install via npm and run Node with the --harmony-proxies flag, then require the module to patch globals. Note that only the current module's globals are updated, so pass proxies carefully to avoid bugs with unpatched methods.

Question 2

Should I use harmony-reflect or native ES6 proxies?

Accepted Answer

Use native proxies if your environment supports them (Node.js v6+, modern browsers), as they're more performant and spec-compliant. Harmony-reflect is only for legacy systems where native support is lacking.

Question 3

Does harmony-reflect work with Symbol objects?

Accepted Answer

No, it does not shim Symbol objects, and due to V8 bugs, Symbols and Proxies may not interact properly. This can cause unexpected behavior in environments with native Symbol support.

Question 4

What are the performance implications of harmony-reflect?

Accepted Answer

The shim adds overhead by patching global methods and emulating proxies, which can slow down performance compared to native implementations. Avoid it in performance-critical modern applications.

Question 5

How can I fix JSON serialization issues with proxy arrays?

Accepted Answer

Harmony-reflect serializes proxy-wrapped arrays as objects (e.g., {} instead of []). You may need custom serialization logic or avoid using proxies for arrays that require JSON array output.

Question 6

Is harmony-reflect still necessary in 2023?

Accepted Answer

For most projects, no, as ES6 Proxy and Reflect are natively supported everywhere. It's primarily useful for maintaining compatibility with very old browsers or Node.js versions below v6.0.0.

harmony-reflect

What is harmony-reflect?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions