/** * 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 './base.fixture'; import { registerFixture } from './runner/fixtures'; import fs from 'fs'; import utils from './utils'; import { BrowserType, Browser, BrowserContext, Page } from '..'; const { removeUserDataDir, makeUserDataDir } = utils; const { WIRE } = testOptions; declare global { interface FixtureState { launchPersistent: (options?: Parameters['launchPersistentContext']>[1]) => Promise<{context: BrowserContext, page: Page}>; } } registerFixture('launchPersistent', async ({tmpDir, defaultBrowserOptions, browserType}, test) => { let context; async function launchPersistent(options) { if (context) throw new Error('can only launch one persitent context'); context = await browserType.launchPersistentContext(tmpDir, {...defaultBrowserOptions, ...options}); const page = context.pages()[0]; return {context, page}; } await test(launchPersistent); if (context) await context.close(); }); it('context.cookies() should work', async ({server, launchPersistent}) => { const {page, context} = await launchPersistent(); await page.goto(server.EMPTY_PAGE); const documentCookie = await page.evaluate(() => { document.cookie = 'username=John Doe'; return document.cookie; }); expect(documentCookie).toBe('username=John Doe'); expect(await page.context().cookies()).toEqual([{ name: 'username', value: 'John Doe', domain: 'localhost', path: '/', expires: -1, httpOnly: false, secure: false, sameSite: FFOX ? 'Lax' : 'None', }]); }); it('context.addCookies() should work', async ({server, launchPersistent}) => { const {page, context} = await launchPersistent(); await page.goto(server.EMPTY_PAGE); await page.context().addCookies([{ url: server.EMPTY_PAGE, name: 'username', value: 'John Doe' }]); expect(await page.evaluate(() => document.cookie)).toBe('username=John Doe'); expect(await page.context().cookies()).toEqual([{ name: 'username', value: 'John Doe', domain: 'localhost', path: '/', expires: -1, httpOnly: false, secure: false, sameSite: 'None', }]); }); it('context.clearCookies() should work', async ({server, launchPersistent}) => { const {page, context} = await launchPersistent(); await page.goto(server.EMPTY_PAGE); await page.context().addCookies([{ url: server.EMPTY_PAGE, name: 'cookie1', value: '1' }, { url: server.EMPTY_PAGE, name: 'cookie2', value: '2' }]); expect(await page.evaluate('document.cookie')).toBe('cookie1=1; cookie2=2'); await page.context().clearCookies(); await page.reload(); expect(await page.context().cookies([])).toEqual([]); expect(await page.evaluate('document.cookie')).toBe(''); }); it('should(not) block third party cookies', async ({server, launchPersistent}) => { const {page, context} = await launchPersistent(); await page.goto(server.EMPTY_PAGE); await page.evaluate(src => { let fulfill; const promise = new Promise(x => fulfill = x); const iframe = document.createElement('iframe'); document.body.appendChild(iframe); iframe.onload = fulfill; iframe.src = src; return promise; }, server.CROSS_PROCESS_PREFIX + '/grid.html'); const documentCookie = await page.frames()[1].evaluate(() => { document.cookie = 'username=John Doe'; return document.cookie; }); await page.waitForTimeout(2000); const allowsThirdParty = CHROMIUM; expect(documentCookie).toBe(allowsThirdParty ? 'username=John Doe' : ''); const cookies = await context.cookies(server.CROSS_PROCESS_PREFIX + '/grid.html'); if (allowsThirdParty) { expect(cookies).toEqual([ { "domain": "127.0.0.1", "expires": -1, "httpOnly": false, "name": "username", "path": "/", "sameSite": "None", "secure": false, "value": "John Doe" } ]); } else { expect(cookies).toEqual([]); } }); it('should support viewport option', async ({launchPersistent}) => { const {page, context} = await launchPersistent({viewport: { width: 456, height: 789 }}); await utils.verifyViewport(page, 456, 789); const page2 = await context.newPage(); await utils.verifyViewport(page2, 456, 789); }); it('should support deviceScaleFactor option', async ({launchPersistent}) => { const {page, context} = await launchPersistent({deviceScaleFactor: 3}); expect(await page.evaluate('window.devicePixelRatio')).toBe(3); }); it('should support userAgent option', async ({server, launchPersistent}) => { const {page, context} = await launchPersistent({userAgent: 'foobar'}); expect(await page.evaluate(() => navigator.userAgent)).toBe('foobar'); const [request] = await Promise.all([ server.waitForRequest('/empty.html'), page.goto(server.EMPTY_PAGE), ]); expect(request.headers['user-agent']).toBe('foobar'); }); it('should support bypassCSP option', async ({server, launchPersistent}) => { const {page, context} = await launchPersistent({bypassCSP: true}); await page.goto(server.PREFIX + '/csp.html'); await page.addScriptTag({content: 'window["__injected"] = 42;'}); expect(await page.evaluate('__injected')).toBe(42); }); it('should support javascriptEnabled option', async ({server, launchPersistent}) => { const {page, context} = await launchPersistent({javaScriptEnabled: false}); await page.goto('data:text/html, '); let error = null; await page.evaluate('something').catch(e => error = e); if (WEBKIT) expect(error.message).toContain('Can\'t find variable: something'); else expect(error.message).toContain('something is not defined'); }); it('should support httpCredentials option', async ({server, launchPersistent}) => { const {page, context} = await launchPersistent({httpCredentials: { username: 'user', password: 'pass' }}); server.setAuth('/playground.html', 'user', 'pass'); const response = await page.goto(server.PREFIX + '/playground.html'); expect(response.status()).toBe(200); }); it('should support offline option', async ({server, launchPersistent}) => { const {page, context} = await launchPersistent({offline: true}); const error = await page.goto(server.EMPTY_PAGE).catch(e => e); expect(error).toBeTruthy(); }); it.skip(true)('should support acceptDownloads option', async ({server, launchPersistent}) => { // TODO: unskip once we support downloads in persistent context. const {page, context} = await launchPersistent({acceptDownloads: true}); server.setRoute('/download', (req, res) => { res.setHeader('Content-Type', 'application/octet-stream'); res.setHeader('Content-Disposition', 'attachment'); res.end(`Hello world`); }); await page.setContent(`download`); const [ download ] = await Promise.all([ page.waitForEvent('download'), page.click('a') ]); const path = await download.path(); expect(fs.existsSync(path)).toBeTruthy(); expect(fs.readFileSync(path).toString()).toBe('Hello world'); }); it('should support hasTouch option', async ({server, launchPersistent}) => { const {page, context} = await launchPersistent({hasTouch: true}); await page.goto(server.PREFIX + '/mobile.html'); expect(await page.evaluate(() => 'ontouchstart' in window)).toBe(true); }); it.skip(FFOX)('should work in persistent context', async ({server, launchPersistent}) => { // Firefox does not support mobile. const {page, context} = await launchPersistent({viewport: {width: 320, height: 480}, isMobile: true}); await page.goto(server.PREFIX + '/empty.html'); expect(await page.evaluate(() => window.innerWidth)).toBe(980); }); it('should support colorScheme option', async ({launchPersistent}) => { const {page, context} = await launchPersistent({colorScheme: 'dark'}); expect(await page.evaluate(() => matchMedia('(prefers-color-scheme: light)').matches)).toBe(false); expect(await page.evaluate(() => matchMedia('(prefers-color-scheme: dark)').matches)).toBe(true); }); it('should support timezoneId option', async ({launchPersistent}) => { const {page, context} = await launchPersistent({timezoneId: 'America/Jamaica'}); expect(await page.evaluate(() => new Date(1479579154987).toString())).toBe('Sat Nov 19 2016 13:12:34 GMT-0500 (Eastern Standard Time)'); }); it('should support locale option', async ({launchPersistent}) => { const {page, context} = await launchPersistent({locale: 'fr-CH'}); expect(await page.evaluate(() => navigator.language)).toBe('fr-CH'); }); it('should support geolocation and permissions options', async ({server, launchPersistent}) => { const {page, context} = await launchPersistent({geolocation: {longitude: 10, latitude: 10}, permissions: ['geolocation']}); await page.goto(server.EMPTY_PAGE); const geolocation = await page.evaluate(() => new Promise(resolve => navigator.geolocation.getCurrentPosition(position => { resolve({latitude: position.coords.latitude, longitude: position.coords.longitude}); }))); expect(geolocation).toEqual({latitude: 10, longitude: 10}); }); it('should support ignoreHTTPSErrors option', async ({httpsServer, launchPersistent}) => { const {page, context} = await launchPersistent({ignoreHTTPSErrors: true}); let error = null; const response = await page.goto(httpsServer.EMPTY_PAGE).catch(e => error = e); expect(error).toBe(null); expect(response.ok()).toBe(true); }); it('should support extraHTTPHeaders option', async ({server, launchPersistent}) => { const {page, context} = await launchPersistent({extraHTTPHeaders: { foo: 'bar' }}); const [request] = await Promise.all([ server.waitForRequest('/empty.html'), page.goto(server.EMPTY_PAGE), ]); expect(request.headers['foo']).toBe('bar'); }); it('should accept userDataDir', async ({launchPersistent, tmpDir}) => { const {page, context} = await launchPersistent(); // Note: we need an open page to make sure its functional. expect(fs.readdirSync(tmpDir).length).toBeGreaterThan(0); await context.close(); expect(fs.readdirSync(tmpDir).length).toBeGreaterThan(0); // This might throw. See https://github.com/GoogleChrome/puppeteer/issues/2778 await removeUserDataDir(tmpDir); }); it.slow()('should restore state from userDataDir', async({browserType, defaultBrowserOptions, server, launchPersistent}) => { const userDataDir = await makeUserDataDir(); const browserContext = await browserType.launchPersistentContext(userDataDir, defaultBrowserOptions); const page = await browserContext.newPage(); await page.goto(server.EMPTY_PAGE); await page.evaluate(() => localStorage.hey = 'hello'); await browserContext.close(); const browserContext2 = await browserType.launchPersistentContext(userDataDir, defaultBrowserOptions); const page2 = await browserContext2.newPage(); await page2.goto(server.EMPTY_PAGE); expect(await page2.evaluate(() => localStorage.hey)).toBe('hello'); await browserContext2.close(); const userDataDir2 = await makeUserDataDir(); const browserContext3 = await browserType.launchPersistentContext(userDataDir2, defaultBrowserOptions); const page3 = await browserContext3.newPage(); await page3.goto(server.EMPTY_PAGE); expect(await page3.evaluate(() => localStorage.hey)).not.toBe('hello'); await browserContext3.close(); // This might throw. See https://github.com/GoogleChrome/puppeteer/issues/2778 await removeUserDataDir(userDataDir); await removeUserDataDir(userDataDir2); }); it.fail(CHROMIUM && (WIN || MAC)).slow()('should restore cookies from userDataDir', async({browserType, defaultBrowserOptions, server, launchPersistent}) => { const userDataDir = await makeUserDataDir(); const browserContext = await browserType.launchPersistentContext(userDataDir, defaultBrowserOptions); const page = await browserContext.newPage(); await page.goto(server.EMPTY_PAGE); const documentCookie = await page.evaluate(() => { document.cookie = 'doSomethingOnlyOnce=true; expires=Fri, 31 Dec 9999 23:59:59 GMT'; return document.cookie; }); expect(documentCookie).toBe('doSomethingOnlyOnce=true'); await browserContext.close(); const browserContext2 = await browserType.launchPersistentContext(userDataDir, defaultBrowserOptions); const page2 = await browserContext2.newPage(); await page2.goto(server.EMPTY_PAGE); expect(await page2.evaluate(() => document.cookie)).toBe('doSomethingOnlyOnce=true'); await browserContext2.close(); const userDataDir2 = await makeUserDataDir(); const browserContext3 = await browserType.launchPersistentContext(userDataDir2, defaultBrowserOptions); const page3 = await browserContext3.newPage(); await page3.goto(server.EMPTY_PAGE); expect(await page3.evaluate(() => document.cookie)).not.toBe('doSomethingOnlyOnce=true'); await browserContext3.close(); // This might throw. See https://github.com/GoogleChrome/puppeteer/issues/2778 await removeUserDataDir(userDataDir); await removeUserDataDir(userDataDir2); }); it('should have default URL when launching browser', async ({launchPersistent}) => { const {page, context} = await launchPersistent(); const urls = context.pages().map(page => page.url()); expect(urls).toEqual(['about:blank']); }); it.skip(FFOX)('should throw if page argument is passed', async ({browserType, defaultBrowserOptions, server, tmpDir}) => { const options = {...defaultBrowserOptions, args: [server.EMPTY_PAGE] }; const error = await browserType.launchPersistentContext(tmpDir, options).catch(e => e); expect(error.message).toContain('can not specify page'); }); it.skip(WIRE)('should have passed URL when launching with ignoreDefaultArgs: true', async ({browserType, defaultBrowserOptions, server, tmpDir, toImpl}) => { const args = toImpl(browserType)._defaultArgs(defaultBrowserOptions, 'persistent', tmpDir, 0).filter(a => a !== 'about:blank'); const options = { ...defaultBrowserOptions, args: [...args, server.EMPTY_PAGE], ignoreDefaultArgs: true, }; const browserContext = await browserType.launchPersistentContext(tmpDir, options); if (!browserContext.pages().length) await browserContext.waitForEvent('page'); await browserContext.pages()[0].waitForLoadState(); const gotUrls = browserContext.pages().map(page => page.url()); expect(gotUrls).toEqual([server.EMPTY_PAGE]); await browserContext.close(); }); it.skip(WIRE)('should handle timeout', async({browserType, defaultBrowserOptions, tmpDir}) => { const options = { ...defaultBrowserOptions, timeout: 5000, __testHookBeforeCreateBrowser: () => new Promise(f => setTimeout(f, 6000)) }; const error = await browserType.launchPersistentContext(tmpDir, options).catch(e => e); expect(error.message).toContain(`browserType.launchPersistentContext: Timeout 5000ms exceeded.`); }); it.skip(WIRE)('should handle exception', async({browserType, defaultBrowserOptions, tmpDir}) => { const e = new Error('Dummy'); const options = { ...defaultBrowserOptions, __testHookBeforeCreateBrowser: () => { throw e; } }; const error = await browserType.launchPersistentContext(tmpDir, options).catch(e => e); expect(error.message).toContain('Dummy'); }); it('should fire close event for a persistent context', async({launchPersistent}) => { const {page, context} = await launchPersistent(); let closed = false; context.on('close', () => closed = true); await context.close(); expect(closed).toBe(true); }); it.skip(!CHROMIUM)('coverage should work', async ({server, launchPersistent}) => { const {page, context} = await launchPersistent(); await page.coverage.startJSCoverage(); await page.goto(server.PREFIX + '/jscoverage/simple.html', { waitUntil: 'load' }); const coverage = await page.coverage.stopJSCoverage(); expect(coverage.length).toBe(1); expect(coverage[0].url).toContain('/jscoverage/simple.html'); expect(coverage[0].functions.find(f => f.functionName === 'foo').ranges[0].count).toEqual(1); }); it.skip(CHROMIUM)('coverage should be missing', async ({launchPersistent}) => { const {page, context} = await launchPersistent(); expect(page.coverage).toBe(null); });