Responses.h 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327
  1. /*
  2. * Copyright (c) 2022-2023, Linus Groh <linusg@serenityos.org>
  3. *
  4. * SPDX-License-Identifier: BSD-2-Clause
  5. */
  6. #pragma once
  7. #include <AK/ByteBuffer.h>
  8. #include <AK/Error.h>
  9. #include <AK/Forward.h>
  10. #include <AK/Optional.h>
  11. #include <AK/Time.h>
  12. #include <AK/Vector.h>
  13. #include <LibJS/Forward.h>
  14. #include <LibJS/Heap/Cell.h>
  15. #include <LibJS/Heap/GCPtr.h>
  16. #include <LibURL/URL.h>
  17. #include <LibWeb/Fetch/Infrastructure/HTTP/Bodies.h>
  18. #include <LibWeb/Fetch/Infrastructure/HTTP/Headers.h>
  19. #include <LibWeb/Fetch/Infrastructure/HTTP/Statuses.h>
  20. namespace Web::Fetch::Infrastructure {
  21. // https://fetch.spec.whatwg.org/#concept-response
  22. class Response : public JS::Cell {
  23. JS_CELL(Response, JS::Cell);
  24. JS_DECLARE_ALLOCATOR(Response);
  25. public:
  26. enum class CacheState {
  27. Local,
  28. Validated,
  29. };
  30. enum class Type {
  31. Basic,
  32. CORS,
  33. Default,
  34. Error,
  35. Opaque,
  36. OpaqueRedirect,
  37. };
  38. // https://fetch.spec.whatwg.org/#response-body-info
  39. struct BodyInfo {
  40. // https://fetch.spec.whatwg.org/#fetch-timing-info-encoded-body-size
  41. u64 encoded_size { 0 };
  42. // https://fetch.spec.whatwg.org/#fetch-timing-info-decoded-body-size
  43. u64 decoded_size { 0 };
  44. // https://fetch.spec.whatwg.org/#response-body-info-content-type
  45. String content_type {};
  46. bool operator==(BodyInfo const&) const = default;
  47. };
  48. [[nodiscard]] static JS::NonnullGCPtr<Response> create(JS::VM&);
  49. [[nodiscard]] static JS::NonnullGCPtr<Response> aborted_network_error(JS::VM&);
  50. [[nodiscard]] static JS::NonnullGCPtr<Response> network_error(JS::VM&, Variant<String, StringView> message);
  51. [[nodiscard]] static JS::NonnullGCPtr<Response> appropriate_network_error(JS::VM&, FetchParams const&);
  52. virtual ~Response() = default;
  53. [[nodiscard]] virtual Type type() const { return m_type; }
  54. void set_type(Type type) { m_type = type; }
  55. [[nodiscard]] virtual bool aborted() const { return m_aborted; }
  56. void set_aborted(bool aborted) { m_aborted = aborted; }
  57. [[nodiscard]] virtual Vector<URL::URL> const& url_list() const { return m_url_list; }
  58. [[nodiscard]] virtual Vector<URL::URL>& url_list() { return m_url_list; }
  59. void set_url_list(Vector<URL::URL> url_list) { m_url_list = move(url_list); }
  60. [[nodiscard]] virtual Status status() const { return m_status; }
  61. void set_status(Status status) { m_status = status; }
  62. [[nodiscard]] virtual ReadonlyBytes status_message() const { return m_status_message; }
  63. void set_status_message(ByteBuffer status_message) { m_status_message = move(status_message); }
  64. [[nodiscard]] virtual JS::NonnullGCPtr<HeaderList> header_list() const { return m_header_list; }
  65. void set_header_list(JS::NonnullGCPtr<HeaderList> header_list) { m_header_list = header_list; }
  66. [[nodiscard]] virtual JS::GCPtr<Body> const& body() const { return m_body; }
  67. [[nodiscard]] virtual JS::GCPtr<Body>& body() { return m_body; }
  68. void set_body(JS::GCPtr<Body> body) { m_body = move(body); }
  69. [[nodiscard]] virtual Optional<CacheState> const& cache_state() const { return m_cache_state; }
  70. void set_cache_state(Optional<CacheState> cache_state) { m_cache_state = move(cache_state); }
  71. [[nodiscard]] virtual Vector<ByteBuffer> const& cors_exposed_header_name_list() const { return m_cors_exposed_header_name_list; }
  72. void set_cors_exposed_header_name_list(Vector<ByteBuffer> cors_exposed_header_name_list) { m_cors_exposed_header_name_list = move(cors_exposed_header_name_list); }
  73. [[nodiscard]] virtual bool range_requested() const { return m_range_requested; }
  74. void set_range_requested(bool range_requested) { m_range_requested = range_requested; }
  75. [[nodiscard]] virtual bool request_includes_credentials() const { return m_request_includes_credentials; }
  76. void set_request_includes_credentials(bool request_includes_credentials) { m_request_includes_credentials = request_includes_credentials; }
  77. [[nodiscard]] virtual bool timing_allow_passed() const { return m_timing_allow_passed; }
  78. void set_timing_allow_passed(bool timing_allow_passed) { m_timing_allow_passed = timing_allow_passed; }
  79. [[nodiscard]] virtual BodyInfo const& body_info() const { return m_body_info; }
  80. void set_body_info(BodyInfo body_info) { m_body_info = body_info; }
  81. [[nodiscard]] bool has_cross_origin_redirects() const { return m_has_cross_origin_redirects; }
  82. void set_has_cross_origin_redirects(bool has_cross_origin_redirects) { m_has_cross_origin_redirects = has_cross_origin_redirects; }
  83. [[nodiscard]] bool is_aborted_network_error() const;
  84. [[nodiscard]] bool is_network_error() const;
  85. [[nodiscard]] Optional<URL::URL const&> url() const;
  86. [[nodiscard]] ErrorOr<Optional<URL::URL>> location_url(Optional<String> const& request_fragment) const;
  87. [[nodiscard]] JS::NonnullGCPtr<Response> clone(JS::Realm&) const;
  88. [[nodiscard]] JS::NonnullGCPtr<Response> unsafe_response();
  89. [[nodiscard]] bool is_cors_cross_origin() const;
  90. [[nodiscard]] bool is_fresh() const;
  91. [[nodiscard]] bool is_stale_while_revalidate() const;
  92. [[nodiscard]] bool is_stale() const;
  93. // Non-standard
  94. [[nodiscard]] Optional<StringView> network_error_message() const;
  95. protected:
  96. explicit Response(JS::NonnullGCPtr<HeaderList>);
  97. virtual void visit_edges(JS::Cell::Visitor&) override;
  98. private:
  99. // https://fetch.spec.whatwg.org/#concept-response-type
  100. // A response has an associated type which is "basic", "cors", "default", "error", "opaque", or "opaqueredirect". Unless stated otherwise, it is "default".
  101. Type m_type { Type::Default };
  102. // https://fetch.spec.whatwg.org/#concept-response-aborted
  103. // A response can have an associated aborted flag, which is initially unset.
  104. bool m_aborted { false };
  105. // https://fetch.spec.whatwg.org/#concept-response-url-list
  106. // A response has an associated URL list (a list of zero or more URLs). Unless stated otherwise, it is the empty list.
  107. Vector<URL::URL> m_url_list;
  108. // https://fetch.spec.whatwg.org/#concept-response-status
  109. // A response has an associated status, which is a status. Unless stated otherwise it is 200.
  110. Status m_status { 200 };
  111. // https://fetch.spec.whatwg.org/#concept-response-status-message
  112. // A response has an associated status message. Unless stated otherwise it is the empty byte sequence.
  113. ByteBuffer m_status_message;
  114. // https://fetch.spec.whatwg.org/#concept-response-header-list
  115. // A response has an associated header list (a header list). Unless stated otherwise it is empty.
  116. JS::NonnullGCPtr<HeaderList> m_header_list;
  117. // https://fetch.spec.whatwg.org/#concept-response-body
  118. // A response has an associated body (null or a body). Unless stated otherwise it is null.
  119. JS::GCPtr<Body> m_body;
  120. // https://fetch.spec.whatwg.org/#concept-response-cache-state
  121. // A response has an associated cache state (the empty string, "local", or "validated"). Unless stated otherwise, it is the empty string.
  122. Optional<CacheState> m_cache_state;
  123. // https://fetch.spec.whatwg.org/#concept-response-cors-exposed-header-name-list
  124. // A response has an associated CORS-exposed header-name list (a list of zero or more header names). The list is empty unless otherwise specified.
  125. Vector<ByteBuffer> m_cors_exposed_header_name_list;
  126. // https://fetch.spec.whatwg.org/#concept-response-range-requested-flag
  127. // A response has an associated range-requested flag, which is initially unset.
  128. bool m_range_requested { false };
  129. // https://fetch.spec.whatwg.org/#response-request-includes-credentials
  130. // A response has an associated request-includes-credentials (a boolean), which is initially true.
  131. bool m_request_includes_credentials { true };
  132. // https://fetch.spec.whatwg.org/#concept-response-timing-allow-passed
  133. // A response has an associated timing allow passed flag, which is initially unset.
  134. bool m_timing_allow_passed { false };
  135. // https://fetch.spec.whatwg.org/#concept-response-body-info
  136. // A response has an associated body info (a response body info). Unless stated otherwise, it is a new response body info.
  137. BodyInfo m_body_info;
  138. // https://fetch.spec.whatwg.org/#response-service-worker-timing-info
  139. // FIXME: A response has an associated service worker timing info (null or a service worker timing info), which is initially null.
  140. // https://fetch.spec.whatwg.org/#response-has-cross-origin-redirects
  141. // A response has an associated has-cross-origin-redirects (a boolean), which is initially false.
  142. bool m_has_cross_origin_redirects { false };
  143. // FIXME is the type correct?
  144. u64 current_age() const;
  145. u64 freshness_lifetime() const;
  146. u64 stale_while_revalidate_lifetime() const;
  147. // Non-standard
  148. UnixDateTime m_response_time;
  149. Optional<Variant<String, StringView>> m_network_error_message;
  150. };
  151. // https://fetch.spec.whatwg.org/#concept-filtered-response
  152. class FilteredResponse : public Response {
  153. JS_CELL(FilteredResponse, Response);
  154. public:
  155. FilteredResponse(JS::NonnullGCPtr<Response>, JS::NonnullGCPtr<HeaderList>);
  156. virtual ~FilteredResponse() = 0;
  157. [[nodiscard]] virtual Type type() const override { return m_internal_response->type(); }
  158. [[nodiscard]] virtual bool aborted() const override { return m_internal_response->aborted(); }
  159. [[nodiscard]] virtual Vector<URL::URL> const& url_list() const override { return m_internal_response->url_list(); }
  160. [[nodiscard]] virtual Vector<URL::URL>& url_list() override { return m_internal_response->url_list(); }
  161. [[nodiscard]] virtual Status status() const override { return m_internal_response->status(); }
  162. [[nodiscard]] virtual ReadonlyBytes status_message() const override { return m_internal_response->status_message(); }
  163. [[nodiscard]] virtual JS::NonnullGCPtr<HeaderList> header_list() const override { return m_internal_response->header_list(); }
  164. [[nodiscard]] virtual JS::GCPtr<Body> const& body() const override { return m_internal_response->body(); }
  165. [[nodiscard]] virtual JS::GCPtr<Body>& body() override { return m_internal_response->body(); }
  166. [[nodiscard]] virtual Optional<CacheState> const& cache_state() const override { return m_internal_response->cache_state(); }
  167. [[nodiscard]] virtual Vector<ByteBuffer> const& cors_exposed_header_name_list() const override { return m_internal_response->cors_exposed_header_name_list(); }
  168. [[nodiscard]] virtual bool range_requested() const override { return m_internal_response->range_requested(); }
  169. [[nodiscard]] virtual bool request_includes_credentials() const override { return m_internal_response->request_includes_credentials(); }
  170. [[nodiscard]] virtual bool timing_allow_passed() const override { return m_internal_response->timing_allow_passed(); }
  171. [[nodiscard]] virtual BodyInfo const& body_info() const override { return m_internal_response->body_info(); }
  172. [[nodiscard]] JS::NonnullGCPtr<Response> internal_response() const { return m_internal_response; }
  173. protected:
  174. virtual void visit_edges(JS::Cell::Visitor&) override;
  175. private:
  176. // https://fetch.spec.whatwg.org/#concept-internal-response
  177. JS::NonnullGCPtr<Response> m_internal_response;
  178. };
  179. // https://fetch.spec.whatwg.org/#concept-filtered-response-basic
  180. class BasicFilteredResponse final : public FilteredResponse {
  181. JS_CELL(BasicFilteredResponse, FilteredResponse);
  182. JS_DECLARE_ALLOCATOR(BasicFilteredResponse);
  183. public:
  184. [[nodiscard]] static JS::NonnullGCPtr<BasicFilteredResponse> create(JS::VM&, JS::NonnullGCPtr<Response>);
  185. [[nodiscard]] virtual Type type() const override { return Type::Basic; }
  186. [[nodiscard]] virtual JS::NonnullGCPtr<HeaderList> header_list() const override { return m_header_list; }
  187. private:
  188. BasicFilteredResponse(JS::NonnullGCPtr<Response>, JS::NonnullGCPtr<HeaderList>);
  189. virtual void visit_edges(JS::Cell::Visitor&) override;
  190. JS::NonnullGCPtr<HeaderList> m_header_list;
  191. };
  192. // https://fetch.spec.whatwg.org/#concept-filtered-response-cors
  193. class CORSFilteredResponse final : public FilteredResponse {
  194. JS_CELL(CORSFilteredResponse, FilteredResponse);
  195. JS_DECLARE_ALLOCATOR(CORSFilteredResponse);
  196. public:
  197. [[nodiscard]] static JS::NonnullGCPtr<CORSFilteredResponse> create(JS::VM&, JS::NonnullGCPtr<Response>);
  198. [[nodiscard]] virtual Type type() const override { return Type::CORS; }
  199. [[nodiscard]] virtual JS::NonnullGCPtr<HeaderList> header_list() const override { return m_header_list; }
  200. private:
  201. CORSFilteredResponse(JS::NonnullGCPtr<Response>, JS::NonnullGCPtr<HeaderList>);
  202. virtual void visit_edges(JS::Cell::Visitor&) override;
  203. JS::NonnullGCPtr<HeaderList> m_header_list;
  204. };
  205. // https://fetch.spec.whatwg.org/#concept-filtered-response-opaque
  206. class OpaqueFilteredResponse final : public FilteredResponse {
  207. JS_CELL(OpaqueFilteredResponse, FilteredResponse);
  208. JS_DECLARE_ALLOCATOR(OpaqueFilteredResponse);
  209. public:
  210. [[nodiscard]] static JS::NonnullGCPtr<OpaqueFilteredResponse> create(JS::VM&, JS::NonnullGCPtr<Response>);
  211. [[nodiscard]] virtual Type type() const override { return Type::Opaque; }
  212. [[nodiscard]] virtual Vector<URL::URL> const& url_list() const override { return m_url_list; }
  213. [[nodiscard]] virtual Vector<URL::URL>& url_list() override { return m_url_list; }
  214. [[nodiscard]] virtual Status status() const override { return 0; }
  215. [[nodiscard]] virtual ReadonlyBytes status_message() const override { return {}; }
  216. [[nodiscard]] virtual JS::NonnullGCPtr<HeaderList> header_list() const override { return m_header_list; }
  217. [[nodiscard]] virtual JS::GCPtr<Body> const& body() const override { return m_body; }
  218. [[nodiscard]] virtual JS::GCPtr<Body>& body() override { return m_body; }
  219. private:
  220. OpaqueFilteredResponse(JS::NonnullGCPtr<Response>, JS::NonnullGCPtr<HeaderList>);
  221. virtual void visit_edges(JS::Cell::Visitor&) override;
  222. Vector<URL::URL> m_url_list;
  223. JS::NonnullGCPtr<HeaderList> m_header_list;
  224. JS::GCPtr<Body> m_body;
  225. };
  226. // https://fetch.spec.whatwg.org/#concept-filtered-response-opaque-redirect
  227. class OpaqueRedirectFilteredResponse final : public FilteredResponse {
  228. JS_CELL(OpaqueRedirectFilteredResponse, FilteredResponse);
  229. JS_DECLARE_ALLOCATOR(OpaqueRedirectFilteredResponse);
  230. public:
  231. [[nodiscard]] static JS::NonnullGCPtr<OpaqueRedirectFilteredResponse> create(JS::VM&, JS::NonnullGCPtr<Response>);
  232. [[nodiscard]] virtual Type type() const override { return Type::OpaqueRedirect; }
  233. [[nodiscard]] virtual Status status() const override { return 0; }
  234. [[nodiscard]] virtual ReadonlyBytes status_message() const override { return {}; }
  235. [[nodiscard]] virtual JS::NonnullGCPtr<HeaderList> header_list() const override { return m_header_list; }
  236. [[nodiscard]] virtual JS::GCPtr<Body> const& body() const override { return m_body; }
  237. [[nodiscard]] virtual JS::GCPtr<Body>& body() override { return m_body; }
  238. private:
  239. OpaqueRedirectFilteredResponse(JS::NonnullGCPtr<Response>, JS::NonnullGCPtr<HeaderList>);
  240. virtual void visit_edges(JS::Cell::Visitor&) override;
  241. JS::NonnullGCPtr<HeaderList> m_header_list;
  242. JS::GCPtr<Body> m_body;
  243. };
  244. }