Merge pull request #32 from stof/driver_features

Add the table of supported driver features

Author: stof

guides/drivers.rst

@@ -20,4 +20,34 @@ Mink comes with five drivers out of the box:
     /drivers/sahi
     /drivers/selenium
 
-.. todo:: Build a table of the features supported by each driver
+.. _driver-feature-support:
+
+Driver Feature Support
+----------------------
+
+Although Mink does its best on removing browser differences between different
+browser emulators, it can't do much in some cases. For example, BrowserKitDriver
+cannot evaluate JavaScript and Selenium2Driver cannot get the response status
+code. In such cases, the driver will always throw a meaningful
+``Behat\Mink\Exception\UnsupportedDriverActionException``.
+
+======================  =================  =========  ======  ========  ====
+Feature                 BrowserKit/Goutte  Selenium2  Zombie  Selenium  Sahi
+======================  =================  =========  ======  ========  ====
+Page traversing         Yes                Yes        Yes     Yes       Yes
+Form manipulation       Yes                Yes        Yes     Yes       Yes
+HTTP Basic auth         Yes                No         Yes     No        No
+Windows management      No                 Yes        No      Yes       Yes
+iFrames management      No                 Yes        No      Yes       No
+Request headers access  Yes                No         Yes     No        No
+Response headers        Yes                no         Yes     No        No
+Cookie manipulation     Yes                Yes        Yes     Yes       Yes
+Status code access      Yes                No         Yes     No        No
+Mouse manipulation      No                 Yes        Yes     Yes       Yes
+Drag'n Drop             No                 Yes        No      Yes       Yes
+Keyboard actions        No                 Yes        Yes     Yes       Yes
+Element visibility      No                 Yes        No      Yes       Yes
+JS evaluation           No                 Yes        Yes     Yes       Yes
+Window resizing         No                 Yes        No      No        No
+Window maxizing         No                 Yes        No      Yes       No
+======================  =================  =========  ======  ========  ====

guides/session.rst

@@ -64,10 +64,8 @@ browser emulator with it:
 .. note::
 
     Although Mink does its best on removing browser differences between different
-    browser emulators, it can't do much in some cases. For example, GoutteDriver
-    can't evaluate JavaScript and Selenium2Driver can't get the response
-    status code. In such cases, the driver will always throw a meaningful
-    ``Behat\Mink\Exception\UnsupportedDriverActionException``.
+    browser emulators, it can't do much in some cases. See the :ref:`driver-feature-support`
+    to see which features are supported by each driver.
 
 Cookies and Headers management
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~