@@ -72,11 +72,23 @@ namespace Exchange {
7272 enum { ID = ID_WEBKITBROWSER_NOTIFICATION };
7373
7474 // Signal changes on the subscribed namespace..
75+ // @brief Initial HTML document has been completely loaded and parsed
76+ // @param URL The URL that has been loaded
77+ // @param code The response code of main resource request
7578 virtual void LoadFinished (const string& URL, const int32_t code) = 0;
79+ // @brief Browser failed to load page
80+ // @param URL The URL that has been failed to load
7681 virtual void LoadFailed (const string& URL) = 0;
82+ // @brief Signals a URL change in the browser
83+ // @param URL The URL that has been loaded or requested
84+ // @param loaded loaded (true) or not (false)
7785 virtual void URLChange (const string& URL, const bool loaded) = 0;
86+ // @brief Signals a visibility change of the browser
87+ // @param hidden hidden (true) or visible (false)
7888 virtual void VisibilityChange (const bool hidden) = 0;
89+ // @brief Notifies that the web page requests to close its window
7990 virtual void PageClosure () = 0;
91+ // @brief Base64 encoded JSON message from legacy $badger bridge
8092 virtual void BridgeQuery (const string& message) = 0;
8193 };
8294
@@ -100,22 +112,41 @@ namespace Exchange {
100112 // @param fps Current FPS
101113 virtual uint32_t FPS (uint8_t & fps /* @out */ ) const = 0;
102114
115+ // @property
116+ // @brief Headers to send on all requests that the browser makes
117+ // @param header Header Name
103118 virtual uint32_t Headers (string& header /* @out */ ) const = 0;
104119 virtual uint32_t Headers (const string& header) = 0;
105120
121+ // @property
122+ // @brief UserAgent string used by the browser
123+ // @param useragent UserAgent value
106124 virtual uint32_t UserAgent (string& ua /* @out */ ) const = 0;
107125 virtual uint32_t UserAgent (const string& ua) = 0;
108126
127+ // @property
128+ // @brief User preferred languages used by the browser
129+ // @param language Preferred language
109130 virtual uint32_t Languages (string& langs /* @out */ ) const = 0;
110131 virtual uint32_t Languages (const string& langs) = 0;
111132
133+ // @property
134+ // @brief Controls the local storage availability
135+ // @param state enabled or disabled
112136 virtual uint32_t LocalStorageEnabled (bool & enabled /* @out */ ) const = 0;
113137 virtual uint32_t LocalStorageEnabled (const bool enabled) = 0;
114138
139+ // @property
140+ // @brief HTTP cookies accept policy
141+ // @param policy HTTP Cookie Accept Policy Type
115142 virtual uint32_t HTTPCookieAcceptPolicy (HTTPCookieAcceptPolicyType& policy /* @out */ ) const = 0;
116143 virtual uint32_t HTTPCookieAcceptPolicy (const HTTPCookieAcceptPolicyType policy) = 0;
117144
145+ // @brief Response for legacy $badger.
146+ // @param payload base64 encoded JSON string response to be delivered to $badger.callback(pid, success, json)
118147 virtual uint32_t BridgeReply (const string& payload) = 0;
148+ // @brief Send legacy $badger event.
149+ // @param payload base64 encoded JSON string response to be delivered to window.$badger.event(handlerId, json)
119150 virtual uint32_t BridgeEvent (const string& payload) = 0;
120151
121152 };
0 commit comments