# master

### Changed

* `require 'capybara/rails'` will automatically enable `:respect_data_method`

on the RackTest driver, so the behavior matches Capybara 1.1.2 [Jo Liss]

* Dropped official support for Ruby 1.8.x. [Jonas Nicklas]

* All methods which find or manipulate fields or buttons now ignore them when

they are disabled. [Jonas Nicklas]

* Can no longer find elements by id via `find(:foo)`, use `find("#foo")` or

`find_by_id("foo")` instead. [Jonas Nicklas]

* Rename `Driver#body` to `Driver#html` (relevant only for driver authors) [Jo

Liss]

### Fixed

* `has_text` (`has_content`) now accepts non-string arguments, like numbers.

[Jo Liss]

* `has_text` and `text` now correctly normalize Unicode whitespace, such as

` `. [Jo Liss]

* RackTest allows protocol relative URLs [Jonas Nicklas]

* Arguments are cast to string where necessary, so that e.g. `click_link(:foo)` works

as expected. [Jonas Nicklas]

# Version 2.0.0.beta2

### Changed

* `respect_data_method` default to `false` for the RackTest driver, which means

that Capybara no longer picks up `:method => :post` et. al. from links in Rails

by default. [Jonas Nicklas]

* `find` now raises an error if more than one element was found. Since `find` is

used by most actions, like `click_link` under the surface, this means that all

actions need to unambiguous in the future. [Jonas Nicklas]

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

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

* `has_content?` now checks the text value returned by `Element#text`, as opposed to

querying the DOM. Which means it does not match hidden text.

[Ryan Montgomery, Mark Dodwell, Jo Liss]

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

state of the DOM (like `#html`), by popular request [Jonas Nicklas]

* `Node#all` no longer returns an array, but rather an enumerable `Capybara::Result`

[Jonas Nicklas]

* The arguments to `select` and `unselect` needs to be the exact text of an option

in a select box, substrings are no longer allowed [Jonas Nicklas]

* The `options` option to `has_select?` must match the exact set of options. Use

`with_options` for the old behaviour. [Gonzalo Rodriguez]

* The `selected` option to `has_select?` must match all selected options for multiple

selects. [Gonzalo Rodriguez]

* Various internals for running driver specs, this should only affect driver authors

[Jonas Nicklas]

### Removed

* No longer possible to specify `failure_message` for custom selectors. [Jonas Nicklas]

* #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]

* `Node#wait_until` and `Session#wait_until` have been removed. See `Node#synchronize`

for an alternative [Jonas Nicklas]

* `Capybara.timeout` has been removed [Jonas Nicklas]

* The `:resynchronize` option has been removed from the Selenium driver [Jonas Nicklas]

* The `rows` option to `has_table?` has been removed without replacement.

[Jonas Nicklas]

### Fixed

* Nodes found via `all` are no longer reloaded. This fixes weird quirks where

nodes would seemingly randomly replace themselves with other nodes [Jonas Nicklas]

* Session is only reset if it has been modified, dramatically improves performance if

only part of the test suite runs Capybara. [Jonas Nicklas]

* 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]

* Exceptions during server boot now propagate to main thread [James Tucker]

* RSpec integration now cleans up before the test instead of after [Darwin]

* If `respect_data_method` is true, the data-method attribute can be capitalized

[Marco Antonio]

* Rack app boot timing out raises an error as opposed to just logging to STDOUT

[Adrian Irving-Beer]

* `#source` returns an empty string instead of nil if no pages have been visited

[Jonas Nicklas]

* Ignore first leading newline in textareas in RackTest [Vitalii Khustochka]

* `within_frame` returns the value of the given block [Alistair Hutchison]

* Running `Node.set` on text fields will not trigger more than one change event

[Andrew Kasper]

* Throw an error when an option is given to a finder method, like `all` or

`has_selector?` which Capybara doesn't understand [Jonas Nicklas]

* Two references to the node now register as equal when comparing them with `==`

[Jonas Nicklas]

### Added

* Much improved error message [Jonas Nicklas]

* Errors from inside the session for apps running in a server are raised when

session is reset [James Tucker, Jonas Nicklas]

* A ton of new selectors built in out of the box, like `field`, `link`, `button`,

etc... [Adam McCrea, Jonas Nicklas]

* `has_text?` has been added as an alias for `has_content?` [Jonas Nicklas]

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

* Add `:type` option for `page.has_field?` [Gonzalo Rodríguez]

* Custom matchers can now be specified in CSS in addition to XPath [Jonas Nicklas]

* `Node#synchronize` method to rerun a block of code if certain errors are raised

[Jonas Nicklas]

* `Capybara.always_include_port` config option always includes the server port in

URLs when using `visit`. Facilitates testing different domain names`. [Douwe Maan]

* Redirect limit for RackTest driver is configurable [Josh Lane]

* Server port can be manually specified during initialization of server.

[Jonas Nicklas, John Wilger]

* `has_content?` and `has_text?` can be given a regular expression [Vasiliy Ermolovich]

# 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)