Page.h 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284
  1. /*
  2. * Copyright (c) 2020-2021, Andreas Kling <kling@serenityos.org>
  3. * Copyright (c) 2021-2022, Linus Groh <linusg@serenityos.org>
  4. * Copyright (c) 2022, Sam Atkins <atkinssj@serenityos.org>
  5. *
  6. * SPDX-License-Identifier: BSD-2-Clause
  7. */
  8. #pragma once
  9. #include <AK/Noncopyable.h>
  10. #include <AK/OwnPtr.h>
  11. #include <AK/RefPtr.h>
  12. #include <AK/URL.h>
  13. #include <AK/WeakPtr.h>
  14. #include <AK/Weakable.h>
  15. #include <Kernel/API/KeyCode.h>
  16. #include <LibGfx/Forward.h>
  17. #include <LibGfx/Palette.h>
  18. #include <LibGfx/Point.h>
  19. #include <LibGfx/Rect.h>
  20. #include <LibGfx/Size.h>
  21. #include <LibGfx/StandardCursor.h>
  22. #include <LibIPC/Forward.h>
  23. #include <LibJS/Heap/Handle.h>
  24. #include <LibWeb/CSS/PreferredColorScheme.h>
  25. #include <LibWeb/CSS/Selector.h>
  26. #include <LibWeb/Cookie/Cookie.h>
  27. #include <LibWeb/Forward.h>
  28. #include <LibWeb/HTML/ActivateTab.h>
  29. #include <LibWeb/Loader/FileRequest.h>
  30. #include <LibWeb/PixelUnits.h>
  31. namespace Web {
  32. class PageClient;
  33. class Page : public Weakable<Page> {
  34. AK_MAKE_NONCOPYABLE(Page);
  35. AK_MAKE_NONMOVABLE(Page);
  36. public:
  37. explicit Page(PageClient&);
  38. ~Page();
  39. PageClient& client() { return m_client; }
  40. PageClient const& client() const { return m_client; }
  41. void set_top_level_traversable(JS::NonnullGCPtr<HTML::TraversableNavigable>);
  42. // FIXME: This is a hack.
  43. bool top_level_traversable_is_initialized() const;
  44. HTML::BrowsingContext& top_level_browsing_context();
  45. HTML::BrowsingContext const& top_level_browsing_context() const;
  46. JS::NonnullGCPtr<HTML::TraversableNavigable> top_level_traversable() const;
  47. HTML::BrowsingContext& focused_context();
  48. HTML::BrowsingContext const& focused_context() const { return const_cast<Page*>(this)->focused_context(); }
  49. void set_focused_browsing_context(Badge<EventHandler>, HTML::BrowsingContext&);
  50. void load(const AK::URL&);
  51. void load_html(StringView);
  52. CSSPixelPoint device_to_css_point(DevicePixelPoint) const;
  53. DevicePixelPoint css_to_device_point(CSSPixelPoint) const;
  54. CSSPixelRect device_to_css_rect(DevicePixelRect) const;
  55. DevicePixelRect enclosing_device_rect(CSSPixelRect) const;
  56. DevicePixelRect rounded_device_rect(CSSPixelRect) const;
  57. bool handle_mouseup(DevicePixelPoint, DevicePixelPoint screen_position, unsigned button, unsigned buttons, unsigned modifiers);
  58. bool handle_mousedown(DevicePixelPoint, DevicePixelPoint screen_position, unsigned button, unsigned buttons, unsigned modifiers);
  59. bool handle_mousemove(DevicePixelPoint, DevicePixelPoint screen_position, unsigned buttons, unsigned modifiers);
  60. bool handle_mousewheel(DevicePixelPoint, DevicePixelPoint screen_position, unsigned button, unsigned buttons, unsigned modifiers, int wheel_delta_x, int wheel_delta_y);
  61. bool handle_doubleclick(DevicePixelPoint, DevicePixelPoint screen_position, unsigned button, unsigned buttons, unsigned modifiers);
  62. bool handle_keydown(KeyCode, unsigned modifiers, u32 code_point);
  63. bool handle_keyup(KeyCode, unsigned modifiers, u32 code_point);
  64. Gfx::Palette palette() const;
  65. CSSPixelRect web_exposed_screen_area() const;
  66. CSS::PreferredColorScheme preferred_color_scheme() const;
  67. bool is_same_origin_policy_enabled() const { return m_same_origin_policy_enabled; }
  68. void set_same_origin_policy_enabled(bool b) { m_same_origin_policy_enabled = b; }
  69. bool is_scripting_enabled() const { return m_is_scripting_enabled; }
  70. void set_is_scripting_enabled(bool b) { m_is_scripting_enabled = b; }
  71. bool should_block_pop_ups() const { return m_should_block_pop_ups; }
  72. void set_should_block_pop_ups(bool b) { m_should_block_pop_ups = b; }
  73. bool is_webdriver_active() const { return m_is_webdriver_active; }
  74. void set_is_webdriver_active(bool b) { m_is_webdriver_active = b; }
  75. DevicePixelPoint window_position() const { return m_window_position; }
  76. void set_window_position(DevicePixelPoint position) { m_window_position = position; }
  77. DevicePixelSize window_size() const { return m_window_size; }
  78. void set_window_size(DevicePixelSize size) { m_window_size = size; }
  79. void did_request_alert(String const& message);
  80. void alert_closed();
  81. bool did_request_confirm(String const& message);
  82. void confirm_closed(bool accepted);
  83. Optional<String> did_request_prompt(String const& message, String const& default_);
  84. void prompt_closed(Optional<String> response);
  85. enum class PendingDialog {
  86. None,
  87. Alert,
  88. Confirm,
  89. Prompt,
  90. };
  91. bool has_pending_dialog() const { return m_pending_dialog != PendingDialog::None; }
  92. PendingDialog pending_dialog() const { return m_pending_dialog; }
  93. Optional<String> const& pending_dialog_text() const { return m_pending_dialog_text; }
  94. void dismiss_dialog();
  95. void accept_dialog();
  96. void did_request_color_picker(WeakPtr<HTML::HTMLInputElement> target, Color current_color);
  97. void color_picker_closed(Optional<Color> picked_color);
  98. enum class PendingNonBlockingDialog {
  99. None,
  100. ColorPicker,
  101. };
  102. struct MediaContextMenu {
  103. AK::URL media_url;
  104. bool is_video { false };
  105. bool is_playing { false };
  106. bool is_muted { false };
  107. bool has_user_agent_controls { false };
  108. bool is_looping { false };
  109. };
  110. void did_request_media_context_menu(i32 media_id, CSSPixelPoint, DeprecatedString const& target, unsigned modifiers, MediaContextMenu);
  111. WebIDL::ExceptionOr<void> toggle_media_play_state();
  112. void toggle_media_mute_state();
  113. WebIDL::ExceptionOr<void> toggle_media_loop_state();
  114. WebIDL::ExceptionOr<void> toggle_media_controls_state();
  115. Optional<String> const& user_style() const { return m_user_style_sheet_source; }
  116. void set_user_style(String source);
  117. bool pdf_viewer_supported() const { return m_pdf_viewer_supported; }
  118. private:
  119. JS::GCPtr<HTML::HTMLMediaElement> media_context_menu_element();
  120. PageClient& m_client;
  121. WeakPtr<HTML::BrowsingContext> m_focused_context;
  122. JS::Handle<HTML::TraversableNavigable> m_top_level_traversable;
  123. // FIXME: Enable this by default once CORS preflight checks are supported.
  124. bool m_same_origin_policy_enabled { false };
  125. bool m_is_scripting_enabled { true };
  126. bool m_should_block_pop_ups { true };
  127. // https://w3c.github.io/webdriver/#dfn-webdriver-active-flag
  128. // The webdriver-active flag is set to true when the user agent is under remote control. It is initially false.
  129. bool m_is_webdriver_active { false };
  130. DevicePixelPoint m_window_position {};
  131. DevicePixelSize m_window_size {};
  132. PendingDialog m_pending_dialog { PendingDialog::None };
  133. Optional<String> m_pending_dialog_text;
  134. Optional<Empty> m_pending_alert_response;
  135. Optional<bool> m_pending_confirm_response;
  136. Optional<Optional<String>> m_pending_prompt_response;
  137. PendingNonBlockingDialog m_pending_non_blocking_dialog { PendingNonBlockingDialog::None };
  138. WeakPtr<HTML::HTMLInputElement> m_pending_non_blocking_dialog_target;
  139. Optional<int> m_media_context_menu_element_id;
  140. Optional<String> m_user_style_sheet_source;
  141. // https://html.spec.whatwg.org/multipage/system-state.html#pdf-viewer-supported
  142. // Each user agent has a PDF viewer supported boolean, whose value is implementation-defined (and might vary according to user preferences).
  143. // Spec Note: This value also impacts the navigation processing model.
  144. // FIXME: Actually support pdf viewing
  145. bool m_pdf_viewer_supported { false };
  146. };
  147. class PageClient {
  148. public:
  149. virtual Page& page() = 0;
  150. virtual Page const& page() const = 0;
  151. virtual bool is_connection_open() const = 0;
  152. virtual Gfx::Palette palette() const = 0;
  153. virtual DevicePixelRect screen_rect() const = 0;
  154. virtual double device_pixels_per_css_pixel() const = 0;
  155. virtual CSS::PreferredColorScheme preferred_color_scheme() const = 0;
  156. virtual void paint(DevicePixelRect const&, Gfx::Bitmap&) = 0;
  157. virtual void page_did_change_title(DeprecatedString const&) { }
  158. virtual void page_did_request_navigate_back() { }
  159. virtual void page_did_request_navigate_forward() { }
  160. virtual void page_did_request_refresh() { }
  161. virtual Gfx::IntSize page_did_request_resize_window(Gfx::IntSize) { return {}; }
  162. virtual Gfx::IntPoint page_did_request_reposition_window(Gfx::IntPoint) { return {}; }
  163. virtual void page_did_request_restore_window() { }
  164. virtual Gfx::IntRect page_did_request_maximize_window() { return {}; }
  165. virtual Gfx::IntRect page_did_request_minimize_window() { return {}; }
  166. virtual Gfx::IntRect page_did_request_fullscreen_window() { return {}; }
  167. virtual void page_did_start_loading(const AK::URL&, bool is_redirect) { (void)is_redirect; }
  168. virtual void page_did_create_new_document(Web::DOM::Document&) { }
  169. virtual void page_did_destroy_document(Web::DOM::Document&) { }
  170. virtual void page_did_finish_loading(const AK::URL&) { }
  171. virtual void page_did_change_selection() { }
  172. virtual void page_did_request_cursor_change(Gfx::StandardCursor) { }
  173. virtual void page_did_request_context_menu(CSSPixelPoint) { }
  174. virtual void page_did_request_link_context_menu(CSSPixelPoint, AK::URL const&, [[maybe_unused]] DeprecatedString const& target, [[maybe_unused]] unsigned modifiers) { }
  175. virtual void page_did_request_image_context_menu(CSSPixelPoint, AK::URL const&, [[maybe_unused]] DeprecatedString const& target, [[maybe_unused]] unsigned modifiers, Gfx::Bitmap const*) { }
  176. virtual void page_did_request_media_context_menu(CSSPixelPoint, [[maybe_unused]] DeprecatedString const& target, [[maybe_unused]] unsigned modifiers, Page::MediaContextMenu) { }
  177. virtual void page_did_click_link(const AK::URL&, [[maybe_unused]] DeprecatedString const& target, [[maybe_unused]] unsigned modifiers) { }
  178. virtual void page_did_middle_click_link(const AK::URL&, [[maybe_unused]] DeprecatedString const& target, [[maybe_unused]] unsigned modifiers) { }
  179. virtual void page_did_enter_tooltip_area(CSSPixelPoint, DeprecatedString const&) { }
  180. virtual void page_did_leave_tooltip_area() { }
  181. virtual void page_did_hover_link(const AK::URL&) { }
  182. virtual void page_did_unhover_link() { }
  183. virtual void page_did_invalidate(CSSPixelRect const&) { }
  184. virtual void page_did_change_favicon(Gfx::Bitmap const&) { }
  185. virtual void page_did_layout() { }
  186. virtual void page_did_request_scroll(i32, i32) { }
  187. virtual void page_did_request_scroll_to(CSSPixelPoint) { }
  188. virtual void page_did_request_scroll_into_view(CSSPixelRect const&) { }
  189. virtual void page_did_request_alert(String const&) { }
  190. virtual void page_did_request_confirm(String const&) { }
  191. virtual void page_did_request_prompt(String const&, String const&) { }
  192. virtual void page_did_request_set_prompt_text(String const&) { }
  193. virtual void page_did_request_accept_dialog() { }
  194. virtual void page_did_request_dismiss_dialog() { }
  195. virtual Vector<Web::Cookie::Cookie> page_did_request_all_cookies(AK::URL const&) { return {}; }
  196. virtual Optional<Web::Cookie::Cookie> page_did_request_named_cookie(AK::URL const&, DeprecatedString const&) { return {}; }
  197. virtual DeprecatedString page_did_request_cookie(const AK::URL&, Cookie::Source) { return {}; }
  198. virtual void page_did_set_cookie(const AK::URL&, Cookie::ParsedCookie const&, Cookie::Source) { }
  199. virtual void page_did_update_cookie(Web::Cookie::Cookie) { }
  200. virtual void page_did_update_resource_count(i32) { }
  201. virtual String page_did_request_new_tab(HTML::ActivateTab) { return {}; }
  202. virtual void page_did_request_activate_tab() { }
  203. virtual void page_did_close_browsing_context(HTML::BrowsingContext const&) { }
  204. virtual void request_file(FileRequest) = 0;
  205. // https://html.spec.whatwg.org/multipage/input.html#show-the-picker,-if-applicable
  206. virtual void page_did_request_file_picker(WeakPtr<DOM::EventTarget>, [[maybe_unused]] bool multiple) {};
  207. virtual void page_did_request_color_picker([[maybe_unused]] Color current_color) {};
  208. virtual void page_did_finish_text_test() {};
  209. virtual void page_did_change_theme_color(Gfx::Color) { }
  210. virtual void page_did_insert_clipboard_entry([[maybe_unused]] String data, [[maybe_unused]] String presentation_style, [[maybe_unused]] String mime_type) { }
  211. virtual void inspector_did_load() { }
  212. virtual void inspector_did_select_dom_node([[maybe_unused]] i32 node_id, [[maybe_unused]] Optional<CSS::Selector::PseudoElement> const& pseudo_element) { }
  213. virtual void inspector_did_execute_console_script([[maybe_unused]] String const& script) { }
  214. protected:
  215. virtual ~PageClient() = default;
  216. };
  217. }
  218. namespace IPC {
  219. template<>
  220. ErrorOr<void> encode(Encoder&, Web::Page::MediaContextMenu const&);
  221. template<>
  222. ErrorOr<Web::Page::MediaContextMenu> decode(Decoder&);
  223. }