summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Userland/Libraries/LibWeb/CMakeLists.txt1
-rw-r--r--Userland/Libraries/LibWeb/HTML/HTMLAnchorElement.cpp18
-rw-r--r--Userland/Libraries/LibWeb/HTML/HTMLAnchorElement.h15
-rw-r--r--Userland/Libraries/LibWeb/HTML/HTMLAnchorElement.idl13
-rw-r--r--Userland/Libraries/LibWeb/HTML/HTMLAreaElement.cpp19
-rw-r--r--Userland/Libraries/LibWeb/HTML/HTMLAreaElement.h15
-rw-r--r--Userland/Libraries/LibWeb/HTML/HTMLAreaElement.idl13
-rw-r--r--Userland/Libraries/LibWeb/HTML/HTMLHyperlinkElementUtils.cpp454
-rw-r--r--Userland/Libraries/LibWeb/HTML/HTMLHyperlinkElementUtils.h64
9 files changed, 609 insertions, 3 deletions
diff --git a/Userland/Libraries/LibWeb/CMakeLists.txt b/Userland/Libraries/LibWeb/CMakeLists.txt
index d4de8dfde7..066755a9dd 100644
--- a/Userland/Libraries/LibWeb/CMakeLists.txt
+++ b/Userland/Libraries/LibWeb/CMakeLists.txt
@@ -120,6 +120,7 @@ set(SOURCES
HTML/HTMLHeadElement.cpp
HTML/HTMLHeadingElement.cpp
HTML/HTMLHtmlElement.cpp
+ HTML/HTMLHyperlinkElementUtils.cpp
HTML/HTMLIFrameElement.cpp
HTML/HTMLImageElement.cpp
HTML/HTMLInputElement.cpp
diff --git a/Userland/Libraries/LibWeb/HTML/HTMLAnchorElement.cpp b/Userland/Libraries/LibWeb/HTML/HTMLAnchorElement.cpp
index 78ca088b3a..9817944cee 100644
--- a/Userland/Libraries/LibWeb/HTML/HTMLAnchorElement.cpp
+++ b/Userland/Libraries/LibWeb/HTML/HTMLAnchorElement.cpp
@@ -17,4 +17,22 @@ HTMLAnchorElement::~HTMLAnchorElement()
{
}
+void HTMLAnchorElement::parse_attribute(FlyString const& name, String const& value)
+{
+ HTMLElement::parse_attribute(name, value);
+ if (name == HTML::AttributeNames::href) {
+ set_the_url();
+ }
+}
+
+String HTMLAnchorElement::hyperlink_element_utils_href() const
+{
+ return attribute(HTML::AttributeNames::href);
+}
+
+void HTMLAnchorElement::set_hyperlink_element_utils_href(String href)
+{
+ set_attribute(HTML::AttributeNames::href, move(href));
+}
+
}
diff --git a/Userland/Libraries/LibWeb/HTML/HTMLAnchorElement.h b/Userland/Libraries/LibWeb/HTML/HTMLAnchorElement.h
index 1888a45eae..8930da4949 100644
--- a/Userland/Libraries/LibWeb/HTML/HTMLAnchorElement.h
+++ b/Userland/Libraries/LibWeb/HTML/HTMLAnchorElement.h
@@ -7,20 +7,31 @@
#pragma once
#include <LibWeb/HTML/HTMLElement.h>
+#include <LibWeb/HTML/HTMLHyperlinkElementUtils.h>
namespace Web::HTML {
-class HTMLAnchorElement final : public HTMLElement {
+class HTMLAnchorElement final
+ : public HTMLElement
+ , public HTMLHyperlinkElementUtils {
public:
using WrapperType = Bindings::HTMLAnchorElementWrapper;
HTMLAnchorElement(DOM::Document&, QualifiedName);
virtual ~HTMLAnchorElement() override;
- String href() const { return attribute(HTML::AttributeNames::href); }
String target() const { return attribute(HTML::AttributeNames::target); }
virtual bool is_focusable() const override { return has_attribute(HTML::AttributeNames::href); }
+
+private:
+ // ^DOM::Element
+ virtual void parse_attribute(FlyString const& name, String const& value) override;
+
+ // ^HTML::HTMLHyperlinkElementUtils
+ virtual DOM::Document const& hyperlink_element_utils_document() const override { return document(); }
+ virtual String hyperlink_element_utils_href() const override;
+ virtual void set_hyperlink_element_utils_href(String) override;
};
}
diff --git a/Userland/Libraries/LibWeb/HTML/HTMLAnchorElement.idl b/Userland/Libraries/LibWeb/HTML/HTMLAnchorElement.idl
index 829b9039ee..0f28114c10 100644
--- a/Userland/Libraries/LibWeb/HTML/HTMLAnchorElement.idl
+++ b/Userland/Libraries/LibWeb/HTML/HTMLAnchorElement.idl
@@ -13,4 +13,17 @@ interface HTMLAnchorElement : HTMLElement {
[Reflect] attribute DOMString rev;
[Reflect] attribute DOMString shape;
+ // FIXME: This should come from a HTMLHyperlinkElementUtils mixin
+ [CEReactions] stringifier attribute USVString href;
+ readonly attribute USVString origin;
+ [CEReactions] attribute USVString protocol;
+ [CEReactions] attribute USVString username;
+ [CEReactions] attribute USVString password;
+ [CEReactions] attribute USVString host;
+ [CEReactions] attribute USVString hostname;
+ [CEReactions] attribute USVString port;
+ [CEReactions] attribute USVString pathname;
+ [CEReactions] attribute USVString search;
+ [CEReactions] attribute USVString hash;
+
};
diff --git a/Userland/Libraries/LibWeb/HTML/HTMLAreaElement.cpp b/Userland/Libraries/LibWeb/HTML/HTMLAreaElement.cpp
index 04056ecfa7..88c9b5ca15 100644
--- a/Userland/Libraries/LibWeb/HTML/HTMLAreaElement.cpp
+++ b/Userland/Libraries/LibWeb/HTML/HTMLAreaElement.cpp
@@ -17,4 +17,23 @@ HTMLAreaElement::~HTMLAreaElement()
{
}
+
+void HTMLAreaElement::parse_attribute(FlyString const& name, String const& value)
+{
+ HTMLElement::parse_attribute(name, value);
+ if (name == HTML::AttributeNames::href) {
+ set_the_url();
+ }
+}
+
+String HTMLAreaElement::hyperlink_element_utils_href() const
+{
+ return attribute(HTML::AttributeNames::href);
+}
+
+void HTMLAreaElement::set_hyperlink_element_utils_href(String href)
+{
+ set_attribute(HTML::AttributeNames::href, move(href));
+}
+
}
diff --git a/Userland/Libraries/LibWeb/HTML/HTMLAreaElement.h b/Userland/Libraries/LibWeb/HTML/HTMLAreaElement.h
index 8cd447b951..67283932e9 100644
--- a/Userland/Libraries/LibWeb/HTML/HTMLAreaElement.h
+++ b/Userland/Libraries/LibWeb/HTML/HTMLAreaElement.h
@@ -1,5 +1,6 @@
/*
* Copyright (c) 2020, the SerenityOS developers.
+ * Copyright (c) 2021, Andreas Kling <kling@serenityos.org>
*
* SPDX-License-Identifier: BSD-2-Clause
*/
@@ -7,15 +8,27 @@
#pragma once
#include <LibWeb/HTML/HTMLElement.h>
+#include <LibWeb/HTML/HTMLHyperlinkElementUtils.h>
namespace Web::HTML {
-class HTMLAreaElement final : public HTMLElement {
+class HTMLAreaElement final
+ : public HTMLElement
+ , public HTMLHyperlinkElementUtils {
public:
using WrapperType = Bindings::HTMLAreaElementWrapper;
HTMLAreaElement(DOM::Document&, QualifiedName);
virtual ~HTMLAreaElement() override;
+
+private:
+ // ^DOM::Element
+ virtual void parse_attribute(FlyString const& name, String const& value) override;
+
+ // ^HTML::HTMLHyperlinkElementUtils
+ virtual DOM::Document const& hyperlink_element_utils_document() const override { return document(); }
+ virtual String hyperlink_element_utils_href() const override;
+ virtual void set_hyperlink_element_utils_href(String) override;
};
}
diff --git a/Userland/Libraries/LibWeb/HTML/HTMLAreaElement.idl b/Userland/Libraries/LibWeb/HTML/HTMLAreaElement.idl
index 7cd0058305..318cddeb1f 100644
--- a/Userland/Libraries/LibWeb/HTML/HTMLAreaElement.idl
+++ b/Userland/Libraries/LibWeb/HTML/HTMLAreaElement.idl
@@ -2,4 +2,17 @@ interface HTMLAreaElement : HTMLElement {
[Reflect=nohref] attribute boolean noHref;
+ // FIXME: This should come from a HTMLHyperlinkElementUtils mixin
+ [CEReactions] stringifier attribute USVString href;
+ readonly attribute USVString origin;
+ [CEReactions] attribute USVString protocol;
+ [CEReactions] attribute USVString username;
+ [CEReactions] attribute USVString password;
+ [CEReactions] attribute USVString host;
+ [CEReactions] attribute USVString hostname;
+ [CEReactions] attribute USVString port;
+ [CEReactions] attribute USVString pathname;
+ [CEReactions] attribute USVString search;
+ [CEReactions] attribute USVString hash;
+
};
diff --git a/Userland/Libraries/LibWeb/HTML/HTMLHyperlinkElementUtils.cpp b/Userland/Libraries/LibWeb/HTML/HTMLHyperlinkElementUtils.cpp
new file mode 100644
index 0000000000..f4e2c6d1c4
--- /dev/null
+++ b/Userland/Libraries/LibWeb/HTML/HTMLHyperlinkElementUtils.cpp
@@ -0,0 +1,454 @@
+/*
+ * Copyright (c) 2021, Andreas Kling <kling@serenityos.org>
+ *
+ * SPDX-License-Identifier: BSD-2-Clause
+ */
+
+#include <AK/URLParser.h>
+#include <LibWeb/DOM/Document.h>
+#include <LibWeb/HTML/HTMLHyperlinkElementUtils.h>
+
+namespace Web::HTML {
+
+HTMLHyperlinkElementUtils::~HTMLHyperlinkElementUtils()
+{
+}
+
+// https://html.spec.whatwg.org/multipage/links.html#reinitialise-url
+void HTMLHyperlinkElementUtils::reinitialize_url() const
+{
+ // 1. If element's url is non-null, its scheme is "blob", and its cannot-be-a-basFe-URL is true, terminate these steps.
+ if (m_url.has_value() && m_url->scheme() == "blob"sv && m_url->cannot_be_a_base_url())
+ return;
+
+ // 2. Set the url.
+ const_cast<HTMLHyperlinkElementUtils*>(this)->set_the_url();
+}
+
+// https://html.spec.whatwg.org/multipage/links.html#concept-hyperlink-url-set
+void HTMLHyperlinkElementUtils::set_the_url()
+{
+ // 1. If this element's href content attribute is absent, set this element's url to null.
+ auto href_content_attribute = hyperlink_element_utils_href();
+ if (href_content_attribute.is_null()) {
+ m_url = {};
+ return;
+ }
+
+ // 2. Otherwise, parse this element's href content attribute value relative to this element's node document.
+ // If parsing is successful, set this element's url to the result; otherwise, set this element's url to null.
+ m_url = hyperlink_element_utils_document().parse_url(href_content_attribute);
+}
+
+// https://html.spec.whatwg.org/multipage/links.html#dom-hyperlink-origin
+String HTMLHyperlinkElementUtils::origin() const
+{
+ // 1. Reinitialize url.
+ reinitialize_url();
+
+ // 2. If this element's url is null, return the empty string.
+ if (!m_url.has_value())
+ return String::empty();
+
+ // 3. Return the serialization of this element's url's origin.
+ return m_url->serialize_origin();
+}
+
+// https://html.spec.whatwg.org/multipage/links.html#dom-hyperlink-protocol
+String HTMLHyperlinkElementUtils::protocol() const
+{
+ // 1. Reinitialize url.
+ reinitialize_url();
+
+ // 2. If this element's url is null, return ":".
+ if (!m_url.has_value())
+ return ":"sv;
+
+ // 3. Return this element's url's scheme, followed by ":".
+ return String::formatted("{}:", m_url->scheme());
+}
+
+// https://html.spec.whatwg.org/multipage/links.html#dom-hyperlink-protocol
+void HTMLHyperlinkElementUtils::set_protocol(String protocol)
+{
+ // 1. Reinitialize url.
+ reinitialize_url();
+
+ // 2. If this element's url is null, terminate these steps.
+ if (!m_url.has_value())
+ return;
+
+ // 3. Basic URL parse the given value, followed by ":", with this element's url as url and scheme start state as state override.
+ auto result_url = URLParser::parse(String::formatted("{}:", protocol), nullptr, m_url, URLParser::State::SchemeStart);
+ if (result_url.is_valid())
+ m_url = move(result_url);
+
+ // 4. Update href.
+ update_href();
+}
+
+// https://html.spec.whatwg.org/multipage/links.html#dom-hyperlink-username
+String HTMLHyperlinkElementUtils::username() const
+{
+ // 1. Reinitialize url.
+ reinitialize_url();
+
+ // 2. If this element's url is null, return the empty string.
+ if (!m_url.has_value())
+ return String::empty();
+
+ // 3. Return this element's url's username.
+ return m_url->username();
+}
+
+// https://html.spec.whatwg.org/multipage/links.html#dom-hyperlink-username
+void HTMLHyperlinkElementUtils::set_username(String username)
+{
+ // 1. Reinitialize url.
+ reinitialize_url();
+
+ // 2. Let url be this element's url.
+ auto& url = m_url;
+
+ // 3. If url is null or url cannot have a username/password/port, then return.
+ if (!url.has_value() || url->cannot_have_a_username_or_password_or_port())
+ return;
+
+ // 4. Set the username given thisโ€™s URL and the given value.
+ url->set_username(AK::URL::percent_encode(username, AK::URL::PercentEncodeSet::Userinfo));
+
+ // 5. Update href.
+ update_href();
+}
+
+// https://html.spec.whatwg.org/multipage/links.html#dom-hyperlink-password
+String HTMLHyperlinkElementUtils::password() const
+{
+ // 1. Reinitialize url.
+ reinitialize_url();
+
+ // 2. Let url be this element's url.
+ auto& url = m_url;
+
+ // 3. If url is null, then return the empty string.
+ if (!url.has_value())
+ return String::empty();
+
+ // 4. Return url's password.
+ return url->password();
+}
+
+// https://html.spec.whatwg.org/multipage/links.html#dom-hyperlink-password
+void HTMLHyperlinkElementUtils::set_password(String password)
+{
+ // 1. Reinitialize url.
+ reinitialize_url();
+
+ // 2. Let url be this element's url.
+ auto& url = m_url;
+
+ // 3. If url is null or url cannot have a username/password/port, then return.
+ if (!url.has_value() || url->cannot_have_a_username_or_password_or_port())
+ return;
+
+ // 4. Set the password, given url and the given value.
+ url->set_password(move(password));
+
+ // 5. Update href.
+ update_href();
+}
+
+// https://html.spec.whatwg.org/multipage/links.html#dom-hyperlink-host
+String HTMLHyperlinkElementUtils::host() const
+{
+ // 1. Reinitialize url.
+ reinitialize_url();
+
+ // 2. Let url be this element's url.
+ auto& url = m_url;
+
+ // 3. If url or url's host is null, return the empty string.
+ if (!url.has_value() || url->host().is_null())
+ return String::empty();
+
+ // 4. If url's port is null, return url's host, serialized.
+ if (!url->port().has_value())
+ return url->host();
+
+ // 5. Return url's host, serialized, followed by ":" and url's port, serialized.
+ return String::formatted("{}:{}", url->host(), url->port().value());
+}
+
+// https://html.spec.whatwg.org/multipage/links.html#dom-hyperlink-host
+void HTMLHyperlinkElementUtils::set_host(String host)
+{
+ // 1. Reinitialize url.
+ reinitialize_url();
+
+ // 2. Let url be this element's url.
+ auto& url = m_url;
+
+ // 3. If url is null or url's cannot-be-a-base-URL is true, then return.
+ if (!url.has_value() || url->cannot_be_a_base_url())
+ return;
+
+ // 4. Basic URL parse the given value, with url as url and host state as state override.
+ auto result_url = URLParser::parse(host, nullptr, url, URLParser::State::Host);
+ if (result_url.is_valid())
+ m_url = move(result_url);
+
+ // 5. Update href.
+ update_href();
+}
+
+String HTMLHyperlinkElementUtils::hostname() const
+{
+ // 1. Reinitialize url.
+ //
+ // 2. Let url be this element's url.
+ //
+ // 3. If url or url's host is null, return the empty string.
+ //
+ // 4. Return url's host, serialized.
+ return AK::URL(href()).host();
+}
+
+void HTMLHyperlinkElementUtils::set_hostname(String hostname)
+{
+ // 1. Reinitialize url.
+ reinitialize_url();
+
+ // 2. Let url be this element's url.
+ auto& url = m_url;
+
+ // 3. If url is null or url's cannot-be-a-base-URL is true, then return.
+ if (!url.has_value() || url->cannot_be_a_base_url())
+ return;
+
+ // 4. Basic URL parse the given value, with url as url and hostname state as state override.
+ auto result_url = URLParser::parse(hostname, nullptr, m_url, URLParser::State::Hostname);
+ if (result_url.is_valid())
+ m_url = move(result_url);
+
+ // 5. Update href.
+ update_href();
+}
+
+// https://html.spec.whatwg.org/multipage/links.html#dom-hyperlink-port
+String HTMLHyperlinkElementUtils::port() const
+{
+ // 1. Reinitialize url.
+ reinitialize_url();
+
+ // 2. Let url be this element's url.
+ auto& url = m_url;
+
+ // 3. If url or url's port is null, return the empty string.
+ if (!url.has_value() || !url->port().has_value())
+ return String::empty();
+
+ // 4. Return url's port, serialized.
+ return String::number(url->port().value());
+}
+
+// https://html.spec.whatwg.org/multipage/links.html#dom-hyperlink-port
+void HTMLHyperlinkElementUtils::set_port(String port)
+{
+ // 1. Reinitialize url.
+ reinitialize_url();
+
+ // 2. Let url be this element's url.
+
+ // 3. If url is null or url cannot have a username/password/port, then return.
+ if (!m_url.has_value() || m_url->cannot_have_a_username_or_password_or_port())
+ return;
+
+ // 4. If the given value is the empty string, then set url's port to null.
+ if (port.is_empty()) {
+ m_url->set_port({});
+ } else {
+ // 5. Otherwise, basic URL parse the given value, with url as url and port state as state override.
+ auto result_url = URLParser::parse(port, nullptr, m_url, URLParser::State::Port);
+ if (result_url.is_valid())
+ m_url = move(result_url);
+ }
+
+ // 6. Update href.
+ update_href();
+}
+
+// https://html.spec.whatwg.org/multipage/links.html#dom-hyperlink-pathname
+String HTMLHyperlinkElementUtils::pathname() const
+{
+ // 1. Reinitialize url.
+ reinitialize_url();
+
+ // 2. Let url be this element's url.
+
+ // 3. If url is null, return the empty string.
+ if (!m_url.has_value())
+ return String::empty();
+
+ // 4. If url's cannot-be-a-base-URL is true, then return url's path[0].
+ // 5. If url's path is empty, then return the empty string.
+ // 6. Return "/", followed by the strings in url's path (including empty strings), separated from each other by "/".
+ return m_url->path();
+}
+
+// https://html.spec.whatwg.org/multipage/links.html#dom-hyperlink-pathname
+void HTMLHyperlinkElementUtils::set_pathname(String pathname)
+{
+ // 1. Reinitialize url.
+ reinitialize_url();
+
+ // 2. Let url be this element's url.
+
+ // 3. If url is null or url's cannot-be-a-base-URL is true, then return.
+ if (!m_url.has_value() || m_url->cannot_be_a_base_url())
+ return;
+
+ // 4. Set url's path to the empty list.
+ auto url = m_url; // We copy the URL here to follow other browser's behaviour of reverting the path change if the parse failed.
+ url->set_paths({});
+
+ // 5. Basic URL parse the given value, with url as url and path start state as state override.
+ auto result_url = URLParser::parse(pathname, nullptr, move(url), URLParser::State::PathStart);
+ if (result_url.is_valid())
+ m_url = move(result_url);
+
+ // 6. Update href.
+ update_href();
+}
+
+String HTMLHyperlinkElementUtils::search() const
+{
+ // 1. Reinitialize url.
+ reinitialize_url();
+
+ // 2. Let url be this element's url.
+
+ // 3. If url is null, or url's query is either null or the empty string, return the empty string.
+ if (!m_url.has_value() || m_url->query().is_null() || m_url->query().is_empty())
+ return String::empty();
+
+ // 4. Return "?", followed by url's query.
+ return String::formatted("?{}", m_url->query());
+}
+
+void HTMLHyperlinkElementUtils::set_search(String search)
+{
+ // 1. Reinitialize url.
+ reinitialize_url();
+
+ // 2. Let url be this element's url.
+
+ // 3. If url is null, terminate these steps.
+ if (!m_url.has_value())
+ return;
+
+ // 4. If the given value is the empty string, set url's query to null.
+ if (search.is_empty()) {
+ m_url->set_query({});
+ } else {
+ // 5. Otherwise:
+ // 1. Let input be the given value with a single leading "?" removed, if any.
+ auto input = search.substring_view(search.starts_with('?'));
+
+ // 2. Set url's query to the empty string.
+ auto url_copy = m_url; // We copy the URL here to follow other browser's behaviour of reverting the search change if the parse failed.
+ url_copy->set_query(String::empty());
+
+ // 3. Basic URL parse input, with null, this element's node document's document's character encoding, url as url, and query state as state override.
+ auto result_url = URLParser::parse(input, nullptr, move(url_copy), URLParser::State::Query);
+ if (result_url.is_valid())
+ m_url = move(result_url);
+ }
+
+ // 6. Update href.
+ update_href();
+}
+
+String HTMLHyperlinkElementUtils::hash() const
+{
+ // 1. Reinitialize url.
+ reinitialize_url();
+
+ // 2. Let url be this element's url.
+
+ // 3. If url is null, or url's fragment is either null or the empty string, return the empty string.
+ if (!m_url.has_value() || m_url->fragment().is_null() || m_url->fragment().is_empty())
+ return String::empty();
+
+ // 4. Return "#", followed by url's fragment.
+ return String::formatted("#{}", m_url->fragment());
+}
+
+void HTMLHyperlinkElementUtils::set_hash(String hash)
+{
+ // 1. Reinitialize url.
+ reinitialize_url();
+
+ // 2. Let url be this element's url.
+
+ // 3. If url is null, then return.
+ if (!m_url.has_value())
+ return;
+
+ // 4. If the given value is the empty string, set url's fragment to null.
+ if (hash.is_empty()) {
+ m_url->set_fragment({});
+ } else {
+ // 5. Otherwise:
+ // 1. Let input be the given value with a single leading "#" removed, if any.
+ auto input = hash.substring_view(hash.starts_with('#'));
+
+ // 2. Set url's fragment to the empty string.
+ auto url_copy = m_url; // We copy the URL here to follow other browser's behaviour of reverting the hash change if the parse failed.
+ url_copy->set_fragment(String::empty());
+
+ // 3. Basic URL parse input, with url as url and fragment state as state override.
+ auto result_url = URLParser::parse(input, nullptr, move(url_copy), URLParser::State::Fragment);
+ if (result_url.is_valid())
+ m_url = move(result_url);
+ }
+
+ // 6. Update href.
+ update_href();
+}
+
+// https://html.spec.whatwg.org/multipage/links.html#dom-hyperlink-href
+String HTMLHyperlinkElementUtils::href() const
+{
+ // 1. Reinitialize url.
+ reinitialize_url();
+
+ // 2. Let url be this element's url.
+ auto& url = m_url;
+
+ // 3. If url is null and this element has no href content attribute, return the empty string.
+ auto href_content_attribute = hyperlink_element_utils_href();
+ if (!url.has_value() && href_content_attribute.is_null())
+ return String::empty();
+
+ // 4. Otherwise, if url is null, return this element's href content attribute's value.
+ if (!url->is_valid())
+ return href_content_attribute;
+
+ // 5. Return url, serialized.
+ return url->serialize();
+}
+
+// https://html.spec.whatwg.org/multipage/links.html#dom-hyperlink-href
+void HTMLHyperlinkElementUtils::set_href(String href)
+{
+ // The href attribute's setter must set this element's href content attribute's value to the given value.
+ set_hyperlink_element_utils_href(move(href));
+}
+
+// https://html.spec.whatwg.org/multipage/links.html#update-href
+void HTMLHyperlinkElementUtils::update_href()
+{
+ // To update href, set the element's href content attribute's value to the element's url, serialized.
+}
+
+}
diff --git a/Userland/Libraries/LibWeb/HTML/HTMLHyperlinkElementUtils.h b/Userland/Libraries/LibWeb/HTML/HTMLHyperlinkElementUtils.h
new file mode 100644
index 0000000000..75f2e5f49f
--- /dev/null
+++ b/Userland/Libraries/LibWeb/HTML/HTMLHyperlinkElementUtils.h
@@ -0,0 +1,64 @@
+/*
+ * Copyright (c) 2021, Andreas Kling <kling@serenityos.org>
+ *
+ * SPDX-License-Identifier: BSD-2-Clause
+ */
+
+#pragma once
+
+#include <AK/URL.h>
+#include <LibWeb/Forward.h>
+
+namespace Web::HTML {
+
+class HTMLHyperlinkElementUtils {
+public:
+ virtual ~HTMLHyperlinkElementUtils();
+
+ String origin() const;
+
+ String href() const;
+ void set_href(String);
+
+ String protocol() const;
+ void set_protocol(String);
+
+ String username() const;
+ void set_username(String);
+
+ String password() const;
+ void set_password(String);
+
+ String host() const;
+ void set_host(String);
+
+ String hostname() const;
+ void set_hostname(String);
+
+ String port() const;
+ void set_port(String);
+
+ String pathname() const;
+ void set_pathname(String);
+
+ String search() const;
+ void set_search(String);
+
+ String hash() const;
+ void set_hash(String);
+
+protected:
+ virtual DOM::Document const& hyperlink_element_utils_document() const = 0;
+ virtual String hyperlink_element_utils_href() const = 0;
+ virtual void set_hyperlink_element_utils_href(String) = 0;
+
+ void set_the_url();
+
+private:
+ void reinitialize_url() const;
+ void update_href();
+
+ Optional<AK::URL> m_url;
+};
+
+}