R browseURL 将 URL 加载到 HTML 浏览器中

说明

将给定的 URL 加载到 HTML 浏览器中。

用法

browseURL(url, browser = getOption("browser"),
          encodeIfNeeded = FALSE)

参数

url	给出要加载的 URL 的非空字符串。某些平台还接受文件路径。
browser	一个非空字符串，给出用作 HTML 浏览器的程序名称。它应该位于 PATH 中，或者指定的完整路径中。或者，一个R调用函数来调用浏览器。 在Windows下NULL也是允许的(并且是默认的)，并且意味着将使用文件关联机制。
encodeIfNeeded	URL 是否应该编码为URLencode在传递给浏览器之前？如果以下情况，则不需要(并且可能有害)：browser程序/函数本身进行编码，并且可能对‘⁠文件://⁠' 某些系统上的 URL 以及“⁠http://⁠’传递给某些 CGI 应用程序的 URL。幸运的是，大多数 URL 不需要编码。

细节

在 Unix 类系统上：

默认浏览器由选项设置"browser"，依次由环境变量设置R_BROWSER默认情况下在文件‘中设置base Rhome/etc/Renviron’到手动或自动做出的选择R已配置。 (看Startup了解在何处覆盖该默认值。)要完全禁止显示 URL，请使用该值"false".

在许多平台上，最好将选项 "browser" 设置为通用程序/脚本，并让它调用用户选择的浏览器。例如，在 macOS 上使用 open ，在许多其他 Unix 类似系统上使用 xdg-open 。

如果browser支持远程控制和R知道如何执行它，可以在任何 already-running 浏览器或新浏览器(如果需要)中打开该 URL。该机制目前可用于支持"-remote openURL(...)"接口(包括 Mozilla 和 Opera)、Galeon、KDE konqueror(通过kfmclient)和 Mozilla 的 GNOME 接口。 (Firefox 已放弃支持，但默认使用 already-running 浏览器。)请注意，浏览器的类型是根据其名称确定的，因此仅当浏览器以其规范名称安装时才会使用此机制。

由于 "-remote" 将使用 X 服务器上显示的任何浏览器(无论它运行在什么机器上)，因此仅当 DISPLAY 指向本地主机时才使用远程控制机制。这可能不允许从远程主机一次显示多个 URL。

如有必要，调用者有责任对 url 进行编码(请参阅 URLencode )。

要完全禁止显示 URL，请设置 browser = "false" 。

非 URL 的参数 url 的行为取决于平台。有些平台接受绝对文件路径；较少接受相对文件路径。

在 Windows 上：

默认浏览器由选项设置"browser"，依次由环境变量设置R_BROWSER如果已设置，否则NULL。要完全禁止显示 URL，请使用该值"false".

有些浏览器需要‘⁠：⁠' 替换为 '⁠|⁠’ 在文件路径中：其他人不接受这一点。所有人似乎都接受‘⁠\⁠’ 作为路径分隔符，尽管 RFC1738 标准要求 ‘⁠/⁠’。

要完全禁止显示 URL，请设置 browser = "false" 。

URL方案

接受哪些 URL 方案是特定于平台的：expect ‘⁠http://⁠', '⁠https://⁠' 和 '⁠ftp://⁠’去工作，但是‘⁠邮件地址：⁠’可能会也可能不会(如果确实如此，则可能不会使用用户首选的电子邮件客户端)。然而，现代浏览器不太可能处理‘⁠ftp://⁠’。

为了 '⁠文件://⁠’方案接受的格式(如果有)可能取决于浏览器和操作系统。

例子

## Not run: 
## for KDE users who want to open files in a new tab
options(browser = "kfmclient newTab")

browseURL("https://www.r-project.org")

## On Windows-only, something like
browseURL("file://d:/R/R-2.5.1/doc/html/index.html",
          browser = "C:/Program Files/Mozilla Firefox/firefox.exe")

## End(Not run)