DEV Community

Cover image for The difference between encodeURI() and encodeURIComponent()
Julia Furst Morgado
Julia Furst Morgado

Posted on

The difference between encodeURI() and encodeURIComponent()

What is a URI and how is it different from a URL?

URI stands for Uniform Resource Identifier.
URL stands for Uniform Resource Locator.

Anything that uniquely identifies a resource is its URI, such as id, name, or ISBN number. A URL specifies a resource and how it can be accessed (the protocol). All URLs are URIs, but not all URIs are URLs.

Why do we need URL encoding:

Certain characters have a special value in a URL string. For example, the ? character denotes the beginning of a query string. To successfully locate a resource on the web, it is necessary to distinguish when a character is meant as a part of a string or part of the URL structure.

This means we need to encode these characters when passing them into a URL; otherwise, they may cause unpredictable situations.

Characters encoded

The difference between encodeURI() and encodeURIComponent() are exactly 11 characters.

encodeURI() will not encode: ~!@#$&*()=:/,;?+'

encodeURIComponent() will not encode: ~!*()'

When to encode:

JS offers some functions which we can use to easily encode URL's. These are two convenient options:

  • encodeURI(): should be used to encode a URI or a full URL.
encodeURI("http://www.example.org/a file with spaces.html")
//http://www.example.org/a%20file%20with%20spaces.html

Enter fullscreen mode Exit fullscreen mode
  • encodeURIComponent(): should be used to encode a URI Component such as individual values in the query string
`http://domain.com/?search=\${encodeURIComponent('encode & decode param')}`

// 'http://domain.com/?search=encode%20%26%20decode%20param'
Enter fullscreen mode Exit fullscreen mode

or when you want to encode the value of a URL parameter.

var p1 = encodeURIComponent("http://example.org/?a=12&b=55")
Enter fullscreen mode Exit fullscreen mode

Then you may create the URL you need:

var url = "http://example.net/?param1=" + p1 + "&param2=99";
Enter fullscreen mode Exit fullscreen mode

And you will get this complete URL:

http://example.net/?param1=http%3A%2F%2Fexample.org%2F%Ffa%3D12%26b%3D55&param2=99

Conclusion

If you have a complete URL, use encodeURI. But if you have a part of a URL, use encodeURIComponent.

Top comments (0)