/** * Copyright 2017 Google Inc. All rights reserved. * Modifications copyright (c) Microsoft Corporation. * * 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 { contextTest as it, expect } from '../config/browserTest'; function getPermission(page, name) { return page.evaluate(name => navigator.permissions.query({ name }).then(result => result.state), name); } it.describe('permissions', () => { it.skip(({ browserName }) => browserName === 'webkit', 'Permissions API is not implemented in WebKit (see https://developer.mozilla.org/en-US/docs/Web/API/Permissions_API)'); it('should be prompt by default', async ({ page, server }) => { await page.goto(server.EMPTY_PAGE); expect(await getPermission(page, 'geolocation')).toBe('prompt'); }); it('should deny permission when not listed', async ({ page, context, server }) => { await page.goto(server.EMPTY_PAGE); await context.grantPermissions([], { origin: server.EMPTY_PAGE }); expect(await getPermission(page, 'geolocation')).toBe('denied'); }); it('should fail when bad permission is given', async ({ page, context, server }) => { await page.goto(server.EMPTY_PAGE); let error: Error; await context.grantPermissions(['foo'], { origin: server.EMPTY_PAGE }).catch(e => error = e); expect(error.message).toContain('Unknown permission: foo'); }); it('should grant geolocation permission when origin is listed', async ({ page, context, server }) => { await page.goto(server.EMPTY_PAGE); await context.grantPermissions(['geolocation'], { origin: server.EMPTY_PAGE }); expect(await getPermission(page, 'geolocation')).toBe('granted'); }); it('should prompt for geolocation permission when origin is not listed', async ({ page, context, server }) => { await page.goto(server.EMPTY_PAGE); await context.grantPermissions(['geolocation'], { origin: server.EMPTY_PAGE }); await page.goto(server.CROSS_PROCESS_PREFIX + '/empty.html'); expect(await getPermission(page, 'geolocation')).toBe('prompt'); }); it('should grant notifications permission when listed', async ({ page, context, server }) => { await page.goto(server.EMPTY_PAGE); await context.grantPermissions(['notifications'], { origin: server.EMPTY_PAGE }); expect(await getPermission(page, 'notifications')).toBe('granted'); }); it('should accumulate when adding', async ({ page, context, server }) => { await page.goto(server.EMPTY_PAGE); await context.grantPermissions(['geolocation']); await context.grantPermissions(['notifications']); expect(await getPermission(page, 'geolocation')).toBe('granted'); expect(await getPermission(page, 'notifications')).toBe('granted'); }); it('should clear permissions', async ({ page, context, server }) => { await page.goto(server.EMPTY_PAGE); await context.grantPermissions(['geolocation']); await context.clearPermissions(); await context.grantPermissions(['notifications']); expect(await getPermission(page, 'geolocation')).not.toBe('granted'); expect(await getPermission(page, 'notifications')).toBe('granted'); }); it('should grant permission when listed for all domains', async ({ page, context, server }) => { await page.goto(server.EMPTY_PAGE); await context.grantPermissions(['geolocation']); expect(await getPermission(page, 'geolocation')).toBe('granted'); }); it('should grant permission when creating context', async ({ server, browser }) => { const context = await browser.newContext({ permissions: ['geolocation'] }); const page = await context.newPage(); await page.goto(server.EMPTY_PAGE); expect(await getPermission(page, 'geolocation')).toBe('granted'); await context.close(); }); it('should reset permissions', async ({ page, context, server }) => { await page.goto(server.EMPTY_PAGE); await context.grantPermissions(['geolocation'], { origin: server.EMPTY_PAGE }); expect(await getPermission(page, 'geolocation')).toBe('granted'); await context.clearPermissions(); expect(await getPermission(page, 'geolocation')).toBe('prompt'); }); it('should trigger permission onchange', async ({ page, context, server, browserName, browserMajorVersion }) => { it.fail(browserName === 'webkit'); await page.goto(server.EMPTY_PAGE); await page.evaluate(() => { window['events'] = []; return navigator.permissions.query({ name: 'geolocation' }).then(function(result) { window['events'].push(result.state); result.onchange = function() { window['events'].push(result.state); }; }); }); expect(await page.evaluate(() => window['events'])).toEqual(['prompt']); await context.grantPermissions([], { origin: server.EMPTY_PAGE }); expect(await page.evaluate(() => window['events'])).toEqual(['prompt', 'denied']); await context.grantPermissions(['geolocation'], { origin: server.EMPTY_PAGE }); expect(await page.evaluate(() => window['events'])).toEqual(['prompt', 'denied', 'granted']); await context.clearPermissions(); // Note: Chromium 110 stopped triggering "onchange" when clearing permissions. expect(await page.evaluate(() => window['events'])).toEqual( (browserName === 'chromium' && browserMajorVersion === 110) ? ['prompt', 'denied', 'granted'] : ['prompt', 'denied', 'granted', 'prompt']); }); it('should isolate permissions between browser contexts', async ({ server, browser }) => { const context = await browser.newContext(); const page = await context.newPage(); await page.goto(server.EMPTY_PAGE); const otherContext = await browser.newContext(); const otherPage = await otherContext.newPage(); await otherPage.goto(server.EMPTY_PAGE); expect(await getPermission(page, 'geolocation')).toBe('prompt'); expect(await getPermission(otherPage, 'geolocation')).toBe('prompt'); await context.grantPermissions([], { origin: server.EMPTY_PAGE }); await otherContext.grantPermissions(['geolocation'], { origin: server.EMPTY_PAGE }); expect(await getPermission(page, 'geolocation')).toBe('denied'); expect(await getPermission(otherPage, 'geolocation')).toBe('granted'); await context.clearPermissions(); expect(await getPermission(page, 'geolocation')).toBe('prompt'); expect(await getPermission(otherPage, 'geolocation')).toBe('granted'); await otherContext.close(); await context.close(); }); it('should support clipboard read', async ({ page, context, server, browserName, headless }) => { it.fail(browserName === 'webkit'); it.fail(browserName === 'firefox', 'No such permissions (requires flag) in Firefox'); it.fixme(browserName === 'chromium' && (!headless || !!process.env.PLAYWRIGHT_CHROMIUM_USE_HEADLESS_NEW)); await page.goto(server.EMPTY_PAGE); expect(await getPermission(page, 'clipboard-read')).toBe('prompt'); let error; await page.evaluate(() => navigator.clipboard.readText()).catch(e => error = e); expect(error.toString()).toContain('denied'); await context.grantPermissions(['clipboard-read']); expect(await getPermission(page, 'clipboard-read')).toBe('granted'); await page.evaluate(() => navigator.clipboard.readText()); }); });