LibWeb: Implement '5.4. Request class' from the Fetch API :^)

2025-07-26 06:17:34 +00:00 · 2022-09-25 19:33:13 +01:00 · 2022-09-25 19:33:13 +01:00 · 9fb672e981
commit 9fb672e981
parent 5ad6283331
13 changed files with 1146 additions and 3 deletions
--- a/Userland/Libraries/LibWeb/Fetch/Request.h
+++ b/Userland/Libraries/LibWeb/Fetch/Request.h
@ -0,0 +1,115 @@
+/*
+ * Copyright (c) 2022, Linus Groh <linusg@serenityos.org>
+ *
+ * SPDX-License-Identifier: BSD-2-Clause
+ */
+
+#pragma once
+
+#include <AK/Forward.h>
+#include <LibJS/Forward.h>
+#include <LibWeb/Bindings/PlatformObject.h>
+#include <LibWeb/Fetch/Body.h>
+#include <LibWeb/Fetch/BodyInit.h>
+#include <LibWeb/Fetch/Headers.h>
+#include <LibWeb/Forward.h>
+
+namespace Web::Fetch {
+
+// https://fetch.spec.whatwg.org/#requestinfo
+using RequestInfo = Variant<JS::Handle<Request>, String>;
+
+// https://fetch.spec.whatwg.org/#requestinit
+struct RequestInit {
+    Optional<String> method;
+    Optional<HeadersInit> headers;
+    Optional<Optional<BodyInit>> body;
+    Optional<String> referrer;
+    Optional<Bindings::ReferrerPolicy> referrer_policy;
+    Optional<Bindings::RequestMode> mode;
+    Optional<Bindings::RequestCredentials> credentials;
+    Optional<Bindings::RequestCache> cache;
+    Optional<Bindings::RequestRedirect> redirect;
+    Optional<String> integrity;
+    Optional<bool> keepalive;
+    Optional<JS::GCPtr<DOM::AbortSignal>> signal;
+    Optional<Bindings::RequestDuplex> duplex;
+    Optional<JS::Value> window;
+
+    // https://infra.spec.whatwg.org/#map-is-empty
+    bool is_empty() const
+    {
+        return !(method.has_value()
+            || headers.has_value()
+            || body.has_value()
+            || referrer.has_value()
+            || referrer_policy.has_value()
+            || mode.has_value()
+            || credentials.has_value()
+            || cache.has_value()
+            || redirect.has_value()
+            || integrity.has_value()
+            || keepalive.has_value()
+            || signal.has_value()
+            || duplex.has_value()
+            || window.has_value());
+    }
+};
+
+// https://fetch.spec.whatwg.org/#request
+class Request final
+    : public Bindings::PlatformObject
+    , public BodyMixin {
+    WEB_PLATFORM_OBJECT(Request, Bindings::PlatformObject);
+
+public:
+    static JS::NonnullGCPtr<Request> create(NonnullOwnPtr<Infrastructure::Request>, Headers::Guard, JS::Realm&);
+    static WebIDL::ExceptionOr<JS::NonnullGCPtr<Request>> create_with_global_object(HTML::Window&, RequestInfo const& input, RequestInit const& init = {});
+
+    virtual ~Request() override;
+
+    // ^BodyMixin
+    virtual Optional<MimeSniff::MimeType> mime_type_impl() const override;
+    virtual Optional<Infrastructure::Body&> body_impl() override;
+    virtual Optional<Infrastructure::Body const&> body_impl() const override;
+
+    [[nodiscard]] Infrastructure::Request& request() { return *m_request; }
+    [[nodiscard]] Infrastructure::Request const& request() const { return *m_request; }
+
+    // JS API functions
+    [[nodiscard]] String method() const;
+    [[nodiscard]] String url() const;
+    [[nodiscard]] JS::NonnullGCPtr<Headers> headers() const;
+    [[nodiscard]] Bindings::RequestDestination destination() const;
+    [[nodiscard]] String referrer() const;
+    [[nodiscard]] Bindings::ReferrerPolicy referrer_policy() const;
+    [[nodiscard]] Bindings::RequestMode mode() const;
+    [[nodiscard]] Bindings::RequestCredentials credentials() const;
+    [[nodiscard]] Bindings::RequestCache cache() const;
+    [[nodiscard]] Bindings::RequestRedirect redirect() const;
+    [[nodiscard]] String integrity() const;
+    [[nodiscard]] bool keepalive() const;
+    [[nodiscard]] bool is_reload_navigation() const;
+    [[nodiscard]] bool is_history_navigation() const;
+    [[nodiscard]] JS::NonnullGCPtr<DOM::AbortSignal> signal() const;
+    [[nodiscard]] WebIDL::ExceptionOr<JS::NonnullGCPtr<Request>> clone() const;
+
+private:
+    Request(JS::Realm&, NonnullOwnPtr<Infrastructure::Request>);
+
+    virtual void visit_edges(Cell::Visitor&) override;
+
+    // https://fetch.spec.whatwg.org/#concept-request-request
+    // A Request object has an associated request (a request).
+    NonnullOwnPtr<Infrastructure::Request> m_request;
+
+    // https://fetch.spec.whatwg.org/#request-headers
+    // A Request object also has an associated headers (null or a Headers object), initially null.
+    JS::GCPtr<Headers> m_headers;
+
+    // https://fetch.spec.whatwg.org/#request-signal
+    // A Request object has an associated signal (null or an AbortSignal object), initially null.
+    JS::GCPtr<DOM::AbortSignal> m_signal;
+};
+
+}