python 标准库之 webbrowser

没啥前提

一张图表示我现在的心情

标准库 webbrowser

webbrowser 模块提供了一个高级接口，允许向用户显示基于Web的文档。在大多数情况下，只需从该模块调用 open() 函数就可以了。

在 Unix 下，图形浏览器在 X11 下是首选，但如果图形浏览器不可用或 X11 显示不可用，则将使用文本模式浏览器。如果使用文本模式浏览器，则调用进程将阻塞，直到用户退出浏览器。

如果存在环境变量 BROWSER ，则将其解释为 os.pathsep 分隔的浏览器列表，以便在平台默认值之前尝试。当列表部分的值包含字符串 ％s 时，它被解释为一个文字浏览器命令行，用于替换 ％s 的参数 URL ；如果该部分不包含 ％s，则它只被解释为要启动的浏览器的名称。

脚本 webbrowser 可以用作模块的命令行界面。它接受一个 URL 作为参数。还接受以下可选参数：-n 如果可能，在新的浏览器窗口中打开 URL ； -t 在新的浏览器页面（“标签”）中打开 URL。这些选择当然是相互排斥的。用法示例:

1	python -m webbrowser -t "https://jeffsui.github.io"

异常

exception webbrowser.`Error`

发生浏览器控件错误时引发异常。

函数

webbrowser.`open`(url, new=0, autoraise=True)

使用默认浏览器显示 url。如果 new 为 0，则尽可能在同一浏览器窗口中打开 url。如果 new 为 1，则尽可能打开新的浏览器窗口。如果 new 为 2，则尽可能打开新的浏览器页面（“标签”）。如果 autoraise 为 “True”，则会尽可能置前窗口（请注意，在许多窗口管理器下，无论此变量的设置如何，都会置前窗口）。请注意，在某些平台上，尝试使用此函数打开文件名，可能会起作用并启动操作系统的关联程序。但是，这种方式不被支持也不可移植。使用 url 参数会引发 auditing event webbrowser.open 。
webbrowser.open_new(url)

如果可能，在默认浏览器的新窗口中打开 url，否则，在唯一的浏览器窗口中打开 url。
webbrowser.open_new_tab(url)

如果可能，在默认浏览器的新页面（“标签”）中打开 url，否则等效于 open_new()。
webbrowser.get(*using=None*)

返回浏览器类型为 using 指定的控制器对象。如果 using 为 None，则返回适用于调用者环境的默认浏览器的控制器。
webbrowser.register(name, constructor, instance=None, **, preferred=False*)

注册 name 浏览器类型。注册浏览器类型后， get() 函数可以返回该浏览器类型的控制器。如果没有提供 instance，或者为 None，constructor 将在没有参数的情况下被调用，以在需要时创建实例。如果提供了 instance，则永远不会调用 constructor，并且可能是 None。将 preferred 设置为 True 使得这个浏览器成为 get() 不带参数调用的首选结果。否则，只有在您计划设置 BROWSER 变量，或使用与您声明的处理程序的名称相匹配的非空参数调用 get() 时，此入口点才有用。

浏览器类型

预定义了许多浏览器类型。此表给出了可以传递给 get() 函数的类型名称以及控制器类的相应实例化，这些都在此模块中定义。

类型名	类名	注释
`'mozilla'`	`Mozilla('mozilla')`
`'firefox'`	`Mozilla('mozilla')`
`'netscape'`	`Mozilla('netscape')`
`'galeon'`	`Galeon('galeon')`
`'epiphany'`	`Galeon('epiphany')`
`'skipstone'`	`BackgroundBrowser('skipstone')`
`'kfmclient'`	`Konqueror()`	(1)
`'konqueror'`	`Konqueror()`	(1)
`'kfm'`	`Konqueror()`	(1)
`'mosaic'`	`BackgroundBrowser('mosaic')`
`'opera'`	`Opera()`
`'grail'`	`Grail()`
`'links'`	`GenericBrowser('links')`
`'elinks'`	`Elinks('elinks')`
`'lynx'`	`GenericBrowser('lynx')`
`'w3m'`	`GenericBrowser('w3m')`
`'windows-default'`	`WindowsDefault`	(2)
`'macosx'`	`MacOSX('default')`	(3)
`'safari'`	`MacOSX('safari')`	(3)
`'google-chrome'`	`Chrome('google-chrome')`
`'chrome'`	`Chrome('chrome')`
`'chromium'`	`Chromium('chromium')`
`'chromium-browser'`	`Chromium('chromium-browser')`

简单的例子:

url = 'http://docs.python.org/'

# Open URL in a new tab, if a browser window is already open.
webbrowser.open_new_tab(url)

# Open URL in new window, raising the window if possible.
webbrowser.open_new(url)

浏览器控制器对象

浏览器控制器提供三个与模块级便捷函数相同的方法：

controller.open(url, new=0, autoraise=True)`

使用此控制器处理的浏览器显示 url。如果 new 为 1，则尽可能打开新的浏览器窗口。如果 new 为 2，则尽可能打开新的浏览器页面（“标签”）。
controller.open_new(url)`

如果可能，在此控制器处理的浏览器的新窗口中打开 url ，否则，在唯一的浏览器窗口中打开 url 。别名 open_new()。
controller.open_new_tab(url)`

如果可能，在此控制器处理的浏览器的新页面（“标签”）中打开 url，否则等效于 open_new()

总结

标准库中的webbrowser只提供了一个简单的操作本地浏览器的接口。