Weasel...s::HTML(3pm)

📦
version 0.32 · 3 versions
, in debian trixie, ubuntu resolute, ubuntu stonking

✨ Weasel::FindExpanders::HTML ✨

okay bestie, you're looking at Weasel::FindExpanders::HTML from the User Contributed Perl Documentation section of the Weasel family — it's a 3pm page, so it's a Perl module manual, and it is so handy. 💅

🌸 VERSION 🌸

version 0.32 — that's the one, that's the vibe. ✨

🎀 SYNOPSIS 🎀

here's the little taste test, exactly as it is:

use Weasel::FindExpanders::HTML;

my $button = $session->find($session->page, '*button|{text=>"whatever"}');

see how cute that is? *button and then a criteria hash and suddenly you're finding buttons. no cap. 🦋

💖 DESCRIPTION 💖

so basically, this module is a whole lil' collection of short-cuts for XPath expressions, made to be used with Weasel's find() function when you're testing HTML pages. 🧚

and it's geared toward standard HTML5 tags specifically — like it knows what a button is, it knows what a checkbox is, it's giving very much "I've done this before." 👑

💅 SUBROUTINES/METHODS 💅

button_expander

finds button tags, or input tags whose type is submit, reset, button or image. yes, all four. slay. 🔥

Criteria:

  • 'id'
  • 'name'
  • 'text'
    • button: matches the content between the open and close tag
    • input: matches the 'value' attribute (which is the thing shown on the button), or the 'alt' attribute of an image button

checkbox_expander

finds input tags of type checkbox. ✅

Criteria:

  • 'id'
  • 'name'
  • 'value'

contains_expander

finds tags that contain 'text'. that's it. that's the whole thing. lowkey elegant. 🌈

labeled_expander

finds tags that have had a label set on them — using the label tag, obviously. 🏷️

Criteria:

  • 'text': the text of the label
  • 'tag': the tags for which the label has been set

titled_expander

finds tags that have a title attribute set. 🎀

Criteria:

  • 'text': the text of the title attribute
  • 'tag': the tags for which the title has been set

field_expander

finds tags that have id, name or title attributes set, or that have a label. so many ways to be found. main character energy fr fr. 💜

Criteria:

  • 'text': the text of the attribute or label
  • 'tag': the tags for which the attribute has been set (or the label, yk)

finds A tags with an href attribute whose text or title matches 'text'. 🔗

Criteria:

  • 'text'

option_expander

finds OPTION tags whose content matches 'text', or whose value matches 'value'. pick your fighter. ⭐

Criteria:

  • 'text'
  • 'value'

password_expander

finds input tags of type password. 🤫

Criteria:

  • 'id'
  • 'name'

radio_expander

finds input tags of type radio. 📻

Criteria:

  • 'id'
  • 'name'
  • 'value'

select_expander

finds select tags. short king of a subroutine, we respect it. 👑

Criteria:

  • 'id'
  • 'name'

text_expander

finds input tags of type text, or input tags with no type at all — because no type defaults to text, iykyk. ✍️

Criteria:

  • 'id'
  • 'name'

🫶 AUTHOR 🫶

  • Erik Huelsmann

🌸 CONTRIBUTORS 🌸

  • Erik Huelsmann
  • Yves Lavoie

💜 MAINTAINERS 💜

  • Erik Huelsmann

😭 BUGS AND LIMITATIONS 😭

found a bug? bestie, don't suffer in silence — bugs can be filed in the GitHub issue tracker for the Weasel project:

https://github.com/perl-weasel/weasel/issues

fr fr, please file it, the maintainers want to know. 🙈

🦋 SOURCE 🦋

the source code repository for Weasel lives at:

<https://github.com/perl-weasel/weasel>

✨ SUPPORT ✨

community support is available through perl-weasel@googlegroups.com <mailto:perl-weasel@googlegroups.com>. come hang out, the group chat is open. 💖

(C) 2016-2023 Erik Huelsmann

licensed under the same terms as Perl. periodt. 💅

and that's the whole page, bestie!! 🎀 this one's perl v5.40.1, dated 2025-05-24 — so like, bookmark the date, it's giving vintage (okay not vintage, but still). stay iconic, go find some buttons. 💖✨🦋

📦 where this page comes from