Coverage Report

Created: 2025-11-16 07:46

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/serenity/Userland/Libraries/LibWeb/Loader/Resource.h
Line
Count
Source
1
/*
2
 * Copyright (c) 2020, Andreas Kling <kling@serenityos.org>
3
 *
4
 * SPDX-License-Identifier: BSD-2-Clause
5
 */
6
7
#pragma once
8
9
#include <AK/ByteBuffer.h>
10
#include <AK/HashMap.h>
11
#include <AK/HashTable.h>
12
#include <AK/Noncopyable.h>
13
#include <AK/RefCounted.h>
14
#include <AK/WeakPtr.h>
15
#include <AK/Weakable.h>
16
#include <LibGfx/Forward.h>
17
#include <LibHTTP/HeaderMap.h>
18
#include <LibURL/URL.h>
19
#include <LibWeb/Forward.h>
20
#include <LibWeb/Loader/LoadRequest.h>
21
22
namespace Web {
23
24
class ResourceClient;
25
26
class Resource : public RefCounted<Resource> {
27
    AK_MAKE_NONCOPYABLE(Resource);
28
    AK_MAKE_NONMOVABLE(Resource);
29
30
public:
31
    enum class Type {
32
        Generic,
33
    };
34
35
    static NonnullRefPtr<Resource> create(Badge<ResourceLoader>, Type, LoadRequest const&);
36
    virtual ~Resource();
37
38
0
    Type type() const { return m_type; }
39
40
    enum class State {
41
        Pending,
42
        Loaded,
43
        Failed,
44
    };
45
46
0
    bool is_pending() const { return m_state == State::Pending; }
47
0
    bool is_loaded() const { return m_state == State::Loaded; }
48
0
    bool is_failed() const { return m_state == State::Failed; }
49
50
0
    ByteString const& error() const { return m_error; }
51
52
0
    bool has_encoded_data() const { return !m_encoded_data.is_empty(); }
53
54
0
    const URL::URL& url() const { return m_request.url(); }
55
0
    ByteBuffer const& encoded_data() const { return m_encoded_data; }
56
57
0
    [[nodiscard]] HTTP::HeaderMap const& response_headers() const { return m_response_headers; }
58
59
0
    [[nodiscard]] Optional<u32> status_code() const { return m_status_code; }
60
61
    void register_client(Badge<ResourceClient>, ResourceClient&);
62
    void unregister_client(Badge<ResourceClient>, ResourceClient&);
63
64
0
    bool has_encoding() const { return m_encoding.has_value(); }
65
0
    Optional<ByteString> const& encoding() const { return m_encoding; }
66
0
    ByteString const& mime_type() const { return m_mime_type; }
67
68
    void for_each_client(Function<void(ResourceClient&)>);
69
70
    void did_load(Badge<ResourceLoader>, ReadonlyBytes data, HTTP::HeaderMap const&, Optional<u32> status_code);
71
    void did_fail(Badge<ResourceLoader>, ByteString const& error, Optional<u32> status_code);
72
73
protected:
74
    explicit Resource(Type, LoadRequest const&);
75
    Resource(Type, Resource&);
76
77
0
    LoadRequest request() const { return m_request; }
78
79
private:
80
    LoadRequest m_request;
81
    ByteBuffer m_encoded_data;
82
    Type m_type { Type::Generic };
83
    State m_state { State::Pending };
84
    ByteString m_error;
85
    Optional<ByteString> m_encoding;
86
87
    ByteString m_mime_type;
88
    HTTP::HeaderMap m_response_headers;
89
    Optional<u32> m_status_code;
90
    HashTable<ResourceClient*> m_clients;
91
};
92
93
class ResourceClient : public Weakable<ResourceClient> {
94
public:
95
    virtual ~ResourceClient();
96
97
0
    virtual void resource_did_load() { }
98
0
    virtual void resource_did_fail() { }
99
100
protected:
101
0
    virtual Resource::Type client_type() const { return Resource::Type::Generic; }
102
103
0
    Resource* resource() { return m_resource; }
104
0
    Resource const* resource() const { return m_resource; }
105
    void set_resource(Resource*);
106
107
private:
108
    RefPtr<Resource> m_resource;
109
};
110
111
}