[BrowserKit] Add response management to BrowserKit documentation

Author: alexandre-daubois

components/browser_kit.rst

@@ -343,6 +343,30 @@ dedicated web crawler or scraper such as `Goutte`_::
         '.table-list-header-toggle a:nth-child(1)'
     )->text());
 
+Dealing with HTTP responses
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When using the BrowserKit component, you may need to deal with responses of
+the requests you made. To do so, you simply have to make a request, then call
+the ``getResponse()`` method of the ``HttpBrowser`` object. This method
+retrieves the last response the browser received::
+
+    $browser = new HttpBrowser(HttpClient::create());
+
+    $browser->request('GET', 'https://foo.com');
+    $response = $browser->getResponse();
+
+If you're making requests that result in a JSON response, you
+maye use the ``toArray()`` method of the response to directly get the
+array representation of the JSON string you received. This avoids an
+extra-call to ``json_decode()``::
+
+    $browser = new HttpBrowser(HttpClient::create());
+
+    $browser->request('GET', 'https://api.foo.com');
+    $decodedResponse = $browser->getResponse()->toArray();
+    // $decodedResponse is an array of the decoded JSON.
+
 Learn more
 ----------