Qual a diferença entre estas três funções, e quando utilizar cada uma delas?
escape()
encodeURI()
encodeURIComponent()
Conforme o MDN:
escape()
(obsoleta)Na função escape()
caracteres são escapados por unidades de código UTF-16. Se o valor da unidade de código for menor que 256, ele será representado por um número hexadecimal de dois dígitos no formato %XX
, preenchido à esquerda com 0
, se necessário. Caso contrário, ele será representado por um número hexadecimal de quatro dígitos no formato %uXXXX
, preenchido à esquerda com 0
, se necessário.
Ele não irá escapar os seguintes caracteres:
A–Z a–z 0–9 _ @ \ * _ + - .
Nota: conforme a documentação da MDN a função
escape()
é obsoleta, em seu lugar useencodeURI()
ouencodeURIComponent()
, conforme a necessidade.
encodeURIComponent()
Na função encodeURIComponent
codifica um componente "Uniform Resource Identifier" (URI), substituindo cada instância de certos caracteres por uma, duas, três ou quatro sequencias de escape que representam a codificação UTF-8 do caractere (somente serão quatro sequencias de escape para caracteres compostos por dois caracteres "de substituição").
Ele não irá escapar os seguintes caracteres:
A-Z a-z 0-9 - _ . ! ~ * ' ( )
encodeURI()
Não codifica caracteres que têm um significado especial (caracteres reservados) para um URI. O exemplo a seguir mostra todas as partes que um "URI Scheme" pode conter. Observe como determinados caracteres são usados para significar significado especial:
http://username:[email protected]:80/path/to/file.php?foo=316&bar=this+has+spaces#anchor
Por isso encodeURI
não codifica caracteres que são necessários para formular um URI completo. Além disso, ele não codifica alguns caracteres adicionais, conhecidos como "marcas não reservadas" (unreserved marks - RFC2396), que não têm um propósito reservado, mas são permitidos em um URI "como está".
Ela não irá escapar os seguintes caracteres:
A-Z a-z 0-9 ; , / ? : @ & = + $ - _ . ! ~ * ' ( ) #