What is the difference between cookie and cookiejar?

Timur Fayzrakhmanov picture Timur Fayzrakhmanov · Jul 7, 2015 · Viewed 10.4k times · Source

Today I faced with the term "cookiejar" (package net/http/cookiejar). I tried to gather some information regarding it, but got nothing intelligible. I know that cookie is key/value pairs that server sends to a client, eg: Set-Cookie: foo=10, browser store it locally and then each subsequent request browser will send these cookies back to the server, eg: Cookie: foo=10.

Ok, but what about cookiejar? What is it and how it looks like?

Answer

icza picture icza · Jul 7, 2015

As you described in your question, cookies are managed by browsers (HTTP clients) and they allow to store information on the clients' computers which are sent automatically by the browser on subsequent requests.

If your application acts as a client (you connect to remote HTTP servers using the net/http package), then there is no browser which would handle / manage the cookies. By this I mean storing/remembering cookies that arrive as Set-Cookie: response headers, and attaching them to subsequent outgoing requests being made to the same host/domain. Also cookies have expiration date which you would also have to check before deciding to include them in outgoing requests.

The http.Client type however allows you to set a value of type http.CookieJar, and if you do so, you will have automatic cookie management which otherwise would not exist or you would have to do it yourself. This enables you to do multiple requests with the net/http package that the server will see as part of the same session just as if they were made by a real browser, as often HTTP sessions (the session ids) are maintained using cookies.

The package net/http/cookiejar is a CookieJar implementation which you can use out of the box. Note that this implementation is in-memory only which means if you restart your application, the cookies will be lost.


So basically an HTTP cookie is a small piece of data sent from a website and stored in a user's web browser while the user is browsing that website.

Cookiejar is a Go interface of a simple cookie manager (to manage cookies from HTTP request and response headers) and an implementation of that interface.