npm - @vardot/varbase-e2e - Versions diffs - 2.0.0 - Mend

@vardot/varbase-e2e 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (301) hide show

package/AGENTS.md +148 -0
package/CLAUDE.md +544 -0
package/README.md +22 -0
package/bin/generate-reports.js +363 -0
package/bin/init-varbase-e2e.js +330 -0
package/bin/postinstall.js +26 -0
package/cucumber.js +125 -0
package/docs/00-quick-start.md +102 -0
package/docs/01-getting-started.md +102 -0
package/docs/02-bbr-smart-waits.md +77 -0
package/docs/03-selector-registry.md +95 -0
package/docs/04-step-reference.md +801 -0
package/docs/05-web-first-assertions.md +91 -0
package/docs/06-network-and-dialogs.md +83 -0
package/docs/07-auth-state.md +75 -0
package/docs/08-clock-mocking.md +59 -0
package/docs/09-api-testing.md +114 -0
package/docs/10-accessibility.md +167 -0
package/docs/11-debugging.md +129 -0
package/docs/12-ai-agent-guide.md +338 -0
package/docs/13-faq.md +236 -0
package/docs/14-recipes-cookbook.md +255 -0
package/docs/15-tag-conventions.md +76 -0
package/docs/16-ci-cd.md +90 -0
package/docs/README.md +125 -0
package/docs/advanced-screenshots/then-i-save-fullscreen-screenshot.md +36 -0
package/docs/advanced-screenshots/then-i-save-width-x-height-screenshot.md +34 -0
package/docs/advanced-screenshots/when-i-save-screenshot-name-filename.md +45 -0
package/docs/advanced-screenshots.md +52 -0
package/docs/advanced-selectors.md +18 -0
package/docs/api-step-definitions.md +45 -0
package/docs/global-settings.md +267 -0
package/docs/install-varbase-e2e/ddev-varbase-e2e.md +52 -0
package/docs/install-varbase-e2e.md +34 -0
package/docs/overview.md +40 -0
package/docs/step-definitions/given-i-am-anonymous-user.md +67 -0
package/docs/step-definitions/given-i-am-homepage.md +68 -0
package/docs/step-definitions/given-i-am-specific-page.md +72 -0
package/docs/step-definitions/then-i-should-be.md +56 -0
package/docs/step-definitions/then-i-should-see.md +62 -0
package/docs/step-definitions/then-item-checkbox.md +54 -0
package/docs/step-definitions/then-item-link-should-contain-url.md +84 -0
package/docs/step-definitions/then-item-should-contain.md +67 -0
package/docs/step-definitions/then-radio-button-value-should-be-selected.md +68 -0
package/docs/step-definitions/then-response-status-code-should-be-number.md +69 -0
package/docs/step-definitions/then-value-radio-button-selected.md +62 -0
package/docs/step-definitions/when-i-attach-file-file-name-element.md +71 -0
package/docs/step-definitions/when-i-check-checkbox.md +60 -0
package/docs/step-definitions/when-i-click-link.md +51 -0
package/docs/step-definitions/when-i-click-operation-text-row.md +71 -0
package/docs/step-definitions/when-i-fill.md +59 -0
package/docs/step-definitions/when-i-go-homepage.md +60 -0
package/docs/step-definitions/when-i-go-specific-page.md +67 -0
package/docs/step-definitions/when-i-move-backward-one-page.md +49 -0
package/docs/step-definitions/when-i-move-forward-one-page.md +58 -0
package/docs/step-definitions/when-i-press-button.md +58 -0
package/docs/step-definitions/when-i-reload-page.md +51 -0
package/docs/step-definitions/when-i-scroll.md +73 -0
package/docs/step-definitions/when-i-select-option-select-list.md +53 -0
package/docs/step-definitions/when-i-select-radio-button-value.md +62 -0
package/docs/step-definitions/when-i-uncheck-checkbox.md +57 -0
package/docs/step-definitions/when-i-wait-ajax-finish.md +64 -0
package/docs/step-definitions/when-i-wait.md +62 -0
package/docs/step-definitions.md +82 -0
package/docs/steps/README.md +137 -0
package/docs/steps/a11y.md +731 -0
package/docs/steps/action.md +181 -0
package/docs/steps/api.md +679 -0
package/docs/steps/assertion.md +328 -0
package/docs/steps/auth.md +108 -0
package/docs/steps/clock.md +171 -0
package/docs/steps/cookie.md +293 -0
package/docs/steps/debug.md +52 -0
package/docs/steps/dialog.md +226 -0
package/docs/steps/drupal-canvas.md +414 -0
package/docs/steps/drupal-ckeditor.md +118 -0
package/docs/steps/drupal-core.md +688 -0
package/docs/steps/drupal-layout-builder.md +437 -0
package/docs/steps/drupal-media.md +107 -0
package/docs/steps/drupal-moderation.md +81 -0
package/docs/steps/drupal-paragraphs.md +36 -0
package/docs/steps/element.md +455 -0
package/docs/steps/field.md +648 -0
package/docs/steps/file-download.md +235 -0
package/docs/steps/form.md +344 -0
package/docs/steps/iframe.md +248 -0
package/docs/steps/input.md +220 -0
package/docs/steps/javascript.md +111 -0
package/docs/steps/keyboard.md +107 -0
package/docs/steps/link.md +217 -0
package/docs/steps/metatag.md +99 -0
package/docs/steps/modal.md +232 -0
package/docs/steps/navigation.md +275 -0
package/docs/steps/network.md +284 -0
package/docs/steps/path.md +203 -0
package/docs/steps/response.md +102 -0
package/docs/steps/responsive.md +139 -0
package/docs/steps/rest.md +140 -0
package/docs/steps/screenshot.md +211 -0
package/docs/steps/scroll.md +266 -0
package/docs/steps/selectors.md +848 -0
package/docs/steps/storage.md +254 -0
package/docs/steps/table.md +216 -0
package/docs/steps/varbase.md +391 -0
package/docs/steps/video.md +111 -0
package/docs/steps/wait.md +553 -0
package/docs/steps/web-first.md +289 -0
package/docs/steps/xml.md +505 -0
package/docs/steps/yaml.md +951 -0
package/examples/a11y.html +31 -0
package/examples/about-us.html +11 -0
package/examples/account.html +32 -0
package/examples/ajax-wait-examples.html +147 -0
package/examples/contact-us.html +10 -0
package/examples/cookies.html +10 -0
package/examples/date.html +12 -0
package/examples/dynamic-examples.html +498 -0
package/examples/element.html +11 -0
package/examples/example-api.json +28 -0
package/examples/existing-page.html +11 -0
package/examples/field.html +24 -0
package/examples/index.html +37 -0
package/examples/keyboard.html +11 -0
package/examples/links.html +9 -0
package/examples/modal.html +14 -0
package/examples/path.html +3 -0
package/examples/table.html +13 -0
package/examples/test--modal-dialogs.html +252 -0
package/examples/test--then--i-should--not--see-text-in-element.html +48 -0
package/examples/test--then--i-should--see-text-in-element.html +48 -0
package/examples/test--then--i-should--see-text-matching-pattern.html +31 -0
package/examples/test--then--i-should-see-text-in-table-row.html +232 -0
package/examples/test--then--the-checkbox-checked.html +68 -0
package/examples/test--then--the-element-should_not-contain-cssproperty.html +47 -0
package/examples/test--then--the-link-should-contain.html +21 -0
package/examples/test--when--i-additionally-select.html +27 -0
package/examples/test--when--i-attach-file-to-feild.html +50 -0
package/examples/test--when--i-check-uncheck-checkbox.html +47 -0
package/examples/test--when--i-click-link.html +18 -0
package/examples/test--when--i-click-text-in-table-row.html +178 -0
package/examples/test--when--i-fill-in.html +48 -0
package/examples/test--when--i-press-button.html +31 -0
package/examples/test--when--i-reload-page.html +27 -0
package/examples/test--when--i-scroll-functionality.html +177 -0
package/examples/test--when--i-scroll-left-right-functionality.html +149 -0
package/examples/test--when--i-select-option-from-dropdownlist.html +35 -0
package/examples/test--when--i-select-radio-button.html +95 -0
package/examples/test--when-i-wait-max-of-time.html +39 -0
package/examples/test--when-i-wait-page-until-is-loaded.html +47 -0
package/examples/test--when-i-wait-specific-time.html +39 -0
package/examples/test-acceptable-url-path.html +11 -0
package/examples/video-demo.html +43 -0
package/package.json +56 -0
package/playwright.config.ts +39 -0
package/tests/assets/test-document.pdf +14 -0
package/tests/assets/vardot.png +0 -0
package/tests/features/a11y.feature +39 -0
package/tests/features/ajax-wait-examples.feature +24 -0
package/tests/features/api-step-definitions-individual.feature +185 -0
package/tests/features/complete-api-testing-examples.feature +205 -0
package/tests/features/cookie.feature +13 -0
package/tests/features/date.feature +11 -0
package/tests/features/dynamic-content-examples.feature +156 -0
package/tests/features/element.feature +16 -0
package/tests/features/field.feature +25 -0
package/tests/features/keyboard.feature +10 -0
package/tests/features/link.feature +11 -0
package/tests/features/modal-advanced-example.feature +54 -0
package/tests/features/modal-basic-example.feature +42 -0
package/tests/features/modal-error-handling-example.feature +37 -0
package/tests/features/modal.feature +11 -0
package/tests/features/path.feature +16 -0
package/tests/features/response.feature +8 -0
package/tests/features/responsive.feature +10 -0
package/tests/features/table.feature +18 -0
package/tests/features/test--given--i-am-an-anonymous-user.feature +10 -0
package/tests/features/test--given--i-am-on-homepage.feature +16 -0
package/tests/features/test--then--i-save-screenshot.feature +33 -0
package/tests/features/test--then--i-see-locator.feature +320 -0
package/tests/features/test--then--i-should--not--see-text-in-element.feature +13 -0
package/tests/features/test--then--i-should--see-text-in-element-by-attr.feature +10 -0
package/tests/features/test--then--i-should--see-text-in-element.feature +10 -0
package/tests/features/test--then--i-should--see-text-matching-pattern-in-element.feature +13 -0
package/tests/features/test--then--i-should--see-text-matching-pattern.feature +18 -0
package/tests/features/test--then--i-should-be-on-page.feature +10 -0
package/tests/features/test--then--i-should-be-on-the-homepage.feature +10 -0
package/tests/features/test--then--i-should-not-see-an-element-by-attr.feature +8 -0
package/tests/features/test--then--i-should-not-see-an-element.feature +8 -0
package/tests/features/test--then--i-should-see-an-element-by-attr.feature +8 -0
package/tests/features/test--then--i-should-see-an-element.feature +8 -0
package/tests/features/test--then--i-should-see-n-elements.feature +24 -0
package/tests/features/test--then--i-should-see-text-in-table-row.feature +96 -0
package/tests/features/test--then--print-current-url-and-response.feature +21 -0
package/tests/features/test--then--the-checkbox-is-checked.feature +18 -0
package/tests/features/test--then--the-checkbox-should-be-checked.feature +16 -0
package/tests/features/test--then--the-element-should-contain-cssproperty.feature +9 -0
package/tests/features/test--then--the-element-should-not-contain-cssproperty.feature +10 -0
package/tests/features/test--then--the-field-should-contain-value.feature +11 -0
package/tests/features/test--then--the-response-should-contain.feature +11 -0
package/tests/features/test--then--the-response-status-code-should-be.feature +31 -0
package/tests/features/test--then--the-url-should-match.feature +7 -0
package/tests/features/test--then-the-link-should-contain-by-attribute.feature +18 -0
package/tests/features/test--then-the-link-should-contain.feature +7 -0
package/tests/features/test--when--i-additionally-select.feature +30 -0
package/tests/features/test--when--i-attach-file-to-feild.feature +9 -0
package/tests/features/test--when--i-check-checkbox.feature +21 -0
package/tests/features/test--when--i-click-link-by-attribute.feature +21 -0
package/tests/features/test--when--i-click-link.feature +9 -0
package/tests/features/test--when--i-click-text-in-table-row.feature +37 -0
package/tests/features/test--when--i-fill-in-by-attr.feature +31 -0
package/tests/features/test--when--i-fill-in-table-by-attr.feature +19 -0
package/tests/features/test--when--i-fill-in.feature +32 -0
package/tests/features/test--when--i-follow.feature +22 -0
package/tests/features/test--when--i-go-to-homepage.feature +9 -0
package/tests/features/test--when--i-move-forward-backward-one-page.feature +14 -0
package/tests/features/test--when--i-press-button-by-attribute.feature +18 -0
package/tests/features/test--when--i-press-button.feature +13 -0
package/tests/features/test--when--i-reload-page.feature +11 -0
package/tests/features/test--when--i-scroll-left-right.feature +48 -0
package/tests/features/test--when--i-scroll.feature +48 -0
package/tests/features/test--when--i-select-option-from-dropdownlist.feature +21 -0
package/tests/features/test--when--i-select-radio-button.feature +37 -0
package/tests/features/test--when--i-wait-page-is-loaded.feature +8 -0
package/tests/features/test--when--i-wait-time.feature +21 -0
package/tests/features/video.feature +18 -0
package/tests/features/wait.feature +7 -0
package/tests/features/yaml.feature +102 -0
package/tests/selectors/_canonical-keys.json +113 -0
package/tests/selectors/back-end-selectors.json +19 -0
package/tests/selectors/cms-contentful-admin.json +35 -0
package/tests/selectors/cms-craft-admin.json +39 -0
package/tests/selectors/cms-drupal-cms-gin.json +56 -0
package/tests/selectors/cms-drupal-core-claro.json +50 -0
package/tests/selectors/cms-generic-admin.json +34 -0
package/tests/selectors/cms-ghost-admin.json +34 -0
package/tests/selectors/cms-joomla-admin.json +41 -0
package/tests/selectors/cms-magento2-admin.json +32 -0
package/tests/selectors/cms-prestashop-admin.json +38 -0
package/tests/selectors/cms-shopify-admin.json +25 -0
package/tests/selectors/cms-strapi-admin.json +42 -0
package/tests/selectors/cms-typo3-admin.json +41 -0
package/tests/selectors/cms-woocommerce-front.json +50 -0
package/tests/selectors/cms-wordpress-admin.json +31 -0
package/tests/selectors/framework-ant-design.json +80 -0
package/tests/selectors/framework-bootstrap.json +86 -0
package/tests/selectors/framework-bulma.json +74 -0
package/tests/selectors/framework-chakra.json +58 -0
package/tests/selectors/framework-foundation.json +51 -0
package/tests/selectors/framework-material-ui.json +72 -0
package/tests/selectors/framework-shadcn.json +51 -0
package/tests/selectors/framework-tailwind.json +40 -0
package/tests/selectors/framework-vuetify.json +61 -0
package/tests/selectors/front-end-selectors.json +16 -0
package/tests/selectors/homepage-selectors.json +13 -0
package/tests/step-definitions/a11y.steps.js +800 -0
package/tests/step-definitions/action.steps.js +167 -0
package/tests/step-definitions/api.steps.js +732 -0
package/tests/step-definitions/assertion.steps.js +352 -0
package/tests/step-definitions/auth.steps.js +126 -0
package/tests/step-definitions/clock.steps.js +128 -0
package/tests/step-definitions/cookie.steps.js +216 -0
package/tests/step-definitions/debug.steps.js +39 -0
package/tests/step-definitions/dialog.steps.js +193 -0
package/tests/step-definitions/drupal-canvas.steps.js +764 -0
package/tests/step-definitions/drupal-ckeditor.steps.js +108 -0
package/tests/step-definitions/drupal-core.steps.js +665 -0
package/tests/step-definitions/drupal-helpers.js +371 -0
package/tests/step-definitions/drupal-layout-builder.steps.js +466 -0
package/tests/step-definitions/drupal-media.steps.js +99 -0
package/tests/step-definitions/drupal-moderation.steps.js +71 -0
package/tests/step-definitions/drupal-paragraphs.steps.js +50 -0
package/tests/step-definitions/element.steps.js +356 -0
package/tests/step-definitions/field.steps.js +653 -0
package/tests/step-definitions/file-download.steps.js +211 -0
package/tests/step-definitions/form.steps.js +333 -0
package/tests/step-definitions/iframe.steps.js +228 -0
package/tests/step-definitions/input.steps.js +202 -0
package/tests/step-definitions/javascript.steps.js +232 -0
package/tests/step-definitions/keyboard.steps.js +112 -0
package/tests/step-definitions/link.steps.js +142 -0
package/tests/step-definitions/metatag.steps.js +91 -0
package/tests/step-definitions/modal.steps.js +244 -0
package/tests/step-definitions/navigation.steps.js +218 -0
package/tests/step-definitions/network.steps.js +280 -0
package/tests/step-definitions/path.steps.js +141 -0
package/tests/step-definitions/response.steps.js +98 -0
package/tests/step-definitions/responsive.steps.js +125 -0
package/tests/step-definitions/rest.steps.js +111 -0
package/tests/step-definitions/screenshot.steps.js +423 -0
package/tests/step-definitions/scroll.steps.js +189 -0
package/tests/step-definitions/selectors.steps.js +1003 -0
package/tests/step-definitions/storage.steps.js +194 -0
package/tests/step-definitions/table.steps.js +181 -0
package/tests/step-definitions/varbase-e2e.js +897 -0
package/tests/step-definitions/varbase.steps.js +458 -0
package/tests/step-definitions/video.steps.js +178 -0
package/tests/step-definitions/wait.steps.js +400 -0
package/tests/step-definitions/web-first.steps.js +298 -0
package/tests/step-definitions/xml.steps.js +411 -0
package/tests/step-definitions/yaml.steps.js +913 -0
package/tsconfig.json +26 -0

