https://github.com/simple-automation-testing/promod-system
https://github.com/simple-automation-testing/promod-system
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/simple-automation-testing/promod-system
- Owner: Simple-Automation-Testing
- License: mit
- Created: 2021-10-31T11:21:25.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2025-04-27T09:20:01.000Z (about 2 months ago)
- Last Synced: 2025-05-07T04:46:12.288Z (about 2 months ago)
- Language: TypeScript
- Size: 440 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
PROMOD-SYSTEM
Designed for
promod - works with anyone
API
The purpose of this library is building of the TAF ecosystem which will not
regardless of library or framework which you use for your automation testing
PromodSystem test runner (powered by mocha)
## Usage. [promod](https://www.npmjs.com/package/promod) example.
- [Waiters](#waiters)
- [Core](#core)
### Waiters
```ts
import { seleniumWD } from 'promod';
import { createBrowserWaiters, createElementWaiters } from 'promod-system';
const { browser, $ } = seleniumWD;
;(async () => {
await getSeleniumDriver({seleniumAddress: 'http://localhost:4444/wd/hub'}, browser);
const browserWaiters = createBrowserWaiters(browser);
const elementWaiters = createElementWaiters();
const documentBody = $('body');
await browser.get('https://www.npmjs.com/');
await browserWaiters.waitForTabTitleIncludes('promod', {timeout: 10_000});
await elementWaiters.waitForTextIncludes(documentBody, 'promod' {timeout: 10_000});
})();
```
### Core
```ts
import { waitFor } from 'sat-wait';
import { seleniumWD } from 'promod';
import { PromodSystemStructure } from 'promod-system';
import type { PromodElementType } from 'promod/built/interface';
const timeouts = {
s: 5000,
m: 10000,
l: 15000,
xl: 25000,
}
class BaseElement extends PromodSystemElement {
constructor(locator: string, name: string, rootElement) {
super(locator, name, rootElement);
}
/**
* @info
* this method should be overridden,
* method will be execute to wait visibility before next base methods
* sendKeys, get, action
* ! for isDisplayed method waitLoadedState will not be executed.
*/
async waitLoadedState() {
await waitForCondition(async () => this.rootElement.isDisplayed(), {
message: `Element ${this.identifier} with root selector ${this.rootLocator}
should become visible during ${timeouts.l} ms.`
timeout: timeouts.l
});
}
/**
* @info
* this method should be overridden,
* method will be execute inside sendKeys method
* depends on base library/framework specific
*/
async baseSendKeys(value): Promise {
await this.rootElement.sendKeys(value);
}
/**
* @info
* this method should be overridden,
* method will be execute inside get method
* depends on base library/framework specific
*/
async baseGetData(): Promise<{ background: any; value: any }> {
return browser.executeScript(() => {
const background = arguments[0].style.background;
const value = arguments[0].value;
const rect = arguments[0].getBoundingClientRect();
const text = arguments[0].innerText.trim()
return {background, value, rect, text}
}, this.rootElement.getEngineElement());
}
}
class BaseFragment extends PromodSystemStructure {
constructor(locator: string, name: string, rootElement: PromodElementType) {
super(locator, name, rootElement);
}
init(locator: string, name: string, Child: new (...args) => any, ...rest) {
return new Child(locator, name, this.rootElement.$(locator), ...rest);
}
initCollection(locator: string, name: string, Collection: new (...args) => any, Child: new (...args) => any) {
return new Collection(locator, name, this.rootElement.$$(locator), Child);
}
/**
* @info
* this method should be overridden, it will be execute to wait visibility before next base methods
* sendKeys, get, action
* ! for isDisplayed method waitLoadedState will not be executed.
*/
async waitLoadedState() {
await waitForCondition(async () => this.rootElement.isDisplayed(), {
message: `Fragment ${this.identifier} with root selector ${this.rootLocator}
should become visible during ${timeouts.l} ms.`
timeout: timeouts.l
});
}
}
class BasePage extends PromodSystemStructure {
constructor(locator: string, pageName: string) {
super(locator, structureName, $(locator));
}
init(locator: string, name: string, Child: new (...args) => any) {
return new Child(locator, name, this.rootElement.$(locator));
}
initCollection(locator: string, name: string, Collection: new (...args) => any, Child: new (...args) => any) {
return new Collection(locator, name, this.rootElement.$$(locator), Child);
}
/**
* @info
* this method should be overridden,
* method will be execute to wait visibility before next base methods
* sendKeys, get, action
* ! for isDisplayed method waitLoadedState will not be executed.
*/
async waitLoadedState() {
await waitForCondition(async () => this.rootElement.isDisplayed(), {
message: `Page ${this.identifier} with root selector ${this.rootLocator}
should become visible during ${timeouts.l} ms.`
timeout: timeouts.l
});
}
}
```
## Improvement/new features plan
- [x] Fix hardcoded values
- [x] Generate get random flows for several fields
- [ ] Config validation
- [ ] Logging
- [ ] Error messages
- [x] Generate config `baseElementsActionsDescription` part based on base elements library
- [ ] Generate base library
- [ ] Generate project example
- [ ] Вepth level flow generation