Molybden API
Loading...
Searching...
No Matches
browser.hpp
1// Copyright (c) 2000-2024 TeamDev. All rights reserved.
2// TeamDev PROPRIETARY and CONFIDENTIAL.
3// Use is subject to license terms.
4
5#ifndef MOLYBDEN_BROWSER_HPP
6#define MOLYBDEN_BROWSER_HPP
7
8#include <unordered_set>
9
10#include "molybden/app/app.hpp"
11#include "molybden/browser/browser_delegates.hpp"
12#include "molybden/browser/browser_events.hpp"
13#include "molybden/ui/geometry.hpp"
14#include "molybden/ui/window.hpp"
15
16namespace molybden {
17
18class CaptureSession;
19class BrowserSettings;
20class Dialogs;
21class DevTools;
22class Frame;
23class FullScreen;
24class Media;
25class Navigation;
26class Profile;
27class TextFinder;
28class Zoom;
29class JavaScript;
30class JsValue;
31
47class Browser : public BrowserEvents, public BrowserDelegates {
48 public:
54 static std::shared_ptr<Browser> create(std::shared_ptr<App> app);
55
61 static std::shared_ptr<Browser> create(std::shared_ptr<Profile> profile);
62
66 virtual std::shared_ptr<App> app() = 0;
67
71 virtual std::shared_ptr<Profile> profile() = 0;
72
76 virtual std::shared_ptr<BrowserSettings> settings() = 0;
77
81 virtual std::shared_ptr<Media> media() = 0;
82
86 virtual std::shared_ptr<Navigation> navigation() = 0;
87
91 virtual std::shared_ptr<DevTools> devTools() = 0;
92
96 virtual std::shared_ptr<TextFinder> textFinder() = 0;
97
102 virtual std::shared_ptr<Zoom> zoom() = 0;
103
108 virtual std::string pageUrl() = 0;
109
114 virtual std::string pageTitle() = 0;
115
120 virtual std::shared_ptr<Frame> mainFrame() = 0;
121
126 virtual std::shared_ptr<Frame> focusedFrame() = 0;
127
132 virtual std::unordered_set<std::shared_ptr<Frame>> frames() = 0;
133
137 virtual std::vector<std::shared_ptr<CaptureSession>> captureSessions() = 0;
138
151 virtual void loadUrl(const std::string& url) = 0;
152
168 virtual JsValue executeJavaScript(const std::string& script) = 0;
169
182 virtual void executeJavaScript(const std::string& script,
183 std::function<void(JsValue)> callback) = 0;
184
197 virtual void download(const std::string& url) = 0;
198
202 virtual void setSize(const Size& size) = 0;
203
207 virtual void setSize(uint32_t width, uint32_t height) = 0;
208
212 virtual void setPosition(const Point& position_on_screen) = 0;
213
217 virtual void setPosition(int32_t x, int32_t y) = 0;
218
224 virtual void setBounds(const Rect& bounds) = 0;
225
229 virtual Rect bounds() = 0;
230
234 virtual void centerWindow() = 0;
235
239 virtual void show() = 0;
240
244 virtual bool isVisible() = 0;
245
249 virtual void hide() = 0;
250
263 virtual void close() = 0;
264
268 virtual bool isClosed() = 0;
269
274 virtual void activate() = 0;
275
279 virtual bool isActive() = 0;
280
285 virtual void deactivate() = 0;
286
290 virtual void maximize() = 0;
291
295 virtual bool isMaximized() = 0;
296
300 virtual void minimize() = 0;
301
305 virtual bool isMinimized() = 0;
306
310 virtual void restore() = 0;
311
318 virtual void enterFullScreen() = 0;
319
323 virtual bool isFullScreen() = 0;
324
331 virtual void exitFullScreen() = 0;
332
343 virtual void setTitle(const std::string& title) = 0;
344
351 virtual std::string title() = 0;
352
356 virtual void setWindowTitleVisible(bool visible) = 0;
357
361 virtual bool isWindowTitleVisible() = 0;
362
375 virtual void setWindowTitlebarVisible(bool visible) = 0;
376
380 virtual bool isWindowTitlebarVisible() = 0;
381
385 virtual void setWindowButtonVisible(WindowButtonType button_type,
386 bool visible) = 0;
387
392 virtual bool isWindowButtonVisible(WindowButtonType button_type) = 0;
393
398 virtual void setAlwaysOnTop(bool always_on_top) = 0;
399
403 virtual bool isAlwaysOnTop() = 0;
404
411 virtual void setWindowDisplayPolicy(WindowDisplayPolicy policy) = 0;
412
419 virtual WindowDisplayPolicy windowDisplayPolicy() = 0;
420
425 virtual void setWindowAnimationEnabled(bool enabled) = 0;
426};
427
428} // namespace molybden
429
430#endif // MOLYBDEN_BROWSER_HPP
A class that contains all browser delegates.
Definition browser_delegates.hpp:1143
A class that contains all browser events.
Definition browser_events.hpp:335
An object that displays web content inside a native window.
Definition browser.hpp:47
virtual void setPosition(const Point &position_on_screen)=0
Sets the browser window's position on screen.
virtual std::string title()=0
Returns the current browser window title.
virtual std::shared_ptr< DevTools > devTools()=0
Returns the DevTools of this browser.
virtual std::shared_ptr< Zoom > zoom()=0
Returns a service that allows zooming content of a web page loaded in the current browser.
virtual std::shared_ptr< App > app()=0
Returns the application instance for this browser.
virtual void setAlwaysOnTop(bool always_on_top)=0
Configures the browser window to always be displayed on top of other windows.
virtual void executeJavaScript(const std::string &script, std::function< void(JsValue)> callback)=0
Executes the given script in the main frame of this browser and returns the result of the execution.
virtual void exitFullScreen()=0
Brings the browser window out of full screen mode.
virtual void deactivate()=0
Deactivates the browser window, making the next window in the Z order the active window.
virtual void close()=0
Hides and destroys the browser window and releases all allocated resources including the browser inst...
virtual void setWindowButtonVisible(WindowButtonType button_type, bool visible)=0
Configures visibility of the given standard browser window button.
virtual bool isFullScreen()=0
Indicates whether the browser window is running in full screen mode.
virtual bool isWindowTitleVisible()=0
Indicates whether the title is visible in the browser window title bar.
virtual std::shared_ptr< Navigation > navigation()=0
Returns the navigation controller of this browser.
virtual bool isAlwaysOnTop()=0
Indicates whether the browser window is always on top of other windows.
virtual std::shared_ptr< BrowserSettings > settings()=0
Returns the content settings of this browser.
virtual void download(const std::string &url)=0
Initiates a download of the resource identified by the given URL.
static std::shared_ptr< Browser > create(std::shared_ptr< Profile > profile)
Creates a new browser instance.
virtual void setWindowTitlebarVisible(bool visible)=0
Configures visibility of the browser window title bar.
virtual void setTitle(const std::string &title)=0
Updates the browser window title.
virtual std::vector< std::shared_ptr< CaptureSession > > captureSessions()=0
Returns the list of all active capture sessions initiated by this browser.
virtual WindowDisplayPolicy windowDisplayPolicy()=0
Returns the policy for displaying the window across multiple desktops.
virtual void restore()=0
Restores the browser window.
virtual void hide()=0
Hides the browser window.
virtual std::string pageTitle()=0
Returns a string that represents the title of the currently loaded web page or an empty string if the...
virtual void setPosition(int32_t x, int32_t y)=0
Sets the browser window's position on screen.
virtual void minimize()=0
Minimizes the browser window.
virtual void setBounds(const Rect &bounds)=0
Sets the browser window's size and location on screen.
virtual bool isActive()=0
Indicates if the browser window is currently the active/focused window.
virtual bool isWindowTitlebarVisible()=0
Indicates whether the browser window title bar is visible.
virtual bool isMaximized()=0
Indicates whether the browser window is maximized.
virtual bool isVisible()=0
Indicates whether the browser window is visible.
virtual bool isWindowButtonVisible(WindowButtonType button_type)=0
Indicates whether the standard browser window button with the given type is visible.
virtual void centerWindow()=0
Centers the browser window on the primary screen.
virtual void maximize()=0
Maximizes the browser window.
static std::shared_ptr< Browser > create(std::shared_ptr< App > app)
Creates a new browser instance.
virtual void setWindowAnimationEnabled(bool enabled)=0
Allows enabling or disabling the default window animation when showing the browser window on macOS.
virtual bool isMinimized()=0
Indicates whether the browser window is minimized.
virtual void loadUrl(const std::string &url)=0
Starts a navigation to the resource identified by the given url.
virtual std::string pageUrl()=0
Gets URL of the currently loaded web page or an empty string if the browser hasn't loaded any web pag...
virtual Rect bounds()=0
Returns the browser window's size and position on screen.
virtual void setWindowDisplayPolicy(WindowDisplayPolicy policy)=0
Specifies the policy for displaying the window across multiple desktops.
virtual bool isClosed()=0
Checks if the browser window is closed.
virtual void enterFullScreen()=0
Sets the browser window to full screen.
virtual void setSize(const Size &size)=0
Sets the browser window's size.
virtual JsValue executeJavaScript(const std::string &script)=0
Executes the given script in the main frame of this browser and returns the result of the execution.
virtual std::shared_ptr< TextFinder > textFinder()=0
Returns the text finder of this browser.
virtual std::shared_ptr< Profile > profile()=0
Returns the profile of this browser.
virtual std::unordered_set< std::shared_ptr< Frame > > frames()=0
Returns all the frames on the currently loaded web page or an empty set if the current browser did no...
virtual void setWindowTitleVisible(bool visible)=0
Configures visibility of the title in the browser window title bar.
virtual std::shared_ptr< Frame > focusedFrame()=0
Returns the focused frame of the currently loaded web page if it exists, otherwise an empty std::shar...
virtual void activate()=0
Activates (brings to front) the browser window.
virtual std::shared_ptr< Frame > mainFrame()=0
Returns the main frame of the currently loaded web page if it exists, otherwise an empty std::shared_...
virtual void show()=0
Shows the browser window, or activates it if it's already visible.
virtual std::shared_ptr< Media > media()=0
Returns the media controller of this browser.
virtual void setSize(uint32_t width, uint32_t height)=0
Sets the browser window's size.
A JavaScript value.
Definition js_value.hpp:44
A pair of numbers that in general are used to define coordinates in the two-dimensional space.
Definition geometry.hpp:16
A rectangle described by the location and dimensions.
Definition geometry.hpp:75
A pair of numbers that in general are used to define dimensions in the two-dimensional space.
Definition geometry.hpp:35