Merge pull request #498 from remarkablemark/feat/heading

feat(assertions): add "Then I do not see heading"

cypress/e2e/example/example.feature

@@ -4,15 +4,16 @@ Feature: Example
     Then I see document title "Example Domain"
       And I see document title contains "Example"
 
-  Scenario: See heading
+  Scenario: Heading
     Given I visit "http://example.com/"
     Then I see heading "Example Domain"
     When I find headings by text "Example Domain"
     Then I count 1 element
     When I find heading by text "Example Domain"
     Then I count 1 element
+      And I do not see heading "Foo"
 
-  Scenario: See and not see text
+  Scenario: Text
     Given I visit "http://example.com/"
     Then I see text "Example Domain"
       And I see text "More information"

src/assertions/heading.ts

@@ -1,6 +1,9 @@
 import { Then } from '@badeball/cypress-cucumber-preprocessor';
 
-import { When_I_find_heading_by_text } from '../queries';
+import {
+  When_I_find_heading_by_text,
+  When_I_find_headings_by_text,
+} from '../queries';
 import { getCypressElement } from '../utils';
 
 /**
@@ -30,3 +33,29 @@ export function Then_I_see_heading(text: string) {
 }
 
 Then('I see heading {string}', Then_I_see_heading);
+
+/**
+ * Then I do not see heading:
+ *
+ * ```gherkin
+ * Then I do not see heading {string}
+ * ```
+ *
+ * Assert heading with text **_does not exist_** in the screen.
+ *
+ * @example
+ *
+ * ```gherkin
+ * Then I do not see heading "Heading"
+ * ```
+ *
+ * @see
+ *
+ * - {@link Then_I_do_not_see_text | Then I do not see text}
+ */
+export function Then_I_do_not_see_heading(text: string) {
+  When_I_find_headings_by_text(text);
+  getCypressElement().should('not.exist');
+}
+
+Then('I do not see heading {string}', Then_I_do_not_see_heading);