LibWeb: Stub out several methods for ElementInternals

This begins implementation on form-associated custom elements. This fixes a few WPT tests which I'm importing. Co-authored-by: Sam Atkins <sam@ladybird.org>
Author: https://github.com/AtkinsSJ Commit: 85842c1739 Pull-request: https://github.com/LadybirdBrowser/ladybird/pull/4813 Reviewed-by: https://github.com/shannonbooth Reviewed-by: https://github.com/tcl3
2025-07-29 04:09:13 +00:00 · 2025-03-31 01:43:20 -07:00 · 2025-03-31 01:43:20 -07:00 · 85842c1739 · 2025-05-21 14:29:13 +00:00
commit 85842c1739
parent 7c4fd9f624
9 changed files with 300 additions and 10 deletions
--- a/Libraries/LibWeb/HTML/ElementInternals.cpp
+++ b/Libraries/LibWeb/HTML/ElementInternals.cpp
@ -46,6 +46,168 @@ GC::Ptr<DOM::ShadowRoot> ElementInternals::shadow_root() const
    return shadow;
 }

+// https://html.spec.whatwg.org/multipage/custom-elements.html#dom-elementinternals-setformvalue
+WebIDL::ExceptionOr<void> ElementInternals::set_form_value(Variant<GC::Root<FileAPI::File>, String, GC::Root<XHR::FormData>> value, Optional<Variant<GC::Root<FileAPI::File>, String, GC::Root<XHR::FormData>>> state)
+{
+    // 1. Let element be this's target element.
+    auto element = m_target_element;
+
+    // 2. If element is not a form-associated custom element, then throw a "NotSupportedError" DOMException.
+    if (!element->is_form_associated_custom_element())
+        return WebIDL::NotSupportedError::create(realm(), "Element is not a form-associated custom element"_string);
+
+    (void)value;
+    (void)state;
+
+    // FIXME: 3. Set target element's submission value to value if value is not a FormData object, or to a clone of value's entry list otherwise.
+
+    // FIXME: 4. If the state argument of the function is omitted, set element's state to its submission value.
+
+    // FIXME: 5. Otherwise, if state is a FormData object, set element's state to a clone of state's entry list.
+
+    // FIXME: 6. Otherwise, set element's state to state.
+
+    dbgln("FIXME: ElementInternals::set_form_value()");
+    return {};
+}
+
+// https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#dom-elementinternals-form
+WebIDL::ExceptionOr<GC::Ptr<HTMLFormElement>> ElementInternals::form() const
+{
+    // Form-associated custom elements don't have form IDL attribute. Instead, their ElementInternals object has a form IDL attribute.
+    // On getting, it must throw a "NotSupportedError" DOMException if the target element is not a form-associated custom element.
+    // Otherwise, it must return the element's form owner, or null if there isn't one.
+    if (!m_target_element->is_form_associated_custom_element())
+        return WebIDL::NotSupportedError::create(realm(), "Element is not a form-associated custom element"_string);
+
+    dbgln("FIXME: ElementInternals::form()");
+    return WebIDL::NotFoundError::create(realm(), "FIXME: ElementInternals::form()"_string);
+}
+
+// https://html.spec.whatwg.org/multipage/custom-elements.html#dom-elementinternals-setvalidity
+WebIDL::ExceptionOr<void> ElementInternals::set_validity(ValidityStateFlags const& flags, Optional<String> message, Optional<GC::Ptr<HTMLElement>> anchor)
+{
+    // 1. Let element be this's target element.
+    auto element = m_target_element;
+
+    // 2. If element is not a form-associated custom element, then throw a "NotSupportedError" DOMException.
+    if (!element->is_form_associated_custom_element())
+        return WebIDL::NotSupportedError::create(realm(), "Element is not a form-associated custom element"_string);
+
+    // 3. If flags contains one or more true values and message is not given or is the empty string, then throw a TypeError.
+    if (flags.has_one_or_more_true_values() && (!message.has_value() || message->is_empty())) {
+        return WebIDL::SimpleException {
+            WebIDL::SimpleExceptionType::TypeError,
+            "Invalid flag(s) and empty message"sv
+        };
+    }
+
+    // FIXME: 4. For each entry flag → value of flags, set element's validity flag with the name flag to value.
+
+    // FIXME: 5. Set element's validation message to the empty string if message is not given or all of element's validity flags are false, or to message otherwise.
+
+    // FIXME: 6. If element's customError validity flag is true, then set element's custom validity error message to element's validation message. Otherwise, set element's custom validity error message to the empty string.
+
+    // FIXME: 7. Set element's validation anchor to null if anchor is not given. Otherwise, if anchor is not a shadow-including descendant of element, then throw a "NotFoundError" DOMException. Otherwise, set element's validation anchor to anchor.
+    if (!anchor.has_value() || !anchor.value().ptr()) {
+        // FIXME
+    } else if (!anchor.value()->is_shadow_including_descendant_of(element)) {
+        return WebIDL::NotFoundError::create(realm(), "Anchor is not a shadow-including descendant of element"_string);
+    } else {
+        // FIXME
+    }
+
+    dbgln("FIXME: ElementInternals::set_validity()");
+    return {};
+}
+
+// https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#dom-elementinternals-willvalidate
+WebIDL::ExceptionOr<bool> ElementInternals::will_validate() const
+{
+    // The willValidate attribute of ElementInternals interface, on getting, must throw a "NotSupportedError" DOMException if
+    // the target element is not a form-associated custom element. Otherwise, it must return true if the target element is a
+    // candidate for constraint validation, and false otherwise.
+    if (!m_target_element->is_form_associated_custom_element())
+        return WebIDL::NotSupportedError::create(realm(), "Element is not a form-associated custom element"_string);
+
+    dbgln("FIXME: ElementInternals::will_validate()");
+    return true;
+}
+
+// https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#dom-elementinternals-validity
+WebIDL::ExceptionOr<GC::Ref<ValidityState const>> ElementInternals::validity() const
+{
+    // The validity attribute of ElementInternals interface, on getting, must throw a "NotSupportedError" DOMException if
+    // the target element is not a form-associated custom element. Otherwise, it must return a ValidityState object that
+    // represents the validity states of the target element. This object is live.
+    if (!m_target_element->is_form_associated_custom_element())
+        return WebIDL::NotSupportedError::create(realm(), "Element is not a form-associated custom element"_string);
+
+    dbgln("FIXME: ElementInternals::validity()");
+    return WebIDL::NotSupportedError::create(realm(), "FIXME: ElementInternals::validity()"_string);
+}
+
+// https://html.spec.whatwg.org/multipage/custom-elements.html#dom-elementinternals-validationmessage
+WebIDL::ExceptionOr<String> ElementInternals::validation_message() const
+{
+    // 1. Let element be this's target element.
+    auto element = m_target_element;
+
+    // 2. If element is not a form-associated custom element, then throw a "NotSupportedError" DOMException.
+    if (!element->is_form_associated_custom_element())
+        return WebIDL::NotSupportedError::create(realm(), "Element is not a form-associated custom element"_string);
+
+    // FIXME: 3. Return element's validation message.
+
+    dbgln("FIXME: ElementInternals::validation_message()");
+    return "FIXME: ElementInternals::validation_message()"_string;
+}
+
+// https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#dom-elementinternals-checkvalidity
+WebIDL::ExceptionOr<bool> ElementInternals::check_validity() const
+{
+    // 1. Let element be this ElementInternals's target element.
+    auto element = m_target_element;
+
+    // 2. If element is not a form-associated custom element, then throw a "NotSupportedError" DOMException.
+    if (!element->is_form_associated_custom_element())
+        return WebIDL::NotSupportedError::create(realm(), "Element is not a form-associated custom element"_string);
+
+    // FIXME: 3. Run the check validity steps on element.
+
+    dbgln("FIXME: ElementInternals::check_validity()");
+    return true;
+}
+
+// https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#dom-elementinternals-reportvalidity
+WebIDL::ExceptionOr<bool> ElementInternals::report_validity() const
+{
+    // 1. Let element be this ElementInternals's target element
+    auto element = m_target_element;
+
+    // 2. If element is not a form-associated custom element, then throw a "NotSupportedError" DOMException.
+    if (!element->is_form_associated_custom_element())
+        return WebIDL::NotSupportedError::create(realm(), "Element is not a form-associated custom element"_string);
+
+    // FIXME: 3. Run the report validity steps on element.
+
+    dbgln("FIXME: ElementInternals::report_validity()");
+    return true;
+}
+
+// https://html.spec.whatwg.org/multipage/forms.html#dom-elementinternals-labels
+WebIDL::ExceptionOr<GC::Ptr<DOM::NodeList>> ElementInternals::labels()
+{
+    // Form-associated custom elements don't have a labels IDL attribute. Instead, their ElementInternals object has a labels IDL attribute.
+    // On getting, it must throw a "NotSupportedError" DOMException if the target element is not a form-associated custom element.
+    // Otherwise, it must return that NodeList object, and that same value must always be returned.
+    if (!m_target_element->is_form_associated_custom_element())
+        return WebIDL::NotSupportedError::create(realm(), "Element is not a form-associated custom element"_string);
+
+    dbgln("FIXME: ElementInternals::labels()");
+    return WebIDL::NotSupportedError::create(realm(), "FIXME: ElementInternals::labels()"_string);
+}
+
 void ElementInternals::initialize(JS::Realm& realm)
 {
    WEB_SET_PROTOTYPE_FOR_INTERFACE(ElementInternals);