Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
feat(page): emulate idle state (#6410)
* https://bugs.chromium.org/p/chromium/issues/detail?id=1090802 * added `page.emulateIdleState(...)` allowing emulate or remove emulation of the idle state; * added test `emulate idle` -> `remove emulation` -> `emulate idle` -> `remove emulation`; * added launch argument `--enable-blink-features=IdleDetection` to turn IdleDetection on.
- Loading branch information
1 parent
03e41da
commit 17960e5
Showing
7 changed files
with
204 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,42 @@ | ||
<!-- Do not edit this file. It is automatically generated by API Documenter. --> | ||
|
||
[Home](./index.md) > [puppeteer](./puppeteer.md) > [Page](./puppeteer.page.md) > [emulateIdleState](./puppeteer.page.emulateidlestate.md) | ||
|
||
## Page.emulateIdleState() method | ||
|
||
Emulates the idle state. If no arguments set, clears idle state emulation. | ||
|
||
<b>Signature:</b> | ||
|
||
```typescript | ||
emulateIdleState(overrides?: { | ||
isUserActive: boolean; | ||
isScreenUnlocked: boolean; | ||
}): Promise<void>; | ||
``` | ||
|
||
## Parameters | ||
|
||
| Parameter | Type | Description | | ||
| --- | --- | --- | | ||
| overrides | { isUserActive: boolean; isScreenUnlocked: boolean; } | Mock idle state. If not set, clears idle overrides | | ||
|
||
<b>Returns:</b> | ||
|
||
Promise<void> | ||
|
||
## Example | ||
|
||
|
||
```js | ||
// set idle emulation | ||
await page.emulateIdleState({isUserActive: true, isScreenUnlocked: false}); | ||
|
||
// do some checks here | ||
... | ||
|
||
// clear idle emulation | ||
await page.emulateIdleState(); | ||
|
||
``` | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,23 @@ | ||
<!DOCTYPE html> | ||
<div id="state"></div> | ||
<script> | ||
const elState = document.querySelector('#state'); | ||
function setState(msg) { | ||
elState.textContent = msg; | ||
} | ||
async function main() { | ||
const controller = new AbortController(); | ||
const signal = controller.signal; | ||
const idleDetector = new IdleDetector({ | ||
threshold: 60000, | ||
signal, | ||
}); | ||
idleDetector.addEventListener('change', () => { | ||
const userState = idleDetector.userState; | ||
const screenState = idleDetector.screenState; | ||
setState(`Idle state: ${userState}, ${screenState}.`); | ||
}); | ||
idleDetector.start(); | ||
} | ||
main(); | ||
</script> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,94 @@ | ||
/** | ||
* Copyright 2020 Google Inc. All rights reserved. | ||
* | ||
* Licensed under the Apache License, Version 2.0 (the "License"); | ||
* you may not use this file except in compliance with the License. | ||
* You may obtain a copy of the License at | ||
* | ||
* http://www.apache.org/licenses/LICENSE-2.0 | ||
* | ||
* Unless required by applicable law or agreed to in writing, software | ||
* distributed under the License is distributed on an "AS IS" BASIS, | ||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
* See the License for the specific language governing permissions and | ||
* limitations under the License. | ||
*/ | ||
|
||
import expect from 'expect'; | ||
import { | ||
getTestState, | ||
setupTestBrowserHooks, | ||
setupTestPageAndContextHooks, | ||
describeFailsFirefox, | ||
} from './mocha-utils'; // eslint-disable-line import/extensions | ||
|
||
describeFailsFirefox('Emulate idle state', () => { | ||
setupTestBrowserHooks(); | ||
setupTestPageAndContextHooks(); | ||
|
||
async function getIdleState() { | ||
const { page } = getTestState(); | ||
|
||
const stateElement = await page.$('#state'); | ||
return await page.evaluate((element: HTMLElement) => { | ||
return element.innerText; | ||
}, stateElement); | ||
} | ||
|
||
async function verifyState(expectedState: string) { | ||
const actualState = await getIdleState(); | ||
expect(actualState).toEqual(expectedState); | ||
} | ||
|
||
it('changing idle state emulation causes change of the IdleDetector state', async () => { | ||
const { page, server, context } = getTestState(); | ||
await context.overridePermissions(server.PREFIX + '/idle-detector.html', [ | ||
'notifications', | ||
]); | ||
|
||
await page.goto(server.PREFIX + '/idle-detector.html'); | ||
|
||
// Store initial state, as soon as it is not guaranteed to be `active, unlocked`. | ||
const initialState = await getIdleState(); | ||
|
||
// Emulate Idle states and verify IdleDetector updates state accordingly. | ||
await page.emulateIdleState({ | ||
isUserActive: false, | ||
isScreenUnlocked: false, | ||
}); | ||
await verifyState('Idle state: idle, locked.'); | ||
|
||
await page.emulateIdleState({ | ||
isUserActive: true, | ||
isScreenUnlocked: false, | ||
}); | ||
await verifyState('Idle state: active, locked.'); | ||
|
||
await page.emulateIdleState({ | ||
isUserActive: true, | ||
isScreenUnlocked: true, | ||
}); | ||
await verifyState('Idle state: active, unlocked.'); | ||
|
||
await page.emulateIdleState({ | ||
isUserActive: false, | ||
isScreenUnlocked: true, | ||
}); | ||
await verifyState('Idle state: idle, unlocked.'); | ||
|
||
// Remove Idle emulation and verify IdleDetector is in initial state. | ||
await page.emulateIdleState(); | ||
await verifyState(initialState); | ||
|
||
// Emulate idle state again after removing emulation. | ||
await page.emulateIdleState({ | ||
isUserActive: false, | ||
isScreenUnlocked: false, | ||
}); | ||
await verifyState('Idle state: idle, locked.'); | ||
|
||
// Remove emulation second time. | ||
await page.emulateIdleState(); | ||
await verifyState(initialState); | ||
}); | ||
}); |