[DomCrawler][Feature][DX] Add Form::getName() method

src/Symfony/Component/DomCrawler/CHANGELOG.md

@@ -1,6 +1,11 @@
 CHANGELOG
 =========
 
+4.4.0
+-----
+
+* Added `Form::getName()` method.
+
 4.3.0
 -----
 

src/Symfony/Component/DomCrawler/Form.php

@@ -250,6 +250,16 @@ public function getMethod()
         return $this->node->getAttribute('method') ? strtoupper($this->node->getAttribute('method')) : 'GET';
     }
 
+    /**
+     * Gets the form name.
+     *
+     * If no name is defined on the form, an empty string is returned.
+     */
+    public function getName(): string
+    {
+        return $this->node->getAttribute('name');
+    }
+
     /**
      * Returns true if the named field exists.
      *

src/Symfony/Component/DomCrawler/Tests/FormTest.php

@@ -327,6 +327,18 @@ public function testGetMethodWithOverride()
         $this->assertEquals('POST', $form->getMethod(), '->getMethod() returns the method attribute value of the form');
     }
 
+    public function testGetName()
+    {
+        $form = $this->createForm('<form name="foo"><input type="submit" /></form>');
+        $this->assertSame('foo', $form->getName());
+    }
+
+    public function testGetNameOnFormWithoutName()
+    {
+        $form = $this->createForm('<form><input type="submit" /></form>');
+        $this->assertSame('', $form->getName());
+    }
+
     public function testGetSetValue()
     {
         $form = $this->createForm('<form><input type="text" name="foo" value="foo" /><input type="submit" /></form>');