mirror of
https://github.com/LadybirdBrowser/ladybird.git
synced 2025-12-08 06:09:58 +00:00
9375660b64
The end goal here is for LibHTTP to be the home of our RFC 9111 (HTTP caching) implementation. We currently have one implementation in LibWeb for our in-memory cache and another in RequestServer for our disk cache. The implementations both largely revolve around interacting with HTTP headers. But in LibWeb, we are using Fetch's header infra, and in RS we are using are home-grown header infra from LibHTTP. So to give these a common denominator, this patch replaces the LibHTTP implementation with Fetch's infra. Our existing LibHTTP implementation was not particularly compliant with any spec, so this at least gives us a standards-based common implementation. This migration also required moving a handful of other Fetch AOs over to LibHTTP. (It turns out these AOs were all from the Fetch/Infra/HTTP folder, so perhaps it makes sense for LibHTTP to be the implementation of that entire set of facilities.)
80 lines
2.7 KiB
C++
80 lines
2.7 KiB
C++
/*
|
|
* Copyright (c) 2022-2023, Linus Groh <linusg@serenityos.org>
|
|
*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <AK/HashMap.h>
|
|
#include <AK/String.h>
|
|
#include <AK/Variant.h>
|
|
#include <AK/Vector.h>
|
|
#include <LibGC/Ptr.h>
|
|
#include <LibHTTP/HeaderList.h>
|
|
#include <LibJS/Forward.h>
|
|
#include <LibWeb/Bindings/PlatformObject.h>
|
|
#include <LibWeb/WebIDL/ExceptionOr.h>
|
|
|
|
namespace Web::Fetch {
|
|
|
|
using HeadersInit = Variant<Vector<Vector<String>>, OrderedHashMap<String, String>>;
|
|
|
|
// https://fetch.spec.whatwg.org/#headers-class
|
|
class Headers final : public Bindings::PlatformObject {
|
|
WEB_PLATFORM_OBJECT(Headers, Bindings::PlatformObject);
|
|
GC_DECLARE_ALLOCATOR(Headers);
|
|
|
|
public:
|
|
enum class Guard {
|
|
Immutable,
|
|
Request,
|
|
RequestNoCORS,
|
|
Response,
|
|
None,
|
|
};
|
|
|
|
static WebIDL::ExceptionOr<GC::Ref<Headers>> construct_impl(JS::Realm& realm, Optional<HeadersInit> const& init);
|
|
|
|
virtual ~Headers() override;
|
|
|
|
[[nodiscard]] NonnullRefPtr<HTTP::HeaderList> const& header_list() const { return m_header_list; }
|
|
void set_header_list(NonnullRefPtr<HTTP::HeaderList> header_list) { m_header_list = move(header_list); }
|
|
|
|
[[nodiscard]] Guard guard() const { return m_guard; }
|
|
void set_guard(Guard guard) { m_guard = guard; }
|
|
|
|
WebIDL::ExceptionOr<void> fill(HeadersInit const&);
|
|
WebIDL::ExceptionOr<void> append(HTTP::Header);
|
|
|
|
// JS API functions
|
|
WebIDL::ExceptionOr<void> append(String const& name, String const& value);
|
|
WebIDL::ExceptionOr<void> delete_(String const& name);
|
|
WebIDL::ExceptionOr<Optional<String>> get(String const& name);
|
|
[[nodiscard]] Vector<String> get_set_cookie();
|
|
WebIDL::ExceptionOr<bool> has(String const& name);
|
|
WebIDL::ExceptionOr<void> set(String const& name, String const& value);
|
|
|
|
using ForEachCallback = Function<JS::ThrowCompletionOr<void>(String const&, String const&)>;
|
|
JS::ThrowCompletionOr<void> for_each(ForEachCallback);
|
|
|
|
private:
|
|
friend class HeadersIterator;
|
|
|
|
Headers(JS::Realm&, NonnullRefPtr<HTTP::HeaderList>);
|
|
|
|
virtual void initialize(JS::Realm&) override;
|
|
|
|
WebIDL::ExceptionOr<bool> validate(HTTP::Header const&) const;
|
|
void remove_privileged_no_cors_request_headers();
|
|
|
|
// https://fetch.spec.whatwg.org/#concept-headers-header-list
|
|
// A Headers object has an associated header list (a header list), which is initially empty.
|
|
NonnullRefPtr<HTTP::HeaderList> m_header_list;
|
|
|
|
// https://fetch.spec.whatwg.org/#concept-headers-guard
|
|
// A Headers object also has an associated guard, which is a headers guard. A headers guard is "immutable", "request", "request-no-cors", "response" or "none".
|
|
Guard m_guard { Guard::None };
|
|
};
|
|
|
|
}
|