minor #10898 Documented the default values of text() and html() (javiereguiluz)

javiereguiluz · javiereguiluz · commit 50c0823d4224 · 2019-01-22T09:08:32.000+01:00
This PR was merged into the master branch. Discussion ---------- Documented the default values of text() and html() Documents symfony/symfony#28581 See also https://symfony.com/blog/new-in-symfony-4-3-domcrawler-improvements Commits ------- 851956d Documented the default values of text() and html()
diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
@@ -201,8 +201,16 @@ Access the node name (HTML tag name) of the first node of the current selection
 
 Access the value of the first node of the current selection::
 
+    // if the node does not exist, calling to text() will result in an exception
     $message = $crawler->filterXPath('//body/p')->text();
 
+    // avoid the exception passing an argument that text() returns when node does not exist
+    $message = $crawler->filterXPath('//body/p')->text('Default text content');
+
+.. versionadded:: 4.3
+
+    The default argument of ``text()`` was introduced in Symfony 4.3.
+
 Access the attribute value of the first node of the current selection::
 
     $class = $crawler->filterXPath('//body/p')->attr('class');
@@ -298,8 +306,16 @@ and :phpclass:`DOMNode` objects::
     Or you can get the HTML of the first node using
     :method:`Symfony\\Component\\DomCrawler\\Crawler::html`::
 
+        // if the node does not exist, calling to html() will result in an exception
         $html = $crawler->html();
 
+        // avoid the exception passing an argument that html() returns when node does not exist
+        $html = $crawler->html('Default <strong>HTML</strong> content');
+
+    .. versionadded:: 4.3
+
+        The default argument of ``html()`` was introduced in Symfony 4.3.
+
 Expression Evaluation
 ~~~~~~~~~~~~~~~~~~~~~
 
