:none

The :none record mode will:

• Replay previously recorded interactions.

• Cause an error to be raised for any new requests.

  This is useful when your code makes potentially dangerous HTTP requests. The :none record mode guarantees that no new HTTP requests will be made.

Background ()

Given a file named "vcr_config.rb" with:

require 'vcr'

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

And a previously recorded cassette file "cassettes/example.yml" with:

--- 
http_interactions: 
- request: 
    method: get
    uri: http://example.com/foo
    body: 
      encoding: UTF-8
      string: ""
    headers: {}
  response: 
    status: 
      code: 200
      message: OK
    headers: 
      Content-Length: 
      - "5"
    body: 
      encoding: UTF-8
      string: Hello
    http_version: "1.1"
  recorded_at: Tue, 01 Nov 2011 04:58:44 GMT
recorded_with: VCR 2.0.0

Previously recorded responses are replayed

Given a file named "replay_recorded_response.rb" with:

require 'vcr_config'

VCR.use_cassette('example', :record => :none) do
  response = Net::HTTP.get_response('example.com', '/foo')
  puts "Response: #{response.body}"
end

When I run ruby replay_recorded_response.rb

Then it should pass with "Response: Hello".

New requests are prevented

Given a file named "prevent_new_request.rb" with:

require 'vcr_config'

VCR.use_cassette('example', :record => :none) do
  Net::HTTP.get_response('example.com', '/bar')
end

When I run ruby prevent_new_request.rb

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