DevExpress/testcafe
### [`v1.9.0`](https://togithub.com/DevExpress/testcafe/blob/master/CHANGELOG.md#v190-2020-8-6)
[Compare Source](https://togithub.com/DevExpress/testcafe/compare/v1.8.8...v1.9.0)
##### Enhancements
##### 🌟 Multi Window Support (Beta)
TestCafe can now automate user actions in multiple windows. You can switch between open windows during the test. Make edits in one window and check that the other window's content changes dynamically to reflect these modifications.
When the main window opens a child window, TestCafe automatically switches to this new window and continues test actions there:
```js
import { Selector } from 'testcafe';
fixture `Login page`
.page('https://login.wrike.com/login/');
const googleButton = Selector('div.login-panel-footer__login-with > button');
test('Login via Google', async t => {
await t
.click(googleButton)
.typeText('input[type=email]', 'This text will be entered inside the pop-up');
});
```
You can use the [t.openWindow](https://devexpress.github.io/testcafe/documentation/reference/test-api/testcontroller/openwindow.html) method to open a child window in test code:
```js
import { Selector, ClientFunction } from 'testcafe';
fixture `Test page`
.page('https://devexpress.github.io/testcafe/example/');
test('Open a new window', async t => {
await t.openWindow('http://example.com');
const url = await t.eval(() => document.documentURI);
await t.expect(url).eql('http://example.com');
});
```
The [t.switchToWindow](https://devexpress.github.io/testcafe/documentation/reference/test-api/testcontroller/switchtowindow.html) method enables you to switch between open windows. You can use a window descriptor or a predicate to specify the window that should be activated:
```js
fixture `Example page`
.page('https://example.com');
test('Switch to a specific window', async t => {
const initialWindow = await t.getCurrentWindow();
const popUp1 = await t.openWindow('https://devexpress.com');
const popUp2 = await t.openWindow('https://github.com');
await t.switchToWindow(initialWindow);
const url = t.eval(() => document.documentURI);
await t.expect(url).eql('https://example.com/');
await t
.switchToWindow(w => w.url.host === 'github.com')
.expect(url).eql('https://github.com');
});
```
The [t.switchToParentWindow](https://devexpress.github.io/testcafe/documentation/reference/test-api/testcontroller/switchtoparentwindow.html) and [t.switchToPreviousWindow](https://devexpress.github.io/testcafe/documentation/reference/test-api/testcontroller/switchtopreviouswindow.html) methods allow you to switch back to the parent window or the previously active window.
The [t.closeWindow](https://devexpress.github.io/testcafe/documentation/reference/test-api/testcontroller/closewindow.html) method closes the current window when called without arguments, or the specified window if you pass a descriptor or predicate:
```js
fixture `Example page`
.page('http://www.example.com');
test('Close the current window', async t => {
const window1 = await t.openWindow('http://devexpress.com');
await t.closeWindow();
const url = await t.eval(() => document.documentURI);
await t.expect(url).eql('http://www.example.com/');
});
test('Close a specific window', async t => {
const window1 = await t.openWindow('http://devexpress.com');
await t.closeWindow(window1);
});
```
##### Detailed Diffs in Failed Assertions
Test run reports now show the differences between an assertion's actual and expected values:
TestCafe can display difference between values, arrays, objects, and even functions.
##### Bug Fixes
- TestCafe now throws a descriptive error when it attempts to start the browser UI on Linux without the X11 server ([4461](https://togithub.com/DevExpress/testcafe/issues/4461))
- Exception no longer thrown when you use remote browsers on Linux without X11 or run Windows browsers from WSL2 ([#4742](https://togithub.com/DevExpress/testcafe/issues/4742))
- Fixed a syntax error on pages whose code destructures empty function parameters ([testcafe-hammerhead/#2391](https://togithub.com/DevExpress/testcafe-hammerhead/issues/2391))
- Fixed a bug when page titles were displayed incorrectly ([testcafe-hammerhead/#2374](https://togithub.com/DevExpress/testcafe-hammerhead/issues/2374))
Renovate configuration
:date: Schedule: At any time (no schedule defined).
:vertical_traffic_light: Automerge: Disabled by config. Please merge this manually once you are satisfied.
:recycle: Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
:no_bell: Ignore: Close this PR and you won't be reminded about this update again.
[ ] If you want to rebase/retry this PR, check this box
This PR contains the following updates:
1.8.8->1.9.0Release Notes
DevExpress/testcafe
### [`v1.9.0`](https://togithub.com/DevExpress/testcafe/blob/master/CHANGELOG.md#v190-2020-8-6) [Compare Source](https://togithub.com/DevExpress/testcafe/compare/v1.8.8...v1.9.0) ##### Enhancements ##### 🌟 Multi Window Support (Beta) TestCafe can now automate user actions in multiple windows. You can switch between open windows during the test. Make edits in one window and check that the other window's content changes dynamically to reflect these modifications.  When the main window opens a child window, TestCafe automatically switches to this new window and continues test actions there: ```js import { Selector } from 'testcafe'; fixture `Login page` .page('https://login.wrike.com/login/'); const googleButton = Selector('div.login-panel-footer__login-with > button'); test('Login via Google', async t => { await t .click(googleButton) .typeText('input[type=email]', 'This text will be entered inside the pop-up'); }); ``` You can use the [t.openWindow](https://devexpress.github.io/testcafe/documentation/reference/test-api/testcontroller/openwindow.html) method to open a child window in test code: ```js import { Selector, ClientFunction } from 'testcafe'; fixture `Test page` .page('https://devexpress.github.io/testcafe/example/'); test('Open a new window', async t => { await t.openWindow('http://example.com'); const url = await t.eval(() => document.documentURI); await t.expect(url).eql('http://example.com'); }); ``` The [t.switchToWindow](https://devexpress.github.io/testcafe/documentation/reference/test-api/testcontroller/switchtowindow.html) method enables you to switch between open windows. You can use a window descriptor or a predicate to specify the window that should be activated: ```js fixture `Example page` .page('https://example.com'); test('Switch to a specific window', async t => { const initialWindow = await t.getCurrentWindow(); const popUp1 = await t.openWindow('https://devexpress.com'); const popUp2 = await t.openWindow('https://github.com'); await t.switchToWindow(initialWindow); const url = t.eval(() => document.documentURI); await t.expect(url).eql('https://example.com/'); await t .switchToWindow(w => w.url.host === 'github.com') .expect(url).eql('https://github.com'); }); ``` The [t.switchToParentWindow](https://devexpress.github.io/testcafe/documentation/reference/test-api/testcontroller/switchtoparentwindow.html) and [t.switchToPreviousWindow](https://devexpress.github.io/testcafe/documentation/reference/test-api/testcontroller/switchtopreviouswindow.html) methods allow you to switch back to the parent window or the previously active window. The [t.closeWindow](https://devexpress.github.io/testcafe/documentation/reference/test-api/testcontroller/closewindow.html) method closes the current window when called without arguments, or the specified window if you pass a descriptor or predicate: ```js fixture `Example page` .page('http://www.example.com'); test('Close the current window', async t => { const window1 = await t.openWindow('http://devexpress.com'); await t.closeWindow(); const url = await t.eval(() => document.documentURI); await t.expect(url).eql('http://www.example.com/'); }); test('Close a specific window', async t => { const window1 = await t.openWindow('http://devexpress.com'); await t.closeWindow(window1); }); ``` ##### Detailed Diffs in Failed Assertions Test run reports now show the differences between an assertion's actual and expected values:  TestCafe can display difference between values, arrays, objects, and even functions. ##### Bug Fixes - TestCafe now throws a descriptive error when it attempts to start the browser UI on Linux without the X11 server ([4461](https://togithub.com/DevExpress/testcafe/issues/4461)) - Exception no longer thrown when you use remote browsers on Linux without X11 or run Windows browsers from WSL2 ([#4742](https://togithub.com/DevExpress/testcafe/issues/4742)) - Fixed a syntax error on pages whose code destructures empty function parameters ([testcafe-hammerhead/#2391](https://togithub.com/DevExpress/testcafe-hammerhead/issues/2391)) - Fixed a bug when page titles were displayed incorrectly ([testcafe-hammerhead/#2374](https://togithub.com/DevExpress/testcafe-hammerhead/issues/2374))Renovate configuration
:date: Schedule: At any time (no schedule defined).
:vertical_traffic_light: Automerge: Disabled by config. Please merge this manually once you are satisfied.
:recycle: Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
:no_bell: Ignore: Close this PR and you won't be reminded about this update again.
This PR has been generated by WhiteSource Renovate. View repository job log here.