browseURL(url, browser = getOption("browser"),
encodeIfNeeded = FALSE)
Under Windows NULL
is also allowed (and is the default), and
implies that the file association mechanism will be used.
URLencode
before passing to the browser? This is not
needed (and might be harmful) if the browser
program/function
itself does encoding, and can be harmful for file:// URLs on some
systems and for http:// URLs passed to some CGI applications.
Fortunately, most URLs do not need encoding."browser"
, in turn set by
the environment variable Startup
for where to override that default value.)
To suppress showing URLs altogether, use the value "false"
.
On many platforms it is best to set option "browser"
to a
generic program/script and let that invoke the user's choice of
browser. For example, on OS X use browser
supports remote control and Rknows how to perform
it, the URL is opened in any already-running browser or a new one if
necessary. This mechanism currently is available for browsers which
support the "-remote openURL(...)"
interface (which includes
Mozilla and Opera), Galeon, KDE konqueror (via kfmclient) and
the GNOME interface to Mozilla. (Firefox has dropped support, but
defaults to using an already-running browser.) Note that the type of
browser is determined from its name, so this mechanism will only be
used if the browser is installed under its canonical name. Because "-remote"
will use any browser displaying on the X
server (whatever machine it is running on), the remote control
mechanism is only used if DISPLAY
points to the local host.
This may not allow displaying more than one URL at a time from a
remote host.
It is the caller's responsibility to encode url
if necessary
(see URLencode
). This can be tricky for file URLs,
where the format accepted can depend on both browser and OS.
To suppress showing URLs altogether, set browser = "false"
.
The behaviour for arguments url
which are not URLs is
platform-dependent. Some platforms accept absolute file paths; fewer
accept relative file paths.
"browser"
, in turn set by
the environment variable NULL
.
To suppress showing URLs altogether, use the value "false"
. Some browsers have required :
be replaced by |
in file
paths: others do not accept that. All seem to accept \
as a
path separator even though the RFC1738 standard requires /
.
To suppress showing URLs altogether, set browser = "false"
.
browseURL("https://www.r-project.org")
browseURL("file://d:/R/R-2.5.1/doc/html/index.html",
browser = "C:/Program Files/Mozilla Firefox/firefox.exe")
Run the code above in your browser using DataLab