NAME

       Mojo::UserAgent::CookieJar - Cookie jar for HTTP user agents

SYNOPSIS

         use Mojo::UserAgent::CookieJar;

         # Add response cookies
         my $jar = Mojo::UserAgent::CookieJar->new;
         $jar->add(
           Mojo::Cookie::Response->new(
             name   => 'foo',
             value  => 'bar',
             domain => 'localhost',
             path   => '/test'
           )
         );

         # Find request cookies
         for my $cookie (@{$jar->find(Mojo::URL->new('http://localhost/test'))}) {
           say $cookie->name;
           say $cookie->value;
         }

DESCRIPTION

       Mojo::UserAgent::CookieJar is a minimalistic and relaxed cookie jar used by
       Mojo::UserAgent and based on RFC 6265 <http://tools.ietf.org/html/rfc6265>.

ATTRIBUTES

       Mojo::UserAgent::CookieJar implements the following attributes.

   collecting
         my $bool = $jar->collecting;
         $jar     = $jar->collecting($bool);

       Allow "collect" to "add" new cookies to the jar, defaults to a true value.

   max_cookie_size
         my $size = $jar->max_cookie_size;
         $jar     = $jar->max_cookie_size(4096);

       Maximum cookie size in bytes, defaults to 4096 (4KB).

METHODS

       Mojo::UserAgent::CookieJar inherits all methods from Mojo::Base and implements the
       following new ones.

   add
         $jar = $jar->add(@cookies);

       Add multiple Mojo::Cookie::Response objects to the jar.

   all
         my $cookies = $jar->all;

       Return all Mojo::Cookie::Response objects that are currently stored in the jar.

         # Names of all cookies
         say $_->name for @{$jar->all};

   collect
         $jar->collect(Mojo::Transaction::HTTP->new);

       Collect response cookies from transaction.

   empty
         $jar->empty;

       Empty the jar.

   find
         my $cookies = $jar->find(Mojo::URL->new);

       Find Mojo::Cookie::Request objects in the jar for Mojo::URL object.

         # Names of all cookies found
         say $_->name for @{$jar->find(Mojo::URL->new('http://example.com/foo'))};

   prepare
         $jar->prepare(Mojo::Transaction::HTTP->new);

       Prepare request cookies for transaction.

SEE ALSO

       Mojolicious, Mojolicious::Guides, <http://mojolicio.us>.