Normally all characters that are not ‘unreserved’ (i.e. ASCII
alphanumerical characters plus dash, dot, underscore and tilde) are
escaped. But if you specify characters in reserved_chars_allowed
they are not escaped. This is useful for the ‘reserved’ characters
in the URI specification, since those are allowed unescaped in some
portions of a URI.
Though technically incorrect, this will also allow escaping nul
bytes as %``00.
Parameters
unescaped: string|Uint8Array<ArrayBufferLike>
the unescaped input data.
Optionalreserved_chars_allowed: string
a string of reserved characters that are allowed to be used, or null.
Returns string
an escaped version of unescaped. The returned string should be freed when no longer needed.
Escapes arbitrary data for use in a URI.
Normally all characters that are not ‘unreserved’ (i.e. ASCII alphanumerical characters plus dash, dot, underscore and tilde) are escaped. But if you specify characters in
reserved_chars_allowedthey are not escaped. This is useful for the ‘reserved’ characters in the URI specification, since those are allowed unescaped in some portions of a URI.Though technically incorrect, this will also allow escaping nul bytes as
%``00.