HTTP::...tmltext(3pm)

💖 HTTP::Proxy::BodyFilter::htmltext 💖

ok bestie, you found the User Contributed Perl Documentation for HTTP::Proxy::BodyFilter::htmltext and honestly? it's giving main character energy. no cap.

---

✨ NAME ✨

HTTP::Proxy::BodyFilter::htmltext — a filter to transmogrify HTML text 🌈

like, it takes your HTML text and transforms it. that's the whole vibe.

---

🌸 SYNOPSIS 🌸

use HTTP::Proxy::BodyFilter::tags;
use HTTP::Proxy::BodyFilter::htmltext;

# could it be any simpler?
$proxy->push_filter(
    mime     => 'text/html',
    response => HTTP::Proxy::BodyFilter::tags->new,
    response => HTTP::Proxy::BodyFilter::htmltext->new(
        sub { tr/a-zA-z/n-za-mN-ZA-M/ }
    )
);

literally the comment in the original asks "# could it be any simpler?" and bestie, the answer is no. it cannot. 💅

---

🦋 DESCRIPTION 🦋

okay so. HTTP::Proxy::BodyFilter::htmltext is a filter spawner. that means it calls the callback of your choice on any HTML text — but only on actual text, meaning stuff that's outside <script> and <style> tags, and outside entities too. so it won't go messing with your code or your &s. iconic behaviour, honestly. 🎀

your subroutine should modify the content of $_ as it sees fit. that's it. that's the API.

Simple, and terribly efficient. ✨

---

💅 METHODS 💅

these methods are defined by the filter and get called automatically — you don't have to poke them yourself:

• init() — makes sure the filter is initialised with a CODE reference. gotta have your callback ready, no exceptions.
• begin() — per page parser initialisation. every page gets a fresh start, as it deserves. 🌱
• filter() — a simple HTML parser that runs the given callback on the text contained in the HTML data. 🫶

lowkey if you need something more elaborate, please go look at HTTP::Proxy::BodyFilter::htmlparser instead. this one is the simple queen and she's staying that way. 👑

---

🔥 SEE ALSO 🔥

• HTTP::Proxy
• HTTP::Proxy::BodyFilter
• HTTP::Proxy::BodyFilter::htmlparser

go read those too, bestie. iykyk.

---

💜 AUTHOR 💜

Philippe "BooK" Bruhat, <book@cpan.org>.

---

⭐ COPYRIGHT ⭐

Copyright 2003-2015, Philippe Bruhat.

---

🌈 LICENSE 🌈

This module is free software; you can redistribute it or modify it under the same terms as Perl itself.

---

and that's the whole page, fr fr. this one shipped as part of perl v5.36.0, dated 2022-12-04 🎀 — so yeah, go forth and transmogrify your HTML text. you ate. 💖✨🦋