Encode the right scope

A URL component encoder escapes reserved separators such as question mark, ampersand, equals, slash, and hash because they may be data inside one parameter value. A complete-URL encoder preserves structural separators so the scheme, host, path, query, and fragment remain recognizable.

Percent encoding represents UTF-8 bytes

Characters outside the unreserved ASCII set are first represented as UTF-8 bytes and then written as percent followed by two hexadecimal digits per byte. A visible character can therefore produce several percent sequences.

Plus signs depend on the surrounding format

In `application/x-www-form-urlencoded` query or form data, a plus sign commonly represents a space. In a general URL path, a plus sign can be literal. The decoding option makes that assumption explicit instead of silently changing every plus sign.

Decoding can fail

A percent sign must be followed by a valid encoded byte sequence, and decoded bytes must form valid UTF-8 for this tool. Partial sequences, invalid hexadecimal, or decoding text twice can cause errors or change data unexpectedly.

Encoding does not make a URL safe, trusted, private, or authorized. Validate schemes, hosts, redirects, and decoded values in the system that consumes them. This tool does not parse or normalize URL semantics.