# URI Without Param(s)

A common source of difficulty when using VCR with the default matchers are non-deterministic URIs. If the URI changes on every test run (because it includes a timestamp parameter, or whatever), the default URI matcher will not work well for you.

You can write a custom matcher to match URIs however you want, but for the common need to match on a URI and ignore particular query parameters, VCR provides an easier way:

```
  :match_requests_on => [
    :method,
    VCR.request_matchers.uri_without_param(:timestamp)
  ]
```

`uri_without_param` also has a plural alias (i.e. `uri_without_params(:timestamp, :session)`)

## Background ()

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

```
--- 
http_interactions: 
- request: 
    method: get
    uri: http://example.com/search?q=foo&timestamp=1316920490
    body: 
      encoding: UTF-8
      string: ""
    headers: {}
  response: 
    status: 
      code: 200
      message: OK
    headers: 
      Content-Length: 
      - "12"
    body: 
      encoding: UTF-8
      string: foo response
    http_version: "1.1"
  recorded_at: Tue, 01 Nov 2011 04:58:44 GMT
- request: 
    method: get
    uri: http://example.com/search?q=bar&timestamp=1296723437
    body: 
      encoding: UTF-8
      string: ""
    headers: {}
  response: 
    status: 
      code: 200
      message: OK
    headers: 
      Content-Length: 
      - "12"
    body: 
      encoding: UTF-8
      string: bar response
    http_version: "1.1"
  recorded_at: Tue, 01 Nov 2011 04:58:44 GMT
recorded_with: VCR 2.0.0
```

## Match the URI on all but the timestamp query parameter

_And_ a file named "uri\_without\_param\_matcher.rb" with:

```
include_http_adapter_for("net/http")

require 'vcr'

VCR.configure do |c|
  c.hook_into :webmock
  c.cassette_library_dir = 'cassettes'
  c.default_cassette_options = {
    :match_requests_on => [:method,
      VCR.request_matchers.uri_without_param(:timestamp)]
  }
end

def search_uri(q)
  "http://example.com/search?q=#{q}&timestamp=#{Time.now.to_i}"
end

VCR.use_cassette('example') do
  puts "Response for bar: " +
       response_body_for(:get, search_uri("bar"))
end

VCR.use_cassette('example') do
  puts "Response for foo: " +
       response_body_for(:get, search_uri("foo"))
end
```

_When_ I run `ruby uri_without_param_matcher.rb`

_Then_ it should pass with:

```
Response for bar: bar response
Response for foo: foo response
```
