LibWeb/URLPattern: Add initial stub for URLPattern interface

Author: https://github.com/shannonbooth
Commit: https://github.com/LadybirdBrowser/ladybird/commit/d4649db55e2
Pull-request: https://github.com/LadybirdBrowser/ladybird/pull/3224
Reviewed-by: https://github.com/AtkinsSJ ✅

Libraries/LibWeb/CMakeLists.txt

@@ -776,6 +776,7 @@ set(SOURCES
     UIEvents/TextEvent.cpp
     UIEvents/UIEvent.cpp
     UIEvents/WheelEvent.cpp
+    URLPattern/URLPattern.cpp
     UserTiming/PerformanceMark.cpp
     UserTiming/PerformanceMeasure.cpp
     WebAssembly/Global.cpp

Libraries/LibWeb/Forward.h

@@ -796,6 +796,10 @@ class TextEvent;
 class UIEvent;
 }
 
+namespace Web::URLPattern {
+class URLPattern;
+}
+
 namespace Web::DOMURL {
 class DOMURL;
 class URLSearchParams;

Libraries/LibWeb/URLPattern/URLPattern.cpp

@@ -0,0 +1,39 @@
+/*
+ * Copyright (c) 2025, Shannon Booth <shannon@serenityos.org>
+ *
+ * SPDX-License-Identifier: BSD-2-Clause
+ */
+
+#include <LibWeb/Bindings/Intrinsics.h>
+#include <LibWeb/Bindings/URLPatternPrototype.h>
+#include <LibWeb/URLPattern/URLPattern.h>
+#include <LibWeb/WebIDL/ExceptionOr.h>
+
+namespace Web::URLPattern {
+
+GC_DEFINE_ALLOCATOR(URLPattern);
+
+URLPattern::URLPattern(JS::Realm& realm)
+    : PlatformObject(realm)
+{
+}
+
+URLPattern::~URLPattern() = default;
+
+void URLPattern::initialize(JS::Realm& realm)
+{
+    Base::initialize(realm);
+    WEB_SET_PROTOTYPE_FOR_INTERFACE(URLPattern);
+}
+
+WebIDL::ExceptionOr<GC::Ref<URLPattern>> URLPattern::construct_impl(JS::Realm& realm, URLPatternInput const&, String const&, URLPatternOptions const&)
+{
+    return realm.create<URLPattern>(realm);
+}
+
+WebIDL::ExceptionOr<GC::Ref<URLPattern>> URLPattern::construct_impl(JS::Realm& realm, URLPatternInput const&, URLPatternOptions const&)
+{
+    return realm.create<URLPattern>(realm);
+}
+
+}

Libraries/LibWeb/URLPattern/URLPattern.h

@@ -0,0 +1,37 @@
+/*
+ * Copyright (c) 2025, Shannon Booth <shannon@serenityos.org>
+ *
+ * SPDX-License-Identifier: BSD-2-Clause
+ */
+
+#pragma once
+
+#include <AK/String.h>
+#include <LibURL/Pattern/Init.h>
+#include <LibURL/Pattern/Pattern.h>
+#include <LibWeb/Bindings/PlatformObject.h>
+
+namespace Web::URLPattern {
+
+using URLPatternInit = URL::Pattern::Init;
+using URLPatternInput = URL::Pattern::Input;
+using URLPatternOptions = URL::Pattern::Options;
+
+// https://urlpattern.spec.whatwg.org/#urlpattern
+class URLPattern : public Bindings::PlatformObject {
+    WEB_PLATFORM_OBJECT(URLPattern, Bindings::PlatformObject);
+    GC_DECLARE_ALLOCATOR(URLPattern);
+
+public:
+    static WebIDL::ExceptionOr<GC::Ref<URLPattern>> construct_impl(JS::Realm&, URLPatternInput const&, String const& base_url, URLPatternOptions const& = {});
+    static WebIDL::ExceptionOr<GC::Ref<URLPattern>> construct_impl(JS::Realm&, URLPatternInput const&, URLPatternOptions const& = {});
+
+    virtual ~URLPattern() override;
+
+protected:
+    virtual void initialize(JS::Realm&) override;
+
+    explicit URLPattern(JS::Realm&);
+};
+
+}

Libraries/LibWeb/URLPattern/URLPattern.idl

@@ -0,0 +1,61 @@
+typedef (USVString or URLPatternInit) URLPatternInput;
+
+// https://urlpattern.spec.whatwg.org/#urlpattern
+[Exposed=(Window,Worker)]
+interface URLPattern {
+    constructor(URLPatternInput input, USVString baseURL, optional URLPatternOptions options = {});
+    constructor(optional URLPatternInput input = {}, optional URLPatternOptions options = {});
+
+    [FIXME] boolean test(optional URLPatternInput input = {}, optional USVString baseURL);
+
+    [FIXME] URLPatternResult? exec(optional URLPatternInput input = {}, optional USVString baseURL);
+
+    [FIXME] readonly attribute USVString protocol;
+    [FIXME] readonly attribute USVString username;
+    [FIXME] readonly attribute USVString password;
+    [FIXME] readonly attribute USVString hostname;
+    [FIXME] readonly attribute USVString port;
+    [FIXME] readonly attribute USVString pathname;
+    [FIXME] readonly attribute USVString search;
+    [FIXME] readonly attribute USVString hash;
+
+    [FIXME] readonly attribute boolean hasRegExpGroups;
+};
+
+// https://urlpattern.spec.whatwg.org/#dictdef-urlpatterninit
+dictionary URLPatternInit {
+    USVString protocol;
+    USVString username;
+    USVString password;
+    USVString hostname;
+    USVString port;
+    USVString pathname;
+    USVString search;
+    USVString hash;
+    USVString baseURL;
+};
+
+// https://urlpattern.spec.whatwg.org/#dictdef-urlpatternoptions
+dictionary URLPatternOptions {
+    boolean ignoreCase = false;
+};
+
+// https://urlpattern.spec.whatwg.org/#dictdef-urlpatternresult
+dictionary URLPatternResult {
+    sequence<URLPatternInput> inputs;
+
+    URLPatternComponentResult protocol;
+    URLPatternComponentResult username;
+    URLPatternComponentResult password;
+    URLPatternComponentResult hostname;
+    URLPatternComponentResult port;
+    URLPatternComponentResult pathname;
+    URLPatternComponentResult search;
+    URLPatternComponentResult hash;
+};
+
+// https://urlpattern.spec.whatwg.org/#dictdef-urlpatterncomponentresult
+dictionary URLPatternComponentResult {
+    USVString input;
+    record<USVString, (USVString or undefined)> groups;
+};

Libraries/LibWeb/idl_files.cmake

@@ -349,6 +349,7 @@ libweb_js_bindings(UIEvents/PointerEvent)
 libweb_js_bindings(UIEvents/TextEvent)
 libweb_js_bindings(UIEvents/UIEvent)
 libweb_js_bindings(UIEvents/WheelEvent)
+libweb_js_bindings(URLPattern/URLPattern)
 libweb_js_bindings(UserTiming/PerformanceMark)
 libweb_js_bindings(UserTiming/PerformanceMeasure)
 libweb_js_bindings(WebAssembly/Global)

Meta/Lagom/Tools/CodeGenerators/LibWeb/BindingsGenerator/IDLGenerators.cpp

@@ -4436,6 +4436,7 @@ using namespace Web::StorageAPI;
 using namespace Web::Streams;
 using namespace Web::SVG;
 using namespace Web::UIEvents;
+using namespace Web::URLPattern;
 using namespace Web::UserTiming;
 using namespace Web::WebAssembly;
 using namespace Web::WebAudio;

Meta/Lagom/Tools/CodeGenerators/LibWeb/BindingsGenerator/Namespaces.h

@@ -37,6 +37,7 @@ static constexpr Array libweb_interface_namespaces = {
     "Selection"sv,
     "ServiceWorker"sv,
     "UIEvents"sv,
+    "URLPattern"sv,
     "WebAudio"sv,
     "WebGL"sv,
     "WebIDL"sv,

Tests/LibWeb/Text/expected/all-window-properties.txt

@@ -394,6 +394,7 @@ TypeError
 UIEvent
 URIError
 URL
+URLPattern
 URLSearchParams
 Uint16Array
 Uint32Array