Return an image (in PNG format) of the javascript-rendered page.

render_png(
  splash_obj = splash_local,
  url,
  base_url = NULL,
  width,
  height,
  timeout = 30,
  resource_timeout,
  wait = 0,
  render_all = TRUE,
  proxy,
  js,
  js_src,
  filters,
  allowed_domains,
  allowed_content_types,
  forbidden_content_types,
  viewport = "full",
  images,
  headers,
  body,
  http_method,
  save_args,
  load_args,
  http2 = FALSE,
  engine = c("webkit", "chromium")
)

Arguments

splash_obj

Object created by a call to splash()

url

The URL to render (required)

base_url

The base URL to render the page with.

width, height

Resize the rendered image to the given width/height (in pixels) keeping the aspect ratio. These are optional

timeout

A timeout (in seconds) for the render (defaults to 30). Without re-configuring the start-up parameters of the Splash server (not this package) the maximum allowed value for the timeout is 60 seconds.

resource_timeout

A timeout (in seconds) for individual network requests.

wait

Time (in seconds) to wait for updates after page is loaded (defaults to 0).

render_all

If TRUE extend the viewport to include the whole webpage (possibly very tall) before rendering.

proxy

Proxy profile name or proxy URL.

js

Javascript profile name.

js_src

JavaScript code to be executed in page context.

filters

Comma-separated list of request filter names.

allowed_domains

Comma-separated list of allowed domain names. If present, Splash won’t load anything neither from domains not in this list nor from subdomains of domains not in this list.

allowed_content_types

Comma-separated list of allowed content types. If present, Splash will abort any request if the response’s content type doesn’t match any of the content types in this list. Wildcards are supported.

forbidden_content_types

Comma-separated list of forbidden content types. If present, Splash will abort any request if the response’s content type matches any of the content types in this list. Wildcards are supported.

viewport

View width and height (in pixels) of the browser viewport to render the web page. Format is “width>xheight”, e.g. 800x600. Default value is "full".

images

Whether to download images.

headers

HTTP headers to set for the first outgoing request.

body

Body of HTTP POST request to be sent if method is POST.

http_method

HTTP method of outgoing Splash request.

save_args

A list of argument names to put in cache.

load_args

Parameter values to load from cache

http2

Enable or disable HTTP2 support. TRUE to enable; FALSE to disable; defaults to FALSE when engine is webkit due to malformed behaviour in 3.4.x of Splash

engine

one of webkit or chromium; defaults to webkit

Value

a magick image object

References

Splash docs

See also

Other splash_renderers: execute_lua(), render_har(), render_html(), render_jpeg(), render_json()

Examples

# NOT RUN {
render_png(url = "https://httpbin.org/")
# }