artes 1.5.11 → 1.6.1

package/README.md

@@ -627,7 +627,7 @@ Artes supports environment-specific configurations through environment variables
 
 Artes can generate Allure reports. After running tests with the `-r` flag, the reports will be stored in the `report` folder in HTML format. You can view them in your browser after the tests complete.
 
-## 📊 Integration with Artes Reporting System
+### Integration with Artes Reporting System
 
 Artes has a built-in integration with the Artes Reporting System. By configuring the options below, you can automatically upload your test reports and keep your pipeline stages clean and organized.
 
@@ -656,7 +656,7 @@ To achieve the best video recording quality, use the following command:
 xvfb-run -a --server-args="-screen 0 3840x1180x24" --auto-servernum npx artes --width 1600 --height 900
 ```
 
-### 🔬 CI/CD Executor on Report
+### CI/CD Executor on Report
 
 Artes automatically detects your CI/CD environment and displays executor information — pipeline name, build number, and a direct link to the build — on the generated report.
 

package/docs/stepDefinitions.md

@@ -4,6 +4,7 @@
 
 - [Mouse Actions](#mouse-actions)
 - [Keyboard Actions](#keyboard-actions)
+- [Browser Actions](#browser-actions)
 - [Page Actions](#page-actions)
 - [Frame Actions](#frame-actions)
 - [API Actions](#api-actions)
@@ -107,6 +108,30 @@
 - User releases `{string}`
 - User presses `{string}`
 
+# Browser Actions
+
+## Cookie Actions
+
+- User sets `{string}` cookies
+
+## Accessibility Actions
+
+### Full Page Checks
+- User checks accessibility of current page
+- User checks accessibility of `{string}` page
+
+### Element Checks
+- User checks accessibility of `{string}` element
+- User checks accessibility of `{string}` element on the `{string}` page
+
+### WCAG-Specific Checks
+> For valid WCAG tags, refer to the [axe-core Tags Documentation](https://www.deque.com/axe/core-documentation/api-documentation/#axecore-tags)
+
+- User checks accessibility of current page due to `{string}` WCAG
+- User checks accessibility of `{string}` page due to `{string}` WCAG
+- User checks accessibility of `{string}` element due to `{string}` WCAG
+- User checks accessibility of `{string}` element on the `{string}` page due to `{string}` WCAG
+
 ---
 
 # Page Actions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "artes",
-  "version": "1.5.11",
+  "version": "1.6.1",
   "description": "The simplest way to automate UI and API tests using Cucumber-style steps.",
   "main": "index.js",
   "scripts": {
@@ -29,6 +29,7 @@
     "dayjs": "1.11.13",
     "deasync": "^0.1.31",
     "playwright": "^1.58.2",
+    "@axe-core/playwright": "^4.11.1",
     "ffmpeg-static": "^5.3.0",
     "ffprobe-static": "^3.1.0",
     "pixelmatch": "^5.3.0",

package/src/helper/controller/reportUploader.js

@@ -17,7 +17,7 @@ async function uploadReport({
   formData.append("project", projectName);
   formData.append("type", projectType);
 
-  const response = await fetch(`${reporterURL}/api/report`, {
+  const response = await fetch(reporterURL, {
     method: "POST",
     body: formData,
   });

package/src/helper/controller/validateWCAGTags .js

@@ -0,0 +1,52 @@
+const EXACT_TAGS = new Set([
+  'wcag2a', 'wcag2aa', 'wcag2aaa',
+  'wcag21a', 'wcag21aa',
+  'wcag22aa',
+  'best-practice',
+  'wcag2a-obsolete',
+  'ACT',
+  'section508',
+  'TTv5',
+  'EN-301-549',
+  'RGAAv4',
+  'experimental'
+]);
+
+const PATTERN_TAGS = [
+  /^wcag\d{3,}$/,       
+  /^section508\.\d+\.\d+$/, 
+  /^TT\d+\.\d+$/,       
+  /^EN-9\.\d+(\.\d+)*$/, 
+  /^RGAA-\d+\.\d+\.\d+$/, 
+  /^cat\..+$/           
+];
+
+const isValidTag = (tag) => {
+  if (EXACT_TAGS.has(tag)) return true;
+  return PATTERN_TAGS.some(pattern => pattern.test(tag));
+};
+
+const validateWCAGTags = (tags) => {
+  const normalized = tags.split(",").map(tag => tag.trim());
+
+  if (normalized.length === 0) {
+    throw new Error('At least one WCAG tag must be provided.');
+  }
+
+  const invalid = normalized.filter(tag => !isValidTag(tag));
+
+  if (invalid.length > 0) {
+    throw new Error(
+      `Invalid WCAG tag(s): "${invalid.join('", "')}"\n` +
+      `Valid tags: wcag2a, wcag2aa, wcag2aaa, wcag21a, wcag21aa, wcag22aa, ` +
+      `best-practice, wcag2a-obsolete, wcag111 (SC pattern), ACT, section508, ` +
+      `section508.x.x, TTv5, TT*.*, EN-301-549, EN-9.*, RGAAv4, RGAA-*.*.*, ` +
+      `experimental, cat.* `+
+      `For more information: https://www.deque.com/axe/core-documentation/api-documentation/#axecore-tags`
+    );
+  }
+
+  return normalized;
+};
+
+module.exports = { validateWCAGTags };

