HTML::O...OM::Root(3)

okay so bestie, welcome to this User Contributed Perl Documentation page for HTML::O...OM::Root(3) ✨ the module is HTML::Object::DOM::Root, and we're about to get into the whole DOM root situation. no cap, this one's short but it's got lore 💅

---

🌸 NAME 🌸

HTML::Object::DOM::Root — HTML Object. That's the name, that's the vibe, periodt 💖

✨ SYNOPSIS ✨

here's the literal code, bestie — copy it exactly, don't freestyle the syntax:

use HTML::Object::DOM::Root;
my $this = HTML::Object::DOM::Root->new || die( HTML::Object::DOM::Root->error, "\n" );

🎀 VERSION 🎀

v0.2.0 — that's the version, and it's giving official release energy 🌟

🦋 DESCRIPTION 🦋

This module implements a Root in DOM. It inherits from HTML::Object::Root and HTML::Object::DOM::Node — so yes, the family tree is real and it's iconic 👑

🌈 INHERITANCE 🌈

okay so the whole inheritance diagram is literally this, and I am obsessed with the arrows:

+---------------------------+     +-------------------------+     +--------------------+     +-------------------------+
|   HTML::Object::Element   | --> |   HTML::Object::Document  | --> |   HTML::Object::Root | --> |   HTML::Object::DOM::Root |
+---------------------------+     +-------------------------+     +--------------------+     +-------------------------+
  |                                                                                            ^
  |                                                                                            |
  v                                                                                            |
+---------------------------+     +-------------------------+                                  |
| HTML::Object::EventTarget | --> | HTML::Object::DOM::Node | ---------------------------------+
+---------------------------+     +-------------------------+

💅 METHODS 💅

these are the methods, and each one is doing its own little thing. let's go 🫶

🍓 cmp 🍓

Provided with another object, this returns true if the other object is a HTML::Object::Root object, or false otherwise. It's a yes/no check, iykyk 💀

🧚 getAttributes 🧚

Returns an empty list in list context, or an empty array reference in scalar context. Empty on purpose, bestie — it's minimalism ✨

⭐ getChildNodes ⭐

Returns the "root" element. That's it. That's the whole method 💖

🌸 getName 🌸

Returns an empty list in list context, or undef in scalar context. So if you're expecting a name, it's giving mystery 🙈

🦋 getNextSibling 🦋

Returns an empty list in list context, or undef in scalar context. No next sibling today, babe 💀

🎀 getParentNode 🎀

Returns an empty list in list context, or undef in scalar context. The parent node is not loading 😭

🍓 getPreviousSibling 🍓

Returns an empty list in list context, or undef in scalar context. Same previous-sibling story — nothing there 🫠

👑 getRootNode 👑

Returns itself. main character energy, honestly 👑

💜 is_inside 💜

Returns false. It's not inside, bestie, and it's not sorry 💅

📄 isDocumentNode 📄

Returns true. This one is a document node — periodt ✨

🌟 root 🌟

Sets or gets a root node, which should be a HTML::Object::DOM::Element::HTML object. So use that kind of object, okay? 😌

🫶 AUTHOR 🫶

Jacques Deguest <jack@deguest.jp> — say thank you to the author, bestie 💖

🔥 SEE ALSO 🔥

HTML::Object::DOM::Element::HTML — go look at that one too, iykyk 🌟

👑 COPYRIGHT & LICENSE 👑

Copyright(c) 2021 DEGUEST Pte. Ltd.

All rights reserved

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

---

mwah 💖 this little manual moment was served by perl v5.42.2, dated 2026-02-15, and the manual name is HTML::O...OM::Root(3). bye bestie, go slay your DOM stuff 🫶✨