174 |
175 |
176 |
179 |
180 |
181 |
182 | `
183 |
184 | // Write the HTML report to a file
185 | const htmlContent = generateHTML(findings)
186 | writeFileSync(htmlOututPath, htmlContent, 'utf-8')
187 | console.log('Data analysis report generated successfully')
188 | }
--------------------------------------------------------------------------------
/src/helper/api/apiHelper.ts:
--------------------------------------------------------------------------------
1 | import { Helper } from "@src/helper/Helper";
2 | import type { APIRequestContext, APIResponse } from "@playwright/test";
3 | import { ApiError } from "@src/utils/error/ErrorManager";
4 | import { validateSchema } from 'playwright-ajv-schema-validator';
5 | import { step } from "@src/utils/report/ReportAction";
6 | import { logError, logInfo } from "@src/utils/report/Logger";
7 |
8 | enum methodType {
9 | GET = "get",
10 | POST = "post",
11 | DELETE = "delete",
12 | PUT = "put",
13 | PATCH = "patch",
14 | HEAD = "head",
15 | }
16 |
17 | const BASE_URL = "https://restful-booker.herokuapp.com";
18 |
19 | export class ApiHelper extends Helper {
20 | private readonly apiRequest: APIRequestContext;
21 | private readonly retries: number;
22 | private readonly timeout: number;
23 |
24 |
25 | /**
26 | * The constructor function initializes a new context for the API.
27 | * @param {any} apiContext - The `apiContext` parameter is an object that represents the context of an
28 | * API. It is used to store and manage information related to the API, such as authentication
29 | * credentials, request headers, and other configuration settings.
30 | */
31 | constructor(apiRequest: APIRequestContext, config?: { timeout?: number; retries?: number }) {
32 | super();
33 | this.apiRequest = apiRequest;
34 | this.timeout = config?.timeout || 30000;
35 | this.retries = config?.retries || 3;
36 | }
37 |
38 |
39 | /**
40 | * Simplified helper for making API requests and returning the status and JSON body.
41 | * This helper automatically performs the request based on the provided method, URL, body, and headers.
42 | *
43 | * @param {string} params.method - The HTTP method to use (POST, GET, PUT, DELETE).
44 | * @param {string} params.url - The URL to send the request to.
45 | * @param {string} [params.baseUrl] - The base URL to prepend to the request URL.
46 | * @param {Record | null} [params.body=null] - The body to send with the request (for POST and PUT requests).
47 | * @param {Record | undefined} [params.headers=undefined] - The headers to include with the request.
48 | * @returns {Promise<{ status: number; body: unknown }>} - An object containing the status code and the parsed response body.
49 | * - `status`: The HTTP status code returned by the server.
50 | * - `body`: The parsed JSON response body from the server.
51 | */
52 | @step('hitApiEndPoint')
53 | async hitApiEndPoint({
54 | method,
55 | endPoint,
56 | body = null,
57 | headers,
58 | statusCode
59 | }: { method: methodType, endPoint: string, body?: string | null, headers?: string, statusCode: number }): Promise<{ status: number, body: unknown }> {
60 |
61 | let response: APIResponse | null = null;
62 |
63 | const options: {
64 | data?: Record | null;
65 | headers?: Record;
66 | } = {};
67 |
68 | if (body) { options.data = body; }
69 |
70 | if (headers) {
71 | options.headers = {
72 | Authorization: `Token ${headers}`,
73 | "Content-Type": "application/json",
74 | };
75 | } else {
76 | options.headers = {
77 | "Content-Type": "application/json",
78 | };
79 | }
80 |
81 | switch (method.toLowerCase()) {
82 | case methodType.GET:
83 | response = await this.invokeGetApi(endPoint, options);
84 | break;
85 | case methodType.POST:
86 | response = await this.invokePostApi(endPoint, body, options);
87 | break;
88 | case methodType.DELETE:
89 | response = await this.invokeDeleteApi(endPoint, options);
90 | break;
91 | case methodType.PUT:
92 | response = await this.invokePutApi(endPoint, body, options);
93 | break;
94 | default:
95 | logError(`Unsupported operation type: ${method}`);
96 | }
97 |
98 | if (!response) {
99 | throw new ApiError(`No response received for method ${method} on ${endPoint}`);
100 | }
101 |
102 | if (!response.ok()) {
103 | const text = await response.text();
104 | new ApiError(
105 | `POST ${endPoint} failed: ${response.status()} ${response.statusText()} | body: ${text}`
106 | );
107 | }
108 | const status = response.status();
109 |
110 | let bodyData: unknown = null;
111 | const contentType = response.headers()["content-type"] || "";
112 |
113 | try {
114 | if (contentType.includes("application/json")) {
115 | bodyData = await response.json();
116 | } else if (contentType.includes("text/")) {
117 | bodyData = await response.text();
118 | }
119 | } catch (err) {
120 | console.warn(`Failed to parse response body for status ${status}: ${err}`);
121 | }
122 |
123 | return { status, body: bodyData };
124 | }
125 |
126 | @step('invokeGetApi')
127 | async invokeGetApi(endPoint: string, options: unknown): Promise {
128 | try {
129 | logInfo(`Making GET request to endPoint: ${BASE_URL}${endPoint} `);
130 | const response = await this.apiRequest.get(endPoint, options);
131 | return await response;
132 | } catch (error) {
133 | console.log(error);
134 | throw new ApiError("Get request failed");
135 | }
136 | }
137 |
138 | @step('invokeDeleteApi')
139 | async invokeDeleteApi(endPoint: string, options: unknown): Promise {
140 | let response;
141 | try {
142 | logInfo(
143 | `Making DELETE request to endPoint: ${BASE_URL}${endPoint} `
144 | );
145 | response = await this.apiRequest.delete(endPoint, options);
146 |
147 | return await response;
148 | } catch (error) {
149 | throw new ApiError("Delete request failed");
150 | }
151 | }
152 |
153 | /**
154 | * The function `invokePostApi` is an asynchronous function that sends a POST request to an API
155 | * endpoint with a payload and returns the response data.
156 | * @param {string} endPoint - The `endPoint` parameter is a string that represents the URL or endpoint
157 | * of the API you want to call.
158 | * @param {object} payload - The `payload` parameter is an object that contains the data to be sent in
159 | * the request body. It is typically used to send data to the server for processing or to update a
160 | * resource.
161 | * @returns the response data as a JSON object if the response status is 200. If there is an error, it
162 | * will return the error object.
163 | */
164 | @step('invokePostApi')
165 | async invokePostApi(
166 | endPoint: string,
167 | body: unknown,
168 | options: unknown,
169 | ): Promise {
170 | let response;
171 | try {
172 | logInfo(
173 | `Making POST request to endPoint: ${BASE_URL}${endPoint} `
174 | );
175 | const reqOptions: any = { ...(options as any) };
176 | if (body !== undefined && body !== null) {
177 | reqOptions.data = body;
178 | }
179 | response = await this.apiRequest.post(endPoint, reqOptions);
180 | return await response;
181 | } catch (error) {
182 | throw new ApiError("Post request failed");
183 | }
184 | }
185 |
186 | @step('invokePutApi')
187 | async invokePutApi(
188 | endPoint: string,
189 | payload: unknown,
190 | options: unknown,
191 | ): Promise {
192 | let response;
193 | try {
194 | logInfo(
195 | `Making PUT request to endPoint: ${BASE_URL}${endPoint} `
196 | );
197 | const reqOptions: any = { ...(options as any) };
198 | if (payload !== undefined && payload !== null) {
199 | reqOptions.data = payload;
200 | }
201 | response = await this.apiRequest.put(endPoint, reqOptions);
202 | return await response;
203 | } catch (error) {
204 | throw new ApiError("Post request failed");
205 | }
206 | }
207 |
208 | getResponseHeader(response:APIResponse){
209 | return response.headers()
210 | }
211 |
212 | validateSchema(response:APIResponse,schema:object){
213 |
214 | }
215 | }
216 |
217 |
218 |
--------------------------------------------------------------------------------
/logs/rejections.log:
--------------------------------------------------------------------------------
1 | {"date":"Sat Nov 08 2025 09:19:40 GMT+0530 (India Standard Time)","error":{},"level":"error","message":"unhandledRejection: columnHeaderText.textextContent is not a function\nTypeError: columnHeaderText.textextContent is not a function\n at eval (eval-31c3f682.repl:2:33)\n at textContent (eval-31c3f682.repl:3:3)\n at C:\\fastcode\\playwright-framework-template\\tests\\web\\example\\webTable.spec.ts:18:62\n at C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\workerMain.js:310:9\n at C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\testInfo.js:305:11\n at TimeoutManager.withRunnable (C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\timeoutManager.js:67:14)\n at TestInfoImpl._runWithTimeout (C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\testInfo.js:303:7)\n at C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\workerMain.js:308:7\n at WorkerMain._runTest (C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\workerMain.js:283:5)\n at WorkerMain.runTestGroup (C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\workerMain.js:198:11)\n at process. (C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\common\\process.js:65:22)","os":{"loadavg":[0,0,0],"uptime":782977.14},"process":{"argv":["C:\\Program Files\\nodejs\\node.exe","C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\common\\process.js"],"cwd":"C:\\fastcode\\playwright-framework-template","execPath":"C:\\Program Files\\nodejs\\node.exe","gid":null,"memoryUsage":{"arrayBuffers":1296009,"external":5094883,"heapTotal":70443008,"heapUsed":42648656,"rss":140890112},"pid":21108,"uid":null,"version":"v22.18.0"},"rejection":true,"service":"job-posting-service","stack":"TypeError: columnHeaderText.textextContent is not a function\n at eval (eval-31c3f682.repl:2:33)\n at textContent (eval-31c3f682.repl:3:3)\n at C:\\fastcode\\playwright-framework-template\\tests\\web\\example\\webTable.spec.ts:18:62\n at C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\workerMain.js:310:9\n at C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\testInfo.js:305:11\n at TimeoutManager.withRunnable (C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\timeoutManager.js:67:14)\n at TestInfoImpl._runWithTimeout (C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\testInfo.js:303:7)\n at C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\workerMain.js:308:7\n at WorkerMain._runTest (C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\workerMain.js:283:5)\n at WorkerMain.runTestGroup (C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\workerMain.js:198:11)\n at process. (C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\common\\process.js:65:22)","timestamp":"2025-11-08T03:49:40.835Z","trace":[{"column":33,"file":"eval-31c3f682.repl","function":"eval","line":2,"method":null,"native":false},{"column":3,"file":"eval-31c3f682.repl","function":"textContent","line":3,"method":null,"native":false},{"column":62,"file":"C:\\fastcode\\playwright-framework-template\\tests\\web\\example\\webTable.spec.ts","function":null,"line":18,"method":null,"native":false},{"column":9,"file":"C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\workerMain.js","function":null,"line":310,"method":null,"native":false},{"column":11,"file":"C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\testInfo.js","function":null,"line":305,"method":null,"native":false},{"column":14,"file":"C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\timeoutManager.js","function":"TimeoutManager.withRunnable","line":67,"method":"withRunnable","native":false},{"column":7,"file":"C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\testInfo.js","function":"TestInfoImpl._runWithTimeout","line":303,"method":"_runWithTimeout","native":false},{"column":7,"file":"C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\workerMain.js","function":null,"line":308,"method":null,"native":false},{"column":5,"file":"C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\workerMain.js","function":"WorkerMain._runTest","line":283,"method":"_runTest","native":false},{"column":11,"file":"C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\worker\\workerMain.js","function":"WorkerMain.runTestGroup","line":198,"method":"runTestGroup","native":false},{"column":22,"file":"C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\common\\process.js","function":null,"line":65,"method":null,"native":false}]}
2 | {"date":"Sat Nov 08 2025 09:22:59 GMT+0530 (India Standard Time)","error":{"name":"Error"},"level":"error","message":"unhandledRejection: locator.textContent: Error: strict mode violation: locator('//*[@id=\\'table1\\']').locator('thead').locator('tr').first().locator('th').locator('span') resolved to 6 elements:\n 1) Last Name aka locator('#table1').getByText('Last Name')\n 2) First Name aka locator('#table1').getByText('First Name')\n 3) Email aka locator('#table1').getByText('Email')\n 4) Due aka locator('#table1').getByText('Due')\n 5) Web Site aka locator('#table1').getByText('Web Site')\n 6) Action aka locator('#table1').getByText('Action')\n\nCall log:\n\u001b[2m - waiting for locator('//*[@id=\\'table1\\']').locator('thead').locator('tr').first().locator('th').locator('span')\u001b[22m\n\nlocator.textContent: Error: strict mode violation: locator('//*[@id=\\'table1\\']').locator('thead').locator('tr').first().locator('th').locator('span') resolved to 6 elements:\n 1) Last Name aka locator('#table1').getByText('Last Name')\n 2) First Name aka locator('#table1').getByText('First Name')\n 3) Email aka locator('#table1').getByText('Email')\n 4) Due aka locator('#table1').getByText('Due')\n 5) Web Site aka locator('#table1').getByText('Web Site')\n 6) Action aka locator('#table1').getByText('Action')\n\nCall log:\n\u001b[2m - waiting for locator('//*[@id=\\'table1\\']').locator('thead').locator('tr').first().locator('th').locator('span')\u001b[22m\n\n at eval (eval-b5eed3dc.repl:2:66)\n at nth (eval-b5eed3dc.repl:3:3)\n at C:\\fastcode\\playwright-framework-template\\tests\\web\\example\\webTable.spec.ts:17:47","os":{"loadavg":[0,0,0],"uptime":783175.89},"process":{"argv":["C:\\Program Files\\nodejs\\node.exe","C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\common\\process.js"],"cwd":"C:\\fastcode\\playwright-framework-template","execPath":"C:\\Program Files\\nodejs\\node.exe","gid":null,"memoryUsage":{"arrayBuffers":1313693,"external":5068800,"heapTotal":34476032,"heapUsed":32383224,"rss":107753472},"pid":8916,"uid":null,"version":"v22.18.0"},"rejection":true,"service":"job-posting-service","stack":"locator.textContent: Error: strict mode violation: locator('//*[@id=\\'table1\\']').locator('thead').locator('tr').first().locator('th').locator('span') resolved to 6 elements:\n 1) Last Name aka locator('#table1').getByText('Last Name')\n 2) First Name aka locator('#table1').getByText('First Name')\n 3) Email aka locator('#table1').getByText('Email')\n 4) Due aka locator('#table1').getByText('Due')\n 5) Web Site aka locator('#table1').getByText('Web Site')\n 6) Action aka locator('#table1').getByText('Action')\n\nCall log:\n\u001b[2m - waiting for locator('//*[@id=\\'table1\\']').locator('thead').locator('tr').first().locator('th').locator('span')\u001b[22m\n\n at eval (eval-b5eed3dc.repl:2:66)\n at nth (eval-b5eed3dc.repl:3:3)\n at C:\\fastcode\\playwright-framework-template\\tests\\web\\example\\webTable.spec.ts:17:47","timestamp":"2025-11-08T03:52:59.577Z","trace":[{"column":66,"file":"eval-b5eed3dc.repl","function":"eval","line":2,"method":null,"native":false},{"column":3,"file":"eval-b5eed3dc.repl","function":"nth","line":3,"method":null,"native":false},{"column":47,"file":"C:\\fastcode\\playwright-framework-template\\tests\\web\\example\\webTable.spec.ts","function":null,"line":17,"method":null,"native":false}]}
3 | {"date":"Sat Nov 08 2025 09:23:12 GMT+0530 (India Standard Time)","error":{},"level":"error","message":"unhandledRejection: locator.textContent: Test ended.\nCall log:\n\u001b[2m - waiting for locator('//*[@id=\\'table1\\']').locator('thead').locator('tr').first().locator('th').locator('span')\u001b[22m\n\nlocator.textContent: Test ended.\nCall log:\n\u001b[2m - waiting for locator('//*[@id=\\'table1\\']').locator('thead').locator('tr').first().locator('th').locator('span')\u001b[22m\n\n at C:\\fastcode\\playwright-framework-template\\tests\\web\\example\\webTable.spec.ts:17:84","os":{"loadavg":[0,0,0],"uptime":783188.687},"process":{"argv":["C:\\Program Files\\nodejs\\node.exe","C:\\fastcode\\playwright-framework-template\\node_modules\\playwright\\lib\\common\\process.js"],"cwd":"C:\\fastcode\\playwright-framework-template","execPath":"C:\\Program Files\\nodejs\\node.exe","gid":null,"memoryUsage":{"arrayBuffers":2182349,"external":5944843,"heapTotal":69562368,"heapUsed":38869160,"rss":139264000},"pid":17000,"uid":null,"version":"v22.18.0"},"rejection":true,"service":"job-posting-service","stack":"locator.textContent: Test ended.\nCall log:\n\u001b[2m - waiting for locator('//*[@id=\\'table1\\']').locator('thead').locator('tr').first().locator('th').locator('span')\u001b[22m\n\n at C:\\fastcode\\playwright-framework-template\\tests\\web\\example\\webTable.spec.ts:17:84","timestamp":"2025-11-08T03:53:12.381Z","trace":[{"column":84,"file":"C:\\fastcode\\playwright-framework-template\\tests\\web\\example\\webTable.spec.ts","function":null,"line":17,"method":null,"native":false}]}
4 |
--------------------------------------------------------------------------------
/Notes:
--------------------------------------------------------------------------------
1 | import { linkSync } from 'fs';
2 |
3 | /**
4 | * Extends Playwright locator with a helper function to find, store, and manage elements using different locator strategies
5 | * @param {import('@playwright/test').Page} page - Playwright page instance
6 | * @returns {Object} Helper object with locator methods
7 | */
8 | function createLocatorHelper(page) {
9 | // Internal storage for locators
10 | const locatorStorage = new Map();
11 |
12 | return {
13 | /**
14 | * Finds a single element using the specified locator strategy
15 | * Checks if element is displayed and enabled
16 | * Returns null if element is not found
17 | * @param {string} type - Locator type ('css', 'xpath', 'text', 'testid', 'role', 'label')
18 | * @param {string} value - Locator value
19 | * @param {Object} [options] - Optional locator options
20 | * @returns {Promise<{locator: import('@playwright/test').Locator, isDisplayed: boolean, isEnabled: boolean} | null>} Playwright locator with status or null
21 | */
22 | async findElement(type, value, options = {}) {
23 | try {
24 | let locator;
25 | switch (type.toLowerCase()) {
26 | case 'css':
27 | locator = page.locator(value, options);
28 | break;
29 | case 'xpath':
30 | locator = page.locator(`xpath=${value}`, options);
31 | break;
32 | case 'text':
33 | locator = page.getByText(value, options);
34 | break;
35 | case 'testid':
36 | locator = page.getByTestId(value, options);
37 | break;
38 | case 'role':
39 | locator = page.getByRole(value, options);
40 | break;
41 | case 'label':
42 | locator = page.getByLabel(value, options);
43 | break;
44 | default:
45 | console.warn(`Unsupported locator type: ${type}`);
46 | return null;
47 | }
48 |
49 | // Check if element exists
50 | const count = await locator.count();
51 | if (count === 0) {
52 | console.warn(`Element not found with ${type} locator: ${value}`);
53 | return null;
54 | }
55 |
56 | // Check visibility and enabled status
57 | const isDisplayed = await locator.isVisible();
58 | const isEnabled = await locator.isEnabled();
59 |
60 | return {
61 | locator,
62 | isDisplayed,
63 | isEnabled
64 | };
65 | } catch (error) {
66 | console.warn(`Error while finding element with ${type} locator: ${value}. Error: ${error.message}`);
67 | return null;
68 | }
69 | }
70 |
71 |
72 |
73 | /**
74 | * Waits for an element to be visible using the specified locator strategy
75 | * @param {string} type - Locator type
76 | * @param {string} value - Locator value
77 | * @param {Object} [options] - Optional locator options with timeout
78 | * @returns {Promise} Playwright locator
79 | */
80 | async waitForElement(type, value, options = { timeout: 5000 }) {
81 | try {
82 | const result = await this.findElement(type, value);
83 | if (!result) {
84 | throw new Error(`Element not found with ${type} locator: ${value}`);
85 | }
86 | await result.locator.waitFor({ state: 'visible', ...options });
87 | return result.locator;
88 | } catch (error) {
89 | throw new Error(`Failed to wait for element with ${type} locator: ${value}. Error: ${error.message}`);
90 | }
91 | }
92 |
93 | };
94 | }
95 |
96 | // Example usage:
97 | /*
98 | const { test, expect } = require('@playwright/test');
99 | const { createLocatorHelper } = require('./playwright_locator_helper');
100 |
101 | test('example test with enhanced findElement', async ({ page }) => {
102 | const locatorHelper = createLocatorHelper(page);
103 | await page.goto('https://example.com');
104 |
105 | // Example with CSS locator
106 | const buttonResult = await locatorHelper.findElement('css', 'button.submit');
107 | if (buttonResult) {
108 | console.log(`Button is displayed: ${buttonResult.isDisplayed}`);
109 | console.log(`Button is enabled: ${buttonResult.isEnabled}`);
110 | if (buttonResult.isDisplayed && buttonResult.isEnabled) {
111 | await buttonResult.locator.click();
112 | }
113 | } else {
114 | console.log('Button not found');
115 | }
116 | });
117 | */
118 |
119 | module.exports = { createLocatorHelper };
120 |
121 | // Example usage:
122 | /*
123 | const { test, expect } = require('@playwright/test');
124 | const { createLocatorHelper } = require('./playwright_locator_helper');
125 |
126 | test('example test with stored locators', async ({ page }) => {
127 | const locatorHelper = createLocatorHelper(page);
128 |
129 | await page.goto('https://example.com');
130 |
131 | // Store locators
132 | await locatorHelper.storeLocator('submitButton', 'css', 'button[type="submit"]');
133 | await locatorHelper.storeLocator('usernameInput', 'css', '#username');
134 |
135 | // Use stored locators
136 | const usernameInput = await locatorHelper.getStoredLocator('usernameInput');
137 | await usernameInput.fill('testuser');
138 |
139 | const submitButton = await locatorHelper.getStoredLocator('submitButton');
140 | await submitButton.click();
141 |
142 | // Clean up
143 | locatorHelper.clearStoredLocators();
144 | });
145 | */
146 |
147 | module.exports = { createLocatorHelper };
148 |
149 | Usage Example
150 |
151 | /**
152 | * Example usage of findElement function for different locator types
153 | * Assumes a webpage with common elements (e.g., a login form)
154 | */
155 | const { test, expect } = require('@playwright/test');
156 | const { createLocatorHelper } = require('./playwright_locator_helper');
157 |
158 | test.describe('Locator Examples', () => {
159 | test.beforeEach(async ({ page }) => {
160 | // Navigate to a sample page (replace with your test URL)
161 | await page.goto('https://example.com/login');
162 | });
163 |
164 | test('Use CSS locator', async ({ page }) => {
165 | const locatorHelper = createLocatorHelper(page);
166 |
167 | // Find an input field by CSS selector
168 | const usernameInput = await locatorHelper.findElement('css', '#username');
169 | await usernameInput.fill('testuser');
170 |
171 | // Verify the input value
172 | await expect(usernameInput).toHaveValue('testuser');
173 | });
174 |
175 | test('Use XPath locator', async ({ page }) => {
176 | const locatorHelper = createLocatorHelper(page);
177 |
178 | // Find a submit button using XPath
179 | const submitButton = await locatorHelper.findElement('xpath', '//button[@type="submit"]');
180 | await submitButton.click();
181 |
182 | // Verify button is clickable (enabled)
183 | await expect(submitButton).toBeEnabled();
184 | });
185 |
186 | test('Use Text locator', async ({ page }) => {
187 | const locatorHelper = createLocatorHelper(page);
188 |
189 | // Find a link by its text content
190 | const forgotPasswordLink = await locatorHelper.findElement('text', 'Forgot Password');
191 | await forgotPasswordLink.click();
192 |
193 | // Verify navigation or element visibility
194 | await expect(page).toHaveURL(/forgot-password/);
195 | });
196 |
197 | test('Use TestID locator', async ({ page }) => {
198 | const locatorHelper = createLocatorHelper(page);
199 |
200 | // Find an element by data-testid attribute
201 | const loginForm = await locatorHelper.findElement('testid', 'login-form');
202 |
203 | // Verify the element is visible
204 | await expect(loginForm).toBeVisible();
205 | });
206 |
207 | test('Use Role locator', async ({ page }) => {
208 | const locatorHelper = createLocatorHelper(page);
209 |
210 | // Find a button by its role and name
211 | const loginButton = await locatorHelper.findElement('role', 'button', { name: 'Log In' });
212 | await loginButton.click();
213 |
214 | // Verify button interaction
215 | await expect(loginButton).toHaveAttribute('aria-pressed', 'true');
216 | });
217 |
218 | test('Use Label locator', async ({ page }) => {
219 | const locatorHelper = createLocatorHelper(page);
220 |
221 | // Find an input by its associated label
222 | const passwordInput = await locatorHelper.findElement('label', 'Password');
223 | await passwordInput.fill('secure123');
224 |
225 | // Verify input value
226 | await expect(passwordInput).toHaveValue('secure123');
227 | });
228 | });
229 |
230 | ## phaatak package
231 | https://www.npmjs.com/package/phaatak Try this npm package for
232 | - managing multiple tabs
233 | - handling new windows
234 | - Saving and loading profiles
235 | - Stop the browser
236 | - close All tabs
237 |
238 |
239 | Example code - https://github.com/ghostinlinux/phaatak-playwright-demo/
240 |
241 | ## Visual testing
242 | https://medium.com/@adam_pajda/playwright-visual-tests-with-git-lfs-and-docker-d537ddd6e86a
243 |
244 | Verify all broken links
245 | https://medium.com/@thananjayan1988/automatic-broken-link-detection-with-playwright-a241a6f41973
246 |
247 | How to link existing chrome browser in playwright run
248 | https://dev.to/mxschmitt/running-playwright-codegen-with-existing-chromium-profiles-5g7k
249 |
250 | Mobile App testing
251 | https://medium.com/@testerstalk/mobile-app-testing-with-playwright-a-step-by-step-guide-in-detail-cabf5def30a9
252 |
253 | Excel data comparision using Playwright
254 | https://medium.com/@testerstalk/how-to-download-validate-excel-file-in-playwright-b8acbb19a4e8
255 |
256 | https://idavidov.eu/never-commit-broken-code-again-a-guide-to-eslint-and-husky-in-playwright?source=more_series_bottom_blogs
257 |
258 | App to run UI test -
259 | https://moatazeldebsy.github.io/test-automation-practices/#/
260 |
261 | https://github.com/AtulKrSharma/PlaywrightInjectTagsWithCaching/blob/main/playwright.config.ts
262 |
263 | https://www.saucedemo.com/
264 | https://the-internet.herokuapp.com/
265 | https://selectorshub.com/xpath-practice-page/
266 | https://test-edzotech.web.app/doms.html
267 | https://github.com/gauravkhuraana/PlaywrightTypeScriptWithAgenticAI
268 | https://idavidov.eu/my-first-live-session-developing-playwright-framework-for-rest-api-testin
269 |
270 | Try this prompt
271 | https://gauravkhurana.in/docs/AI/prompt-library/#playwright-typescript-framework-creation
272 |
273 | A must follow:
274 | https://github.com/seontechnologies/playwright-utils
--------------------------------------------------------------------------------
/.windsurf/rules/rules.md:
--------------------------------------------------------------------------------
1 | ---
2 | trigger: always_on
3 | ---
4 |
5 | ## Primary Goal for AI Agent
6 |
7 | Your primary goal is to assist in the development and maintenance of a robust and maintainable automated testing framework. This includes generating high-quality TypeScript code for Playwright tests (UI, API, E2E), page objects, fixtures, and utility functions, as well as providing expert advice on testing strategies and best practices, all while adhering to the instructions provided in specific prompts.
8 |
9 | ## Tech Stack
10 |
11 | - TypeScript (Strict Mode, ESNext)
12 | - Playwright (latest stable version)
13 | - Zod (for schema validation)
14 |
15 | ## AI Persona & Role
16 |
17 | You are an expert Senior Test Automation Engineer with deep specialization in:
18 | - TypeScript for test automation.
19 | - Playwright for UI, API, and end-to-end testing.
20 | - Designing and implementing scalable and maintainable Page Object Models (POM).
21 | - API testing best practices, including request/response validation using libraries like Zod.
22 | - Frontend and Backend testing considerations relevant to a complex platforms.
23 | - Adherence to strict coding standards and best practices.
24 |
25 | You are expected to:
26 | - Write concise, idiomatic, and technically accurate TypeScript code.
27 | - Provide type-safe examples and ensure all generated code includes correct type annotations.
28 | - Proactively identify potential issues and suggest improvements in test design and implementation *when asked or if it directly relates to the prompt`s request*.
29 | - Explain complex concepts clearly and provide rationale for your suggestions when asked.
30 | - Perform tasks like refactoring, debugging, suggesting improvements, or generating test cases *only when explicitly instructed to do so in a prompt*.
31 |
32 | ## Project Structure & Contextroot/
33 | |
34 | ├── env/ # Environment configuration files
35 | │ ├── .env.dev
36 | │ └── .env.example
37 | │
38 | ├── fixture/ # Playwright test fixtures
39 | │ ├── api/ # API specific fixtures
40 | │ │ ├── api-request-fixture.ts # Base fixture for API requests
41 | │ │ ├── plain-function.ts # Utility functions for API interactions
42 | │ │ ├── schemas.ts # Zod schemas for API validation
43 | │ │ └── types-guards.ts # Type guards for API responses
44 | │ └── pom/ # Page Object Model fixtures
45 | │ ├── page-object-fixtures.ts # Fixtures for instantiating page objects
46 | │ └── test-options.ts # Merges various test fixtures (e.g., page object and API fixtures)
47 | |
48 | ├── pages/ # Page Object Model classes
49 | │ ├── adminPanel/ # Page objects for the Admin Panel
50 | │ └── clientSite/ # Page objects for the Client Site
51 | |
52 | ├── tests-data/ # Test data (e.g., JSON, CSV files) - To be populated later.
53 | |
54 | ├── tests/ # Test scripts
55 | │ ├── auth.setup.ts # Global authentication setup
56 | │ ├── AdminPanel/ # E2E tests for the Admin Panel
57 | │ ├── API/ # API tests
58 | │ └── ClientSite/ # E2E tests for the Client Site
59 | |
60 | ├── .gitignore
61 | ├── .prettierrc # Prettier configuration for code formatting
62 | ├── package-lock.json
63 | ├── package.json
64 | ├── playwright.config.ts # Main Playwright configuration
65 | ├── README.md
66 | └── TEST-PLAN.md # Overall test plan document
67 |
68 | **Key Files & Their Purpose:**
69 | - `playwright.config.ts`: Defines global settings, projects, reporters (standard HTML reporter is sufficient), and base URLs.
70 | - `fixture/pom/test-options.ts`: Responsible for merging different sets of fixtures.
71 | - `fixture/api/schemas.ts`: Contains Zod schemas used for validating API request payloads and response bodies.
72 | - `pages/**/*.ts`: Contain Page Object classes, structured as per the guidelines below.
73 | - Any new utility functions or classes should be created in appropriate files within this structure.
74 |
75 | ## Code Style & Best Practices
76 |
77 | **General:**
78 | - Adhere strictly to the settings defined in `.prettierrc`.
79 | - All code must be type-safe. Leverage TypeScript`s features to ensure this.
80 | - Avoid `any` type unless absolutely necessary and provide a justification.
81 | - Use modern JavaScript features (ESNext) where appropriate (e.g., optional chaining, nullish coalescing).
82 | - No commented-out code in the final output. Explanatory comments are acceptable if they clarify complex logic.
83 |
84 | **Playwright Specific:**
85 | 1. **Page Object Model (POM) (`pages/**/*.ts`):**
86 | * Page classes should encapsulate locators (as getters) and methods representing user interactions or assertions for that page/component.
87 | * **Constructor:** Must accept `page: Page` (from Playwright) as its first argument, using the `private` shorthand.
88 | ```
89 |
90 | typescript
91 | constructor(private page: Page) {}
92 |
93 |
94 | ```
95 | * **Locators:**
96 | * Define all locators as public `get` accessors.
97 | * **Prioritize user-facing locators (Playwright`s recommendations):**
98 | 1. `this.page.getByRole()`
99 | 2. `this.page.getByText()`
100 | 3. `this.page.getByLabel()`
101 | 4. `this.page.getByPlaceholder()`
102 | 5. `this.page.getByAltText()`
103 | 6. `this.page.getByTitle()`
104 | * Use `this.page.frameLocator()` for elements within iframes.
105 | * Only use `this.page.locator()` (CSS or XPath) as a last resort when semantic locators are not feasible or stable. If using `this.page.locator()`, prefer `data-testid` attributes for robustness (e.g., `this.page.locator('[data-testid="error-message"]')`).
106 | * Ensure locators are specific enough to avoid ambiguity (e.g., using `.first()` if multiple elements match and it`s intended).
107 | * **Methods:**
108 | * Methods should represent complete user actions or flows (e.g., `publishArticle(...)`, `navigateToEditArticlePage()`) or retrieve page state (e.g., `getPublishErrorMessageText()`).
109 | * Methods performing actions **must include validation** to confirm the action`s success. This can involve:
110 | * Waiting for network responses: `await this.page.waitForResponse(response => ...)`
111 | * Asserting element visibility/state: `await expect(this.page.getByRole('heading', { name: title })).toBeVisible();`
112 | * Checking URL changes or other relevant side effects.
113 | * Provide comprehensive JSDoc comments for all public methods, including:
114 | * A clear description of what the method does.
115 | * `@param` for each parameter with its type and description.
116 | * `@returns {Promise}` for action methods or `Promise` for methods returning data.
117 | * Mention any important pre/post-conditions or potential errors if applicable.
118 | * Avoid methods that perform only a single Playwright action (e.g., a method solely for `await someButton.click()`). Incorporate such actions into larger, more meaningful user flow methods.
119 |
120 | * **Example Page Object (`ArticlePage`):**
121 | ```
122 |
123 | 1. **Tests (`tests/**/*.spec.ts`):**
124 | * Use the merged fixtures from `fixture/pom/test-options.ts` (e.g., `test('should display user dashboard', async ({ articlePage, otherPage }) => { ... })`).
125 | * Tests should be independent and focused on a single piece of functionality or user story.
126 | * Employ web-first assertions (`expect(locator).toBeVisible()`, `expect(page).toHaveURL()`).
127 | * Use built-in configuration objects like `devices` from `playwright.config.ts` when appropriate (e.g., for responsive testing).
128 | * Avoid hardcoded timeouts. Rely on Playwright`s auto-waiting mechanisms and web-first assertions. If a specific timeout is needed for an assertion, pass it as an option: `expect(locator).toBeVisible({ timeout: 5000 });`.
129 | * Group related tests using `test.describe()`.
130 | * Use `test.beforeEach` and `test.afterEach` for setup and teardown logic specific to a group of tests.
131 | * For global setup (like authentication), use the `auth.setup.ts` pattern.
132 |
133 | 2. **API Tests (`tests/API/**/*.spec.ts`):**
134 | * Utilize `apiRequest` context (from fixtures) for making API calls.
135 | * Use Zod schemas from `fixture/api/schemas.ts` to validate request payloads and response structures.
136 | * Verify status codes, headers, and response bodies thoroughly.
137 |
138 | 3. **Fixtures (`fixture/**/*.ts`):**
139 | * Clearly define the purpose and usage of each fixture with JSDoc.
140 | * Ensure fixtures are scoped correctly (worker vs. test) based on their purpose.
141 | * `fixture/pom/page-object-fixture.ts` should define how page objects are instantiated and provided to tests.
142 | * `fixture/api/api-request-fixture.ts` should configure the `APIRequestContext` (e.g., base URL from environment variables).
143 |
144 | ## Output Format & Expectations
145 |
146 | - **Code Generation:** Provide complete, runnable TypeScript code blocks that strictly follow these rules.
147 | - **Explanations:** When asked for explanations or advice, be clear, concise, and provide actionable recommendations aligned with these guidelines.
148 | - **Error Handling in Generated Code:** Generated code should include robust error handling where appropriate (e.g., try-catch for API calls if not handled by Playwright`s `toPass` or similar, checks for element states if complex interactions are involved). Standard Playwright assertions usually handle waits and implicit erroring.
149 | - **Clarity on Ambiguity:** If a user`s prompt is ambiguous or lacks necessary detail to follow these rules, ask clarifying questions before generating code.
150 |
151 | ## Things to Avoid
152 |
153 | - Generating overly complex or monolithic functions/classes. Prefer smaller, focused units that adhere to Single Responsibility Principle.
154 | - Using `page.waitForTimeout()` for arbitrary waits. Rely on web-first assertions and Playwright`s actionability checks.
155 | - Directly manipulating the DOM (e.g., `page.evaluate()` to change styles or content) unless it`s for a specific, justified testing scenario (like mocking complex browser APIs not supported by Playwright).
156 | - Hardcoding sensitive data (credentials, API keys) or environment-specific URLs directly in tests or page objects. Use environment variables (`process.env`) accessed via `playwright.config.ts` or fixtures.
157 | - Suggesting outdated practices or libraries not listed in the Tech Stack.
158 | - Including commented-out code in the final output, unless it`s a JSDoc or a brief, necessary clarification for exceptionally complex logic that cannot be made self-evident through code structure.
159 | - Deviating from the specified POM structure and locator strategies.
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 |
Playwright-Framework-Template
2 |
3 | ## Introduction
4 |
5 | Playwright-Framework-Template - This project is based on Microsoft Playwright, Appium, Artillery which enables reliable end-to-end testing, Web testing, API testing, Mobile testing, load testing. It is a single unified for your entire testing suite : UI, API, Mobile, Load testing.
6 |
7 | _☝ If you liked the project, please give a ⭐ on [GitHub](https://github.com/abhaybharti/playwright-framework-template). It will motivate me to add more such project._
8 |
9 | \_☝ If you want new feature to be added or you believe you've encountered a bug [Open an issue] (https://github.com/abhaybharti/playwright-framework-template/issues) .
10 |
11 | ## Core capabilites
12 | - **Cross-Browser Testing**: Chromium, Firefox,WebKit, Edge
13 | - **Multipel Test Types**: UI, API, Mobile, Load Testing, Visual Testing
14 | - **Page Object Model**: Scalable & maintainable test architecture
15 | - **JSON Config**: Build script
16 | - **Dependency Injection**: Custom Fixtures, TypeScript Decorators for clean test & function code
17 | - **Comprehenisve Reporting**: HTML, Log file, Video, Trace, Screenshot,
18 | - **Capture API**: HTML, Log file, Video, Trace, Screenshot,
19 |
20 |
21 |
22 | ## Features
23 |
24 | - Easy to Configure
25 | - Auto wait for all elements & checks
26 | - Generate HTML report
27 | - Generate detailed trace file which helps to debug
28 | - Generate snapshot for each step
29 | - Record video for test case execution
30 | - Support Web automation with support for chrome, Edge, Firefox and Safari
31 | - Support Mobile automation with support for Android native, web and hybrid apps automation
32 | - Support iOS native, web and hybrid apps automation
33 | - Support execution of Web tests on Microsoft Azure (can scale on demand)
34 | - Support API testing (GET, POST, PUT, DELETE HTTP methods)
35 | - Dynamic data handling using external JSON files
36 | - Support taking screenshots
37 | - Run functional test for load testing using Artillery
38 | - Support Serial and Parallel execution
39 | - Environment configuration using .env files
40 |
41 | ## Tech Stack/Libraries Used
42 |
43 | - [PlayWright](https://playwright.dev/) - for web/API automation/Mobile Device Emulation Testing
44 | - [Artillery](https://www.artillery.io/) - for load testing
45 | - [Appium](https://appium.io/docs/en/2.4/) - for mobile app automation
46 | - [ESLint](https://eslint.org/) - pinpoint issues and guide you in rectifying potential problems in both JavaScript and TypeScript.
47 | - [Prettier](https://prettier.io/) - for formatting code & maintain consistent style throughout codebase
48 | - [Dotenv](https://www.dotenv.org/) - to load environment variables from .env file
49 | - [Secrets](https://github.com/du5rte/secrets) - to load secrets from AWS Secrets Manager
50 | - [TypeScript](https://www.typescriptlang.org/) - for type safety
51 | - [Joi](https://github.com/sideway/joi) - for data validation
52 | - [Moment](https://momentjs.com/) - for date & time handling
53 | - [Winston](https://github.com/winstonjs/winston) - for logging
54 | - [Mocha](https://mochajs.org/) - for test runner
55 | - [Chai](https://www.chaijs.com/) - for assertion
56 |
57 |
58 |
59 | ## Getting Started
60 |
61 | ## Project Structure
62 | ```text
63 | playwright-framework-template/
64 | ├── .github/workflows/ # GitHub Actions CI/CD
65 | ├── src/
66 | | └── helper/ # Helpers
67 | | | ├── api/apiHelper.ts # API Helper
68 | | | ├── load/loadHelper.ts # Load testing Helper
69 | | | ├── mobile/mobileHelper.ts # Mobile action Helper
70 | | | └── web/webHelper.ts # Web action Helper
71 | | └── utils/ # Utilities
72 | | | ├── config/ # config files
73 | | | ├── error/ # Centralized error manager
74 | | | ├── reader/ # JSON/Excel reader Helper
75 | | | ├── report/ # Custom report manager
76 | | | └── other/ # Har Analyzer
77 | | └── globals/ # Global setup/teardown/healthcheck scripts
78 | ├── tests/
79 | | ├── fixtures/ # Custom test fixtures
80 | | ├── api/ # API Integration tests
81 | | | └── example/ # example api tests
82 | | ├── e2e/ # E2E tets
83 | | | └── example/ # example e2e tests
84 | | ├── load/ # Load testing
85 | | | └── example/ # example load tests
86 | | ├── resources/ # resource files
87 | | ├── web/ # browser tests
88 | | | └── example/ # example web tests
89 | | └── mobile/ # Mobile tests
90 | | └── example/ # example mobile tests
91 | ├── Dockerfile # Dockerfile
92 | ├── docker-compose.yml # docker-compose.yml
93 | ├── .env # environment variables
94 | ├── .env.example # environment variables example
95 | ├── .gitignore # git ignore
96 | ├── .prettierrc # prettier config
97 | ├── .eslintrc.json # eslint config
98 | ├── package.json # package.json
99 | ├── playwright.config.ts # playwright config
100 | ├── README.md # README.md
101 | └── tsconfig.json # tsconfig.json
102 |
103 |
104 | ### Prerequisite
105 |
106 | - `nodejs`: Download and install Node JS from
107 | > `https://nodejs.org/en/download`
108 | - `Visual Studio Code/WindSurf/Cursor`: Download and install code editor
109 | - `Git`
110 |
111 | ### Installation
112 |
113 | - clone the repo using below URL
114 |
115 | > `https://github.com/abhaybharti/playwright-framework-template.git`
116 |
117 | - Navigate to folder and install dependencies
118 |
119 | > `npm install`
120 |
121 | - For first time installation use below command to download & install required browsers:
122 |
123 | > `npx playwright install`
124 |
125 | - In case you want to do fresh setup of playwright
126 | - Create a folder & run command `npm init playwright@latest`
127 | - select `TypeScript` & select default for other options
128 |
129 |
130 | ## Usage
131 |
132 | - For browser configuration, change required parameters in playwright.config.ts
133 | - To run your suite on MS Azure, copy the below code in `azure-pipeline.yml` and `playwright.service.config.ts` to root folder, update following key & run your suite
134 | - PLAYWRIGHT_SERVICE_ACCESS_TOKEN
135 | - PLAYWRIGHT_SERVICE_URL=XXX
136 |
137 | ## How to generate Playwright code (Playwright Test Generator)
138 |
139 | - run command `npx playwright codegen`
140 | - Browser gets opened & navigate to web app & perform test actions
141 |
142 | Playwright test generator generates tests and pick locator for you. It uses role,text and test ID locators.
143 |
144 | To pick a locator, run the `codegen` command followed by URL, `npx playwright codegen https://opensource-demo.orangehrmlive.com/web/index.php/auth/login`
145 |
146 | ## Writing Tests
147 |
148 | - Create test files in `src/tests` folder
149 |
150 | ## Sample Test
151 |
152 | ### Unit/Integration Testing
153 |
154 | ### Sample Web Test
155 |
156 | > Note: Refer to [sample-web-test](https://github.com/abhaybharti/playwright-framework-template/tree/master/src/tests/web/example)
157 |
158 | Pls go through different `\*.ts` file, which has tests example for different purpose.
159 |
160 | #### Locator Example
161 |
162 | > Note: Refer to [sample-web-test](https://github.com/abhaybharti/playwright-framework-template/tree/master/src/tests/web/example/locator.spec.ts)
163 |
164 | ### Sample Web Load Test
165 |
166 | ### Sample Api Test
167 |
168 | > Note: Refer to [sample-api-test](https://github.com/abhaybharti/playwright-framework-template/tree/master/src/tests/api/example)
169 |
170 | Pls go through different `\*.ts` files, which has tests example for different api tests.
171 |
172 | ### Sample API Load Test
173 |
174 | ### Sample Mobile Test
175 |
176 | ## Run Test
177 |
178 | ### To Run Web Test
179 |
180 | - `npx playwright test (name-of-file.spec.ts) --headed` to run test in ui mode
181 | - `npx playwright test (name-of-file.spec.ts) --headed --config=playwright.config.chrome.ts` to run test in ui mode on chrome browser
182 | - `npx playwright test (name-of-file.spec.ts) --headed --config=playwright.config.firefox.ts` to run test in ui mode on firefox browser
183 | - `npx playwright test (name-of-file.spec.ts) --headed --config=playwright.config.edge.ts` to run test in ui mode on edge browser
184 |
185 | ### To Run Api Test
186 |
187 | ### To Run Mobile Test
188 |
189 | ### To Run Test Multiple Times in Parallel
190 |
191 | `npx playwright test --workers=5 --headed --repeat-each=5`
192 |
193 | - This will run test 5 times, at a time 5 instance will run. `--workers=5` will run 5 instances
194 |
195 | ### To Run Test Multiple Times in Sequence
196 |
197 | `npx playwright test --workers=1 --headed --repeat-each=5`
198 |
199 | - This will run test 5 times, at a time single instance will run, `--repeat-each=5` will run 5 times
200 |
201 | ### To Run Load Test using Artillery & PlayWright Suite
202 |
203 | `artillery run artillery-script.yml --output report.json`
204 |
205 | ### Grouping and Organizing Test Suite in PlayWright
206 |
207 | `npx playwright test --grep @smoke` This will run only test tagged as @smoke
208 |
209 | ## Debug And Analyze
210 |
211 | ### View Trace Result of PlayWright Execution
212 |
213 | - Open `https://trace.playwright.dev`
214 | - Upload `trace.zip` file to above site, it will show trace details
215 |
216 | ### Run test in debug mode
217 |
218 | `npx playwright test UIBasictest.spec.js --debug`
219 |
220 | This will start running script in debug mode & open PlayWright inspector
221 |
222 | ### How to generate load test report using artillery + Playwright
223 |
224 | `artillery report report.json --output report.html`
225 |
226 | #### Run & Generate Report
227 |
228 | ### Best Practices in Test Authoring:
229 |
230 | - `Create isolated test cases`: Each test case should be independent.
231 | - `Write Meaningful Test Case Titles`: Make your test case titles descriptive and meaningful.
232 | - `Follow the AAA (Arrange-Act-Assert) Pattern`: Align your Test-Driven Development (TDD) approach with the clarity of Arrange, Act, and Assert.
233 | - `Maintain Cleanliness`: Separate additional logic from tests for a tidy and focused codebase.
234 |
235 | ## GitHub Actions - created workflow to run test
236 |
237 | ## Contributing
238 |
239 | We love our contributors! Here's how you can contribute:
240 |
241 | - [Open an issue](https://github.com/abhaybharti/playwright-framework-template/issues) if you believe you've encountered a bug.
242 | - Make a [pull request](https://github.com/abhaybharti/playwright-framework-template/pulls) to add new features/make quality-of-life improvements/fix bugs.
243 |
244 |
245 |
246 |
247 |
248 |
249 | g
--------------------------------------------------------------------------------