minor #12392 Documented the DomCrawler option to normalize white spaces (javiereguiluz)

javiereguiluz · javiereguiluz · commit c746a77f7612 · 2019-10-01T08:45:05.000+02:00
This PR was merged into the 4.4 branch. Discussion ---------- Documented the DomCrawler option to normalize white spaces Fixes #12388. Commits ------- 9556e4c Documented the DomCrawler option to normalize white spaces
diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
@@ -232,10 +232,18 @@ Access the value of the first node of the current selection::
     // avoid the exception passing an argument that text() returns when node does not exist
     $message = $crawler->filterXPath('//body/p')->text('Default text content');
 
+    // pass TRUE as the second argument of text() to remove all extra white spaces, including
+    // the internal ones (e.g. "  foo\n  bar    baz \n " is returned as "foo bar baz")
+    $crawler->filterXPath('//body/p')->text('Default text content', true);
+
 .. versionadded:: 4.3
 
     The default argument of ``text()`` was introduced in Symfony 4.3.
 
+.. versionadded:: 4.4
+
+    The option to trim white spaces in ``text()`` was introduced in Symfony 4.4.
+
 Access the attribute value of the first node of the current selection::
 
     $class = $crawler->filterXPath('//body/p')->attr('class');
diff --git a/testing.rst b/testing.rst
@@ -692,6 +692,13 @@ The Crawler can extract information from the nodes::
     // returns the node value for the first node
     $crawler->text();
 
+    // returns the default text if the node does not exist
+    $crawler->text('Default text content');
+
+    // pass TRUE as the second argument of text() to remove all extra white spaces, including
+    // the internal ones (e.g. "  foo\n  bar    baz \n " is returned as "foo bar baz")
+    $crawler->text(null, true);
+
     // extracts an array of attributes for all nodes
     // (_text returns the node value)
     // returns an array for each element in crawler,
@@ -703,6 +710,10 @@ The Crawler can extract information from the nodes::
         return $node->attr('href');
     });
 
+.. versionadded:: 4.4
+
+    The option to trim white spaces in ``text()`` was introduced in Symfony 4.4.
+
 Links
 ~~~~~
 
