WWW::Me...e::Image(3)

💅 WWW::Mechanize::Image(3) — like, the whole page, bestie

okay so real quick: this is the manual page for WWW::Mechanize::Image, which lives in the User Contributed Perl Documentation corner of the world, and today we're reading it together. grab a lil snack, it's short and it's cute 🍓

---

✨ NAME ✨

WWW::Mechanize::Image — it's the Image object for WWW::Mechanize. that's it, that's the vibe. an object whose whole personality is "i hold image stuff for Mech" 🎀

🌸 VERSION 🌸

version 2.19. yes ma'am, we're on 2.19, write it down 💖

🦋 SYNOPSIS 🦋

it's an Image object that encapsulates all the stuff that Mech needs. lowkey self-explanatory but the docs said it so i'm saying it ✨

🧚 Constructor

new()

creates and returns a brand-new WWW::Mechanize::Image object. she's fresh out the box, no cap 💅

my $image = WWW::Mechanize::Image->new( {
    url    => $url,
    base   => $base,
    tag    => $tag,
    name   => $name,     # From the INPUT tag
    height => $height,   # optional
    width  => $width,    # optional
    alt    => $alt,      # optional
    attrs  => $attr_ref, # optional
} );

those last four are optional, the rest are just… there. iykyk 💜

👑 Accessors

the getter girlies. one bullet each, no skipping, we love a complete list 🌈

• $image->url() — the image URL, pulled straight from the src attribute of the source tag. heads up though: it may be undef if the source tag has no src attribute. so like, don't assume, mmkay? 🙈
• $image->base() — the base URL that the links are relative to.
• $image->name() — the name for the field, from the NAME attribute, if there even is one.
• $image->tag() — the tag name. it's either image or input. those are the two options, periodt.
• $image->height() — the image height 📏
• $image->width() — the image width 📏
• $image->alt() — the ALT attribute from the source tag, if any. accessibility icon behavior honestly 🫶
• $image->attrs() — a hash ref with all the attributes and attribute values in the tag. the whole ensemble, not just the fit 💀
• $image->URI() — returns the URL as a URI::URL object. glow-up into a real object ✨
• $image->url_abs() — returns the URL as an absolute URL string. no relatives allowed, we're going absolute 🔥

---

🎀 SEE ALSO 🎀

go check out WWW::Mechanize and WWW::Mechanize::Link — the friend group this one rolls with 🦋

💖 AUTHOR 💖

Andy Lester <andy at petdance.com> — thank you for your service, king 👑

📜 COPYRIGHT AND LICENSE 📜

This software is copyright (c) 2004 by Andy Lester.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. so like, free free, fr fr 💜

---

and that's the whole page bestie 🥹 before you go: this was the WWW::Mechanize::Image(3) page as shipped with perl v5.42.0, dated 2024-09-17, and it's literally giving "User Contributed Perl Documentation." slay, go write some Perl 💅✨🌸