ladybird/Libraries/LibWeb/HTML/SharedResourceRequest.h
Andreas Kling fe31d205a5 LibWeb: Bound per-document decoded image caches
Prune decoded image resources retained by active documents once they
grow beyond a recent working set. Route-heavy applications can load
many unique images through one Document, and the shared resource and
available-image caches would otherwise keep decoded image data alive
after the DOM stopped using those images.

Track cache touches and evict least recently used decoded images from
both caches. This keeps active documents from accumulating unbounded
decoded image resources while preserving a small hot cache for repeat
loads.
2026-05-17 00:29:18 +02:00

83 lines
2.3 KiB
C++

/*
* Copyright (c) 2023, Andreas Kling <andreas@ladybird.org>
*
* SPDX-License-Identifier: BSD-2-Clause
*/
#pragma once
#include <LibGC/Function.h>
#include <LibGC/Ptr.h>
#include <LibJS/Heap/Cell.h>
#include <LibURL/URL.h>
#include <LibWeb/DOM/DocumentLoadEventDelayer.h>
#include <LibWeb/Forward.h>
namespace Web::HTML {
class SharedResourceRequest final : public JS::Cell {
GC_CELL(SharedResourceRequest, JS::Cell);
GC_DECLARE_ALLOCATOR(SharedResourceRequest);
public:
static constexpr bool OVERRIDES_FINALIZE = true;
[[nodiscard]] static GC::Ref<SharedResourceRequest> get_or_create(JS::Realm&, GC::Ref<Page>, URL::URL const&);
virtual ~SharedResourceRequest() override;
URL::URL const& url() const { return m_url; }
[[nodiscard]] GC::Ptr<DecodedImageData> image_data() const;
[[nodiscard]] bool can_be_pruned_from_memory_cache() const { return m_image_data; }
[[nodiscard]] u64 cache_touch_serial() const { return m_cache_touch_serial; }
void touch_memory_cache_entry();
[[nodiscard]] GC::Ptr<Fetch::Infrastructure::FetchController> fetch_controller();
void set_fetch_controller(GC::Ptr<Fetch::Infrastructure::FetchController>);
void fetch_resource(JS::Realm&, GC::Ref<Fetch::Infrastructure::Request>);
void add_callbacks(Function<void()> on_finish, Function<void()> on_fail);
bool is_fetching() const;
bool needs_fetching() const;
private:
explicit SharedResourceRequest(GC::Ref<Page>, URL::URL, GC::Ref<DOM::Document>);
virtual void finalize() override;
virtual void visit_edges(JS::Cell::Visitor&) override;
void handle_successful_fetch(URL::URL const&, StringView mime_type, ByteBuffer data);
void handle_failed_fetch();
void handle_successful_resource_load();
enum class State {
New,
Fetching,
Finished,
Failed,
};
State m_state { State::New };
GC::Ref<Page> m_page;
struct Callbacks {
GC::Ptr<GC::Function<void()>> on_finish;
GC::Ptr<GC::Function<void()>> on_fail;
};
Vector<Callbacks> m_callbacks;
URL::URL m_url;
GC::Ptr<DecodedImageData> m_image_data;
GC::Ptr<Fetch::Infrastructure::FetchController> m_fetch_controller;
u64 m_cache_touch_serial { 0 };
GC::Ptr<DOM::Document> m_document;
Optional<DOM::DocumentLoadEventDelayer> m_load_event_delayer;
};
}