Show extra output when request is performed

req_verbose() uses the following prefixes to distinguish between different components of the HTTP requests and responses:

• * informative curl messages

• <- request headers

• << request body

• -> response headers

• >> response body

req_verbose(
  req,
  header_req = TRUE,
  header_resp = TRUE,
  body_req = FALSE,
  body_resp = FALSE,
  info = FALSE,
  redact_headers = TRUE
)

Arguments

req

A request.

header_req, header_resp

Show request/response headers?

body_req, body_resp

Should request/response bodies? When the response body is compressed, this will show the number of bytes received in each "chunk".

info

Show informational text from curl? This is mainly useful for debugging https and auth problems, so is disabled by default.

redact_headers

Redact confidential data in the headers? Currently redacts the contents of the Authorization header to prevent you from accidentally leaking credentials when debugging/reprexing.

Value

A modified HTTP request.

See also

req_perform() which exposes a limited subset of these options through the verbosity argument and with_verbosity() which allows you to control the verbosity of requests deeper within the call stack.

Examples

# Use `req_verbose()` to see the headers that are sent back and forth when
# making a request
resp <- request("https://httr2.r-lib.org") %>%
  req_verbose() %>%
  req_perform()
#> -> GET / HTTP/2
#> -> Host: httr2.r-lib.org
#> -> user-agent: httr2/0.1.1.9000 r-curl/4.3.2 libcurl/7.68.0
#> -> accept: */*
#> -> accept-encoding: deflate, gzip, br
#> -> 
#> <- HTTP/2 200 
#> <- server: GitHub.com
#> <- content-type: text/html; charset=utf-8
#> <- last-modified: Tue, 28 Sep 2021 17:33:28 GMT
#> <- access-control-allow-origin: *
#> <- etag: W/"615351e8-49e8"
#> <- expires: Tue, 28 Sep 2021 17:43:48 GMT
#> <- cache-control: max-age=600
#> <- content-encoding: gzip
#> <- x-proxy-cache: MISS
#> <- x-github-request-id: A2D4:7F6C:A9CC5:E0AC1:615351FC
#> <- accept-ranges: bytes
#> <- date: Tue, 28 Sep 2021 17:36:08 GMT
#> <- via: 1.1 varnish
#> <- age: 106
#> <- x-served-by: cache-sea4478-SEA
#> <- x-cache: HIT
#> <- x-cache-hits: 1
#> <- x-timer: S1632850569.541849,VS0,VE1
#> <- vary: Accept-Encoding
#> <- x-fastly-request-id: a137c1fff5842969ebcde77fff43da4c36e7b02d
#> <- content-length: 5279
#> <- 

# Or use one of the convenient shortcuts:
resp <- request("https://httr2.r-lib.org") %>%
  req_perform(verbosity = 1)
#> -> GET / HTTP/2
#> -> Host: httr2.r-lib.org
#> -> user-agent: httr2/0.1.1.9000 r-curl/4.3.2 libcurl/7.68.0
#> -> accept: */*
#> -> accept-encoding: deflate, gzip, br
#> -> 
#> <- HTTP/2 200 
#> <- server: GitHub.com
#> <- content-type: text/html; charset=utf-8
#> <- last-modified: Tue, 28 Sep 2021 17:33:28 GMT
#> <- access-control-allow-origin: *
#> <- etag: W/"615351e8-49e8"
#> <- expires: Tue, 28 Sep 2021 17:43:48 GMT
#> <- cache-control: max-age=600
#> <- content-encoding: gzip
#> <- x-proxy-cache: MISS
#> <- x-github-request-id: A2D4:7F6C:A9CC5:E0AC1:615351FC
#> <- accept-ranges: bytes
#> <- date: Tue, 28 Sep 2021 17:36:08 GMT
#> <- via: 1.1 varnish
#> <- age: 106
#> <- x-served-by: cache-sea4478-SEA
#> <- x-cache: HIT
#> <- x-cache-hits: 2
#> <- x-timer: S1632850569.565220,VS0,VE0
#> <- vary: Accept-Encoding
#> <- x-fastly-request-id: 5d975c103d6859a87d8efb7a91c309cfaa70463a
#> <- content-length: 5279
#> <-