vita-playwright 1.2.7 → 1.2.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vita-playwright",
-  "version": "1.2.7",
+  "version": "1.2.9",
   "email": "noreply_testautomation@vialto.com",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/README.md

@@ -1,617 +0,0 @@
-# VITA Playwright Helpers
-VITA Playwright helpers are written in Typescript with playwright support and a focus on using common playwright helpers, Excel utilities and Pdf utilities.
-
-## Table of Contents
-- [VITA Playwright Helpers](#vita-playwright-helpers)
-  - [Table of Contents](#table-of-contents)
-  - [Installation](#installation)
-    - [Node.js](#nodejs)
-  - [Helpers](#helpers)
-    - [Api Helpers](#api-helpers)
-      - [ApiHelpers.post](#apihelperspost)
-      - [ApiHelpers.get](#apihelpersget)
-      - [ApiHelpers.put](#apihelpersput)
-    - [UI Helpers](#ui-helpers)
-      - [filltheData](#fillthedata)
-      - [clickonWebElement](#clickonwebelement)
-      - [getInnerHTML](#getinnerhtml)
-      - [getInnerText](#getinnertext)
-      - [getText](#gettext)
-      - [getAttribute](#getattribute)
-      - [evaluateJS](#evaluatejs)
-      - [isElementPresent](#iselementpresent)
-      - [isElementEnabled](#iselementenabled)
-      - [waitTillElementIsVisible](#waittillelementisvisible)
-      - [getInputBoxValue](#getinputboxvalue)
-      - [downloadAFile](#downloadafile)
-      - [uploadAFile](#uploadafile)
-      - [getElementRefByRole](#getelementrefbyrole)
-  - [Utilities](#utilities)
-    - [Document Utilities](#document-utilities)
-      - [readData](#readdata)
-      - [readDataFromExcelorCSV](#readdatafromexcelorcsv)
-      - [filterData](#filterdata)
-      - [updateExcelData](#updateexceldata)
-      - [deleteAllFilesUnderDir](#deleteallfilesunderdir)
-      - [readPdfFile](#readpdffile)
-    - [Lighthouse Utilities](#lighthouse-utilities)
-      - [auditLightHouse](#auditlighthouse)
-      - [createLightHouseReport](#createlighthousereport)
-    - [Date Utilities](#date-utilities)
-      - [getDateInCustomFormat](#getdateincustomformat)
-      - [getPastDateInCustomFormat](#getpastdateincustomformat)
-      - [getFutureDateInCustomFormat](#getfuturedateincustomformat)
-      - [getMinDateFromMultipleDates](#getmindatefrommultipledates)
-      - [getMaxDateFromMultipleDates](#getmaxdatefrommultipledates)
-      - [calculateRelativeDate](#calculaterelativedate)
-    - [Database Utilities](#database-utilities)
-      - [sqlDBConnection](#sqldbconnection)
-      - [executeSqlQuery](#executesqlquery)
-    - [Data Comparisions](#data-comparisions)
-  - [Missing Features](#missing-features)
-
-## Installation
-
-### Node.js
-```bash
-npm install vita-playwright
-```
-Note that vita-playwright uses ES6 features so only Node.js v4+ is supported.
-
-## Helpers
-
-vita-playwright has an [extensive methods](#api-reference) for working with playwright, excel and pdf. This section reviews the most common functions and use cases. Examples can also be found in the examples directory of the source code.
-
-### Api Helpers
-
-To use most common API methods, you first require ApiHelper class. Then you can access methods within the ApiHelper class to use API calls.
-```ts
-import {ApiHelper} from 'vita-playwright';
-
-// call static methods using classname
-const getResponse = await ApiHelper.get(url, header);
-const putResponse = await ApiHelper.put(url, header, payload);
-const postResponse = await ApiHelper.post(url, header, payload);
-```
-#### ApiHelpers.post
-```ts
-/**
- * @description: Post call with endpoint, headers and data.
- * @param {string}  apiEndPoint - API end point.
- * @param {string}  headers  - headers contains authentication keys, application type etc..
- * @param {json/string}  payload  - payload data
- * @returns {Promise<reponse>} - returns Promise of reponse
- */
-import { ApiHelper } from "vita-playwright";
-const headers= {
-        "content-type": "application/json; charset=utf-8",
-        "Accept": "*/*"
-        };
-const payload = {
-  "key":"value"
-};
-const apiEndPoint = "https://admin.googleapis.com/discovery/rest?version=datatransfer_v1";
-
-await ApiHelper.post(
-        apiEndPoint,
-        headers,
-        payload
-      );
-```
-#### ApiHelpers.get
-```ts
-/**
- * @description: Get call with endpoint and headers.
- * @param {string}  apiEndPoint - API end point.
- * @param {string}  headers  - headers contains authentication keys, application type etc..
- * @returns {Promise<reponse>} - returns Promise of reponse
- */
-import { ApiHelper } from "vita-playwright";
-const headers= {
-        "content-type": "application/json; charset=utf-8",
-        "Accept": "*/*"
-        };
-const apiEndPoint = "https://admin.googleapis.com/discovery/rest?version=datatransfer_v1";
-
-await ApiHelper.get(
-        apiEndPoint,
-        headers,
-      );
-```
-#### ApiHelpers.put
-```ts
-/**
- * @description: Put call with endpoint, headers and data and it will insert the data.
- * @param {string}  apiEndPoint - API end point.
- * @param {string}  headers  - headers contains authentication keys, application type etc..
- * @param {string}  payload  - payload data
- * @returns {Promise<reponse>} - returns Promise of reponse
- */
-import { ApiHelper } from "vita-playwright";
-const headers= {
-        "content-type": "application/json; charset=utf-8",
-        "Accept": "*/*"
-        };
-const data = {
-  "key":"value"
-};
-const apiEndPoint = "https://admin.googleapis.com/discovery/rest?version=datatransfer_v1";
-
-await ApiHelper.put(
-        apiEndPoint,
-        headers,
-        data
-      );
-```
-
-### UI Helpers
-
-Either you can create object or extends UIHelper to  use common ui helpers by passing locators
-```ts
-import {UIHelper} from 'vita-playwright';
-
-const uihelper = new UIHelpers();
-// call static methods using classname
-await uihelper.filltheData(locator, data);
-await uihelper.clickonWebElement(locator);
-await uihelper.getInnerHTML(locator);
-await uihelper.getInnerText(locator);
-await uihelper.getText(locator);
-await uihelper.getAttribute(locator, attribute);
-await uihelper.evaluateJS(jsDOM);
-const isElementPresent = await uihelper.isElementPresent(locator);
-const isElementEnabled = await uihelper.isElementEnabled(locator);
-await waitTillElementIsVisible(elementSelector, waitTime);
-const inputBoxValue = await uihelper.getIputBoxValue(locator);
-await downloadAFile(downloadButton, downloadFilePath);
-await uploadAFile(uploadButton, uploadFilePath);
-const elementReference = await getElementRefByRole(roleType, roleName);
-```
-__Note__: getElementRefByRole() method will work for all types of roles, example: button, combobox, main, checkbox and radiobutton.
-
-#### filltheData
-```ts
-/**
- * @description: sets the text in inputbox.
- * @param {string}  locator - css selector/xpath of the inputbox.
- * @param {string}  data  - Text to be set to inputbox
- * @returns {Promise<void>} - returns Promise of void
- */
-async filltheData(locator: any, data: any);
-
-Usage:
-import { UIHelper } from 'vita-playwright'
-class UserClass extends UIHelper{
-  await this.filltheData("locator/xpath/css selector", "data to set into inputbox");
-}
-```
-#### clickonWebElement
-```ts
-/**
- * @description: click the given locator element.
- * @param {string}  locator - css selector/xpath of the element.
- * @returns {Promise<void>} - returns Promise of void
- */
-async clickonWebElement(locator: any)
-
-Usage:
-import { UIHelper } from 'vita-playwright'
-class UserClass extends UIHelper{
-  await this.clickonWebElement("locator/xpath/css selector");
-}
-```
-#### getInnerHTML
-```ts
-/**
- * @description: returns inner html of locator element.
- * @param {string}  locator - css selector/xpath of the element.
- * @returns {string} - returns inner html string
- */
-async getInnerHTML(locator: any)
-
-Usage:
-import { UIHelper } from 'vita-playwright'
-class UserClass extends UIHelper{
-  console.log(await this.getInnerHTML("locator/xpath/css selector"));
-  //output: inner HTML of given selector
-}
-```
-#### getInnerText
-```ts
-/**
- * @description: returns inner text of locator element.
- * @param {string}  locator - css selector/xpath of the element.
- * @returns {string} - returns inner text string
- */
-async getInnerText(locator: any)
-
-Usage:
-import { UIHelper } from 'vita-playwright'
-class UserClass extends UIHelper{
-  console.log(await this.getInnerText("locator/xpath/css selector"));
-  //output: inner Text of given selector
-}
-```
-#### getText
-```ts
-/**
- * @description: returns text of locator element.
- * @param {string}  locator - css selector/xpath of the element.
- * @returns {string} - returns text string
- */
-async getText(locator: any)
-
-Usage:
-import { UIHelper } from 'vita-playwright'
-class UserClass extends UIHelper{
-  console.log(await this.getText("locator/xpath/css selector"));
-  //output: Text of given selector
-}
-```
-#### getAttribute
-```ts
-/**
- * @description: returns given attribute value of locator element.
- * @param {string}  locator - css selector/xpath of the element.
- * @param {string} attribute - html attribute to get value
- * @returns {string} - returns text string
- */
-async getAttribute(locator: any, attribute: any)
-
-Usage:
-import { UIHelper } from 'vita-playwright'
-class UserClass extends UIHelper{
-  console.log(await this.getAttribute("locator/xpath/css selector", "class"));
-  //output: returns locator class value
-}
-```
-#### evaluateJS
-```ts
-// will be added in next versions.
-```
-#### isElementPresent
-```ts
-/**
- * @description: verifies given locator element is displayed or not.
- * @param {string}  locator - css selector/xpath of the element.
- * @returns {boolean} - returns true/false
- */
-async isElementPresent(locator: any)
-
-Usage:
-import { UIHelper } from 'vita-playwright'
-class UserClass extends UIHelper{
-  console.log(await this.isElementPresent("locator/xpath/css selector"));
-  //output: returns true if given locator is present in the dom
-}
-```
-#### isElementEnabled
-```ts
-/**
- * @description: verifies given locator element is enabled or not.
- * @param {string}  locator - css selector/xpath of the element.
- * @returns {boolean} - returns true/false
- */
-async isElementEnabled(locator: any)
-
-Usage:
-import { UIHelper } from 'vita-playwright'
-class UserClass extends UIHelper{
-  console.log(await this.isElementEnabled("locator/xpath/css selector"));
-  //output: returns true if given locator is enabled in the dom
-}
-```
-#### waitTillElementIsVisible
-```ts
-/**
- * @description: waits until locator element visibles.
- * @param {elementReference}  elementSelector - element reference.
- * @param {number} wait time
- * @returns {Promise<void>} - returns Promise of void
- */
-async waitTillElementIsVisible(elementSelector: any, waitTime = 60000)
-
-Usage:
-import { UIHelper } from 'vita-playwright'
-class UserClass extends UIHelper{
-  await this.waitTillElementIsVisible("locator/xpath/css selector", 100000);
-  //output: wait for given locator to be available in the dom
-}
-```
-#### getInputBoxValue
-```ts
-/**
- * @description: returns value of inputbox.
- * @param {string}  locator - css selector/xpath of the element.
- * @returns {string} - returns text string
- */
-async getInputBoxValue(locator: any)
-
-Usage:
-import { UIHelper } from 'vita-playwright'
-class UserClass extends UIHelper{
-  console.log(await this.getInputBoxValue("locator/xpath/css selector"));
-  //output: returns inputbox value
-}
-```
-#### downloadAFile
-```ts
-/**
- * @description: wait untill download process completes and save file with custom name.
- * @param {string}  locator - css selector/xpath of the element.
- * @param {string}  filePath - Complete path of the excel file, example: C:/resources/****.xlsx.
- * @returns {Promise<void>} - returns Promise of void
- */
-async downloadAFile(downloadButton: String, filePath: string)
-
-Usage:
-import { UIHelper } from 'vita-playwright'
-class UserClass extends UIHelper{
-  const filePath = path.resolve(config.use.downloadsPath, downloadFileName);
-  await this.downloadAFile(downloadButtonRef, filePath);
-  //will wait for download completes and saves in to given filepath with custom name
-}
-```
-#### uploadAFile
-```ts
-/**
- * @description: wait untill upload process completes and save file with custom name.
- * @param {string}  locator - css selector/xpath of the element.
- * @param {string}  filePath - Complete path of the excel file, example: C:/resources/****.xlsx.
- * @returns {Promise<void>} - returns Promise of void
- */
-async uploadAFile(uploadButton: String, uploadFilePath: String)
-
-Usage:
-import { UIHelper } from 'vita-playwright'
-class UserClass extends UIHelper{
-  const filePath = path.resolve(config.use.downloadsPath, UploadFileName);
-  await this.uploadAFile(UploadButtonRef, filePath);
-  //will wait for upload completes
-}
-```
-#### getElementRefByRole
-```ts
-/**
- * @description: will perform click action.
- * @param {string}  roleType - example: "alert"|"alertdialog"|"application"|"article"|"banner"|"blockquote"|"button"|"caption"|"cell"|"checkbox"|"code"|"columnheader"|"combobox"|"complementary"|"contentinfo"|"definition"|"deletion"|"dialog"|"directory"|"document"|"emphasis"|"feed"|"figure"|"form"|"generic"|"grid"|"gridcell"|"group"|"heading"|"img"|"insertion"|"link"|"list"|"listbox"|"listitem"|"log"|"main"|"marquee"|"math"|"meter"|"menu"|"menubar"|"menuitem"|"menuitemcheckbox"|"menuitemradio"|"navigation"|"none"|"note"|"option"|"paragraph"|"presentation"|"progressbar"|"radio"|"radiogroup"|"region"|"row"|"rowgroup"|"rowheader"|"scrollbar"|"search"|"searchbox"|"separator"|"slider"|"spinbutton"|"status"|"strong"|"subscript"|"superscript"|"switch"|"tab"|"table"|"tablist"|"tabpanel"|"term"|"textbox"|"time"|"timer"|"toolbar"|"tooltip"|"tree"|"treegrid"|"treeitem".
- * @param {string}  roleName - name of the element.
- * @returns {Promise<void>} - returns Promise of void
- */
-async getElementRefByRole(roleType: string, roleName: string)
-
-Usage:
-import { UIHelper } from 'vita-playwright'
-class UserClass extends UIHelper{
-  await this.getElementRefByRole("link", "Dashboard");
-  await this.getElementRefByRole("button", "Jobs");
-  await this.getElementRefByRole("checkbox", "jobName");
-}
-```
-
-## Utilities
-vita-playwright also provides utilities for Excel, Pdf, Date, Email and Lighthosue for perfomace.
-
-### Document Utilities
-
-You can access rows and columns in order to change size, hide/show, or access cells within:
-
-#### readData
-```ts
-/**
- * @description: it will take excel file path as input and will return excel Workbook object.
- * @param {string}  filePath - Complete path of the excel file, example: C:/resources/****.xlsx.
- * @returns {Promise<Workbook>} - returns Promise, if we resolves and will get Workbook object
- */
-static async readData(filePath: string)
-```
-#### readDataFromExcelorCSV
-```ts
-/**
- * @description: it will take excel file path and sheetname as input and will return array of objects.
- * @param {string}  filePath - Complete path of the excel file, example: C:/resources/****.xlsx.
- * @param {string}  sheetname - name of the sheet name and it is optional. For CSV files no need pass this parameter.
- * @returns {Promise<Array<Object>>} - returns Promise, if we resolves and will get Array of Json objects. 
- * [{startDate: '****',endDate: '****', employeeId: '****',CompanyToken: '******'}]
- */
-static async readDataFromExcelorCSV(filePath: string, sheetname: string)
-```
-#### filterData
-```ts
-/**
- * @description: it will filter excel data and will return filtered array of objects.
- * @param {string}  filePath - Complete path of the excel file, example: C:/resources/****.xlsx.
- * @param {string}  sheetname - name of the sheet name and it is optional. For CSV files no need pass this parameter.
- * @param {Object}  filterObject - {column Name:Row value} key:value pair. example: {startDate: '****'}  
- * @returns {Promise<Array<Object>>} - returns Promise, if we resolves and will get filtered Array of Json objects. 
- * [{startDate: '****',endDate: '****', employeeId: '****',CompanyToken: '******'}]
- */
-static async filterData(filePath: string, sheetname: string)
-```
-#### updateExcelData
-```ts
-/**
- * @description: it will modify/update excel file based on input data.
- * @param {string}  filePath - Complete path of the excel file, example: C:/resources/****.xlsx.
- * @param {string}  sheetname - name of the sheet name and it is optional. For CSV files no need pass this parameter.
- * @param {Array<Object>}  exportData - excel modify data. example: [{startDate: '****',endDate: '****', employeeId: '****',CompanyToken: '******'}]
- * @returns {Promise<void>} - returns void promise. 
- */
-static async updateExcelData(filePath: string, sheetname: string)
-```
-#### deleteAllFilesUnderDir
-```ts
-/**
- * @description: it will delete all files under given directory.
- * @param {string}  dirPath - Complete path of the directory which contain file, example: C:/resources.
- * @returns {Promise<void>} - returns void promise. 
- */
-static async deleteAllFilesUnderDir(filePath: string, sheetname: string)
-```
-#### readPdfFile
-```ts
-/**
- * @description: it will take pdf file path as input and will return array of strings(each each line in pdf is each item in result array).
- * @param {string}  filePath - Complete path of the excel file, example: C:/resources/****.pdf.
- * @returns { Array<string>} - returns array os string, each string represents each line in pdf
- */
-static async readPdfFile(filePath: string)
-```
-
-### Lighthouse Utilities
-Lighthouse utilities are used to perform Lighthouse performace testing provided by Google.
-
-#### auditLightHouse
-```ts
-/**
- * @description: it will take url of the web page and will calculates the performance of that web page and compare with given customThresholds. If any threashold doesn't meet the minimum value, then it test will be fail.
- * @param {string}  pageurl - url of the given page which needs to be calculated.
- * @param {string}  deviceType - type of device i.e desktop or mobile.
- * @param {string}  filename - to save the result the filename.
- * @param {object}  customThresholds - It is optional threshold object. example: {performance: 80,accessibility: 70,
-'best-practices': 70,seo: 70, pwa: 70,} these are the default values.
- * @param {object}  format - This is optional. example: { html: true, csv:true, json: true}.
- * @returns {Promise<void>} - returns void promise. 
- */
-static async auditLightHouse(pageurl: string, deviceType, filename, customThresholds = {
-        performance: 80,
-        accessibility: 70,
-        'best-practices': 70,
-        seo: 70,
-        pwa: 70,
-    }, format = { html: true })
-
-//"Usage with new browser context:"
-  test("light house testing "+vurl, async ({ page }) => {
-    const browser = await playwright['chromium'].launch({
-        args: ['--start-maximized', '--remote-debugging-port=9222'],
-        channel:'chrome'
-    });
-    const context = await browser.newContext();
-    const page = await context.newPage();
-    page.goto(url);
-    await LightHouseUtility.auditLightHouse(url, "desktop", url.split('/').join('_')+'.html');
-  });
-
-//"Usage with default playwright page:"
-//Please set port in playwright.config.ts
-args: ['--start-maximized','--remote-debugging-port=9222']
-
-//calling auditLightHouse from test
- test("light house testing " + url, async ({ page }) => {
-    page.goto(url);
-    await LightHouseUtility.auditLightHouse(url, "desktop", url.split('/').join('_')+'.html');
-});
-```
-#### createLightHouseReport
-```ts
-/**
- * @description: it creates new index.html file which has links to all pages htnl files.
- * @param {string}  dirPath - Complete path of the directory which contains Lighthouse performace html files, example: C:/lighthouse.
- * @param {String}  savefilepath - Based on files in directory, new index.html file will be created. To save that index.html file in given filepath. example: C:/lighthouse/complateReport/
- * @param {String} applicationName - Name of the Application
- * @returns {Promise<void>} - returns void promise. 
- */
-static async createLightHouseReport(filePath: string, sheetname: string)
-
-//Usage:
-await LightHouseUtility.createLightHouseReport(process.cwd() + '/lighthouse/pages', process.cwd() + '/lighthouse/index.html', applicationName);
-```
-
-### Date Utilities
-Date related utilities
-
-```ts
-// will be added in next versions.
-```
-#### getDateInCustomFormat
-```ts
-/**
- * @description: returns date in required format.
- * @param {string}  date - date in the form of string, example: 01/01/2023.
- * @param {string}  format - format od date, example: DD/MM/YYYY.
- * @returns {string} - returns date in given format. 
- */
-static getDateInCustomFormat(date:any, format: string)
-```
-#### getPastDateInCustomFormat
-```ts
-/**
- * @description: subtracts no of days|months|years|hours|minutes|seconds from given date.
- * @param {string}  date - date in the form of string, example: 01/01/2023.
- * @param {string}  format - format od date, example: DD/MM/YYYY.
- * @param {string}  durationType - example days, months, years, hours, minutes, seconds.
- * @param {string}  duration - no of days|months|years|hours|minutes|seconds.
- * @returns {string} - returns date in given format.
- */
-static getPastDateInCustomFormat(date: any, format: string, durationType:DurationInputArg2, duration: DurationInputArg1)
-```
-#### getFutureDateInCustomFormat
-```ts
-/**
- * @description: adds no of days|months|years|hours|minutes|seconds from given date.
- * @param {string}  date - date in the form of string, example: 01/01/2023.
- * @param {string}  format - format od date, example: DD/MM/YYYY.
- * @param {string}  durationType - example days, months, years, hours, minutes, seconds.
- * @param {string}  duration - no of days|months|years|hours|minutes|seconds.
- * @returns {string} - returns date in given format.
- */
-static getFutureDateInCustomFormat(date: any, format: string, durationType:DurationInputArg2, duration: DurationInputArg1)
-```
-#### getMinDateFromMultipleDates
-```ts
-/**
- * @description: return min date from given dates.
- * @param {Array<object<date,format>>}  datesArrayObject - array of dates in form of object example: [{date:10/01/2023, format: "DD/MM/YYYY"}, {date:20/01/2023, format: "DD/MM/YYYY"}].
- * @returns {string} - return min date amount given dates example: 10/01/2023.
- */
-static getMinDateFromMultipleDates(datesArrayObject: any)
-```
-#### getMaxDateFromMultipleDates
-```ts
-/**
- * @description: return max date from given dates.
- * @param {Array<object<date,format>>}  datesArrayObject - array of dates in form of object example: [{date:10/01/2023, format: "DD/MM/YYYY"}, {date:20/01/2023, format: "DD/MM/YYYY"}].
- * @returns {string} - return max date amount given dates example: 20/01/2023.
- */
-```
-#### calculateRelativeDate
-```ts
-/**
- * @description: returns no of days "lessthan|Greaterthan" from given date.
- * @param {string}  fromDate - date in the form of string, example: 01/01/2023.
- * @param {string}  format - format od date, example: DD/MM/YYYY.
- * @returns {string} - returns string which is no of days "lessthan|Greaterthan" from given date. 
- */
-static calculateRelativeDate(fromDate: any, format: string)
-```
-### Database Utilities
-Utilities related SQL server utilities
-
-#### sqlDBConnection
-```ts
-/**
- * @description: establish the connection  with database.
- * @param {string}  configuration - example: {server: string, database: string, username:string, password: string, portNumber: number}.
- * @returns {Connection} - returns connection object. 
- */
-static sqlDBConnection(fromDate: any, format: string)
-```
-#### executeSqlQuery
-```ts
-/**
- * @description: establish the connection  with database.
- * @param {string} connectionObj - connection object which will come from sqlDBConnection()
- * @param {string} queryString - query to execute
- * @returns {Connection} - returns connection object. 
- */
-static async executeSqlQuery(connectionObj: any, queryString: any)
-```
-
-### Data Comparisions
-TODO: need to add Data Comparisions Utilities
-```ts
-// will be added in next versions
-```
-## Missing Features
-There are many features of playwright and other node modules needs to be added.