@vardot/varbase-e2e 2.0.0

package/docs/steps/link.md

@@ -0,0 +1,217 @@
+# Links steps
+
+9 steps, defined in `tests/step-definitions/link.steps.js`.
+
+Cucumber-js loads every `*.steps.js` in that directory automatically — you never `require()` a step file from a feature.
+
+| # | Step |
+| --- | --- |
+| 1 | `Then the link "About" with the href "/about" should exist` |
+| 2 | `Then the link "Home" with the href "/" within the element "#main-nav" should exist` |
+| 3 | `Then the link "Sign in" with the href "/login" should not exist` |
+| 4 | `Then the link "Logout" with the href "/logout" within the element ".guest-nav" should not exist` |
+| 5 | `Then the link with the title "Open menu" should exist` |
+| 6 | `Then the link with the title "Delete user" should not exist` |
+| 7 | `Then the link "Twitter" should be an absolute link` |
+| 8 | `Then the link "Home" should not be an absolute link` |
+| 9 | `When I click on the link with the title "Open menu"` |
+
+---
+
+## 1. Then the link "About" with the href "/about" should exist
+
+Assert a link with the given visible text and an href containing a fragment exists.
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+'the link {string} with the href {string} should exist'
+```
+
+**Examples**
+
+```gherkin
+Then the link "About" with the href "/about" should exist
+Then the link "Sign in" with the href "/login" should exist
+And the link "Pricing" with the href "/pricing" should exist
+Then the link "Docs" with the href "docs.example.com" should exist
+Then the link "Contact" with the href "/contact-us" should exist
+```
+
+## 2. Then the link "Home" with the href "/" within the element "#main-nav" should exist
+
+Assert a link exists inside a specific parent element.
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+'the link {string} with the href {string} within the element {string} should exist'
+```
+
+**Examples**
+
+```gherkin
+Then the link "Home" with the href "/" within the element "#main-nav" should exist
+Then the link "Privacy" with the href "/privacy" within the element "footer" should exist
+And the link "Sign in" with the href "/login" within the element ".header" should exist
+Then the link "Docs" with the href "/docs" within the element "nav" should exist
+Then the link "Pricing" with the href "/pricing" within the element ".cta-block" should exist
+```
+
+## 3. Then the link "Sign in" with the href "/login" should not exist
+
+Assert NO link with the given visible text and href fragment exists.
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+'the link {string} with the href {string} should not exist'
+```
+
+**Examples**
+
+```gherkin
+Then the link "Sign in" with the href "/login" should not exist
+Then the link "Admin" with the href "/admin" should not exist
+And the link "Old docs" with the href "/v1/docs" should not exist
+Then the link "Logout" with the href "/logout" should not exist
+Then the link "Beta" with the href "/beta" should not exist
+```
+
+## 4. Then the link "Logout" with the href "/logout" within the element ".guest-nav" should not exist
+
+Assert NO link with text+href exists inside a specific parent element.
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+'the link {string} with the href {string} within the element {string} should not exist'
+```
+
+**Examples**
+
+```gherkin
+Then the link "Logout" with the href "/logout" within the element ".guest-nav" should not exist
+Then the link "Admin" with the href "/admin" within the element "footer" should not exist
+And the link "Beta" with the href "/beta" within the element "#main-nav" should not exist
+Then the link "Old" with the href "/v1" within the element ".breadcrumb" should not exist
+Then the link "Internal" with the href "/internal" within the element ".public-nav" should not exist
+```
+
+## 5. Then the link with the title "Open menu" should exist
+
+Assert at least one link has the exact `title` attribute.
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+'the link with the title {string} should exist'
+```
+
+**Examples**
+
+```gherkin
+Then the link with the title "Open menu" should exist
+Then the link with the title "Edit profile" should exist
+And the link with the title "Download PDF" should exist
+Then the link with the title "Print page" should exist
+Then the link with the title "Sign in" should exist
+```
+
+## 6. Then the link with the title "Delete user" should not exist
+
+Assert NO link has the given exact `title` attribute.
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+'the link with the title {string} should not exist'
+```
+
+**Examples**
+
+```gherkin
+Then the link with the title "Delete user" should not exist
+Then the link with the title "Open admin" should not exist
+And the link with the title "Edit billing" should not exist
+Then the link with the title "Sign out" should not exist
+Then the link with the title "Reveal secret" should not exist
+```
+
+## 7. Then the link "Twitter" should be an absolute link
+
+Assert a link's href is absolute (starts with `http://` or `https://`).
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+'the link {string} should be an absolute link'
+```
+
+**Examples**
+
+```gherkin
+Then the link "Twitter" should be an absolute link
+Then the link "GitHub" should be an absolute link
+And the link "Documentation" should be an absolute link
+Then the link "Status page" should be an absolute link
+Then the link "External docs" should be an absolute link
+```
+
+## 8. Then the link "Home" should not be an absolute link
+
+Assert a link's href is relative (no `http://` / `https://` scheme).
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+'the link {string} should not be an absolute link'
+```
+
+**Examples**
+
+```gherkin
+Then the link "Home" should not be an absolute link
+Then the link "About" should not be an absolute link
+And the link "Privacy" should not be an absolute link
+Then the link "Pricing" should not be an absolute link
+Then the link "Docs" should not be an absolute link
+```
+
+## 9. When I click on the link with the title "Open menu"
+
+Click a link addressed by its `title` attribute.
+
+**Keyword**: `When`
+
+**Pattern**
+
+```js
+/^(I |we )*click on the link with the title "([^"]*)"$/
+```
+
+**Examples**
+
+```gherkin
+When I click on the link with the title "Open menu"
+When I click on the link with the title "Edit profile"
+And we click on the link with the title "Download PDF"
+When I click on the link with the title "Print page"
+When I click on the link with the title "Sign in"
+```

package/docs/steps/metatag.md

@@ -0,0 +1,99 @@
+# Meta tags steps
+
+3 steps, defined in `tests/step-definitions/metatag.steps.js`.
+
+Cucumber-js loads every `*.steps.js` in that directory automatically — you never `require()` a step file from a feature.
+
+| # | Step |
+| --- | --- |
+| 1 | `Then the meta tag should exist with the following attributes:` |
+| 2 | `Then the meta tag should not exist with the following attributes:` |
+| 3 | `Then the "description" meta tag should not contain any HTML tags` |
+
+---
+
+## 1. Then the meta tag should exist with the following attributes:
+
+Assert at least one `<meta>` tag matches every attribute in the data table.
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+'the meta tag should exist with the following attributes:'
+```
+
+**Examples**
+
+```gherkin
+Then the meta tag should exist with the following attributes:
+  | name    | description                |
+  | content | Documentation site          |
+Then the meta tag should exist with the following attributes:
+  | property | og:title    |
+  | content  | Home        |
+And the meta tag should exist with the following attributes:
+  | name    | viewport                          |
+  | content | width=device-width, initial-scale=1 |
+Then the meta tag should exist with the following attributes:
+  | name    | robots         |
+  | content | noindex,nofollow |
+Then the meta tag should exist with the following attributes:
+  | charset | UTF-8 |
+```
+
+## 2. Then the meta tag should not exist with the following attributes:
+
+Assert NO `<meta>` tag matches every attribute in the data table.
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+'the meta tag should not exist with the following attributes:'
+```
+
+**Examples**
+
+```gherkin
+Then the meta tag should not exist with the following attributes:
+  | name    | description     |
+  | content | Coming soon     |
+Then the meta tag should not exist with the following attributes:
+  | name    | robots          |
+  | content | noindex         |
+And the meta tag should not exist with the following attributes:
+  | property | og:title       |
+  | content  | Placeholder    |
+Then the meta tag should not exist with the following attributes:
+  | http-equiv | refresh       |
+  | content    | 5             |
+Then the meta tag should not exist with the following attributes:
+  | name    | author          |
+  | content | Anonymous       |
+```
+
+## 3. Then the "description" meta tag should not contain any HTML tags
+
+Assert the `content` attribute of a named meta tag contains no HTML markup.
+Useful for description / open-graph fields that should render as plain text.
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+'the {string} meta tag should not contain any HTML tags'
+```
+
+**Examples**
+
+```gherkin
+Then the "description" meta tag should not contain any HTML tags
+Then the "og:title" meta tag should not contain any HTML tags
+And the "twitter:description" meta tag should not contain any HTML tags
+Then the "keywords" meta tag should not contain any HTML tags
+Then the "author" meta tag should not contain any HTML tags
+```

