Mojo::U...okieJar(3)

💅 Mojo::UserAgent::CookieJar — the manual, but make it cute

okay so bestie, pull up a chair 🎀 this is Mojo::UserAgent::CookieJar, aka the actual manual name of this page, and it's the cookie jar for HTTP user agents. yes, a cookie jar. for your HTTP user agent. she's iconic for that 💖

---

✨ SYNOPSIS ✨

here's the whole vibe in code, fr fr — no notes needed:

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;
}

like, add response cookies, find request cookies. the duality of cookie 🍪✨

---

🌸 DESCRIPTION 🌸

Mojo::UserAgent::CookieJar is a minimalistic and relaxed cookie jar used by Mojo::UserAgent, and it's based on RFC 6265 <https://tools.ietf.org/html/rfc6265> 🦋 yes she cites her sources, we stan.

lowkey she's chill, highkey she's correct. the way that she's minimalistic and relaxed? main character energy honestly 👑

---

🌈 ATTRIBUTES 🌈

Mojo::UserAgent::CookieJar implements the following attributes. let's go 🫶

🎀 file

my $file = $jar->file;
$jar     = $jar->file('/home/sri/cookies.txt');

this is the file you "load" cookies from and "save" cookies to, in Netscape format. yes, Netscape format. she's vintage 💅

# Save cookies to file
$jar->file('cookies.txt')->save;

# Empty cookie jar and load cookies from file
$jar->file('cookies.txt')->empty->load;

look at that chaining. empty then load. chef's kiss 😭

🦋 ignore

my $ignore = $jar->ignore;
$jar       = $jar->ignore(sub {...});

a callback that decides whether a cookie should be ignored by "collect" — very much a vibe check for cookies if you think about it ⭐

# Ignore all cookies
$jar->ignore(sub { 1 });

# Ignore cookies for domains "com", "net" and "org"
$jar->ignore(sub ($cookie) {
  return undef unless my $domain = $cookie->domain;
  return $domain eq 'com' || $domain eq 'net' || $domain eq 'org';
});

not her rejecting the entire com, net and org domains 💀 honestly fair.

🍓 max_cookie_size

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

maximum cookie size in bytes, and it defaults to 4096 (that's 4KiB bestie 🧚). size matters, she's just setting boundaries periodt.

---

👑 METHODS 👑

Mojo::UserAgent::CookieJar inherits all methods from Mojo::Base and implements the following new ones. slay, let's get into it 💅

🔥 add

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

add multiple Mojo::Cookie::Response objects to the jar. multiple. she's a collector.

💜 all

my $cookies = $jar->all;

return all Mojo::Cookie::Response objects that are currently stored in the jar. yes, all of them, no crumbs left behind 🍪

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

✨ collect

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

collect response cookies from transaction. go little cookie, go get collected 🦋

🎀 empty

$jar = $jar->empty;

empty the jar. she's empty. she's cleansed. she's at peace 🌸

⭐ find

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

find Mojo::Cookie::Request objects in the jar for a Mojo::URL object. a little scavenger hunt, but make it HTTP 🔍

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

🌈 load

$jar = $jar->load;

load cookies from "file". that's it, that's the method 💖

🫶 prepare

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

prepare request cookies for transaction. getting them ready, doing their makeup, sending them out 💄

🧚 save

$jar = $jar->save;

save cookies to "file". persistence queen 👑

💀 to_string

my $string = $jar->to_string;

stringify cookies in Netscape format. turn the whole jar into one string, iykyk ✨

---

lowkey a reminder bestie: file, ignore and max_cookie_size are attributes, and load/save literally read and write that "file" — so don't be weird about it 💅

---

🌸 SEE ALSO 🌸

• Mojolicious
• Mojolicious::Guides
• <https://mojolicious.org>

---

okay that's the whole page 🎀 perl v5.42.0, dated 2026-07-15 — and that's genuinely the source/version and date, bestie, so now you can't say I never told you anything 😭💖 bye, go set some cookies 🍪✨