Skip to content

Temporarily set verbosity for all requests

Source: R/verbosity.R
with_verbosity.Rd

with_verbosity() and local_verbosity() are useful for debugging httr2 code buried deep inside another package, because they allow you to change the verbosity even when you don't have access to the request.

Both functions work by temporarily setting the httr2_verbosity option. You can also control verbosity by setting the HTTR2_VERBOSITY environment variable. This has lower precedence than the option, but can be more easily changed outside of R.

Usage

with_verbosity(code, verbosity = 1)

local_verbosity(verbosity, env = caller_env())

Arguments

code

Code to execture

verbosity

How much information to print? This is a wrapper around req_verbose() that uses an integer to control verbosity:

  • 0: no output

  • 1: show headers

  • 2: show headers and bodies

  • 3: show headers, bodies, and curl status messages.

Use with_verbosity() to control the verbosity of requests that you can't affect directly.

env

Environment to use for scoping changes.

Value

with_verbosity() returns the result of evaluating code. local_verbosity() is called for its side-effect and invisibly returns the previous value of the option.

Examples

fun <- function() {
  request("https://httr2.r-lib.org") |> req_perform()
}
with_verbosity(fun())
#> -> GET / HTTP/2
#> -> Host: httr2.r-lib.org
#> -> User-Agent: httr2/1.2.0 r-curl/6.4.0 libcurl/8.5.0
#> -> Accept: */*
#> -> Accept-Encoding: deflate, gzip, br, zstd
#> -> 
#> <- HTTP/2 200 
#> <- server: GitHub.com
#> <- content-type: text/html; charset=utf-8
#> <- last-modified: Fri, 11 Jul 2025 20:18:29 GMT
#> <- access-control-allow-origin: *
#> <- etag: W/"68717195-4b42"
#> <- expires: Mon, 14 Jul 2025 13:37:29 GMT
#> <- cache-control: max-age=600
#> <- content-encoding: gzip
#> <- x-proxy-cache: MISS
#> <- x-github-request-id: 826C:3270C7:110149D:11C1A79:687505C0
#> <- accept-ranges: bytes
#> <- date: Mon, 14 Jul 2025 13:27:52 GMT
#> <- via: 1.1 varnish
#> <- age: 23
#> <- x-served-by: cache-bur-kbur8200111-BUR
#> <- x-cache: HIT
#> <- x-cache-hits: 5
#> <- x-timer: S1752499672.007940,VS0,VE0
#> <- vary: Accept-Encoding
#> <- x-fastly-request-id: 4cfdff590a4f6ea53e9d9530a0b488fdf5c80081
#> <- content-length: 4746
#> <- 
#> <httr2_response>
#> GET https://httr2.r-lib.org/
#> Status: 200 OK
#> Content-Type: text/html
#> Body: In memory (19266 bytes)

fun <- function() {
  local_verbosity(2)
  # someotherpackage::fun()
}