http_head: Asynchronous HTTP HEAD request

In r-lib/async: Asynchronous Computation and 'I/O'

Asynchronous HTTP HEAD request

Description

An async HTTP deferred object is also an event emitter, see http_get() for details, and also event_emitter.

Usage

http_head(
  url,
  headers = character(),
  file = NULL,
  options = list(),
  on_progress = NULL
)

Arguments

url	URL to connect to.
headers	HTTP headers to send.
file	If not NULL, it must be a string, specifying a file. The body of the response is written to this file.
options	Options to set on the handle. Passed to curl::handle_setopt().
on_progress	Progress handler function. It is only used if the response body is written to a file. See details below.

Value

Deferred object.

See Also

Other asyncronous HTTP calls: http_get(), http_setopt()

Examples

afun <- async(function() {
  dx <- http_head("https://eu.httpbin.org/status/200")$
    then(function(x) x$status_code)
})
synchronise(afun())

# Check a list of URLs in parallel
afun <- function(urls) {
  when_all(.list = lapply(urls, http_head))$
    then(function(x) lapply(x, "[[", "status_code"))
}
urls <- c("https://google.com", "https://eu.httpbin.org")
synchronise(afun(urls))

r-lib/async documentation built on Nov. 19, 2024, 12:08 p.m.