View Source HttpCookie.Jar (http_cookie v0.6.0)

Summary

Types

t()

Functions

clear_expired_cookies(jar, now \\ DateTime.utc_now())

Removes cookies which expired before the provided time from the jar.

clear_session_cookies(jar)

Removes session cookies from the jar.

get_cookie_header_value(jar, request_url)

get_matching_cookies(jar, request_url)

Gets all the cookies in the store which match the given request URL.

new(opts \\ [])

Creates a new empty cookie jar.

put_cookie(jar, cookie)

Stores the provided cookie in the jar.

put_cookies(jar, cookies)

Stores the provided cookies in the jar.

put_cookies_from_headers(jar, request_url, headers)

Processes the response header list for the given request URL. Parses set-cookie/set-cookie2 headers and stores valid cookies.

Types

t()

@type t() :: %HttpCookie.Jar{cookies: [HttpCookie.t()], opts: keyword()}

Functions

clear_expired_cookies(jar, now \\ DateTime.utc_now())

@spec clear_expired_cookies(
  jar :: %HttpCookie.Jar{cookies: term(), opts: term()},
  now :: DateTime.t()
) ::
  %HttpCookie.Jar{cookies: term(), opts: term()}

Removes cookies which expired before the provided time from the jar.

Uses the current time if no time is provided.

clear_session_cookies(jar)

@spec clear_session_cookies(jar :: %HttpCookie.Jar{cookies: term(), opts: term()}) ::
  %HttpCookie.Jar{
    cookies: term(),
    opts: term()
  }

Removes session cookies from the jar.

Cookies which don't have an explicit expiry time set are considered session cookies and they expire when a user session ends.

get_cookie_header_value(jar, request_url)

@spec get_cookie_header_value(
  jar :: %HttpCookie.Jar{cookies: term(), opts: term()},
  request_url :: URI.t()
) :: {:ok, String.t()} | {:error, :no_matching_cookies}

get_matching_cookies(jar, request_url)

@spec get_matching_cookies(
  jar :: %HttpCookie.Jar{cookies: term(), opts: term()},
  request_url :: URI.t()
) :: [HttpCookie.t()]

Gets all the cookies in the store which match the given request URL.

new(opts \\ [])

@spec new(opts :: keyword()) :: %HttpCookie.Jar{cookies: term(), opts: term()}

Creates a new empty cookie jar.

Options

:reject_public_suffixes - controls whether to reject public suffixes to guard against "supercookies", defaults to true

put_cookie(jar, cookie)

@spec put_cookie(
  jar :: %HttpCookie.Jar{cookies: term(), opts: term()},
  cookie :: HttpCookie.t()
) ::
  %HttpCookie.Jar{cookies: term(), opts: term()}

Stores the provided cookie in the jar.

put_cookies(jar, cookies)

@spec put_cookies(
  jar :: %HttpCookie.Jar{cookies: term(), opts: term()},
  cookies :: [HttpCookie.t()]
) ::
  %HttpCookie.Jar{cookies: term(), opts: term()}

Stores the provided cookies in the jar.

put_cookies_from_headers(jar, request_url, headers)

@spec put_cookies_from_headers(jar :: t(), request_url :: URI.t(), headers :: list()) ::
  t()

Processes the response header list for the given request URL. Parses set-cookie/set-cookie2 headers and stores valid cookies.