feat(ecmascript): add URI encoding/decoding support to constant evaluation

[Copilot]

This PR implements constant evaluation support for the four global URI encoding/decoding functions: encodeURI, encodeURIComponent, decodeURI, and decodeURIComponent.

Changes

Core Implementation

• Extended global function call handling in try_fold_known_global_methods to support global functions (previously only handled method calls on objects)
• Added URI function implementations following ECMA-262 specification:
  • encodeURI() - Encodes URI while preserving reserved characters (;,/?:@&=+$#)
  • encodeURIComponent() - Encodes URI component, only preserving unreserved characters (A-Za-z0-9-_.!~*'())
  • decodeURI() - Decodes URI while preserving encoded reserved characters for safety
  • decodeURIComponent() - Decodes all percent-encoded sequences

Technical Details

• Robust UTF-8 handling for multi-byte Unicode characters (e.g., café → caf%C3%A9)
• Proper error handling for malformed percent-encoded sequences (returns None to prevent unsafe optimizations)
• Spec-compliant character set handling with different rules for URI vs URI component encoding

Example Optimizations

Before:

const encoded = encodeURI('hello world');
const component = encodeURIComponent('a;b,c/d?e');
const decoded = decodeURI('hello%20world');

After:

const encoded = 'hello%20world';
const component = 'a%3Bb%2Cc%2Fd%3Fe';
const decoded = 'hello world';

Testing

Added comprehensive tests covering:

• Basic ASCII encoding/decoding
• Reserved vs unreserved character handling differences
• Unicode character support (including Chinese characters)
• Invalid input handling and edge cases
• Roundtrip operations (encode → decode)
• Error cases (wrong argument counts, non-literals)

All existing tests continue to pass, ensuring no regressions.

Benefits

• Improved bundle size by eliminating runtime URI function calls when possible
• Better performance by moving encoding/decoding to compile-time
• Spec compliance with ECMA-262 URI function behavior

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[graphite-app]

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

• 0-merge - adds this PR to the back of the merge queue
• hotfix - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

[sapphi-red]

@copilot check the comments

[camc314]

@sapphi-red Iirc, we need to be very careful with this optimization, there's some diff between how node vs web browsers encode certain url params that has caught me out before.

let me see if i can find the issue

[sapphi-red]

@camc314 Does that mean Node or browsers has a bug? These functions were defined in the ECMA spec since ES3.

[camc314]

Ah the issue was with how browser handle * in URLs (not encode/decode search params)

// chrome 
(new URL("https://*.wikipedia.org/*")).origin // 'https://%2A.wikipedia.org'
// safari
(new URL("https://*.wikipedia.org/*").origin // https://*.wikipedia.org

so this shouldn't affect these optimizations, new URL also doesn't appear to be in the spec.

Ignore me 🙂

[sapphi-red]

FYI the URL constructor is defined in the URL Standard spec.

[Copilot]

@copilot check the comments

All review comments have been addressed in commit 24dd1b3. The changes include:

• Moving global function handling into the match statement
• Creating shared URI_ALWAYS_UNESCAPED constant
• Reordering characters per ECMA-262 spec
• Removing obvious comments
• Optimizing encode/decode functions with rust_urlencoding approach
• Cleaning up test formatting

All tests continue to pass.

[sapphi-red]

@copilot check the comments

[sapphi-red]

• feat(ecmascript): add URI encoding/decoding support to constant evaluation #12934 👈 (View in Graphite)
• main

---

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

• 0-merge - adds this PR to the back of the merge queue
• hotfix - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

[codspeed-hq]

CodSpeed Instrumentation Performance Report

Merging #12934 will not alter performance

_{Comparing copilot/fix-8bf3e9d5-2736-45fa-9ede-2d554baeb25b (1a8b45c) with main (96b4009)¹}

Summary

✅ 34 untouched benchmarks

Footnotes

1. No successful run was found on main (e28c491) during the generation of this report, so 96b4009 was used instead as the comparison base. There might be some changes unrelated to this pull request in this report. ↩

[Copilot]

Pull Request Overview

This PR implements constant evaluation support for the four global URI encoding/decoding functions (encodeURI, encodeURIComponent, decodeURI, and decodeURIComponent) to enable compile-time optimization of these function calls when used with literal string arguments.

• Extends the constant evaluation framework to handle global function calls (not just method calls)
• Adds URI encoding/decoding implementations following ECMA-262 specification with proper UTF-8 and error handling
• Includes comprehensive test coverage for all functions, edge cases, and roundtrip operations

Reviewed Changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
crates/oxc_minifier/src/peephole/replace_known_methods.rs	Adds extensive test cases covering all URI functions with various inputs including Unicode
crates/oxc_ecmascript/src/constant_evaluation/url_encoding/mod.rs	Module entry point exposing URI encoding/decoding functions
crates/oxc_ecmascript/src/constant_evaluation/url_encoding/enc.rs	URI encoding implementation with character set handling
crates/oxc_ecmascript/src/constant_evaluation/url_encoding/dec.rs	URI decoding implementation with error handling for malformed sequences
crates/oxc_ecmascript/src/constant_evaluation/mod.rs	Adds url_encoding module to constant evaluation
crates/oxc_ecmascript/src/constant_evaluation/call_expr.rs	Integrates URI functions into constant evaluation framework