Promis...eferred(3pm)

💖 NAME 💖

Promise::XS::Deferred — it's the deferred object, bestie 💅

(also it's a 3pm page, so like, Perl module docs, iykyk ✨)

---

🦋 SYNOPSIS 🦋

okay so lowkey the synopsis is just:

See Promise::XS.

that's it. that's the whole vibe. go look at Promise::XS, she's the main character here 👑

---

🌸 DESCRIPTION 🌸

so this class is the one that handles a promise's "producer" behavior — like, the part that actually makes the promise do stuff, not the part that sits around waiting for it 🙈

do NOT instantiate this directly. fr fr. you don't new this one yourself, you get it via Promise::XS. that's the whole pipeline, no shortcuts ✨

---

🎀 BASIC METHODS 🎀

these are the ones you need for, like, normal promise workflows. the everyday slay 💖

• $obj = OBJ->resolve( @ARGUMENTS ) — resolves OBJ's promise and hands it the given @ARGUMENTS as the value. returns OBJ 🫶

⚠️ IMPORTANT: behavior is not defined if literally anything in @ARGUMENTS is itself a promise. so like, don't do that. that's undefined behavior territory and we do not go there 💀

• $obj = OBJ->reject( @ARGUMENTS ) — same energy as resolve() but it rejects the promise instead. one of these days, am I right 😭

---

🌈 ADDITIONAL METHODS 🌈

the bonus round, the extra sprinkles 🍓

• $yn = OBJ->is_pending() — returns a boolean telling you whether the promise is still pending (as opposed to resolved or rejected). like, is she still cooking or is dinner served 🍳

normally you don't need this but it can be useful when you're debugging. it's giving detective energy 🔍

and for compatibility with preexisting promise libraries, is_in_progress() exists as an alias for this exact same logic. two names, one girl. periodt 💅

• $obj = OBJ->clear_unhandled_rejection() — so ordinarily, if a promise's rejection is "unhandled", a warning about that unhandled rejection gets produced. call this after reject() to silence that warning 🔇

(it's generally better, of course, to just handle all your errors. the warning is not the problem bestie, the unhandled rejection is 🙈)

---

and that's the whole page!! this was perl v5.42.3, dated 2026-08-22, from the Promis...eferred(3pm) page (yes the title gets truncated in the header, we don't talk about it 💀). mwah, go resolve some promises responsibly 💖✨🦋