package/tests/step-definitions/storage.steps.js ADDED Viewed

@@ -0,0 +1,194 @@
+'use strict';
+// Cookie / local storage / session storage manipulation steps.
+//
+// Pre-seed per-scenario state without going through the UI. Useful for
+// onboarding flags, A/B-test bucket assignments, feature toggles, language
+// preferences, and any cookie-driven server behaviour.
+//
+// Cookies are scoped to the current page's domain (or `localhost` if no page
+// is loaded yet). Local storage and session storage are scoped to the current
+// page's origin and require a navigated page first.
+const { Given } = require('@cucumber/cucumber');
+// ---------------------------------------------------------------------------
+// Cookies — context-level
+// ---------------------------------------------------------------------------
+/**
+ * Set a cookie on the current browser context.
+ *
+ * Example #1: Given the cookie "session" is set to "abc123"
+ * Example #2: Given the cookie "lang" is set to "en"
+ * Example #3: Given cookie "ab_bucket" is set to "variant-b"
+ * Example #4: Given the cookie "consent" is set to "accepted"
+ *               And I am on the homepage
+ * Example #5: Given the cookie "feature_flag" is set to "enabled"
+ *               And I am on "/dashboard"
+ *
+ */
+Given(/^(?:the cookie|cookie) "([^"]*)" is set to "([^"]*)"$/, async function (name, value) {
+  const url = this.page.url() && this.page.url() !== 'about:blank' ? this.page.url() : (this.launchUrl || 'http://localhost');
+  const u = new URL(url);
+  await this.context.addCookies([{
+    name,
+    value,
+    domain: u.hostname,
+    path: '/',
+  }]);
+});
+/**
+ * Remove a single cookie by name (other cookies preserved).
+ *
+ * Example #1: Given the cookie "session" is removed
+ * Example #2: Given the cookie "consent" is removed
+ *               When I reload the page
+ *               Then I should see "Accept cookies"
+ * Example #3: Given the cookie "ab_bucket" is removed
+ * Example #4: Given the cookie "lang" is removed
+ *               And I am on the homepage
+ * Example #5: Given the cookie "feature_flag" is removed
+ *               When I follow "Pricing"
+ *
+ */
+Given(/^the cookie "([^"]*)" is removed$/, async function (name) {
+  const cookies = await this.context.cookies();
+  const remaining = cookies.filter((c) => c.name !== name);
+  await this.context.clearCookies();
+  if (remaining.length) await this.context.addCookies(remaining);
+});
+/**
+ * Wipe every cookie on the browser context.
+ *
+ * Example #1: Given all cookies are cleared
+ * Example #2: Given all cookies are cleared
+ *               When I am on the homepage
+ *               Then I should see "Sign in"
+ * Example #3: Given all cookies are cleared
+ *               And I am an anonymous user
+ * Example #4: Given all cookies are cleared
+ *               And localStorage is cleared
+ *               And sessionStorage is cleared
+ * Example #5: Given all cookies are cleared
+ *               When I follow "Login"
+ *
+ */
+Given(/^all cookies are cleared$/, async function () {
+  await this.context.clearCookies();
+});
+// ---------------------------------------------------------------------------
+// localStorage / sessionStorage — page-level
+// ---------------------------------------------------------------------------
+/**
+ * Set a local storage entry on the current page.
+ *
+ * The page must be loaded first (local storage is per-origin). Stored value
+ * is always a string — JSON-encode complex objects manually.
+ *
+ * Example #1: Given the local storage "user" is set to "Alice"
+ * Example #2: Given I am on the homepage
+ *               And the local storage "theme" is set to "dark"
+ *               When I reload the page
+ *               Then "<body>" should have class "theme-dark"
+ * Example #3: Given local storage "lang" is set to "fr"
+ * Example #4: Given the local storage "onboarding_complete" is set to "true"
+ *               And I am on "/dashboard"
+ *               Then I should not see "Welcome tour"
+ * Example #5: Given the local storage "feature_flag" is set to "enabled"
+ *
+ */
+Given(/^(?:the )?local storage "([^"]*)" is set to "([^"]*)"$/, async function (key, value) {
+  await this.page.evaluate(({ k, v }) => localStorage.setItem(k, v), { k: key, v: value });
+});
+/**
+ * Remove a single local storage entry.
+ *
+ * Example #1: Given the local storage "user" is removed
+ * Example #2: Given local storage "theme" is removed
+ *               When I reload the page
+ *               Then "<body>" should not have class "theme-dark"
+ * Example #3: Given the local storage "onboarding_complete" is removed
+ * Example #4: Given the local storage "cart" is removed
+ *               And I am on "/cart"
+ *               Then I should see "Your cart is empty"
+ * Example #5: Given the local storage "auth_token" is removed
+ *
+ */
+Given(/^(?:the )?local storage "([^"]*)" is removed$/, async function (key) {
+  await this.page.evaluate((k) => localStorage.removeItem(k), key);
+});
+/**
+ * Wipe local storage for the current origin.
+ *
+ * Example #1: Given local storage is cleared
+ * Example #2: Given I am on the homepage
+ *               And local storage is cleared
+ *               When I reload the page
+ * Example #3: Given local storage is cleared
+ *               And all cookies are cleared
+ * Example #4: Given local storage is cleared
+ *               And session storage is cleared
+ * Example #5: Given local storage is cleared
+ *               Then I should see "First-time visitor"
+ *
+ */
+Given(/^local storage is cleared$/, async function () {
+  await this.page.evaluate(() => localStorage.clear());
+});
+/**
+ * Set a session storage entry on the current page.
+ *
+ * Example #1: Given the session storage "checkout step" is set to "2"
+ * Example #2: Given the session storage "temp form" is set to "draft"
+ * Example #3: Given session storage "tab id" is set to "tab-1"
+ * Example #4: Given the session storage "wizard progress" is set to "3/5"
+ *               And I am on "/wizard"
+ * Example #5: Given the session storage "from checkout" is set to "true"
+ *               And I am on "/cart"
+ *
+ */
+Given(/^(?:the )?session storage "([^"]*)" is set to "([^"]*)"$/, async function (key, value) {
+  await this.page.evaluate(({ k, v }) => sessionStorage.setItem(k, v), { k: key, v: value });
+});
+/**
+ * Remove a single session storage entry.
+ *
+ * Example #1: Given the session storage "checkout step" is removed
+ * Example #2: Given session storage "temp form" is removed
+ * Example #3: Given the session storage "wizard progress" is removed
+ *               When I reload the page
+ *               Then I should see "Step 1"
+ * Example #4: Given the session storage "tab id" is removed
+ * Example #5: Given the session storage "from checkout" is removed
+ *
+ */
+Given(/^(?:the )?session storage "([^"]*)" is removed$/, async function (key) {
+  await this.page.evaluate((k) => sessionStorage.removeItem(k), key);
+});
+/**
+ * Wipe session storage for the current origin.
+ *
+ * Example #1: Given session storage is cleared
+ * Example #2: Given session storage is cleared
+ *               And local storage is cleared
+ * Example #3: Given session storage is cleared
+ *               And all cookies are cleared
+ * Example #4: Given session storage is cleared
+ *               When I reload the page
+ * Example #5: Given session storage is cleared
+ *               And I am an anonymous user
+ *
+ */
+Given(/^session storage is cleared$/, async function () {
+  await this.page.evaluate(() => sessionStorage.clear());
+});

package/tests/step-definitions/table.steps.js ADDED Viewed

@@ -0,0 +1,181 @@
+'use strict';
+// Inspect and assert HTML table contents.
+const { Then } = require('@cucumber/cucumber');
+const assert = require('assert');
+async function getTable(page, sel) {
+  return await page.locator(sel).first().evaluate((tbl) => {
+    const rows = Array.from(tbl.querySelectorAll('tr'));
+    const head = Array.from((tbl.querySelector('thead') || tbl).querySelectorAll('th')).map((c) => c.textContent.trim());
+    const body = rows
+      .filter((r) => r.querySelector('td'))
+      .map((r) => Array.from(r.querySelectorAll('td')).map((c) => c.textContent.trim()));
+    return { head, body, rowCount: body.length, colCount: (body[0] || head).length };
+  });
+}
+/**
+ * Assert a table has exactly N body rows.
+ *
+ * Example #1: Then the table "#users" should have 5 rows
+ * Example #2: Then the table "table.orders" should have 1 row
+ * Example #3: And the table "[data-testid=products]" should have 12 rows
+ * Example #4: Then the table "#audit-log" should have 0 rows
+ * Example #5: Then the table "table.responsive" should have 20 rows
+ *
+ */
+Then('the table {string} should have {int} row(s)', async function (sel, count) {
+  const t = await getTable(this.page, sel);
+  assert.strictEqual(t.rowCount, count, `Table "${sel}" has ${t.rowCount} rows, expected ${count}.`);
+});
+/**
+ * Assert a table has exactly N columns.
+ *
+ * Example #1: Then the table "#users" should have 4 columns
+ * Example #2: Then the table "table.orders" should have 6 columns
+ * Example #3: And the table "[data-testid=products]" should have 5 columns
+ * Example #4: Then the table "#summary" should have 2 columns
+ * Example #5: Then the table "table.responsive" should have 8 columns
+ *
+ */
+Then('the table {string} should have {int} column(s)', async function (sel, count) {
+  const t = await getTable(this.page, sel);
+  assert.strictEqual(t.colCount, count, `Table "${sel}" has ${t.colCount} columns, expected ${count}.`);
+});
+/**
+ * Assert the table header contains every column listed in the table.
+ *
+ * Example #1: Then the table "#users" should contain the following columns:
+ *               | Name |
+ *               | Email |
+ * Example #2: Then the table "table.orders" should contain the following columns:
+ *               | Order ID | Status | Total |
+ * Example #3: And the table "[data-testid=products]" should contain the following columns:
+ *               | Title | Price | Stock |
+ * Example #4: Then the table "#audit-log" should contain the following columns:
+ *               | Timestamp | Actor | Action |
+ * Example #5: Then the table ".grid" should contain the following columns:
+ *               | Country | Population | Capital |
+ *
+ */
+Then('the table {string} should contain the following columns:', async function (sel, table) {
+  const t = await getTable(this.page, sel);
+  const want = table.raw().flat();
+  for (const col of want) {
+    assert.ok(t.head.includes(col), `Column "${col}" not found in [${t.head.join(', ')}].`);
+  }
+});
+/**
+ * Assert a table has zero body rows.
+ *
+ * Example #1: Then the table "#users" should be empty
+ * Example #2: Then the table "table.orders" should be empty
+ * Example #3: And the table "[data-testid=products]" should be empty
+ * Example #4: Then the table "#audit-log" should be empty
+ * Example #5: Then the table ".grid" should be empty
+ *
+ */
+Then('the table {string} should be empty', async function (sel) {
+  const t = await getTable(this.page, sel);
+  assert.strictEqual(t.rowCount, 0, `Table "${sel}" should be empty.`);
+});
+/**
+ * Assert a table has at least one body row.
+ *
+ * Example #1: Then the table "#users" should not be empty
+ * Example #2: Then the table "table.orders" should not be empty
+ * Example #3: And the table "[data-testid=products]" should not be empty
+ * Example #4: Then the table "#audit-log" should not be empty
+ * Example #5: Then the table ".grid" should not be empty
+ *
+ */
+Then('the table {string} should not be empty', async function (sel) {
+  const t = await getTable(this.page, sel);
+  assert.ok(t.rowCount > 0, `Table "${sel}" should not be empty.`);
+});
+/**
+ * Assert a table is sorted ascending or descending by a header.
+ *
+ * Direction accepts `ascending` / `asc` / `descending` / `desc`.
+ *
+ * Example #1: Then the table "#users" should be sorted by "Name" in "ascending" order
+ * Example #2: Then the table "table.orders" should be sorted by "Total" in "descending" order
+ * Example #3: And the table "[data-testid=products]" should be sorted by "Price" in "asc" order
+ * Example #4: Then the table "#audit-log" should be sorted by "Timestamp" in "desc" order
+ * Example #5: Then the table ".grid" should be sorted by "Country" in "ascending" order
+ *
+ */
+Then('the table {string} should be sorted by {string} in {string} order', async function (sel, column, direction) {
+  const t = await getTable(this.page, sel);
+  const idx = t.head.findIndex((h) => h === column);
+  assert.ok(idx !== -1, `Column "${column}" not found.`);
+  const values = t.body.map((r) => r[idx]);
+  const sorted = [...values].sort();
+  if (direction.toLowerCase() === 'descending' || direction.toLowerCase() === 'desc') sorted.reverse();
+  assert.deepStrictEqual(values, sorted, `Table "${sel}" not sorted by "${column}" ${direction}.`);
+});
+/**
+ * Assert a table contains every row described by the data table (substring match per cell).
+ *
+ * Example #1: Then the table "#users" should contain the following rows:
+ *               | Alice | Editor |
+ *               | Bob   | Admin  |
+ * Example #2: Then the table "table.orders" should contain the following rows:
+ *               | 1234 | Shipped   |
+ *               | 5678 | Cancelled |
+ * Example #3: And the table "[data-testid=products]" should contain the following rows:
+ *               | Laptop | $999.00 |
+ * Example #4: Then the table "#audit-log" should contain the following rows:
+ *               | login |
+ * Example #5: Then the table ".grid" should contain the following rows:
+ *               | Jordan | Amman |
+ *
+ */
+Then('the table {string} should contain the following rows:', async function (sel, table) {
+  const t = await getTable(this.page, sel);
+  for (const row of table.raw()) {
+    const found = t.body.some((br) => row.every((cell) => br.some((bc) => bc.indexOf(cell) !== -1)));
+    assert.ok(found, `Row ${JSON.stringify(row)} not found in table.`);
+  }
+});
+/**
+ * Assert a row containing a given text fragment also contains every listed cell value.
+ *
+ * Example #1: Then the "Alice" row should contain the following:
+ *               | Editor |
+ *               | Active |
+ * Example #2: Then the "Order #1234" row should contain the following:
+ *               | Shipped |
+ * Example #3: And the "Project Alpha" row should contain the following:
+ *               | Open    |
+ *               | High    |
+ * Example #4: Then the "alice@example.com" row should contain the following:
+ *               | Admin |
+ * Example #5: Then the "Premium" row should contain the following:
+ *               | $99 |
+ *
+ */
+Then('the {string} row should contain the following:', async function (rowText, table) {
+  const cells = table.raw().flat();
+  // Find a tr whose text contains rowText.
+  const trs = await this.page.locator('tr').all();
+  let match = null;
+  for (const tr of trs) {
+    const txt = await tr.innerText();
+    if (txt.indexOf(rowText) !== -1) { match = tr; break; }
+  }
+  assert.ok(match, `No row matching "${rowText}" was found.`);
+  const text = await match.innerText();
+  for (const c of cells) {
+    assert.ok(text.indexOf(c) !== -1, `Row "${rowText}" does not contain "${c}".`);
+  }
+});