253 def userAgent(cls, resolveEmpty=False): |
253 def userAgent(cls, resolveEmpty=False): |
254 """ |
254 """ |
255 Class method to get the global user agent setting. |
255 Class method to get the global user agent setting. |
256 |
256 |
257 @param resolveEmpty flag indicating to resolve an empty |
257 @param resolveEmpty flag indicating to resolve an empty |
258 user agent (boolean) |
258 user agent |
259 @return user agent string (string) |
259 @type bool |
|
260 @return user agent string |
|
261 @rtype str |
260 """ |
262 """ |
261 agent = Preferences.getWebBrowser("UserAgent") |
263 agent = Preferences.getWebBrowser("UserAgent") |
262 if agent == "" and resolveEmpty: |
264 if agent == "" and resolveEmpty: |
263 agent = cls.userAgentForUrl(QUrl()) |
265 agent = cls.userAgentForUrl(QUrl()) |
264 return agent |
266 return agent |
266 @classmethod |
268 @classmethod |
267 def setUserAgent(cls, agent): |
269 def setUserAgent(cls, agent): |
268 """ |
270 """ |
269 Class method to set the global user agent string. |
271 Class method to set the global user agent string. |
270 |
272 |
271 @param agent new current user agent string (string) |
273 @param agent new current user agent string |
|
274 @type str |
272 """ |
275 """ |
273 Preferences.setWebBrowser("UserAgent", agent) |
276 Preferences.setWebBrowser("UserAgent", agent) |
274 |
277 |
275 @classmethod |
278 @classmethod |
276 def userAgentForUrl(cls, url): |
279 def userAgentForUrl(cls, url): |
277 """ |
280 """ |
278 Class method to determine the user agent for the given URL. |
281 Class method to determine the user agent for the given URL. |
279 |
282 |
280 @param url URL to determine user agent for (QUrl) |
283 @param url URL to determine user agent for |
281 @return user agent string (string) |
284 @type QUrl |
|
285 @return user agent string |
|
286 @rtype str |
282 """ |
287 """ |
283 agent = WebBrowserWindow.userAgentsManager().userAgentForUrl(url) |
288 agent = WebBrowserWindow.userAgentsManager().userAgentForUrl(url) |
284 if agent == "": |
289 if agent == "": |
285 # no agent string specified for the given host -> use global one |
290 # no agent string specified for the given host -> use global one |
286 agent = Preferences.getWebBrowser("UserAgent") |
291 agent = Preferences.getWebBrowser("UserAgent") |