# master

### Fixed

* Test suite now passes on Ruby 1.8 [Jo Liss]

* #565: `require 'capybara/dsl'` is no longer necessary [Jo Liss]

* Rack::Test now respects ports when changing hosts [Jo Liss]

* #603: Rack::Test now preserves the original referer URL when following a

redirect [Rob van Dijk]

* Rack::Test now does not send a referer when calling `visit` multiple times

[Jo Liss]

### Added

* #481: XPath ... and new selectors ... [Adam McCrea, Jonas Nicklas]

* has_text, has_content ... [Jonas Nicklas]

* Add Capybara.server_host option (default: 127.0.0.1) [David Balatero]

### Changed

* find now raises an error if more than one element was found [Jonas Nicklas]

* #394: #body now returns the unmodified source (like #source), not the current

state of the DOM (like #html) [Jonas Nicklas]

* Element#text on RackTest now only returns visible text and normalizes

(strips) whitespace, as with Selenium [Mark Dodwell, Jo Liss]

### Removed

* #589: Capybara.server_boot_timeout has been removed in favor of a higher

(60-second) hard-coded timeout [Jo Liss]

* Capybara.prefer_visible_elements has been removed, as it is no longer needed

with the changed find semantics [Jonas Nicklas]

# Version 1.1.2

Release date: 2011-11-15

### Fixed

* #541: Make attach_file work with selenium-webdriver >=2.12 [Jonas Nicklas]

# Version 1.1.0

Release date: 2011-09-02

### Fixed

* Sensible inspect for Capybara::Session [Jo Liss]

* Fix headers and host on redirect [Matt Colyer, Jonas Nicklas, Kim Burgestrand]

* using_driver now restores the old driver instead of reverting to the default [Carol Nichols]

* Errors when following links relative to the root path under rack-test [Jonas Nicklas, Kim Burgestrand]

* Make sure exit codes are propagated properly [Edgar Beigarts]

### Changed

* resynchronization is off by default under Selenium

### Added

* Elements are automatically reloaded (including parents) during wait [Jonas Nicklas]

* Rescue driver specific element errors, such as the dreaded ObsoleteElementError and retry [Jonas Nicklas]

* Raise an error if something has frozen time [Jonas Nicklas]

* Allow within to take a node instead of a selector [Peter Williams]

* Using wait_time_time to change wait time for a block of code [Jonas Nicklas, Kim Burgestrand]

* Option for rack-test driver to disable data-method hack [Jonas Nicklas, Kim Burgestrand]

# Version 1.0.1

Release date: 2011-08-12

### Fixed

* Dependend on selenium-webdriver ~>2.0 and fix deprecations [Thomas Walpole, Jo Liss]

* Depend on Launch 2.0 [Jeremy Hinegardner]

* Rack-Test ignores fill in on fields with maxlength=""

# Version 1.0.0

Release date: 2011-06-14

### Added

* Added DSL for acceptance tests, inspired by Luismi Cavallé's Steak [Luismi Cavalle and Jonas Nicklas]

* Selenium driver automatically waits for AJAX requests to finish [mgiambalvo, Nicklas Ramhöj and Jonas Nicklas]

* Support for switching between multiple named sessions [Tristan Dunn]

* failure_message can be specified for Selectors [Jonas Nicklas]

* RSpec matchers [David Chelimsky and Jonas Nicklas]

* Added save_page to save tempfile without opening in browser [Jeff Kreeftmeijer]

* Cucumber now switches automatically to a registered driver if the tag matches the name [Jonas Nicklas]

* Added Session#text [Jonas Nicklas and Scott Cytacki]

* Added Session#html as an alias for Session#body [Jo Liss]

* Added Session#current_host method [Jonas Nicklas]

* Buttons can now be clicked by title [Javier Martin]

* :headers option for RackTest driver to set custom HTTP headers [Jonas Nicklas]

### Removed

* Culerity and Celerity drivers have been removed and split into separate gems [Gabriel Sobrinho]

### Deprecated

* `include Capybara` has been deprecated in favour of `include Capybara::DSL` [Jonas Nicklas]

### Changed

* Rack test driver class has been renamed from Capybara::Driver::RackTest to Capybara::RackTest::Driver [Jonas Nicklas]

* Selenium driver class has been renamed from Capybara::Driver::Selenium to Capybara::Selenium::Driver [Jonas Nicklas]

* Capybara now prefers visible elements over hidden elements, disable by setting Capybara.prefer_visible_elements = false [Jonas Nicklas and Nicklas Ramhöj]

* For RSpec, :type => :request is now supported (and preferred over :acceptance) [Jo Liss]

* Selenium driver tried to wait for AJAX requests to finish before proceeding [Jonas Nicklas and Nicklas Ramhöj]

* Session no longer uses method missing, uses explicit delegates instead [Jonas Nicklas]

### Fixed

* The Rack::Test driver now respects maxlength on text fields [Guilherme Carvalho]

* Allow for more than one save_and_open_page call per second [Jo Liss]

* Automatically convert options to :count, :minimum, :maximum, etc. to integers [Keith Marcum]

* Rack::Test driver honours maxlength on input fields [Guilherme Carvalho]

* Rack::Test now works as expected with domains and subdomains [Jonas Nicklas]

* Session is reset more thoroughly between tests. [Jonas Nicklas]

* Raise error when uploading non-existant file [Jonas Nicklas]

* Rack reponse body should respond to #each [Piotr Sarnacki]

* Deprecation warnings with selenium webdriver 0.2.0 [Aaron Gibraltar]

* Selenium Chrome no longer YELLS tagname [Carl Jackson & David W. Frank]

* Capybara no longer strips encoding before sending to Rack [Jonas Nicklas]

* Improve handling of relative URLs [John Barton]

* Readd and fix build_rack_mock_session [Jonas Nicklas, Jon Leighton]

# Version 0.4.1

Release date: 2011-01-21

### Added

* New click_on alias for click_link_or_button, shorter yet unambiguous. [Jonas Nicklas]

* Finders now accept :visible => false which will find all elements regardless of Capybara.ignore_hidden_elements [Jonas Nicklas]

* Configure how the server is started via Capybara.server { |app, port| ... }. [John Firebough]

* Added :between, :maximum and :minimum options to has_selector and friends [James B. Byrne]

* New Capybara.string util function which allows matchers on arbitrary strings, mostly for helper and view specs [David Chelimsky and Jonas Nicklas]

* Server boot timeout is now configurable, via Capybara.server_boot_timeout [Adam Cigánek]

* Built in support for RSpec [Jonas Nicklas]

* Capybara.using_driver to switch to a different driver temporarily [Jeff Kreeftmeijer]

* Added Session#first which is somewhat speedier than Session#all, use it internally for speed boost [John Firebaugh]

### Changed

* Session#within now accepts the same arguments as other finders, like Session#all and Session#find [Jonas Nicklas]

### Removed

* All deprecations from 0.4.0 have been removed. [Jonas Nicklas]

### Fixed

* Don't mangle URLs in save_and_open_page when using self-closing tags [Adam Spiers]

* Catch correct error when server boot times out [Jonas Nicklas]

* Celerity driver now properly passes through options, making it configurable [Jonas Nicklas]

* Better implementation of attributes in C[ue]lerity, should fix issues with attributes with strange names [Jonas Nicklas]

* Session#find no longer swallows errors [Jonas Nicklas]

* Fix problems with multiple file inputs [Philip Arndt]

* Submit multipart forms as multipart under rack-test even if they contain no files [Ryan Kinderman]

* Matchers like has_select? and has_checked_field? now work with dynamically changed values [John Firebaugh]

* Preserve order of rack params [Joel Chippindale]

* RackTest#reset! is more thorough [Joel Chippindale]

# Version 0.4.0

Release date: 2010-10-22

### Changed

* The Selector API was changed slightly, use Capybara.add_selector, see README

### Fixed

* Celerity driver is registered properly

* has_selector? and has_no_selector? added to DSL

* Multiple selects return correct values under C[cu]lerity

* Naked query strings are handled correctly by rack-test

# Version 0.4.0.rc

Release date: 2010-10-12

### Changed

* within and find/locate now follow the XPath spec in that //foo finds all nodes in the document, instead of

only for the context node. See this post for details: http://groups.google.com/group/ruby-capybara/browse_thread/thread/b129067979df21b3

* within now executes within the first found instance of the selector, not in all of them

* find now waits for AJAX requests and raises an exception when the element is not found (same as locate used to do)

* The default selector is now CSS, not XPath

### Deprecated

* Session#click has been renamed click_link_or_button and the old click has been deprecated

* Node#node has been renamed native

* Node#locate is deprecated in favor of Node#find, which now behaves identically

* Session#drag is deprecated, please use Node#drag_to(other_node) instead

### Added

* Pretty much everything is properly documented now

* It's now possible to call all session methods on nodes, like `find('#foo').fill_in(...)`

* Custom selectors can be added with Capybara::Selector.add

* The :id selector is added by default, use it lile `find(:id, 'foo')` or `find(:foo)`

* Added Node#has_selector? so any kind of selector can be queried.

* Added Capybara.configure for less wordy configuration

* Added within_window to switch between different windows (currently Selenium only)

* Capybara.server_port to provide a fixed port if wanted (defaults to automatic selection)

### Fixed

* CSS selectors with multiple selectors, such as "h1, h2" now work correctly

* Port is automatically assigned instead of guessing

* Strip encodings in rack-test, no more warnings!

* RackTest no longer submits disabled fields

* Servers no longer output annoying debug information when started

* TCP port selection is left to Ruby to decide, no more port guessing

* Select boxes now return option value instead of text if present

* The default has been changed from localhost to 127.0.0.1, should fix some obscure selenium bugs

* RackTest now supports complex field names, such as foo[bar][][baz]

# Version 0.3.9

Release date: 2010-07-03

### Added

* status_code which returns the HTTP status code of the last response (no Selenium!)

* Capybara.save_and_open_page to store tempfiles

* RackTest and Culerity drivers now clean up after themselves properly

### Fixed

* When no rack app is set and the app is called, a more descriptive error is raised

* select now works with optgroups

* Don't submit image buttons unless they were clicked under rack-test

* Support custom field types under Selenium

* Support input fields without a type, treat them as though they were text fields

* Redirect now throws an error after 5 redirects, as per RFC

* Selenium now properly raises an error when Node#trigger is called

* Node#value now returns the correct value for textareas under rack-test

# Version 0.3.8

Release date: 2010-05-12

### Added

* Within_frame method to execute a block of code within a particular iframe (Selenium only!)

### Fixed

* Single quotes are properly escaped with `select` under rack-test and Selenium.

* The :text option for searches now escapes regexp special characters when a string is given.

* Selenium now correctly checks already checked checkboxes (same with uncheck)

* Timing issue which caused Selenium to hang under certain circumstances.

* Selenium now resolves attributes even if they are given as a Symbol

# Version 0.3.7

Release date: 2010-04-09

This is a drop in compatible maintainance release. It's mostly

important for driver authors.

### Added

* RackTest scans for data-method which rails3 uses to change the request method

### Fixed

* Don't hang when starting server on Windoze

### Changed

* The driver and session specs are now located inside lib! Driver authors can simply require them.

# Version 0.3.6

Release date: 2010-03-22

This is a maintainance release with minor bug fixes, should be

drop in compatible.

### Added

* It's now possible to load in external drivers

### Fixed

* has_content? ignores whitespace

* Trigger events when choosing radios and checking checkboxes under Selenium

* Make Capybara.app totally optional when running without server

* Changed fallback host so it matches the one set up by Rails' integration tests

# Version 0.3.5

Release date: 2010-02-26

This is a mostly backwards compatible release, it does break

the API in some minor places, which should hopefully not affect

too many users, please read the release notes carefully!

### Breaking

* Relative searching in a node (e.g. find('//p').all('//a')) will now follow XPath standard

this means that if you want to find descendant nodes only, you'll need to prefix a dot!

* `visit` now accepts fully qualified URLs for drivers that support it.

* Capybara will always try to run a rack server, unless you set Capybara.run_sever = false

### Changed

* thin is preferred over mongrel and webrick, since it is Ruby 1.9 compatible

* click_button and click will find <input type="button">, clicking them does nothing in RackTest

### Added

* Much improved error messages in a multitude of places

* More semantic page querying with has_link?, has_button?, etc...

* Option to ignore hidden elements when querying and interacting with the page

* Support for multiple selects

### Fixed

* find_by_id is no longer broken

* clicking links where the image's alt attribute contains the text is now possible

* within_fieldset and within_table work when the default selector is CSS

* boolean attributes work the same across drivers (return true/false)