Add assertAttribute method

Author: Giulio Troccoli-Allard

src/Concerns/MakesAssertions.php

@@ -548,6 +548,33 @@ public function assertValue($selector, $value)
         return $this;
     }
 
+    /**
+     * Assert that the element at the given selector has the given attribute value.
+     *
+     * @param  string  $selector
+     * @param  string  $attribute
+     * @param  string  $value
+     * @return $this
+     */
+    public function assertAttribute($selector, $attribute, $value)
+    {
+        $fullSelector = $this->resolver->format($selector);
+
+        $actual = $this->resolver->findOrFail($selector)->getAttribute($attribute);
+
+        PHPUnit::assertNotNull(
+            $actual,
+            "Did not see expected attribute [{$attribute}] within element [{$fullSelector}]."
+        );
+
+        PHPUnit::assertEquals(
+            $value, $actual,
+            "Expected '$attribute' attribute [{$value}] does not equal actual value [$actual]."
+        );
+
+        return $this;
+    }
+
     /**
      * Assert that the element with the given selector is visible.
      *

tests/MakesAssertionsTest.php

@@ -53,6 +53,43 @@ public function test_assert_title_contains()
         }
     }
 
+    public function test_assert_attribute()
+    {
+        $driver = m::mock(stdClass::class);
+        $element = m::mock(stdClass::class);
+        $element->shouldReceive('getAttribute')->with('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->assertAttribute('foo', 'bar', 'joe');
+
+        try {
+            $browser->assertAttribute('foo', 'bar', 'joe');
+            $this->fail();
+        } catch (ExpectationFailedException $e) {
+            $this->assertStringContainsString(
+                "Did not see expected attribute [bar] within element [Foo].",
+                $e->getMessage()
+            );
+        }
+
+        try {
+            $browser->assertAttribute('foo', 'bar', 'joe');
+            $this->fail();
+        } catch (ExpectationFailedException $e) {
+            $this->assertStringContainsString(
+                "Expected 'bar' attribute [joe] does not equal actual value [sue].",
+                $e->getMessage()
+            );
+        }
+    }
+
     public function test_assert_present()
     {
         $driver = m::mock(stdClass::class);