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

funcNew¶

func New(o *Options) (*Jar,error)

New returns a new cookie jar. A nil*Options is equivalent to a zeroOptions.

// Start a server to give us cookies.ts := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {if cookie, err := r.Cookie("Flavor"); err != nil {http.SetCookie(w, &http.Cookie{Name: "Flavor", Value: "Chocolate Chip"})} else {cookie.Value = "Oatmeal Raisin"http.SetCookie(w, cookie)}}))defer ts.Close()u, err := url.Parse(ts.URL)if err != nil {log.Fatal(err)}// All users of cookiejar should import "golang.org/x/net/publicsuffix"jar, err := cookiejar.New(&cookiejar.Options{PublicSuffixList: publicsuffix.List})if err != nil {log.Fatal(err)}client := &http.Client{Jar: jar,}if _, err = client.Get(u.String()); err != nil {log.Fatal(err)}fmt.Println("After 1st request:")for _, cookie := range jar.Cookies(u) {fmt.Printf("  %s: %s\n", cookie.Name, cookie.Value)}if _, err = client.Get(u.String()); err != nil {log.Fatal(err)}fmt.Println("After 2nd request:")for _, cookie := range jar.Cookies(u) {fmt.Printf("  %s: %s\n", cookie.Name, cookie.Value)}

Output:After 1st request:  Flavor: Chocolate ChipAfter 2nd request:  Flavor: Oatmeal Raisin

func (*Jar)Cookies¶

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

Cookies implements the Cookies method of thehttp.CookieJar interface.

It returns an empty slice if the URL's scheme is not HTTP or HTTPS.

func (*Jar)SetCookies¶

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

SetCookies implements the SetCookies method of thehttp.CookieJar interface.

It does nothing if the URL's scheme is not HTTP or HTTPS.

type Options struct {// PublicSuffixList is the public suffix list that determines whether// an HTTP server can set a cookie for a domain.//// A nil value is valid and may be useful for testing but it is not// secure: it means that the HTTP server for foo.co.uk can set a cookie// for bar.co.uk.PublicSuffixListPublicSuffixList}

type PublicSuffixList interface {// PublicSuffix returns the public suffix of domain.//// TODO: specify which of the caller and callee is responsible for IP// addresses, for leading and trailing dots, for case sensitivity, and// for IDN/Punycode.PublicSuffix(domainstring)string// String returns a description of the source of this public suffix// list. The description will typically contain something like a time// stamp or version number.String()string}