# Error for HTTP request made when no cassette is in use

VCR is designed to help you remove all HTTP dependencies from your test suite. To assist with this, VCR will cause an exception to be raised when an HTTP request is made while there is no cassette in use. The error is helpful to pinpoint where HTTP requests are made so you can use a VCR cassette at that point in your code.

If you want insight about how VCR attempted to handle the request, you can use the [debug\_logger](https://github.com/andrewmcodes/vcr-docs/tree/96ad135477fb79398b35e9852787c6409c50320f/configuration/debug-logging/README.md) configuration option to log more details.

If you want to allow an HTTP request to proceed as normal, you can set the [allow\_http\_connections\_when\_no\_cassette](https://github.com/andrewmcodes/vcr-docs/tree/96ad135477fb79398b35e9852787c6409c50320f/configuration/allow-http-connections-when-no-cassette/README.md) configuration option or you can temporarily turn VCR off:

*   `VCR.turn_off!` => turn VCR off so HTTP requests are allowed.

    Cassette insertions will trigger an error.
*   `VCR.turn_off!(:ignore_cassettes => true)` => turn

    VCR off and ignore cassette insertions (so that no error is raised).
* `VCR.turn_on!` => turn VCR back on
*   `VCR.turned_off { ... }` => turn VCR off for the duration of the

    provided block.

## Error for request when no cassette is in use

_Given_ a file named "no\_cassette\_error.rb" with:

```
include_http_adapter_for("<http_lib>")

require 'vcr'

VCR.configure do |c|
  <configuration>
  c.cassette_library_dir = 'cassettes'
end

response_body_for(:get, 'http://example.com/')
```

_When_ I run `ruby no_cassette_error.rb`

_Then_ it should fail with "An HTTP request has been made that VCR does not know how to handle".

### Examples

| configuration          | http\_lib              |
| ---------------------- | ---------------------- |
| c.hook\_into :webmock  | net/http               |
| c.hook\_into :webmock  | httpclient             |
| c.hook\_into :webmock  | curb                   |
| c.hook\_into :webmock  | patron                 |
| c.hook\_into :webmock  | em-http-request        |
| c.hook\_into :webmock  | typhoeus               |
| c.hook\_into :typhoeus | typhoeus               |
| c.hook\_into :excon    | excon                  |
| c.hook\_into :faraday  | faraday (w/ net\_http) |

## Temporarily turn VCR off to allow HTTP requests to procede as normal

_Given_ a file named "turn\_off\_vcr.rb" with:

```
$server = start_sinatra_app do
  get('/') { 'Hello' }
end

require 'vcr'

VCR.configure do |c|
  c.hook_into :webmock
end
WebMock.allow_net_connect!

def make_request(context)
  puts context
  puts Net::HTTP.get_response('localhost', '/', $server.port).body
rescue => e
  puts "Error: #{e.class}"
end

VCR.turned_off do
  make_request "In VCR.turned_off block"
end

make_request "Outside of VCR.turned_off block"

VCR.turn_off!
make_request "After calling VCR.turn_off!"

VCR.turn_on!
make_request "After calling VCR.turn_on!"
```

_When_ I run `ruby turn_off_vcr.rb`

_Then_ the output should contain:

```
In VCR.turned_off block
Hello
```

_And_ the output should contain:

```
Outside of VCR.turned_off block
Error: VCR::Errors::UnhandledHTTPRequestError
```

_And_ the output should contain:

```
After calling VCR.turn_off!
Hello
```

_And_ the output should contain:

```
After calling VCR.turn_on!
Error: VCR::Errors::UnhandledHTTPRequestError
```

## Turning VCR off prevents cassettes from being inserted

_Given_ a file named "turn\_off\_vcr\_and\_insert\_cassette.rb" with:

```
require 'vcr'

VCR.configure do |c|
  c.hook_into :webmock
end
WebMock.allow_net_connect!

VCR.turn_off!
VCR.insert_cassette('example')
```

_When_ I run `ruby turn_off_vcr_and_insert_cassette.rb`

_Then_ it should fail with "VCR is turned off. You must turn it on before you can insert a cassette.".

## Turning VCR off with `:ignore_cassettes => true` ignores cassettes

_Given_ a file named "turn\_off\_vcr\_and\_insert\_cassette.rb" with:

```
$server = start_sinatra_app do
  get('/') { 'Hello' }
end

require 'vcr'

VCR.configure do |c|
  c.cassette_library_dir = 'cassettes'
  c.hook_into :webmock
end
WebMock.allow_net_connect!

VCR.turn_off!(:ignore_cassettes => true)

VCR.use_cassette('example') do
  response = Net::HTTP.get_response('localhost', '/', $server.port).body
  puts "Response: #{response}"
end
```

_When_ I run `ruby turn_off_vcr_and_insert_cassette.rb`

_Then_ it should pass with "Response: Hello"

_And_ the file "cassettes/example.yml" should not exist.