package/docs/steps/modal.md

@@ -0,0 +1,232 @@
+# Modals steps
+
+9 steps, defined in `tests/step-definitions/modal.steps.js`.
+
+Cucumber-js loads every `*.steps.js` in that directory automatically — you never `require()` a step file from a feature.
+
+| # | Step |
+| --- | --- |
+| 1 | `Then I should see a modal` |
+| 2 | `Then I should see a modal with title "Confirm Action"` |
+| 3 | `Then I should see a "confirmation-modal" modal` |
+| 4 | `Then I should see "Are you sure?" in the modal` |
+| 5 | `Then the modal should contain "Welcome modal text"` |
+| 6 | `Then the modal should not contain "Goodbye"` |
+| 7 | `When I click "Confirm" in the modal` |
+| 8 | `When I click on "#close-btn" in the modal` |
+| 9 | `When I close the modal` |
+
+---
+
+## 1. Then I should see a modal
+
+Assert that a modal dialog is visible or not visible on the page.
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+/^(I |we )*should( not)* see (a |the )*modal( dialog)*$/
+```
+
+**Examples**
+
+```gherkin
+Then I should see a modal
+Then I should see the modal
+Then we should see a modal dialog
+Then I should not see a modal
+Then I should not see the modal dialog
+```
+
+## 2. Then I should see a modal with title "Confirm Action"
+
+Assert that a modal dialog with a given title is visible or not visible.
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+/^(I |we )*should( not)* see (a |the )*modal with title "([^"]*)?"$/
+```
+
+**Examples**
+
+```gherkin
+Then I should see a modal with title "Confirm Action"
+Then I should see the modal with title "Welcome"
+Then we should see a modal with title "Welcome Message"
+Then I should not see a modal with title "Error"
+Then I should not see the modal with title "Validation Error"
+```
+
+## 3. Then I should see a "confirmation-modal" modal
+
+Assert that a specific modal by id/class/data-modal is visible or not.
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+/^(I |we )*should( not)* see (a |the )*"([^"]*)?" modal$/
+```
+
+**Examples**
+
+```gherkin
+Then I should see a "confirmation-modal" modal
+Then I should see the "#delete-modal" modal
+Then we should see a "settings-modal" modal
+Then I should not see a "error-modal" modal
+Then I should not see the "#success-modal" modal
+```
+
+## 4. Then I should see "Are you sure?" in the modal
+
+Assert that a modal contains or does not contain specific text.
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+/^(I |we )*should( not)* see "([^"]*)?" in( the)* modal( dialog)*$/
+```
+
+**Examples**
+
+```gherkin
+Then I should see "Are you sure?" in the modal
+Then I should see "Delete this item" in the modal
+Then we should see "Confirmation required" in the modal dialog
+Then I should not see "Error occurred" in the modal
+```
+
+## 5. Then the modal should contain "Welcome modal text"
+
+Assert that the modal contains the given text (alternate phrasing).
+
+Distinct from "I should see :text in the modal" — checks plain
+`innerText`, ignoring nested layout. Use when the text is part of the
+modal body rather than a specific element.
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+'the modal should contain {string}'
+```
+
+**Examples**
+
+```gherkin
+Then the modal should contain "Welcome modal text"
+Then the modal should contain "Are you sure"
+And the modal should contain "Order #1234"
+When I press "Show details"
+  Then the modal should contain "Address"
+Given I am on "/dashboard"
+  When I click "Open settings"
+  And I wait for the modal to appear
+  Then the modal should contain "Preferences"
+```
+
+## 6. Then the modal should not contain "Goodbye"
+
+Assert that the modal does NOT contain the given text.
+
+Passes when no modal exists OR when the modal exists but lacks the text.
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+'the modal should not contain {string}'
+```
+
+**Examples**
+
+```gherkin
+Then the modal should not contain "Goodbye"
+Then the modal should not contain "Error"
+And the modal should not contain "Payment failed"
+When I close the modal
+  Then the modal should not contain "Welcome"
+When I press "Refresh"
+  Then the modal should not contain "Loading"
+```
+
+## 7. When I click "Confirm" in the modal
+
+Click a button or link inside a modal dialog by its visible text.
+
+**Keyword**: `When`
+
+**Pattern**
+
+```js
+/^(I |we )*click "([^"]*)?"( button)* in( the)* modal( dialog)*$/
+```
+
+**Examples**
+
+```gherkin
+When I click "Confirm" in the modal
+When I click "Cancel" in the modal dialog
+When we click "OK" button in the modal
+And I click "Close" in the modal
+```
+
+## 8. When I click on "#close-btn" in the modal
+
+Click a CSS-selector-addressed element inside the active modal.
+
+Distinct from "click :text in the modal" which uses visible button text.
+Use this variant when the target lacks readable text (icon button) or
+when text is ambiguous across multiple buttons in the modal.
+
+**Keyword**: `When`
+
+**Pattern**
+
+```js
+/^(I |we )*click on "([^"]*)" in the modal$/
+```
+
+**Examples**
+
+```gherkin
+When I click on "#close-btn" in the modal
+When I click on ".confirm-delete" in the modal
+And I click on "[data-testid=accept]" in the modal
+When I click on "button[aria-label=Close]" in the modal
+When I press "Open settings"
+  And I wait for the modal to appear
+  Then I click on "#tab-notifications" in the modal
+```
+
+## 9. When I close the modal
+
+Close or dismiss a modal dialog (uses close button, or Escape fallback).
+
+**Keyword**: `When`
+
+**Pattern**
+
+```js
+/^(I |we )*(close|dismiss)( the)* modal( dialog)*$/
+```
+
+**Examples**
+
+```gherkin
+When I close the modal
+When I dismiss the modal dialog
+When we close the modal
+And I dismiss the modal
+```