8 |
);
19 |
20 | ReactDOM.render(showCase, document.querySelector('#root'));
21 |
--------------------------------------------------------------------------------
/test-suite/src/app/svelte/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 | Todo app
9 |Counter
12 |
13 |
14 |
15 |
16 | Multi Counter
17 |
19 |
20 |
21 |
22 |
23 |
24 |
--------------------------------------------------------------------------------
/test-suite/src/app/react/index.tsx:
--------------------------------------------------------------------------------
1 | import * as React from 'react';
2 | import ReactDOM = require('react-dom');
3 |
4 | import { TodoApp } from './todo-app';
5 | import { EventsApp } from './events';
6 | import {RenderTestApp, TestAppProps} from '../../types';
7 |
8 | export class TestApp extends React.Component
19 |
20 | {item.label}
21 | {#if item.completed}
22 | Completed!
23 | {/if}
24 |
25 |
26 |
--------------------------------------------------------------------------------
/adapters/protractor/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "@unidriver/protractor",
3 | "version": "3.1.0",
4 | "description": "",
5 | "main": "dist/index.js",
6 | "typings": "dist/index.d.ts",
7 | "scripts": {
8 | "build": "rm -rf dist && tsc -p .",
9 | "pretest": "test $CI || webdriver-manager update",
10 | "test": "(protractor ./dist/protractor.conf.js) || true"
11 | },
12 | "author": "Wix.com",
13 | "license": "MIT",
14 | "dependencies": {
15 | "@unidriver/core": "^1.3.0",
16 | "chromedriver": "^96.0.0",
17 | "selenium-webdriver": "^3.6.0"
18 | },
19 | "peerDependencies": {
20 | "protractor": "^5.0.0"
21 | },
22 | "devDependencies": {
23 | "@unidriver/test-suite": "^1.3.0",
24 | "protractor": "^5.0.0"
25 | }
26 | }
27 |
--------------------------------------------------------------------------------
/adapters/playwright/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "@unidriver/playwright",
3 | "version": "1.1.6",
4 | "description": "",
5 | "main": "dist/index.js",
6 | "typings": "dist/index.d.ts",
7 | "scripts": {
8 | "build": "rm -rf dist && tsc -p .",
9 | "test": "mocha --timeout 20000 dist/**/spec.js"
10 | },
11 | "keywords": [],
12 | "author": "Wix.com",
13 | "license": "MIT",
14 | "dependencies": {
15 | "@unidriver/core": "^1.3.0"
16 | },
17 | "devDependencies": {
18 | "@unidriver/test-suite": "^1.3.0",
19 | "find-free-port-sync": "^1.0.0",
20 | "mocha": "^6.0.0",
21 | "playwright": "^1.8.0"
22 | },
23 | "peerDependencies": {
24 | "playwright": "^1.8.0"
25 | },
26 | "gitHead": "c793eb6b7c1d687fe054bf47fb11224028b51f77"
27 | }
28 |
--------------------------------------------------------------------------------
/examples/src/server.ts:
--------------------------------------------------------------------------------
1 | import * as express from 'express';
2 | import * as ejs from 'ejs';
3 | import {readFileSync} from 'fs';
4 | import * as path from 'path';
5 | import {Server} from 'http';
6 |
7 | export const startServer = (port: number): Promise
25 |
26 | {this.state.counter}
27 |
28 |
);
29 | }
30 | }
31 |
--------------------------------------------------------------------------------
/adapters/selenium/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "@unidriver/selenium",
3 | "version": "1.3.6",
4 | "description": "",
5 | "typings": "dist/index.d.ts",
6 | "main": "dist/index.js",
7 | "scripts": {
8 | "build": "rm -rf dist && tsc -p .",
9 | "test": "mocha --timeout 20000 dist/**/spec.js"
10 | },
11 | "dependencies": {
12 | "@unidriver/core": "^1.3.0",
13 | "chromedriver": "^103.0.0",
14 | "selenium-webdriver": "^3.6.0"
15 | },
16 | "devDependencies": {
17 | "@types/selenium-webdriver": "^3.0.15",
18 | "@unidriver/test-suite": "^1.3.0",
19 | "find-free-port-sync": "^1.0.0",
20 | "mocha": "^6.0.0"
21 | },
22 | "keywords": [],
23 | "author": "Wix.com",
24 | "license": "MIT",
25 | "gitHead": "c793eb6b7c1d687fe054bf47fb11224028b51f77"
26 | }
27 |
--------------------------------------------------------------------------------
/test-suite/src/server/index.ejs:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
22 |
23 |
24 |
25 |
26 |
27 |
--------------------------------------------------------------------------------
/migrating.md:
--------------------------------------------------------------------------------
1 | ### Migration from `unidriver@~2.0.1` to `@unidriver/* latest`
2 |
3 | If you are migrating from a previous version of `unidriver`, before the seperation of adapters, you will need to take the following breaking change into account:
4 |
5 | | method | `unidriver@2.0.1` | `@unidriver/* latest` |
6 | |-----------|-------------------|---------------------|
7 | | `pupUniDriver` | `(el: ElementGetter): UniDriver
27 |
28 |
29 |
);
30 | };
31 |
32 | render () {
33 | return (
34 |
35 | {this.state.counters.map(this.renderSingle)}
36 |
37 |
);
38 | }
39 | }
40 |
--------------------------------------------------------------------------------
/examples/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "unidriver-examples",
3 | "version": "1.4.6",
4 | "description": "",
5 | "main": "index.js",
6 | "private": true,
7 | "scripts": {
8 | "start": "node dist/index.js",
9 | "build-ts": "tsc -p .",
10 | "build-rest": "cp src/index.ejs dist/index.ejs && browserify dist/client.js > dist/bundle.js",
11 | "build": "npm run build-ts && npm run build-rest",
12 | "test-jsdom": "mocha -r jsdom-global/register dist/**/*.spec.js --exit --timeout 20000",
13 | "test-e2e": "mocha dist/**/*.e2e.js --exit --timeout 20000",
14 | "test": "npm run test-jsdom && npm run test-e2e"
15 | },
16 | "author": "",
17 | "license": "MIT",
18 | "dependencies": {
19 | "@unidriver/core": "^1.3.0",
20 | "@unidriver/jsdom-react": "^1.7.0",
21 | "@unidriver/puppeteer": "^1.2.2",
22 | "@unidriver/selenium": "^1.3.6",
23 | "browserify": "^16.0.0",
24 | "chromedriver": "^103.0.0",
25 | "express": "^4.16.0",
26 | "find-free-port-sync": "^1.0.0",
27 | "jsdom": "^13.2.0",
28 | "jsdom-global": "^3.0.2",
29 | "mocha": "^6.0.0"
30 | },
31 | "devDependencies": {
32 | "@types/puppeteer": "^5.4.0",
33 | "puppeteer": "^14.0.0",
34 | "ts-node": "^7.0.0",
35 | "typescript": "^3.7.5"
36 | }
37 | }
38 |
--------------------------------------------------------------------------------
/examples/src/shared.e2e.ts:
--------------------------------------------------------------------------------
1 | require('chromedriver');
2 | import { startServer } from './server';
3 | import * as puppeteer from 'puppeteer';
4 | import { ThenableWebDriver, Builder } from 'selenium-webdriver';
5 | import * as chrome from 'selenium-webdriver/chrome';
6 | import { defaultUrl, freePort } from './utils';
7 | let server: any = null;
8 | let browser: puppeteer.Browser;
9 | let wd: ThenableWebDriver;
10 |
11 | before(async function () {
12 | this.timeout(20000);
13 | server = await startServer(freePort);
14 | browser = await puppeteer.launch();
15 |
16 | // cache init stuff
17 | const cachePup = async () => {
18 | const page = await browser.newPage();
19 | await page.goto(defaultUrl, {waitUntil: 'networkidle2'});
20 | await page.close();
21 | };
22 |
23 | const cacheWd = async () => wd.get(defaultUrl);
24 |
25 | const chromeOptions = new chrome.Options();
26 | if (!!process.env.CI) {
27 | chromeOptions.headless();
28 | }
29 |
30 | wd = new Builder()
31 | .forBrowser('chrome')
32 | .setChromeOptions(chromeOptions)
33 | .build();
34 |
35 | await Promise.all([cachePup(), cacheWd()]);
36 | });
37 |
38 | after(async () => {
39 | server.close();
40 | wd.quit();
41 | browser.close();
42 | });
43 |
44 |
45 |
46 | export const getWd = () => wd;
47 | export const getBrowser = () => browser;
48 |
49 |
--------------------------------------------------------------------------------
/test-suite/src/app/svelte/Events/Events.svelte:
--------------------------------------------------------------------------------
1 |
16 |
17 |
23 |
24 |
25 |
41 |
--------------------------------------------------------------------------------
/examples/src/counter/counter.e2e.tsx:
--------------------------------------------------------------------------------
1 | import { assert } from 'chai';
2 | import { pupUniDriver } from '@unidriver/puppeteer';
3 | import { counterDriver } from './counter.driver';
4 | import { getBrowser } from '../shared.e2e';
5 | import { goAndWait } from '../utils';
6 | import { Page } from 'puppeteer';
7 |
8 | describe('counter - e2e', () => {
9 |
10 | let page: Page;
11 |
12 | beforeEach(async () => page = await goAndWait(getBrowser()));
13 | afterEach(() => page.close());
14 |
15 | const begin = async () => {
16 | const base = pupUniDriver(async() => {
17 | const selector = 'body';
18 | return{
19 | element: await page.$(selector),
20 | page,
21 | selector
22 | }
23 | });
24 | return counterDriver(base.$('.single-counter-wrapper'));
25 | };
26 |
27 | it('shows initial value', async () => {
28 | const driver = await begin();
29 | assert.equal(await driver.val(), 0);
30 | });
31 |
32 | it('increases value', async () => {
33 | const driver = await begin();
34 | await driver.increase();
35 | assert.equal(await driver.val(), 1);
36 | await driver.increase();
37 | await driver.increase();
38 | assert.equal(await driver.val(), 3);
39 | });
40 |
41 | it('decreases value', async () => {
42 | const driver = await begin();
43 | await driver.decrease();
44 | assert.equal(await driver.val(), -1);
45 | await driver.decrease();
46 | await driver.decrease();
47 | assert.equal(await driver.val(), -3);
48 | });
49 | });
50 |
--------------------------------------------------------------------------------
/examples/src/counter/counter.spec.tsx:
--------------------------------------------------------------------------------
1 | import * as React from 'react';
2 | import * as ReactDOM from 'react-dom';
3 |
4 | import { assert } from 'chai';
5 | import { counterDriver } from './counter.driver';
6 | import { jsdomReactUniDriver } from '@unidriver/jsdom-react';
7 | import { Counter } from './counter';
8 |
9 | const render = (val: number) => {
10 | const div = document.createElement('div');
11 | ReactDOM.render(
26 |
30 | {#each mouseEvents as event}
31 |
34 |
35 |
36 | {#each keyboardEvents as event}
37 |
40 |
43 |
44 |
46 |
48 |
49 |
50 | {#each items as item, index}
51 |
53 | {/each}
54 |
55 |
59 |
60 |
--------------------------------------------------------------------------------
/website/docs/doc3.md:
--------------------------------------------------------------------------------
1 | ---
2 | id: doc3
3 | title: This is Document Number 3
4 | ---
5 |
6 | Lorem ipsum dolor sit amet, consectetur adipiscing elit. In ac euismod odio, eu consequat dui. Nullam molestie consectetur risus id imperdiet. Proin sodales ornare turpis, non mollis massa ultricies id. Nam at nibh scelerisque, feugiat ante non, dapibus tortor. Vivamus volutpat diam quis tellus elementum bibendum. Praesent semper gravida velit quis aliquam. Etiam in cursus neque. Nam lectus ligula, malesuada et mauris a, bibendum faucibus mi. Phasellus ut interdum felis. Phasellus in odio pulvinar, porttitor urna eget, fringilla lectus. Aliquam sollicitudin est eros. Mauris consectetur quam vitae mauris interdum hendrerit. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
7 |
8 | Duis et egestas libero, imperdiet faucibus ipsum. Sed posuere eget urna vel feugiat. Vivamus a arcu sagittis, fermentum urna dapibus, congue lectus. Fusce vulputate porttitor nisl, ac cursus elit volutpat vitae. Nullam vitae ipsum egestas, convallis quam non, porta nibh. Morbi gravida erat nec neque bibendum, eu pellentesque velit posuere. Fusce aliquam erat eu massa eleifend tristique.
9 |
10 | Sed consequat sollicitudin ipsum eget tempus. Integer a aliquet velit. In justo nibh, pellentesque non suscipit eget, gravida vel lacus. Donec odio ante, malesuada in massa quis, pharetra tristique ligula. Donec eros est, tristique eget finibus quis, semper non nisl. Vivamus et elit nec enim ornare placerat. Sed posuere odio a elit cursus sagittis.
11 |
12 | Phasellus feugiat purus eu tortor ultrices finibus. Ut libero nibh, lobortis et libero nec, dapibus posuere eros. Sed sagittis euismod justo at consectetur. Nulla finibus libero placerat, cursus sapien at, eleifend ligula. Vivamus elit nisl, hendrerit ac nibh eu, ultrices tempus dui. Nam tellus neque, commodo non rhoncus eu, gravida in risus. Nullam id iaculis tortor.
13 |
14 | Nullam at odio in sem varius tempor sit amet vel lorem. Etiam eu hendrerit nisl. Fusce nibh mauris, vulputate sit amet ex vitae, congue rhoncus nisl. Sed eget tellus purus. Nullam tempus commodo erat ut tristique. Cras accumsan massa sit amet justo consequat eleifend. Integer scelerisque vitae tellus id consectetur.
15 |
--------------------------------------------------------------------------------
/tslint.json:
--------------------------------------------------------------------------------
1 | {
2 | "extends": ["tslint:latest", "tslint-react"],
3 | "rulesDirectory": [
4 | "tslint-rules"
5 | ],
6 | "rules": {
7 | "lower-case-module-imports": true,
8 | "no-dev-translations": true,
9 | "no-namespace": [true, "allow-declarations"],
10 | "no-reference": false,
11 | "only-arrow-functions": [true, "allow-declarations"],
12 | "typedef-whitespace": [true,
13 | {"variable-declaration": "nospace", "call-signature": "nospace", "parameter": "nospace", "property-declaration": "nospace"},
14 | {"variable-declaration": "onespace", "call-signature": "onespace", "parameter": "onespace", "property-declaration": "onespace"}
15 | ],
16 | "no-submodule-imports": false,
17 | "interface-over-type-literal": false,
18 | "space-before-function-paren": true,
19 | "ordered-imports": [false],
20 | "member-access": false,
21 | "curly": true,
22 | "no-bitwise": true,
23 | "no-conditional-assignment": true,
24 | "no-console": [true, "log", "error"],
25 | "no-debugger": true,
26 | "no-empty": true,
27 | "no-eval": true,
28 | "no-invalid-this": [true, "check-function-in-method"],
29 | "no-shadowed-variable": true,
30 | "no-switch-case-fall-through": true,
31 | "no-var-keyword": true,
32 | "switch-default": false,
33 | "triple-equals": true,
34 | "eofline": true,
35 | "indent": [true, "tabs"],
36 | "no-trailing-whitespace": true,
37 | "trailing-comma": [true, {"singleline": "never"}],
38 | "class-name": true,
39 | "no-consecutive-blank-lines": [true],
40 | "no-implicit-dependencies": false,
41 | "object-literal-key-quotes": [true, "as-needed"],
42 | "one-line": [true, "check-catch", "check-finally", "check-else", "check-open-brace", "check-whitespace"],
43 | "quotemark": [true, "single", "jsx-single"],
44 | "semicolon": [true, "always"],
45 | "whitespace": [true, "check-branch", "check-decl", "check-operator", "check-separator", "check-type"],
46 | "cyclomatic-complexity": [true, 20],
47 | "interface-name": [true, "never-prefix"],
48 | "jsx-alignment": true,
49 | "jsx-no-lambda": true,
50 | "jsx-curly-spacing": [true, "never"],
51 | "jsx-no-multiline-js": true,
52 | "jsx-no-string-ref": true,
53 | "jsx-self-close": true,
54 | "object-literal-sort-keys": false
55 | }
56 | }
57 |
--------------------------------------------------------------------------------
/adapters/selenium/src/spec.ts:
--------------------------------------------------------------------------------
1 | require('chromedriver');
2 | import { seleniumUniDriver } from './';
3 | import { Server } from 'http';
4 | import { ThenableWebDriver, Builder, WebElement, By } from 'selenium-webdriver';
5 | import * as chrome from 'selenium-webdriver/chrome';
6 | import {
7 | SetupFn,
8 | runTestSuite,
9 | startTestAppServer,
10 | getTestAppUrl,
11 | } from '@unidriver/test-suite';
12 | import { assert } from 'chai';
13 |
14 | const port = require('find-free-port-sync')();
15 |
16 | let server: Server;
17 | let wd: ThenableWebDriver;
18 |
19 | const beforeFn = async () => {
20 | const headless = !!process.env.CI;
21 | const chromeOptions = new chrome.Options();
22 |
23 | if (headless) {
24 | chromeOptions.headless();
25 | }
26 |
27 | server = await startTestAppServer(port);
28 | wd = new Builder()
29 | .forBrowser('chrome')
30 | .setChromeOptions(chromeOptions)
31 | .build();
32 |
33 | await wd.get(`http://localhost:${port}${getTestAppUrl({})}`);
34 |
35 | const driver = seleniumUniDriver(() => {
36 | const el: any = wd.findElement(By.css('body'));
37 | return el as Promise
84 |
86 |
89 |
)
90 | }
91 | }
92 |
--------------------------------------------------------------------------------
/.circleci/config.yml:
--------------------------------------------------------------------------------
1 | # Use the latest 2.1 version of CircleCI pipeline process engine.
2 | # See: https://circleci.com/docs/2.0/configuration-reference
3 | version: 2.1
4 |
5 | orbs:
6 | # The Node.js orb contains a set of prepackaged CircleCI configuration you can utilize
7 | # Orbs reduce the amount of configuration required for common tasks.
8 | # See the orb documentation here: https://circleci.com/developer/orbs/orb/circleci/node
9 | node: circleci/node@4.1
10 | browser-tools: circleci/browser-tools@1.1.1
11 |
12 | jobs:
13 | # Below is the definition of your job to build and test your app, you can rename and customize it as you want.
14 | build-and-test:
15 | # These next lines define a docker executor: https://circleci.com/docs/2.0/executor-types/
16 | # You can specify an image from Dockerhub or use one of our Convenience Images from CircleCI's Developer Hub.
17 | # A list of available CircleCI docker Convenience Images are available here: https://circleci.com/developer/images/image/cimg/node
18 | docker:
19 | - image: cimg/node:15.1
20 | # Then run your tests!
21 | # CircleCI will report the results back to your VCS provider.
22 | steps:
23 | # Checkout the code as the first step.
24 | - checkout
25 | # Next, the node orb's install-packages step will install the dependencies from a package.json.
26 | # The orb install-packages step will also automatically cache them for faster future runs.
27 | # - node/install-packages
28 | # If you are using yarn instead npm, remove the line above and uncomment the two lines below.
29 | - browser-tools/install-browser-tools
30 | - node/install-packages:
31 | pkg-manager: yarn
32 | - run:
33 | name: webdriver manager update
34 | command: node_modules/protractor/bin/webdriver-manager update
35 | - run:
36 | name: Run Build
37 | command: npm run build
38 | - run:
39 | name: Run tests
40 | command: npm run test
41 |
42 | workflows:
43 | # Below is the definition of your workflow.
44 | # Inside the workflow, you provide the jobs you want to run, e.g this workflow runs the build-and-test job above.
45 | # CircleCI will run this workflow on every commit.
46 | # For more details on extending your workflow, see the configuration docs: https://circleci.com/docs/2.0/configuration-reference/#workflows
47 | sample:
48 | jobs:
49 | - build-and-test
50 | # For running simple node tests, you could optionally use the node/test job from the orb to replicate and replace the job above in fewer lines.
51 | # - node/test
52 |
--------------------------------------------------------------------------------
/test-suite/src/app/react/events/index.tsx:
--------------------------------------------------------------------------------
1 | import * as React from 'react';
2 | import { EventsAppProps } from '../../../types';
3 |
4 | export type EventsAppState = {
5 | keyboardEvents: React.KeyboardEvent[];
6 | mouseEvents: React.MouseEvent[];
7 | }
8 |
9 | const keyboardEventComp = (event: React.KeyboardEvent, idx: number) => {
10 | const normalizedKey = event.key === 'OS' ? 'Meta' : event.key; // on FF Meta key press ends up named "OS", so we normalize it (https://stackoverflow.com/questions/39292111/can-firefox-detect-metakey)
11 | // `whiteSpace: pre` is needed for tests that run in browsers + Space key
12 | return (
13 | Items: {state.items.length}
87 |- {state.items.map((item, idx) =>
14 | {normalizedKey}
15 | {event.keyCode}
16 |
17 | );
18 | };
19 |
20 | const mouseEventComp = (event: React.MouseEvent, idx: number) => {
21 | return (
22 |
23 | {event.type}
24 |
25 | )
26 | }
27 |
28 | export class EventsApp extends React.Component
52 |
63 | );
64 | }
65 | }
66 |
--------------------------------------------------------------------------------
/adapters/puppeteer/src/pptr.spec.ts:
--------------------------------------------------------------------------------
1 | import * as puppeteer from 'puppeteer';
2 | import { Browser, Page } from 'puppeteer';
3 | import {
4 | getTestAppUrl,
5 | startTestAppServer,
6 | SetupFn,
7 | itemCreator,
8 | runTestSuite
9 | } from '@unidriver/test-suite';
10 | import { pupUniDriver } from '.';
11 | import { Server } from 'http';
12 | import { assert } from 'chai';
13 |
14 | const port = require('find-free-port-sync')();
15 |
16 | let server: Server;
17 | let browser: Browser;
18 | let page: Page;
19 |
20 | const beforeFn = async () => {
21 | const args = process.env.CI ? ['--no-sandbox'] : [];
22 | const headless = !!process.env.CI || undefined;
23 | server = await startTestAppServer(port);
24 | browser = await puppeteer.launch({
25 | headless,
26 | args,
27 | });
28 | page = await browser.newPage();
29 | };
30 |
31 | const afterFn = async () => {
32 | server.close();
33 | await page.close();
34 | await browser.close();
35 | };
36 |
37 | const setup: SetupFn = async (params) => {
38 | await page.goto(`http://localhost:${port}${getTestAppUrl(params)}`);
39 | const driver = pupUniDriver({
40 | page,
41 | selector: 'body',
42 | });
43 |
44 | const tearDown = async () => { };
45 |
46 | return { driver, tearDown };
47 | };
48 |
49 | describe('puppeteer', () => {
50 | runTestSuite({ setup, before: beforeFn, after: afterFn });
51 | });
52 |
53 | describe('puppeteer specific tests', () => {
54 | before(beforeFn);
55 | after(afterFn);
56 | describe('enterValue', () => {
57 | it(`doesn't attempt to clear value when shouldClear is false`, async () => {
58 | const { driver } = await setup({ items: [], initialText: 'hello' });
59 | await driver
60 | .$('header input')
61 | .enterValue(' world!', { shouldClear: false });
62 | assert.equal(await driver.$('header input').value(), 'hello world!');
63 | });
64 | });
65 | describe('text', () => {
66 | it(`checking text return value when the text is empty`, async () => {
67 | const { driver } = await setup({ items: [itemCreator({ label: '' })], initialText: '' });
68 | const labelText = await driver.$$('.label').text();
69 | assert.equal(labelText[0], "");
70 | });
71 | it(`checking text return value when the text is not empty`, async () => {
72 | const { driver } = await setup({ items: [itemCreator({ label: 'hello' })], initialText: '' });
73 | const labelText = await driver.$$('.label').text();
74 | assert.equal(labelText[0], "hello");
75 | });
76 | it(`checking text return value when the component doesn't have textContent property`, async () => {
77 | const { driver } = await setup({ items: [], initialText: 'hello' });
78 |
79 | let textThatDoesNotExists = await driver.$('header input').text();
80 | assert.equal(textThatDoesNotExists, '');
81 | });
82 | });
83 | });
84 |
--------------------------------------------------------------------------------
/adapters/puppeteer/src/pptr-core.spec.ts:
--------------------------------------------------------------------------------
1 | import * as puppeteer from 'puppeteer-core';
2 | import { Browser, Page } from 'puppeteer-core';
3 | import {
4 | getTestAppUrl,
5 | startTestAppServer,
6 | SetupFn,
7 | itemCreator,
8 | runTestSuite
9 | } from '@unidriver/test-suite';
10 | import { pupUniDriver } from '.';
11 | import { Server } from 'http';
12 | import { assert } from 'chai';
13 |
14 | const port = require('find-free-port-sync')();
15 | const locateChrome = require('locate-chrome');
16 |
17 | let server: Server;
18 | let browser: Browser;
19 | let page: Page;
20 |
21 | const beforeFn = async () => {
22 | const args = process.env.CI ? ['--no-sandbox'] : [];
23 | const headless = !!process.env.CI || undefined;
24 | const pathToChrome = await locateChrome();
25 | server = await startTestAppServer(port);
26 | browser = await puppeteer.launch({
27 | executablePath:pathToChrome,
28 | headless,
29 | args,
30 | });
31 | page = await browser.newPage();
32 | };
33 |
34 | const afterFn = async () => {
35 | server.close();
36 | await page.close();
37 | await browser.close();
38 | };
39 |
40 | const setup: SetupFn = async (params) => {
41 | await page.goto(`http://localhost:${port}${getTestAppUrl(params)}`);
42 | const driver = pupUniDriver({
43 | page,
44 | selector: 'body',
45 | });
46 |
47 | const tearDown = async () => { };
48 |
49 | return { driver, tearDown };
50 | };
51 |
52 | describe('puppeteer-core', () => {
53 | runTestSuite({ setup, before: beforeFn, after: afterFn });
54 | });
55 |
56 | describe('puppeteer-core specific tests', () => {
57 | before(beforeFn);
58 | after(afterFn);
59 | describe('enterValue', () => {
60 | it(`doesn't attempt to clear value when shouldClear is false`, async () => {
61 | const { driver } = await setup({ items: [], initialText: 'hello' });
62 | await driver
63 | .$('header input')
64 | .enterValue(' world!', { shouldClear: false });
65 | assert.equal(await driver.$('header input').value(), 'hello world!');
66 | });
67 | });
68 | describe('text', () => {
69 | it(`checking text return value when the text is empty`, async () => {
70 | const { driver } = await setup({ items: [itemCreator({ label: '' })], initialText: '' });
71 | const labelText = await driver.$$('.label').text();
72 | assert.equal(labelText[0], "");
73 | });
74 | it(`checking text return value when the text is not empty`, async () => {
75 | const { driver } = await setup({ items: [itemCreator({ label: 'hello' })], initialText: '' });
76 | const labelText = await driver.$$('.label').text();
77 | assert.equal(labelText[0], "hello");
78 | });
79 | it(`checking text return value when the component doesn't have textContent property`, async () => {
80 | const { driver } = await setup({ items: [], initialText: 'hello' });
81 |
82 | let textThatDoesNotExists = await driver.$('header input').text();
83 | assert.equal(textThatDoesNotExists, '');
84 | });
85 | });
86 | });
87 |
--------------------------------------------------------------------------------
/website/src/pages/index.js:
--------------------------------------------------------------------------------
1 | import React from 'react';
2 | import clsx from 'clsx';
3 | import Layout from '@theme/Layout';
4 | import Link from '@docusaurus/Link';
5 | import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
6 | import useBaseUrl from '@docusaurus/useBaseUrl';
7 | import styles from './styles.module.css';
8 |
9 | const features = [
10 | {
11 | title: 'Truly Flexible',
12 | imageUrl: 'img/undraw_pilates_gpdb.svg',
13 | description: (
14 | <>
15 | Compatible with Node (via JSDom), Selenium, Protractor, Puppeteer, Playwright and Cypress.io!
16 | Use any test runner and any assertion library you want.
17 |
18 | ),
19 | },
20 | {
21 | title: 'Write Once, Test Everywhere',
22 | imageUrl: 'img/undraw_analyze_17kw.svg',
23 | description: (
24 | <>
25 | Create drivers for you components using UniDriver once, and re-use them across all test levels. From unit testing and up to browser testing in production.
26 |
27 | ),
28 | },
29 | {
30 | title: 'Enable True Collaboration',
31 | imageUrl: 'img/undraw_shared_goals_3d12.svg',
32 | description: (
33 | <>
34 | Break the barriers between product engineers and QA engineers. Share test code and reduce selector related breaking tests.
35 |
36 | ),
37 | },
38 | ];
39 |
40 | function Feature({imageUrl, title, description}) {
41 | const imgUrl = useBaseUrl(imageUrl);
42 | return (
43 |
53 |
56 |
58 | {state.mouseEvents.map(mouseEventComp)}
57 |
59 |
60 |
62 | {state.keyboardEvents.map(keyboardEventComp)}
61 |
44 | {imgUrl && (
45 |
52 | );
53 | }
54 |
55 | function Home() {
56 | const context = useDocusaurusContext();
57 | const {siteConfig = {}} = context;
58 | return (
59 |
46 | 
47 |
48 | )}
49 |
47 | {title}
50 |{description}
51 |
64 |
77 | {siteConfig.title}
65 |{siteConfig.tagline}
66 |
67 |
73 | Get Started
74 |
75 |
76 |
82 |
88 |
83 | {features.map((props, idx) => (
84 |
87 |
25 |
26 | {item.label}
27 | {item.completed ? Completed! : null}
28 |
29 |
30 | );
31 | }
32 | }
33 |
34 | type TodoAppState = {
35 | newItem: string;
36 | items: TodoItem[];
37 | activeItem: number;
38 | };
39 |
40 | export class TodoApp extends React.Component
87 |
88 |
89 |
90 |
91 |
92 | {itemsComp}
93 |
94 |
98 |
);
99 | }
100 | }
101 |
--------------------------------------------------------------------------------
/core/src/index.ts:
--------------------------------------------------------------------------------
1 | import { KeyDefinitionType } from './key-types';
2 |
3 | export * from './utils';
4 | export * from './key-types';
5 |
6 | export type Locator = string;
7 |
8 | export type MapFn-
154 |
- Definition list 155 |
- Is something people use sometimes. 156 | 157 |
- Markdown in HTML 158 |
- Does *not* work **very** well. Use HTML tags. 159 |
189 |
192 |
195 |
196 | );
197 | ReactDOM.render(btn, elem);
198 |
199 | const driver = jsdomReactUniDriver(elem);
200 |
201 | await driver.$('button#A').click();
202 | await driver.$('button#B').click();
203 | cleanJsdom();
204 |
205 | sinon.assert.callOrder(focusA, blurA, focusB);
206 |
207 | assert(focusA.calledOnce);
208 | assert(blurA.calledOnce);
209 | assert(focusB.calledOnce);
210 | });
211 |
212 | it('should trigger [focusA, blurA] when clicking enabled and disabled button', async () => {
213 | const cleanJsdom = require('jsdom-global')();
214 | const focusA = spy();
215 | const focusB = spy();
216 | const blurA = spy();
217 | const elem = document.createElement('div');
218 | const btn = (
219 |
220 |
223 |
226 |
227 | );
228 | ReactDOM.render(btn, elem);
229 |
230 | const driver = jsdomReactUniDriver(elem);
231 |
232 | await driver.$('button#A').click();
233 | await driver.$('button#B').click();
234 | cleanJsdom();
235 |
236 | sinon.assert.callOrder(focusA, blurA);
237 |
238 | assert(focusA.calledOnce);
239 | assert(blurA.calledOnce);
240 | assert(focusB.notCalled);
241 | });
242 |
243 | it('should trigger blur on active element when clicking an svg', async () => {
244 | const cleanJsdom = require('jsdom-global')();
245 | const blurA = spy();
246 | const elem = document.createElement('div');
247 | const testApp = (
248 |
249 |
252 |
255 |
256 | );
257 | ReactDOM.render(testApp, elem);
258 |
259 | const driver = jsdomReactUniDriver(elem);
260 |
261 | await driver.$('button#A').click();
262 | await driver.$('svg#B').click();
263 | cleanJsdom();
264 |
265 | assert(blurA.calledOnce);
266 | });
267 | })
268 |
269 | describe('enterValue', () => {
270 | it('should set event target properly', async () => {
271 | const cleanJsdom = require('jsdom-global')();
272 | const change = spy();
273 | const elem = document.createElement('div');
274 | const input = (
275 |
280 | );
281 |
282 | ReactDOM.render(input, elem);
283 |
284 | const driver = jsdomReactUniDriver(elem);
285 |
286 | await driver.$('input').enterValue('some keywords');
287 | assert(change.calledOnce);
288 |
289 | const eventTarget = change.args[0][0].target;
290 | assert.equal(eventTarget.name, "search");
291 | assert.equal(eventTarget.type, "text");
292 | assert.equal(eventTarget.value, "some keywords");
293 |
294 | cleanJsdom();
295 | });
296 |
297 | it('works with uncontrolled inputs', async () => {
298 | const cleanJsdom = require('jsdom-global')();
299 | const elem = document.createElement('div');
300 | const input = (
301 |
305 | );
306 |
307 | ReactDOM.render(input, elem);
308 |
309 | const driver = jsdomReactUniDriver(elem);
310 |
311 | await driver.$('input').enterValue('some keywords');
312 |
313 | const inputValue = await driver.$('input').value();
314 | assert.equal(inputValue, "some keywords");
315 |
316 | cleanJsdom();
317 | });
318 | })
319 |
320 | });
321 |
--------------------------------------------------------------------------------
/website/static/img/undraw_shared_goals_3d12.svg:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/website/static/img/undraw_docusaurus_tree.svg:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------