Responses.h 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255
  1. /*
  2. * Copyright (c) 2022, 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/URL.h>
  12. #include <AK/Vector.h>
  13. #include <LibWeb/Fetch/Infrastructure/HTTP/Bodies.h>
  14. #include <LibWeb/Fetch/Infrastructure/HTTP/Headers.h>
  15. #include <LibWeb/Fetch/Infrastructure/HTTP/Statuses.h>
  16. namespace Web::Fetch::Infrastructure {
  17. // https://fetch.spec.whatwg.org/#concept-response
  18. class Response {
  19. public:
  20. enum class CacheState {
  21. Local,
  22. Validated,
  23. };
  24. enum class Type {
  25. Basic,
  26. CORS,
  27. Default,
  28. Error,
  29. Opaque,
  30. OpaqueRedirect,
  31. };
  32. // https://fetch.spec.whatwg.org/#response-body-info
  33. struct BodyInfo {
  34. // https://fetch.spec.whatwg.org/#fetch-timing-info-encoded-body-size
  35. u64 encoded_size { 0 };
  36. // https://fetch.spec.whatwg.org/#fetch-timing-info-decoded-body-size
  37. u64 decoded_size { 0 };
  38. };
  39. [[nodiscard]] static NonnullOwnPtr<Response> aborted_network_error();
  40. [[nodiscard]] static NonnullOwnPtr<Response> network_error();
  41. Response();
  42. virtual ~Response() = default;
  43. [[nodiscard]] virtual Type type() const { return m_type; }
  44. void set_type(Type type) { m_type = type; }
  45. [[nodiscard]] virtual bool aborted() const { return m_aborted; }
  46. void set_aborted(bool aborted) { m_aborted = aborted; }
  47. [[nodiscard]] virtual Vector<AK::URL> const& url_list() const { return m_url_list; }
  48. [[nodiscard]] Vector<AK::URL>& url_list() { return m_url_list; }
  49. void set_url_list(Vector<AK::URL> url_list) { m_url_list = move(url_list); }
  50. [[nodiscard]] virtual Status status() const { return m_status; }
  51. void set_status(Status status) { m_status = status; }
  52. [[nodiscard]] virtual ReadonlyBytes status_message() const { return m_status_message; }
  53. void set_status_message(ByteBuffer status_message) { m_status_message = move(status_message); }
  54. [[nodiscard]] virtual NonnullRefPtr<HeaderList> const& header_list() const { return m_header_list; }
  55. [[nodiscard]] NonnullRefPtr<HeaderList>& header_list() { return m_header_list; }
  56. void set_header_list(NonnullRefPtr<HeaderList> header_list) { m_header_list = move(header_list); }
  57. [[nodiscard]] virtual Optional<Body> const& body() const { return m_body; }
  58. [[nodiscard]] Optional<Body>& body() { return m_body; }
  59. void set_body(Optional<Body> body) { m_body = move(body); }
  60. [[nodiscard]] virtual Optional<CacheState> const& cache_state() const { return m_cache_state; }
  61. void set_cache_state(Optional<CacheState> cache_state) { m_cache_state = move(cache_state); }
  62. [[nodiscard]] virtual Vector<ByteBuffer> const& cors_exposed_header_name_list() const { return m_cors_exposed_header_name_list; }
  63. [[nodiscard]] Vector<ByteBuffer>& cors_exposed_header_name_list() { return m_cors_exposed_header_name_list; }
  64. 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); }
  65. [[nodiscard]] virtual bool range_requested() const { return m_range_requested; }
  66. void set_range_requested(bool range_requested) { m_range_requested = range_requested; }
  67. [[nodiscard]] virtual bool request_includes_credentials() const { return m_request_includes_credentials; }
  68. void set_request_includes_credentials(bool request_includes_credentials) { m_request_includes_credentials = request_includes_credentials; }
  69. [[nodiscard]] virtual bool timing_allow_passed() const { return m_timing_allow_passed; }
  70. void set_timing_allow_passed(bool timing_allow_passed) { m_timing_allow_passed = timing_allow_passed; }
  71. [[nodiscard]] virtual BodyInfo const& body_info() const { return m_body_info; }
  72. [[nodiscard]] BodyInfo& body_info() { return m_body_info; }
  73. void set_body_info(BodyInfo body_info) { m_body_info = body_info; }
  74. [[nodiscard]] bool is_aborted_network_error() const;
  75. [[nodiscard]] bool is_network_error() const;
  76. [[nodiscard]] Optional<AK::URL const&> url() const;
  77. [[nodiscard]] ErrorOr<Optional<AK::URL>> location_url(Optional<String> const& request_fragment) const;
  78. [[nodiscard]] WebIDL::ExceptionOr<NonnullOwnPtr<Response>> clone() const;
  79. private:
  80. // https://fetch.spec.whatwg.org/#concept-response-type
  81. // A response has an associated type which is "basic", "cors", "default", "error", "opaque", or "opaqueredirect". Unless stated otherwise, it is "default".
  82. Type m_type { Type::Default };
  83. // https://fetch.spec.whatwg.org/#concept-response-aborted
  84. // A response can have an associated aborted flag, which is initially unset.
  85. bool m_aborted { false };
  86. // A response has an associated URL list (a list of zero or more URLs). Unless stated otherwise, it is the empty list.
  87. Vector<AK::URL> m_url_list;
  88. // https://fetch.spec.whatwg.org/#concept-response-status
  89. // A response has an associated status, which is a status. Unless stated otherwise it is 200.
  90. Status m_status { 200 };
  91. // https://fetch.spec.whatwg.org/#concept-response-status-message
  92. // A response has an associated status message. Unless stated otherwise it is the empty byte sequence.
  93. ByteBuffer m_status_message;
  94. // https://fetch.spec.whatwg.org/#concept-response-header-list
  95. // A response has an associated header list (a header list). Unless stated otherwise it is empty.
  96. NonnullRefPtr<HeaderList> m_header_list;
  97. // https://fetch.spec.whatwg.org/#concept-response-body
  98. // A response has an associated body (null or a body). Unless stated otherwise it is null.
  99. Optional<Body> m_body;
  100. // https://fetch.spec.whatwg.org/#concept-response-cache-state
  101. // A response has an associated cache state (the empty string, "local", or "validated"). Unless stated otherwise, it is the empty string.
  102. Optional<CacheState> m_cache_state;
  103. // https://fetch.spec.whatwg.org/#concept-response-cors-exposed-header-name-list
  104. // 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.
  105. Vector<ByteBuffer> m_cors_exposed_header_name_list;
  106. // https://fetch.spec.whatwg.org/#concept-response-range-requested-flag
  107. // A response has an associated range-requested flag, which is initially unset.
  108. bool m_range_requested { false };
  109. // https://fetch.spec.whatwg.org/#response-request-includes-credentials
  110. // A response has an associated request-includes-credentials (a boolean), which is initially true.
  111. bool m_request_includes_credentials { true };
  112. // https://fetch.spec.whatwg.org/#concept-response-timing-allow-passed
  113. // A response has an associated timing allow passed flag, which is initially unset.
  114. bool m_timing_allow_passed { false };
  115. // https://fetch.spec.whatwg.org/#concept-response-body-info
  116. // A response has an associated body info (a response body info). Unless stated otherwise, it is a new response body info.
  117. BodyInfo m_body_info;
  118. // https://fetch.spec.whatwg.org/#response-service-worker-timing-info
  119. // FIXME: A response has an associated service worker timing info (null or a service worker timing info), which is initially null.
  120. };
  121. // https://fetch.spec.whatwg.org/#concept-filtered-response
  122. class FilteredResponse : public Response {
  123. public:
  124. explicit FilteredResponse(Response&);
  125. virtual ~FilteredResponse() = 0;
  126. [[nodiscard]] virtual Type type() const override { return m_internal_response.type(); }
  127. [[nodiscard]] virtual bool aborted() const override { return m_internal_response.aborted(); }
  128. [[nodiscard]] virtual Vector<AK::URL> const& url_list() const override { return m_internal_response.url_list(); }
  129. [[nodiscard]] virtual Status status() const override { return m_internal_response.status(); }
  130. [[nodiscard]] virtual ReadonlyBytes status_message() const override { return m_internal_response.status_message(); }
  131. [[nodiscard]] virtual NonnullRefPtr<HeaderList> const& header_list() const override { return m_internal_response.header_list(); }
  132. [[nodiscard]] virtual Optional<Body> const& body() const override { return m_internal_response.body(); }
  133. [[nodiscard]] virtual Optional<CacheState> const& cache_state() const override { return m_internal_response.cache_state(); }
  134. [[nodiscard]] virtual Vector<ByteBuffer> const& cors_exposed_header_name_list() const override { return m_internal_response.cors_exposed_header_name_list(); }
  135. [[nodiscard]] virtual bool range_requested() const override { return m_internal_response.range_requested(); }
  136. [[nodiscard]] virtual bool request_includes_credentials() const override { return m_internal_response.request_includes_credentials(); }
  137. [[nodiscard]] virtual bool timing_allow_passed() const override { return m_internal_response.timing_allow_passed(); }
  138. [[nodiscard]] virtual BodyInfo const& body_info() const override { return m_internal_response.body_info(); }
  139. [[nodiscard]] Response const& internal_response() const { return m_internal_response; }
  140. [[nodiscard]] Response& internal_response() { return m_internal_response; }
  141. protected:
  142. // https://fetch.spec.whatwg.org/#concept-internal-response
  143. Response& m_internal_response;
  144. };
  145. // https://fetch.spec.whatwg.org/#concept-filtered-response-basic
  146. class BasicFilteredResponse final : public FilteredResponse {
  147. public:
  148. static ErrorOr<NonnullOwnPtr<BasicFilteredResponse>> create(Response&);
  149. [[nodiscard]] virtual Type type() const override { return Type::Basic; }
  150. [[nodiscard]] virtual NonnullRefPtr<HeaderList> const& header_list() const override { return m_header_list; }
  151. private:
  152. BasicFilteredResponse(Response&, NonnullRefPtr<HeaderList>);
  153. NonnullRefPtr<HeaderList> m_header_list;
  154. };
  155. // https://fetch.spec.whatwg.org/#concept-filtered-response-cors
  156. class CORSFilteredResponse final : public FilteredResponse {
  157. public:
  158. static ErrorOr<NonnullOwnPtr<CORSFilteredResponse>> create(Response&);
  159. [[nodiscard]] virtual Type type() const override { return Type::CORS; }
  160. [[nodiscard]] virtual NonnullRefPtr<HeaderList> const& header_list() const override { return m_header_list; }
  161. private:
  162. CORSFilteredResponse(Response&, NonnullRefPtr<HeaderList>);
  163. NonnullRefPtr<HeaderList> m_header_list;
  164. };
  165. // https://fetch.spec.whatwg.org/#concept-filtered-response-opaque
  166. class OpaqueFilteredResponse final : public FilteredResponse {
  167. public:
  168. static NonnullOwnPtr<OpaqueFilteredResponse> create(Response&);
  169. [[nodiscard]] virtual Type type() const override { return Type::Opaque; }
  170. [[nodiscard]] virtual Vector<AK::URL> const& url_list() const override { return m_url_list; }
  171. [[nodiscard]] virtual Status status() const override { return 0; }
  172. [[nodiscard]] virtual ReadonlyBytes status_message() const override { return {}; }
  173. [[nodiscard]] virtual NonnullRefPtr<HeaderList> const& header_list() const override { return m_header_list; }
  174. [[nodiscard]] virtual Optional<Body> const& body() const override { return m_body; }
  175. private:
  176. explicit OpaqueFilteredResponse(Response&);
  177. Vector<AK::URL> m_url_list;
  178. NonnullRefPtr<HeaderList> m_header_list;
  179. Optional<Body> m_body;
  180. };
  181. // https://fetch.spec.whatwg.org/#concept-filtered-response-opaque-redirect
  182. class OpaqueRedirectFilteredResponse final : public FilteredResponse {
  183. public:
  184. static NonnullOwnPtr<OpaqueRedirectFilteredResponse> create(Response&);
  185. [[nodiscard]] virtual Type type() const override { return Type::OpaqueRedirect; }
  186. [[nodiscard]] virtual Status status() const override { return 0; }
  187. [[nodiscard]] virtual ReadonlyBytes status_message() const override { return {}; }
  188. [[nodiscard]] virtual NonnullRefPtr<HeaderList> const& header_list() const override { return m_header_list; }
  189. [[nodiscard]] virtual Optional<Body> const& body() const override { return m_body; }
  190. private:
  191. explicit OpaqueRedirectFilteredResponse(Response&);
  192. NonnullRefPtr<HeaderList> m_header_list;
  193. Optional<Body> m_body;
  194. };
  195. }