summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--Doc/library/webbrowser.rst7
-rw-r--r--Lib/webbrowser.py3
2 files changed, 10 insertions, 0 deletions
diff --git a/Doc/library/webbrowser.rst b/Doc/library/webbrowser.rst
index 334f21f..4a15597 100644
--- a/Doc/library/webbrowser.rst
+++ b/Doc/library/webbrowser.rst
@@ -72,6 +72,8 @@ The following functions are defined:
(note that under many window managers this will occur regardless of the
setting of this variable).
+ Returns ``True`` if a browser was successfully launched, ``False`` otherwise.
+
Note that on some platforms, trying to open a filename using this function,
may work and start the operating system's associated program. However, this
is neither supported nor portable.
@@ -84,11 +86,16 @@ The following functions are defined:
Open *url* in a new window of the default browser, if possible, otherwise, open
*url* in the only browser window.
+ Returns ``True`` if a browser was successfully launched, ``False`` otherwise.
+
+
.. function:: open_new_tab(url)
Open *url* in a new page ("tab") of the default browser, if possible, otherwise
equivalent to :func:`open_new`.
+ Returns ``True`` if a browser was successfully launched, ``False`` otherwise.
+
.. function:: get(using=None)
diff --git a/Lib/webbrowser.py b/Lib/webbrowser.py
index 252ca92..d2efc72 100644
--- a/Lib/webbrowser.py
+++ b/Lib/webbrowser.py
@@ -80,6 +80,9 @@ def open(url, new=0, autoraise=True):
- 1: a new browser window.
- 2: a new browser page ("tab").
If possible, autoraise raises the window (the default) or not.
+
+ If opening the browser succeeds, return True.
+ If there is a problem, return False.
"""
if _tryorder is None:
with _lock: