/* * Copyright (c) 2025, Tim Flynn * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace DevTools { class DEVTOOLS_API DevToolsDelegate { public: virtual ~DevToolsDelegate() = default; virtual Vector tab_list() const { return {}; } virtual Vector css_property_list() const { return {}; } virtual void navigate_tab(TabDescription const&, String const&) const { } virtual void reload_tab(TabDescription const&, bool bypass_cache) const { (void)bypass_cache; } virtual void traverse_the_history_by_delta(TabDescription const&, int) const { } virtual Vector cookies(TabDescription const&) const { return {}; } virtual ErrorOr set_cookie(TabDescription const&, Optional, HTTP::Cookie::Cookie) const { return {}; } virtual void delete_cookies(TabDescription const&, Vector) const { } using OnHostCookieChange = Function)>; virtual void listen_for_host_cookie_changes(TabDescription const&, OnHostCookieChange) const { } virtual void stop_listening_for_host_cookie_changes(TabDescription const&) const { } struct StorageItem { String name; String value; }; using OnStorageItemsReceived = Function>)>; virtual void inspect_storage(TabDescription const&, Web::StorageAPI::StorageEndpointType, OnStorageItemsReceived) const { } virtual ErrorOr> set_storage_item(TabDescription const&, Web::StorageAPI::StorageEndpointType, String const&, String const&, String const&) const { return Optional {}; } virtual ErrorOr> remove_storage_item(TabDescription const&, Web::StorageAPI::StorageEndpointType, String const&, String const&) const { return Optional {}; } virtual ErrorOr clear_storage(TabDescription const&, Web::StorageAPI::StorageEndpointType, String const&) const { return {}; } struct StorageChange { enum class Type : u8 { Added, Changed, Deleted, Cleared, }; Web::StorageAPI::StorageEndpointType storage_endpoint; String host; Type type; Optional key; }; using OnStorageChange = Function; virtual u64 add_storage_change_listener(TabDescription const&, OnStorageChange) const { return 0; } virtual void remove_storage_change_listener(TabDescription const&, u64) const { } using OnIndexedDBInspectionComplete = Function)>; virtual void inspect_indexed_database_storage(TabDescription const&, OnIndexedDBInspectionComplete) const { } virtual void inspect_indexed_database_objects(TabDescription const&, String const&, Optional, JsonObject, OnIndexedDBInspectionComplete) const { } virtual void delete_indexed_database(TabDescription const&, String const&, String const&, OnIndexedDBInspectionComplete) const { } virtual void clear_indexed_database_object_store(TabDescription const&, String const&, String const&, OnIndexedDBInspectionComplete) const { } virtual void delete_indexed_database_record(TabDescription const&, String const&, String const&, OnIndexedDBInspectionComplete) const { } using OnIndexedDatabaseChange = Function; virtual u64 add_indexed_database_change_listener(TabDescription const&, OnIndexedDatabaseChange) const { return 0; } virtual void remove_indexed_database_change_listener(TabDescription const&, u64) const { } using OnTabInspectionComplete = Function)>; virtual void inspect_tab(TabDescription const&, OnTabInspectionComplete) const { } using OnAccessibilityTreeInspectionComplete = Function)>; virtual void inspect_accessibility_tree(TabDescription const&, OnAccessibilityTreeInspectionComplete) const { } using OnDOMNodePropertiesReceived = Function; virtual void listen_for_dom_properties(TabDescription const&, OnDOMNodePropertiesReceived) const { } virtual void stop_listening_for_dom_properties(TabDescription const&) const { } virtual void inspect_dom_node(TabDescription const&, WebView::DOMNodeProperties::Type, Web::UniqueNodeID, Optional, JsonObject options = {}) const { (void)options; } virtual void clear_inspected_dom_node(TabDescription const&) const { } struct NodePickerEvent { enum class Type : u8 { Hovered, Picked, Previewed, Canceled, }; Type type; Optional node_id; }; using OnNodePickerEvent = Function; virtual void start_node_picker(TabDescription const&, OnNodePickerEvent) const { } virtual void stop_node_picker(TabDescription const&) const { } virtual void clear_node_picker(TabDescription const&) const { } using OnGridLayoutsReceived = Function; using OnCurrentGridReceived = Function)>; using OnCurrentFlexboxReceived = Function)>; virtual void inspect_grid_layouts(TabDescription const&, Web::UniqueNodeID, OnGridLayoutsReceived) const { } virtual void inspect_current_grid(TabDescription const&, Web::UniqueNodeID, OnCurrentGridReceived) const { } virtual void inspect_current_flexbox(TabDescription const&, Web::UniqueNodeID, bool, OnCurrentFlexboxReceived) const { } virtual void highlight_dom_node(TabDescription const&, Web::UniqueNodeID, Optional) const { } virtual void clear_highlighted_dom_node(TabDescription const&) const { } virtual void highlight_flexbox(TabDescription const&, Web::UniqueNodeID, JsonValue) const { } virtual void clear_flexbox_highlight(TabDescription const&, Web::UniqueNodeID) const { } virtual void highlight_grid(TabDescription const&, Web::UniqueNodeID, JsonValue) const { } virtual void clear_grid_highlight(TabDescription const&, Web::UniqueNodeID) const { } using OnDOMMutationReceived = Function; virtual void listen_for_dom_mutations(TabDescription const&, OnDOMMutationReceived) const { } virtual void stop_listening_for_dom_mutations(TabDescription const&) const { } using OnDOMNodeHTMLReceived = Function)>; using OnDOMNodeEditComplete = Function)>; virtual void get_dom_node_inner_html(TabDescription const&, Web::UniqueNodeID, OnDOMNodeHTMLReceived) const { } virtual void get_dom_node_outer_html(TabDescription const&, Web::UniqueNodeID, OnDOMNodeHTMLReceived) const { } virtual void set_dom_node_outer_html(TabDescription const&, Web::UniqueNodeID, String const&, OnDOMNodeEditComplete) const { } virtual void set_dom_node_text(TabDescription const&, Web::UniqueNodeID, String const&, OnDOMNodeEditComplete) const { } virtual void set_dom_node_tag(TabDescription const&, Web::UniqueNodeID, String const&, OnDOMNodeEditComplete) const { } virtual void add_dom_node_attributes(TabDescription const&, Web::UniqueNodeID, ReadonlySpan, OnDOMNodeEditComplete) const { } virtual void replace_dom_node_attribute(TabDescription const&, Web::UniqueNodeID, String const&, ReadonlySpan, OnDOMNodeEditComplete) const { } virtual void create_child_element(TabDescription const&, Web::UniqueNodeID, OnDOMNodeEditComplete) const { } virtual void insert_dom_node_before(TabDescription const&, Web::UniqueNodeID, Web::UniqueNodeID, Optional, OnDOMNodeEditComplete) const { } virtual void clone_dom_node(TabDescription const&, Web::UniqueNodeID, OnDOMNodeEditComplete) const { } virtual void remove_dom_node(TabDescription const&, Web::UniqueNodeID, OnDOMNodeEditComplete) const { } using OnStyleSheetsReceived = Function>)>; using OnStyleSheetSourceReceived = Function; virtual void retrieve_style_sheets(TabDescription const&, OnStyleSheetsReceived) const { } virtual void retrieve_style_sheet_source(TabDescription const&, Web::CSS::StyleSheetIdentifier const&) const { } virtual void listen_for_style_sheet_sources(TabDescription const&, OnStyleSheetSourceReceived) const { } virtual void stop_listening_for_style_sheet_sources(TabDescription const&) const { } using OnScriptEvaluationComplete = Function)>; virtual void evaluate_javascript(TabDescription const&, String const&, OnScriptEvaluationComplete) const { } using OnConsoleMessage = Function; virtual void listen_for_console_messages(TabDescription const&, OnConsoleMessage) const { } virtual void stop_listening_for_console_messages(TabDescription const&) const { } struct NetworkRequestData { u64 request_id { 0 }; String url; String method; UnixDateTime start_time; Vector request_headers; ByteBuffer request_body; Optional initiator_type; }; struct NetworkResponseData { u64 request_id { 0 }; u32 status_code { 0 }; Optional reason_phrase; Vector response_headers; }; struct NetworkRequestCompleteData { u64 request_id { 0 }; u64 body_size { 0 }; Requests::RequestTimingInfo timing_info; Optional network_error; }; using OnNetworkRequestStarted = Function; using OnNetworkResponseHeadersReceived = Function; using OnNetworkResponseBodyReceived = Function; using OnNetworkRequestFinished = Function; virtual void listen_for_network_events(TabDescription const&, OnNetworkRequestStarted, OnNetworkResponseHeadersReceived, OnNetworkResponseBodyReceived, OnNetworkRequestFinished) const { } virtual void stop_listening_for_network_events(TabDescription const&) const { } using OnNavigationStarted = Function; using OnNavigationFinished = Function; virtual void listen_for_navigation_events(TabDescription const&, OnNavigationStarted, OnNavigationFinished) const { } virtual void stop_listening_for_navigation_events(TabDescription const&) const { } virtual void did_connect_devtools_client(TabDescription const&) const { } virtual void did_disconnect_devtools_client(TabDescription const&) const { } }; }