Add assertAriaAttribute method

Author: Giulio Troccoli-Allard

src/Concerns/MakesAssertions.php

@@ -588,6 +588,19 @@ public function assertDataAttribute($selector, $attribute, $value)
         return $this->assertAttribute($selector, 'data-' . $attribute, $value);
     }
 
+    /**
+     * Assert that the element at the given selector has the given aria attribute value.
+     *
+     * @param  string  $selector
+     * @param  string  $attribute
+     * @param  string  $value
+     * @return $this
+     */
+    public function assertAriaAttribute($selector, $attribute, $value)
+    {
+        return $this->assertAttribute($selector, 'aria-' . $attribute, $value);
+    }
+
     /**
      * Assert that the element with the given selector is visible.
      *

tests/MakesAssertionsTest.php

@@ -127,6 +127,43 @@ public function test_assert_data_attribute()
         }
     }
 
+    public function test_assert_aria_attribute()
+    {
+        $driver = m::mock(stdClass::class);
+        $element = m::mock(stdClass::class);
+        $element->shouldReceive('getAttribute')->with('aria-bar')->andReturn(
+            'joe',
+            null,
+            'sue'
+        );
+        $resolver = m::mock(stdClass::class);
+        $resolver->shouldReceive('format')->with('foo')->andReturn('Foo');
+        $resolver->shouldReceive('findOrFail')->with('foo')->andReturn($element);
+        $browser = new Browser($driver, $resolver);
+
+        $browser->assertAriaAttribute('foo', 'bar', 'joe');
+
+        try {
+            $browser->assertAriaAttribute('foo', 'bar', 'joe');
+            $this->fail();
+        } catch (ExpectationFailedException $e) {
+            $this->assertStringContainsString(
+                "Did not see expected attribute [aria-bar] within element [Foo].",
+                $e->getMessage()
+            );
+        }
+
+        try {
+            $browser->assertAriaAttribute('foo', 'bar', 'joe');
+            $this->fail();
+        } catch (ExpectationFailedException $e) {
+            $this->assertStringContainsString(
+                "Expected 'aria-bar' attribute [joe] does not equal actual value [sue].",
+                $e->getMessage()
+            );
+        }
+    }
+
     public function test_assert_present()
     {
         $driver = m::mock(stdClass::class);