package/src/helper/stepFunctions/browserActions.js

@@ -1,4 +1,16 @@
-const { context, selector, resolveVariable } = require("../imports/commons");
+const { page: p } = require("artes/src/helper/stepFunctions/pageActions");
+const {
+  context,
+  resolveVariable,
+  expect,
+  selector,
+} = require("../imports/commons");
+const { AxeBuilder } = require("@axe-core/playwright");
+const {
+  validateWCAGTags,
+} = require("artes/src/helper/controller/validateWCAGTags ");
+require("allure-cucumberjs");
+const allure = require("allure-js-commons");
 
 const browser = {
   setCookies: async (cookies) => {
@@ -15,6 +27,59 @@ const browser = {
 
     await context.browserContext.addCookies(cookieData);
   },
+  checkAccessibilityOfPage: async (page, url, element) => {
+    if (url) {
+      await p.navigateTo(url);
+    }
+
+    if (element) {
+      element = await selector(element);
+      await page.locator(element).waitFor();
+    }
+
+    const accessibilityScanResults = await new AxeBuilder({ page })
+      .include(element)
+      .analyze();
+    await allure.attachment(
+      "Accessibility Results",
+      JSON.stringify(accessibilityScanResults, null, 2),
+      "application/json",
+    );
+
+    try {
+      expect(accessibilityScanResults.violations).toEqual([]);
+    } catch (e) {
+      e.name = "AssertionError";
+      throw e;
+    }
+  },
+  checkAccessibilityOfPageDueToWCAG: async (page, url, element, tags) => {
+    if (url) {
+      await p.navigateTo(url);
+    }
+
+    if (element) {
+      element = await selector(element);
+      await page.locator(element).waitFor();
+    }
+    if (tags) {
+      tags = validateWCAGTags(tags);
+    }
+
+    expect(accessibilityScanResults.violations).toEqual([]);
+    await allure.attachment(
+      "Accessibility Results",
+      JSON.stringify(accessibilityScanResults, null, 2),
+      "application/json",
+    );
+
+    try {
+      expect(accessibilityScanResults.violations).toEqual([]);
+    } catch (e) {
+      e.name = "AssertionError";
+      throw e;
+    }
+  },
 };
 
 module.exports = {

package/src/stepDefinitions/browser.steps.js

@@ -1,7 +1,74 @@
-const { When } = require("../helper/imports/commons");
+const { When, context } = require("../helper/imports/commons");
 const { browser } = require("../helper/stepFunctions/exporter");
 
 // User sets cookies in json format
 When("User sets {string} cookies", async function (cookies) {
   await browser.setCookies(cookies);
 });
+
+When("User checks accessibility of current page", async function () {
+  await browser.checkAccessibilityOfPage(context.page, null, null);
+});
+
+When("User checks accessibility of {string} page", async function (url) {
+  await browser.checkAccessibilityOfPage(context.page, url, null);
+});
+
+When("User checks accessibility of {string} element", async function (element) {
+  await browser.checkAccessibilityOfPage(context.page, null, element);
+});
+
+When(
+  "User checks accessibility of {string} element on the {string} page",
+  async function (element, url) {
+    await browser.checkAccessibilityOfPage(context.page, url, element);
+  },
+);
+
+When(
+  "User checks accessibility of current page due to {string} WCAG",
+  async function (wcag) {
+    await browser.checkAccessibilityOfPageDueToWCAG(
+      context.page,
+      null,
+      null,
+      wcag,
+    );
+  },
+);
+
+When(
+  "User checks accessibility of {string} page due to {string} WCAG",
+  async function (url, wcag) {
+    await browser.checkAccessibilityOfPageDueToWCAG(
+      context.page,
+      url,
+      null,
+      wcag,
+    );
+  },
+);
+
+When(
+  "User checks accessibility of {string} element due to {string} WCAG",
+  async function (element, wcag) {
+    await browser.checkAccessibilityOfPageDueToWCAG(
+      context.page,
+      null,
+      element,
+      wcag,
+    );
+  },
+);
+
+When(
+  "User checks accessibility of {string} element on the {string} page due to {string} WCAG",
+  async function (element, url, wcag) {
+    await browser.checkAccessibilityOfPageDueToWCAG(
+      context.page,
+      url,
+      element,
+      wcag,
+    );
+  },
+);