cookie

package

v1.0.0 Latest Latest Go to latest Published: Jan 5, 2026 License: MIT Imports: 5 Imported by: 0

Details

Package cookie implements an HTTP cookie jar with thread-safe storage and automatic cookie management for HTTP clients.

This section is empty.

This section is empty.

This section is empty.

type Jar struct {
	// contains filtered or unexported fields
}

Jar is a thread-safe cookie jar that stores cookies per host. It implements http.CookieJar interface for compatibility.

func New() *Jar

New creates a new empty cookie jar.

func (j *Jar) CleanExpired()

CleanExpired removes all expired cookies from the jar.

func (j *Jar) Clear()

Clear removes all cookies from the jar.

func (j *Jar) ClearHost(host string)

ClearHost removes all cookies for a specific host.

func (j *Jar) Cookies(u *url.URL) []*http.Cookie

Cookies returns cookies for the given URL. Implements http.CookieJar interface.

func (j *Jar) Count() int

Count returns the total number of cookies stored.

func (j *Jar) DeleteCookie(u *url.URL, name string)

DeleteCookie removes a cookie by name for the given URL.

func (j *Jar) GetCookie(u *url.URL, name string) *http.Cookie

GetCookie returns a specific cookie by name for the given URL, or nil if not found.

func (j *Jar) SetCookie(u *url.URL, cookie *http.Cookie)

SetCookie sets a single cookie for the given URL.

func (j *Jar) SetCookies(u *url.URL, cookies []*http.Cookie)

SetCookies stores cookies for the given URL. Implements http.CookieJar interface.