/** * Copyright 2017 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. */ const fs = require('fs'); const rm = require('rimraf').sync; const path = require('path'); const helper = require('../lib/helper'); if (process.env.COVERAGE) helper.recordPublicAPICoverage(); const Browser = require('../lib/Browser'); const SimpleServer = require('./server/SimpleServer'); const GoldenUtils = require('./golden-utils'); const YELLOW_COLOR = '\x1b[33m'; const RESET_COLOR = '\x1b[0m'; const GOLDEN_DIR = path.join(__dirname, 'golden'); const OUTPUT_DIR = path.join(__dirname, 'output'); const PORT = 8907; const PREFIX = 'http://localhost:' + PORT; const EMPTY_PAGE = PREFIX + '/empty.html'; const HTTPS_PORT = 8908; const HTTPS_PREFIX = 'https://localhost:' + HTTPS_PORT; const headless = (process.env.HEADLESS || 'true').trim().toLowerCase() === 'true'; const slowMo = parseInt((process.env.SLOW_MO || '0').trim(), 10); const executablePath = process.env.CHROME; if (executablePath) console.warn(`${YELLOW_COLOR}WARN: running tests with ${executablePath}${RESET_COLOR}`); const defaultBrowserOptions = { executablePath, slowMo, headless, args: ['--no-sandbox'] }; if (process.env.DEBUG_TEST || slowMo) jasmine.DEFAULT_TIMEOUT_INTERVAL = 1000 * 1000 * 1000; else jasmine.DEFAULT_TIMEOUT_INTERVAL = 10 * 1000; // Make sure the `npm install` was run after the chromium roll. { const Downloader = require('../utils/ChromiumDownloader'); const chromiumRevision = require('../package.json').puppeteer.chromium_revision; const revisionInfo = Downloader.revisionInfo(Downloader.currentPlatform(), chromiumRevision); console.assert(revisionInfo, `Chromium r${chromiumRevision} is not downloaded. Run 'npm install' and try to re-run tests.`); } let server; let httpsServer; beforeAll(SX(async function() { const assetsPath = path.join(__dirname, 'assets'); server = await SimpleServer.create(assetsPath, PORT); httpsServer = await SimpleServer.createHTTPS(assetsPath, HTTPS_PORT); if (fs.existsSync(OUTPUT_DIR)) rm(OUTPUT_DIR); })); afterAll(SX(async function() { await Promise.all([ server.stop(), httpsServer.stop(), ]); })); describe('Browser', function() { it('Browser.Options.ignoreHTTPSErrors', SX(async function() { let options = Object.assign({ignoreHTTPSErrors: true}, defaultBrowserOptions); let browser = new Browser(options); let page = await browser.newPage(); let error = null; let response = null; try { response = await page.goto(HTTPS_PREFIX + '/empty.html'); } catch (e) { error = e; } expect(error).toBe(null); expect(response.ok).toBe(true); browser.close(); })); it('should reject all promises when browser is closed', SX(async function() { let browser = new Browser(defaultBrowserOptions); let page = await browser.newPage(); let error = null; let neverResolves = page.evaluate(() => new Promise(r => {})).catch(e => error = e); browser.close(); await neverResolves; expect(error.message).toContain('Protocol error'); })); }); describe('Page', function() { const iPhone = require('../DeviceDescriptors')['iPhone 6']; const iPhoneLandscape = require('../DeviceDescriptors')['iPhone 6 landscape']; let browser; let page; beforeAll(SX(async function() { browser = new Browser(defaultBrowserOptions); })); afterAll(SX(async function() { browser.close(); })); beforeEach(SX(async function() { page = await browser.newPage(); server.reset(); httpsServer.reset(); GoldenUtils.addMatchers(jasmine, GOLDEN_DIR, OUTPUT_DIR); })); afterEach(SX(async function() { await page.close(); })); describe('Browser.version', function() { it('should return whether we are in headless', SX(async function() { let version = await browser.version(); expect(version.length).toBeGreaterThan(0); expect(version.startsWith('Headless')).toBe(headless); })); }); describe('Page.close', function() { it('should reject all promises when page is closed', SX(async function() { let newPage = await browser.newPage(); let neverResolves = newPage.evaluate(() => new Promise(r => {})); newPage.close(); let error = null; try { await neverResolves; } catch (e) { error = e; } expect(error.message).toContain('Protocol error'); })); }); describe('Page.evaluate', function() { it('should work', SX(async function() { let result = await page.evaluate(() => 7 * 3); expect(result).toBe(21); })); it('should await promise', SX(async function() { let result = await page.evaluate(() => Promise.resolve(8 * 7)); expect(result).toBe(56); })); it('should work from-inside inPageCallback', SX(async function() { // Setup inpage callback, which calls Page.evaluate await page.addBinding('callController', async function(a, b) { return await page.evaluate((a, b) => a * b, a, b); }); let result = await page.evaluate(async function() { return await callController(9, 3); }); expect(result).toBe(27); })); it('should reject promise with exception', SX(async function() { let error = null; try { await page.evaluate(() => not.existing.object.property); } catch (e) { error = e; } expect(error).toBeTruthy(); expect(error.message).toContain('not is not defined'); })); it('should return complex objects', SX(async function() { const object = {foo: 'bar!'}; let result = await page.evaluate(a => a, object); expect(result).not.toBe(object); expect(result).toEqual(object); })); it('should return NaN', SX(async function() { let result = await page.evaluate(() => NaN); expect(Object.is(result, NaN)).toBe(true); })); it('should return -0', SX(async function() { let result = await page.evaluate(() => -0); expect(Object.is(result, -0)).toBe(true); })); it('should return Infinity', SX(async function() { let result = await page.evaluate(() => Infinity); expect(Object.is(result, Infinity)).toBe(true); })); it('should return -Infinity', SX(async function() { let result = await page.evaluate(() => -Infinity); expect(Object.is(result, -Infinity)).toBe(true); })); it('should not fail for window object', SX(async function() { let result = await page.evaluate(() => window); expect(result).toBe('Window'); })); it('should accept a string', SX(async function() { let result = await page.evaluate('1 + 2'); expect(result).toBe(3); })); it('should accept a string with semi colons', SX(async function() { let result = await page.evaluate('1 + 5;'); expect(result).toBe(6); })); it('should accept a string with comments', SX(async function() { let result = await page.evaluate('2 + 5;\n// do some math!'); expect(result).toBe(7); })); }); describe('Page.injectFile', function() { it('should work', SX(async function() { const helloPath = path.join(__dirname, 'assets', 'injectedfile.js'); await page.injectFile(helloPath); const result = await page.evaluate(() => __injected); expect(result).toBe(42); })); it('should include sourcemap', SX(async function() { const helloPath = path.join(__dirname, 'assets', 'injectedfile.js'); await page.injectFile(helloPath); const result = await page.evaluate(() => __injectedError.stack); expect(result).toContain(path.join('assets', 'injectedfile.js')); })); }); describe('Frame.evaluate', function() { let FrameUtils = require('./frame-utils'); it('should have different execution contexts', SX(async function() { await page.goto(EMPTY_PAGE); await FrameUtils.attachFrame(page, 'frame1', EMPTY_PAGE); expect(page.frames().length).toBe(2); let frame1 = page.frames()[0]; let frame2 = page.frames()[1]; await frame1.evaluate(() => window.FOO = 'foo'); await frame2.evaluate(() => window.FOO = 'bar'); expect(await frame1.evaluate(() => window.FOO)).toBe('foo'); expect(await frame2.evaluate(() => window.FOO)).toBe('bar'); })); it('should execute after cross-site navigation', SX(async function() { await page.goto(EMPTY_PAGE); let mainFrame = page.mainFrame(); expect(await mainFrame.evaluate(() => window.location.href)).toContain('localhost'); await page.goto('http://127.0.0.1:' + PORT + '/empty.html'); expect(await mainFrame.evaluate(() => window.location.href)).toContain('127'); })); }); describe('Frame.waitForFunction', function() { it('should accept a string', SX(async function() { const watchdog = page.waitForFunction('window.__FOO === 1'); await page.evaluate(() => window.__FOO = 1); await watchdog; })); it('should poll on interval', SX(async function() { let success = false; const startTime = Date.now(); const polling = 100; const watchdog = page.waitForFunction(() => window.__FOO === 'hit', {polling}) .then(() => success = true); await page.evaluate(() => window.__FOO = 'hit'); expect(success).toBe(false); await page.evaluate(() => document.body.appendChild(document.createElement('div'))); await watchdog; expect(Date.now() - startTime).not.toBeLessThan(polling / 2); })); it('should poll on mutation', SX(async function() { let success = false; const watchdog = page.waitForFunction(() => window.__FOO === 'hit', {polling: 'mutation'}) .then(() => success = true); await page.evaluate(() => window.__FOO = 'hit'); expect(success).toBe(false); await page.evaluate(() => document.body.appendChild(document.createElement('div'))); await watchdog; })); it('should poll on raf', SX(async function() { const watchdog = page.waitForFunction(() => window.__FOO === 'hit', {polling: 'raf'}); await page.evaluate(() => window.__FOO = 'hit'); await watchdog; })); it('should throw on bad polling value', SX(async function() { let error = null; try { await page.waitForFunction(() => !!document.body, {polling: 'unknown'}); } catch (e) { error = e; } expect(error).toBeTruthy(); expect(error.message).toContain('polling'); })); it('should throw negative polling interval', SX(async function() { let error = null; try { await page.waitForFunction(() => !!document.body, {polling: -10}); } catch (e) { error = e; } expect(error).toBeTruthy(); expect(error.message).toContain('Cannot poll with non-positive interval'); })); }); describe('Frame.waitForSelector', function() { let FrameUtils = require('./frame-utils'); let addElement = tag => document.body.appendChild(document.createElement(tag)); it('should immediately resolve promise if node exists', SX(async function() { await page.goto(EMPTY_PAGE); let frame = page.mainFrame(); let added = false; await frame.waitForSelector('*').then(() => added = true); expect(added).toBe(true); added = false; await frame.evaluate(addElement, 'div'); await frame.waitForSelector('div').then(() => added = true); expect(added).toBe(true); })); it('should resolve promise when node is added', SX(async function() { await page.goto(EMPTY_PAGE); let frame = page.mainFrame(); let added = false; frame.waitForSelector('div').then(() => added = true); // run nop function.. await frame.evaluate(() => 42); // .. to be sure that waitForSelector promise is not resolved yet. expect(added).toBe(false); await frame.evaluate(addElement, 'br'); expect(added).toBe(false); await frame.evaluate(addElement, 'div'); expect(added).toBe(true); })); it('should work when node is added through innerHTML', SX(async function() { await page.goto(EMPTY_PAGE); let watchdog = page.waitForSelector('h3 div'); await page.evaluate(addElement, 'span'); await page.evaluate(() => document.querySelector('span').innerHTML = '

'); await watchdog; })); it('Page.waitForSelector is shortcut for main frame', SX(async function() { await page.goto(EMPTY_PAGE); await FrameUtils.attachFrame(page, 'frame1', EMPTY_PAGE); let otherFrame = page.frames()[1]; let added = false; page.waitForSelector('div').then(() => added = true); await otherFrame.evaluate(addElement, 'div'); expect(added).toBe(false); await page.evaluate(addElement, 'div'); expect(added).toBe(true); })); it('should run in specified frame', SX(async function() { await FrameUtils.attachFrame(page, 'frame1', EMPTY_PAGE); await FrameUtils.attachFrame(page, 'frame2', EMPTY_PAGE); let frame1 = page.frames()[1]; let frame2 = page.frames()[2]; let added = false; frame2.waitForSelector('div').then(() => added = true); expect(added).toBe(false); await frame1.evaluate(addElement, 'div'); expect(added).toBe(false); await frame2.evaluate(addElement, 'div'); expect(added).toBe(true); })); it('should throw if evaluation failed', SX(async function() { await page.evaluateOnNewDocument(function() { document.querySelector = null; }); await page.goto(EMPTY_PAGE); try { await page.waitForSelector('*'); fail('Failed waitForSelector did not throw.'); } catch (e) { expect(e.message).toContain('document.querySelector is not a function'); } })); it('should throw when frame is detached', SX(async function() { await FrameUtils.attachFrame(page, 'frame1', EMPTY_PAGE); let frame = page.frames()[1]; let waitError = null; let waitPromise = frame.waitForSelector('.box').catch(e => waitError = e); await FrameUtils.detachFrame(page, 'frame1'); await waitPromise; expect(waitError).toBeTruthy(); expect(waitError.message).toContain('waitForSelector failed: frame got detached.'); })); it('should survive navigation', SX(async function() { let boxFound = false; let waitForSelector = page.waitForSelector('.box').then(() => boxFound = true); await page.goto(EMPTY_PAGE); expect(boxFound).toBe(false); await page.reload(); expect(boxFound).toBe(false); await page.goto(PREFIX + '/grid.html'); await waitForSelector; expect(boxFound).toBe(true); })); it('should wait for visible', SX(async function() { let divFound = false; let waitForSelector = page.waitForSelector('div', {visible: true}).then(() => divFound = true); await page.setContent(`
`); expect(divFound).toBe(false); await page.evaluate(() => document.querySelector('div').style.removeProperty('display')); expect(divFound).toBe(false); await page.evaluate(() => document.querySelector('div').style.removeProperty('visibility')); expect(await waitForSelector).toBe(true); })); it('should respect timeout', SX(async function() { let error = null; await page.waitForSelector('div', {timeout: 10}).catch(e => error = e); expect(error).toBeTruthy(); expect(error.message).toContain('waiting failed: timeout'); })); }); describe('Page.waitFor', function() { it('should wait for selector', SX(async function() { let found = false; let waitFor = page.waitFor('div').then(() => found = true); await page.goto(EMPTY_PAGE); expect(found).toBe(false); await page.goto(PREFIX + '/grid.html'); await waitFor; expect(found).toBe(true); })); it('should timeout', SX(async function() { let startTime = Date.now(); const timeout = 42; await page.waitFor(timeout); expect(Date.now() - startTime).not.toBeLessThan(timeout / 2); })); it('should wait for predicate', SX(async function() { const watchdog = page.waitFor(() => window.innerWidth < 100); page.setViewport({width: 10, height: 10}); await watchdog; })); it('should throw when unknown type', SX(async function() { try { await page.waitFor({foo: 'bar'}); fail('Failed to throw exception'); } catch (e) { expect(e.message).toContain('Unsupported target type'); } })); }); describe('Page.Events.Console', function() { it('should work', SX(async function() { let commandArgs = []; page.once('console', (...args) => commandArgs = args); await Promise.all([ page.evaluate(() => console.log(5, 'hello', {foo: 'bar'})), waitForEvents(page, 'console') ]); expect(commandArgs).toEqual([5, 'hello', {foo: 'bar'}]); })); it('should work for different console API calls', SX(async function() { let messages = []; page.on('console', msg => messages.push(msg)); await Promise.all([ page.evaluate(() => { // A pair of time/timeEnd generates only one Console API call. console.time('calling console.time'); console.timeEnd('calling console.time'); console.trace('calling console.trace'); console.dir('calling console.dir'); console.warn('calling console.warn'); console.error('calling console.error'); }), // Wait for 5 events to hit. waitForEvents(page, 'console', 5) ]); expect(messages[0]).toContain('calling console.time'); expect(messages.slice(1)).toEqual([ 'calling console.trace', 'calling console.dir', 'calling console.warn', 'calling console.error', ]); })); it('should not fail for window object', SX(async function() { let windowObj = null; page.once('console', arg => windowObj = arg); await Promise.all([ page.evaluate(() => console.error(window)), waitForEvents(page, 'console') ]); expect(windowObj).toBe('Window'); })); }); describe('Page.navigate', function() { it('should navigate to about:blank', SX(async function() { let response = await page.goto('about:blank'); expect(response).toBe(null); })); it('should fail when navigating to bad url', SX(async function() { let error = null; try { await page.goto('asdfasdf'); } catch (e) { error = e; } expect(error.message).toContain('Cannot navigate to invalid URL'); })); it('should fail when navigating to bad SSL', SX(async function() { // Make sure that network events do not emit 'undefind'. // @see https://crbug.com/750469 page.on('request', request => expect(request).toBeTruthy()); page.on('requestfinished', request => expect(request).toBeTruthy()); page.on('requestfailed', request => expect(request).toBeTruthy()); let error = null; try { await page.goto(HTTPS_PREFIX + '/empty.html'); } catch (e) { error = e; } expect(error.message).toContain('SSL Certificate error'); })); it('should fail when main resources failed to load', SX(async function() { let error = null; try { await page.goto('chrome-devtools://non-existing.html'); } catch (e) { error = e; } expect(error.message).toContain('Failed to navigate'); })); it('should fail when exceeding maximum navigation timeout', SX(async function() { let error = null; // Hang for request to the empty.html server.setRoute('/empty.html', (req, res) => { }); try { await page.goto(PREFIX + '/empty.html', {timeout: 59}); } catch (e) { error = e; } expect(error.message).toContain('Navigation Timeout Exceeded: 59ms'); })); it('should work when navigating to valid url', SX(async function() { const response = await page.goto(EMPTY_PAGE); expect(response.ok).toBe(true); })); it('should work when navigating to data url', SX(async function() { const response = await page.goto('data:text/html,hello'); expect(response.ok).toBe(true); })); it('should work when navigating to 404', SX(async function() { const response = await page.goto(PREFIX + '/not-found'); expect(response.ok).toBe(false); expect(response.status).toBe(404); })); it('should return last response in redirect chain', SX(async function() { server.setRedirect('/redirect/1.html', '/redirect/2.html'); server.setRedirect('/redirect/2.html', '/redirect/3.html'); server.setRedirect('/redirect/3.html', EMPTY_PAGE); const response = await page.goto(PREFIX + '/redirect/1.html'); expect(response.ok).toBe(true); expect(response.url).toBe(EMPTY_PAGE); })); it('should wait for network idle to succeed navigation', SX(async function() { let responses = []; // Hold on to a bunch of requests without answering. server.setRoute('/fetch-request-a.js', (req, res) => responses.push(res)); server.setRoute('/fetch-request-b.js', (req, res) => responses.push(res)); server.setRoute('/fetch-request-c.js', (req, res) => responses.push(res)); server.setRoute('/fetch-request-d.js', (req, res) => responses.push(res)); let initialFetchResourcesRequested = Promise.all([ server.waitForRequest('/fetch-request-a.js'), server.waitForRequest('/fetch-request-b.js'), server.waitForRequest('/fetch-request-c.js'), ]); let secondFetchResourceRequested = server.waitForRequest('/fetch-request-d.js'); // Navigate to a page which loads immediately and then does a bunch of // requests via javascript's fetch method. let navigationPromise = page.goto(PREFIX + '/networkidle.html', { waitUntil: 'networkidle', networkIdleTimeout: 100, networkIdleInflight: 0, // Only be idle when there are 0 inflight requests }); // Track when the navigation gets completed. let navigationFinished = false; navigationPromise.then(() => navigationFinished = true); // Wait for the page's 'load' event. await new Promise(fulfill => page.once('load', fulfill)); expect(navigationFinished).toBe(false); // Wait for the initial three resources to be requested. await initialFetchResourcesRequested; // Expect navigation still to be not finished. expect(navigationFinished).toBe(false); // Respond to initial requests. for (let response of responses) { response.statusCode = 404; response.end(`File not found`); } // Reset responses array responses = []; // Wait for the second round to be requested. await secondFetchResourceRequested; // Expect navigation still to be not finished. expect(navigationFinished).toBe(false); // Respond to requests. for (let response of responses) { response.statusCode = 404; response.end(`File not found`); } const response = await navigationPromise; // Expect navigation to succeed. expect(response.ok).toBe(true); })); it('should wait for websockets to succeed navigation', SX(async function() { let responses = []; // Hold on to the fetch request without answering. server.setRoute('/fetch-request.js', (req, res) => responses.push(res)); let fetchResourceRequested = server.waitForRequest('/fetch-request.js'); // Navigate to a page which loads immediately and then opens a bunch of // websocket connections and then a fetch request. let navigationPromise = page.goto(PREFIX + '/websocket.html', { waitUntil: 'networkidle', networkIdleTimeout: 100, networkIdleInflight: 0, // Only be idle when there are 0 inflight requests/connections }); // Track when the navigation gets completed. let navigationFinished = false; navigationPromise.then(() => navigationFinished = true); // Wait for the page's 'load' event. await new Promise(fulfill => page.once('load', fulfill)); expect(navigationFinished).toBe(false); // Wait for the resource to be requested. await fetchResourceRequested; // Expect navigation still to be not finished. expect(navigationFinished).toBe(false); // Respond to the request. for (let response of responses) { response.statusCode = 404; response.end(`File not found`); } const response = await navigationPromise; // Expect navigation to succeed. expect(response.ok).toBe(true); })); it('should not leak listeners durint navigation', SX(async function() { let warning = null; const warningHandler = w => warning = w; process.on('warning', warningHandler); for (let i = 0; i < 20; ++i) await page.goto(EMPTY_PAGE); process.removeListener('warning', warningHandler); expect(warning).toBe(null); })); }); describe('Page.waitForNavigation', function() { it('should work', SX(async function() { await page.goto(EMPTY_PAGE); const [result] = await Promise.all([ page.waitForNavigation(), page.evaluate(url => window.location.href = url, PREFIX + '/grid.html') ]); const response = await result; expect(response.ok).toBe(true); expect(response.url).toContain('grid.html'); })); }); describe('Page.goBack', function() { it('should work', SX(async function() { await page.goto(EMPTY_PAGE); await page.goto(PREFIX + '/grid.html'); let response = await page.goBack(); expect(response.ok).toBe(true); expect(response.url).toContain(EMPTY_PAGE); response = await page.goForward(); expect(response.ok).toBe(true); expect(response.url).toContain('/grid.html'); response = await page.goForward(); expect(response).toBe(null); })); }); describe('Page.addBinding', function() { it('should work', SX(async function() { await page.addBinding('compute', function(a, b) { return a * b; }); let result = await page.evaluate(async function() { return await compute(9, 4); }); expect(result).toBe(36); })); it('should survive navigation', SX(async function() { await page.addBinding('compute', function(a, b) { return a * b; }); await page.goto(EMPTY_PAGE); let result = await page.evaluate(async function() { return await compute(9, 4); }); expect(result).toBe(36); })); it('should await returned promise', SX(async function() { await page.addBinding('compute', function(a, b) { return Promise.resolve(a * b); }); let result = await page.evaluate(async function() { return await compute(3, 5); }); expect(result).toBe(15); })); }); describe('Page.setRequestInterceptionEnabled', function() { it('should intercept', SX(async function() { await page.setRequestInterceptionEnabled(true); page.on('request', request => { expect(request.url).toContain('empty.html'); expect(request.headers.has('User-Agent')).toBeTruthy(); expect(request.method).toBe('GET'); expect(request.postData).toBe(undefined); request.continue(); }); const response = await page.goto(EMPTY_PAGE); expect(response.ok).toBe(true); })); it('should show custom HTTP headers', SX(async function() { await page.setExtraHTTPHeaders(new Map(Object.entries({ foo: 'bar' }))); await page.setRequestInterceptionEnabled(true); page.on('request', request => { expect(request.headers.get('foo')).toBe('bar'); request.continue(); }); const response = await page.goto(EMPTY_PAGE); expect(response.ok).toBe(true); })); it('should be abortable', SX(async function() { await page.setRequestInterceptionEnabled(true); page.on('request', request => { if (request.url.endsWith('.css')) request.abort(); else request.continue(); }); let failedRequests = 0; page.on('requestfailed', event => ++failedRequests); const response = await page.goto(PREFIX + '/one-style.html'); expect(response.ok).toBe(true); expect(failedRequests).toBe(1); })); it('should amend HTTP headers', SX(async function() { await page.setRequestInterceptionEnabled(true); page.on('request', request => { let headers = new Map(request.headers); headers.set('foo', 'bar'); request.continue({ headers }); }); await page.goto(EMPTY_PAGE); const [request] = await Promise.all([ server.waitForRequest('/sleep.zzz'), page.evaluate(() => fetch('/sleep.zzz')) ]); expect(request.headers['foo']).toBe('bar'); })); it('should fail navigation when aborting main resource', SX(async function() { await page.setRequestInterceptionEnabled(true); page.on('request', request => request.abort()); let error = null; try { await page.goto(EMPTY_PAGE); } catch (e) { error = e; } expect(error).toBeTruthy(); expect(error.message).toContain('Failed to navigate'); })); it('should work with redirects', SX(async function() { await page.setRequestInterceptionEnabled(true); page.on('request', request => request.continue()); server.setRedirect('/non-existing-page.html', '/non-existing-page-2.html'); server.setRedirect('/non-existing-page-2.html', '/non-existing-page-3.html'); server.setRedirect('/non-existing-page-3.html', '/non-existing-page-4.html'); server.setRedirect('/non-existing-page-4.html', '/empty.html'); let response = await page.goto(PREFIX + '/non-existing-page.html'); expect(response.status).toBe(200); expect(response.url).toContain('empty.html'); })); it('should be able to abort redirects', SX(async function() { await page.setRequestInterceptionEnabled(true); server.setRedirect('/non-existing.json', '/non-existing-2.json'); server.setRedirect('/non-existing-2.json', '/simple.html'); page.on('request', request => { if (request.url.includes('non-existing-2')) request.abort(); else request.continue(); }); await page.goto(EMPTY_PAGE); let result = await page.evaluate(async() => { try { await fetch('/non-existing.json'); } catch (e) { return e.message; } }); expect(result).toContain('Failed to fetch'); })); it('should work with equal requests', SX(async function() { await page.goto(EMPTY_PAGE); let responseCount = 1; server.setRoute('/zzz', (req, res) => res.end((responseCount++) * 11 + '')); await page.setRequestInterceptionEnabled(true); let spinner = false; // Cancel 2nd request. page.on('request', request => { spinner ? request.abort() : request.continue(); spinner = !spinner; }); let results = await page.evaluate(() => Promise.all([ fetch('/zzz').then(response => response.text()).catch(e => 'FAILED'), fetch('/zzz').then(response => response.text()).catch(e => 'FAILED'), fetch('/zzz').then(response => response.text()).catch(e => 'FAILED'), ])); expect(results).toEqual(['11', 'FAILED', '22']); })); }); describe('Page.Events.Dialog', function() { it('should fire', SX(async function() { page.on('dialog', dialog => { expect(dialog.type).toBe('alert'); expect(dialog.defaultValue()).toBe(''); expect(dialog.message()).toBe('yo'); dialog.accept(); }); await page.evaluate(() => alert('yo')); })); it('should allow accepting prompts', SX(async function() { page.on('dialog', dialog => { expect(dialog.type).toBe('prompt'); expect(dialog.defaultValue()).toBe('yes.'); expect(dialog.message()).toBe('question?'); dialog.accept('answer!'); }); let result = await page.evaluate(() => prompt('question?', 'yes.')); expect(result).toBe('answer!'); })); it('should dismiss the prompt', SX(async function() { page.on('dialog', dialog => { dialog.dismiss(); }); let result = await page.evaluate(() => prompt('question?')); expect(result).toBe(null); })); }); describe('Page.Events.PageError', function() { it('should fire', SX(async function() { let error = null; page.once('pageerror', e => error = e); page.goto(PREFIX + '/error.html'); await waitForEvents(page, 'pageerror'); expect(error.message).toContain('Fancy'); })); }); describe('Page.Events.Request', function() { it('should fire', SX(async function() { let requests = []; page.on('request', request => requests.push(request)); await page.goto(EMPTY_PAGE); expect(requests.length).toBe(1); expect(requests[0].url).toContain('empty.html'); })); }); describe('Frame Management', function() { let FrameUtils = require('./frame-utils'); it('should handle nested frames', SX(async function() { await page.goto(PREFIX + '/frames/nested-frames.html'); expect(FrameUtils.dumpFrames(page.mainFrame())).toBeGolden('nested-frames.txt'); })); it('should send events when frames are manipulated dynamically', SX(async function() { await page.goto(EMPTY_PAGE); // validate frameattached events let attachedFrames = []; page.on('frameattached', frame => attachedFrames.push(frame)); await FrameUtils.attachFrame(page, 'frame1', './assets/frame.html'); expect(attachedFrames.length).toBe(1); expect(attachedFrames[0].url()).toContain('/assets/frame.html'); // validate framenavigated events let navigatedFrames = []; page.on('framenavigated', frame => navigatedFrames.push(frame)); await FrameUtils.navigateFrame(page, 'frame1', './empty.html'); expect(navigatedFrames.length).toBe(1); expect(navigatedFrames[0].url()).toContain('/empty.html'); // validate framedetached events let detachedFrames = []; page.on('framedetached', frame => detachedFrames.push(frame)); await FrameUtils.detachFrame(page, 'frame1'); expect(detachedFrames.length).toBe(1); expect(detachedFrames[0].isDetached()).toBe(true); })); it('should persist mainFrame on cross-process navigation', SX(async function() { await page.goto(EMPTY_PAGE); let mainFrame = page.mainFrame(); await page.goto('http://127.0.0.1:' + PORT + '/empty.html'); expect(page.mainFrame() === mainFrame).toBeTruthy(); })); it('should not send attach/detach events for main frame', SX(async function() { let hasEvents = false; page.on('frameattached', frame => hasEvents = true); page.on('framedetached', frame => hasEvents = true); await page.goto(EMPTY_PAGE); expect(hasEvents).toBe(false); })); it('should detach child frames on navigation', SX(async function() { let attachedFrames = []; let detachedFrames = []; let navigatedFrames = []; page.on('frameattached', frame => attachedFrames.push(frame)); page.on('framedetached', frame => detachedFrames.push(frame)); page.on('framenavigated', frame => navigatedFrames.push(frame)); await page.goto(PREFIX + '/frames/nested-frames.html'); expect(attachedFrames.length).toBe(4); expect(detachedFrames.length).toBe(0); expect(navigatedFrames.length).toBe(5); attachedFrames = []; detachedFrames = []; navigatedFrames = []; await page.goto(EMPTY_PAGE); expect(attachedFrames.length).toBe(0); expect(detachedFrames.length).toBe(4); expect(navigatedFrames.length).toBe(1); })); it('should report frame.name()', SX(async function() { await FrameUtils.attachFrame(page, 'theFrameId', EMPTY_PAGE); await page.evaluate(url => { let frame = document.createElement('iframe'); frame.name = 'theFrameName'; frame.src = url; document.body.appendChild(frame); return new Promise(x => frame.onload = x); }, EMPTY_PAGE); expect(page.frames()[0].name()).toBe(''); expect(page.frames()[1].name()).toBe('theFrameId'); expect(page.frames()[2].name()).toBe('theFrameName'); })); it('should report frame.parent()', SX(async function() { await FrameUtils.attachFrame(page, 'frame1', EMPTY_PAGE); await FrameUtils.attachFrame(page, 'frame2', EMPTY_PAGE); expect(page.frames()[0].parentFrame()).toBe(null); expect(page.frames()[1].parentFrame()).toBe(page.mainFrame()); expect(page.frames()[2].parentFrame()).toBe(page.mainFrame()); })); }); describe('input', function() { it('should click the button', SX(async function() { await page.goto(PREFIX + '/input/button.html'); await page.click('button'); expect(await page.evaluate(() => result)).toBe('Clicked'); })); it('should fail to click a missing button', SX(async function() { await page.goto(PREFIX + '/input/button.html'); try { await page.click('button.does-not-exist'); fail('Clicking the button did not throw.'); } catch (error) { expect(error.message).toBe('No node found for selector: button.does-not-exist'); } })); // @see https://github.com/GoogleChrome/puppeteer/issues/161 it('should not hang with touch-enabled viewports', SX(async function() { await page.setViewport(iPhone.viewport); await page.mouse.down(); await page.mouse.move(100, 10); await page.mouse.up(); })); it('should type into the textarea', SX(async function() { await page.goto(PREFIX + '/input/textarea.html'); await page.focus('textarea'); await page.type('Type in this text!'); expect(await page.evaluate(() => result)).toBe('Type in this text!'); })); it('should click the button after navigation ', SX(async function() { await page.goto(PREFIX + '/input/button.html'); await page.click('button'); await page.goto(PREFIX + '/input/button.html'); await page.click('button'); expect(await page.evaluate(() => result)).toBe('Clicked'); })); it('should upload the file', SX(async function(){ await page.goto(PREFIX + '/input/fileupload.html'); const filePath = path.relative(process.cwd(), __dirname + '/assets/file-to-upload.txt'); await page.uploadFile('input', filePath); expect(await page.evaluate(() => { let input = document.querySelector('input'); return input.files[0].name; })).toBe('file-to-upload.txt'); expect(await page.evaluate(() => { let input = document.querySelector('input'); let reader = new FileReader(); let promise = new Promise(fulfill => reader.onload = fulfill); reader.readAsText(input.files[0]); return promise.then(() => reader.result); })).toBe('contents of the file'); })); it('should move with the arrow keys', SX(async function(){ await page.goto(PREFIX + '/input/textarea.html'); await page.focus('textarea'); await page.type('Hello World!'); expect(await page.evaluate(() => document.querySelector('textarea').value)).toBe('Hello World!'); for (let i = 0; i < 'World!'.length; i++) page.press('ArrowLeft'); await page.type('inserted '); expect(await page.evaluate(() => document.querySelector('textarea').value)).toBe('Hello inserted World!'); page.keyboard.down('Shift'); for (let i = 0; i < 'inserted '.length; i++) page.press('ArrowLeft'); page.keyboard.up('Shift'); await page.press('Backspace'); expect(await page.evaluate(() => document.querySelector('textarea').value)).toBe('Hello World!'); })); it('should send a character with Page.press', SX(async function() { await page.goto(PREFIX + '/input/textarea.html'); await page.focus('textarea'); await page.press('a', {text: 'f'}); expect(await page.evaluate(() => document.querySelector('textarea').value)).toBe('f'); await page.evaluate(() => window.addEventListener('keydown', e => e.preventDefault(), true)); await page.press('a', {text: 'y'}); expect(await page.evaluate(() => document.querySelector('textarea').value)).toBe('f'); })); it('should send a character with sendCharacter', SX(async function() { await page.goto(PREFIX + '/input/textarea.html'); await page.focus('textarea'); await page.keyboard.sendCharacter('嗨'); expect(await page.evaluate(() => document.querySelector('textarea').value)).toBe('嗨'); await page.evaluate(() => window.addEventListener('keydown', e => e.preventDefault(), true)); await page.keyboard.sendCharacter('a'); expect(await page.evaluate(() => document.querySelector('textarea').value)).toBe('嗨a'); })); it('should report shiftKey', SX(async function(){ await page.goto(PREFIX + '/input/keyboard.html'); let keyboard = page.keyboard; let codeForKey = {'Shift': 16, 'Alt': 18, 'Meta': 91, 'Control': 17}; for (let modifierKey in codeForKey) { await keyboard.down(modifierKey); expect(await page.evaluate(() => getResult())).toBe('Keydown: ' + modifierKey + ' ' + codeForKey[modifierKey] + ' [' + modifierKey + ']'); await keyboard.down('!'); expect(await page.evaluate(() => getResult())).toBe('Keydown: ! 49 [' + modifierKey + ']'); await keyboard.up('!'); expect(await page.evaluate(() => getResult())).toBe('Keyup: ! 49 [' + modifierKey + ']'); await keyboard.up(modifierKey); expect(await page.evaluate(() => getResult())).toBe('Keyup: ' + modifierKey + ' ' + codeForKey[modifierKey] + ' []'); } })); it('should report multiple modifiers', SX(async function(){ await page.goto(PREFIX + '/input/keyboard.html'); let keyboard = page.keyboard; await keyboard.down('Control'); expect(await page.evaluate(() => getResult())).toBe('Keydown: Control 17 [Control]'); await keyboard.down('Meta'); expect(await page.evaluate(() => getResult())).toBe('Keydown: Meta 91 [Control Meta]'); await keyboard.down(';'); expect(await page.evaluate(() => getResult())).toBe('Keydown: ; 186 [Control Meta]'); await keyboard.up(';'); expect(await page.evaluate(() => getResult())).toBe('Keyup: ; 186 [Control Meta]'); await keyboard.up('Control'); expect(await page.evaluate(() => getResult())).toBe('Keyup: Control 17 [Meta]'); await keyboard.up('Meta'); expect(await page.evaluate(() => getResult())).toBe('Keyup: Meta 91 []'); })); it('should send proper codes while typing', SX(async function(){ await page.goto(PREFIX + '/input/keyboard.html'); await page.type('!'); expect(await page.evaluate(() => getResult())).toBe( [ 'Keydown: ! 49 []', 'Keypress: ! 33 33 33 []', 'Keyup: ! 49 []'].join('\n')); await page.type('^'); expect(await page.evaluate(() => getResult())).toBe( [ 'Keydown: ^ 54 []', 'Keypress: ^ 94 94 94 []', 'Keyup: ^ 54 []'].join('\n')); })); it('should send propery codes while typing with shift', SX(async function(){ await page.goto(PREFIX + '/input/keyboard.html'); let keyboard = page.keyboard; await keyboard.down('Shift'); await page.type('~'); expect(await page.evaluate(() => getResult())).toBe( [ 'Keydown: Shift 16 [Shift]', 'Keydown: ~ 192 [Shift]', // 192 is ` keyCode 'Keypress: ~ 126 126 126 [Shift]', // 126 is ~ charCode 'Keyup: ~ 192 [Shift]'].join('\n')); await keyboard.up('Shift'); })); it('should not type canceled events', SX(async function(){ await page.goto(PREFIX + '/input/textarea.html'); await page.focus('textarea'); await page.evaluate(() => { window.addEventListener('keydown', event => { event.stopPropagation(); event.stopImmediatePropagation(); if (event.key === 'l') event.preventDefault(); if (event.key === 'o') Promise.resolve().then(() => event.preventDefault()); }, false); }); await page.type('Hello World!'); expect(await page.evaluate(() => textarea.value)).toBe('He Wrd!'); })); it('keyboard.modifiers()', SX(async function(){ let keyboard = page.keyboard; expect(keyboard._modifiers).toBe(0); await keyboard.down('Shift'); expect(keyboard._modifiers).toBe(8); await keyboard.down('Alt'); expect(keyboard._modifiers).toBe(9); await keyboard.up('Shift'); await keyboard.up('Alt'); expect(keyboard._modifiers).toBe(0); })); it('should resize the textarea', SX(async function(){ await page.goto(PREFIX + '/input/textarea.html'); let {x, y, width, height} = await page.evaluate(dimensions); let mouse = page.mouse; await mouse.move(x + width - 4, y + height - 4); await mouse.down(); await mouse.move(x + width + 100, y + height + 100); await mouse.up(); let newDimensions = await page.evaluate(dimensions); expect(newDimensions.width).toBe(width + 104); expect(newDimensions.height).toBe(height + 104); })); it('should scroll and click the button', SX(async function(){ await page.goto(PREFIX + '/input/scrollable.html'); await page.click('#button-5'); expect(await page.evaluate(() => document.querySelector('#button-5').textContent)).toBe('clicked'); await page.click('#button-80'); expect(await page.evaluate(() => document.querySelector('#button-80').textContent)).toBe('clicked'); })); it('should click a partially obscured button', SX(async function() { await page.goto(PREFIX + '/input/button.html'); await page.evaluate(() => { let button = document.querySelector('button'); button.textContent = 'Some really long text that will go offscreen'; button.style.position = 'absolute'; button.style.left = '368px'; }); await page.click('button'); expect(await page.evaluate(() => window.result)).toBe('Clicked'); })); it('should select the text with mouse', SX(async function(){ await page.goto(PREFIX + '/input/textarea.html'); await page.focus('textarea'); let text = 'This is the text that we are going to try to select. Let\'s see how it goes.'; await page.type(text); await page.evaluate(() => document.querySelector('textarea').scrollTop = 0); let {x, y} = await page.evaluate(dimensions); await page.mouse.move(x + 2,y + 2); await page.mouse.down(); await page.mouse.move(100,100); await page.mouse.up(); expect(await page.evaluate(() => window.getSelection().toString())).toBe(text); })); it('should select the text by triple clicking', SX(async function(){ await page.goto(PREFIX + '/input/textarea.html'); await page.focus('textarea'); let text = 'This is the text that we are going to try to select. Let\'s see how it goes.'; await page.type(text); await page.click('textarea'); await page.click('textarea', {clickCount: 2}); await page.click('textarea', {clickCount: 3}); expect(await page.evaluate(() => window.getSelection().toString())).toBe(text); })); it('should trigger hover state', SX(async function(){ await page.goto(PREFIX + '/input/scrollable.html'); await page.hover('#button-6'); expect(await page.evaluate(() => document.querySelector('button:hover').id)).toBe('button-6'); await page.hover('#button-2'); expect(await page.evaluate(() => document.querySelector('button:hover').id)).toBe('button-2'); await page.hover('#button-91'); expect(await page.evaluate(() => document.querySelector('button:hover').id)).toBe('button-91'); })); it('should fire contextmenu event on right click', SX(async function(){ await page.goto(PREFIX + '/input/scrollable.html'); await page.click('#button-8', {button: 'right'}); expect(await page.evaluate(() => document.querySelector('#button-8').textContent)).toBe('context menu'); })); it('should set modifier keys on click', SX(async function(){ await page.goto(PREFIX + '/input/scrollable.html'); await page.evaluate(() => document.querySelector('#button-3').addEventListener('mousedown', e => window.lastEvent = e, true)); let modifiers = {'Shift': 'shiftKey', 'Control': 'ctrlKey', 'Alt': 'altKey', 'Meta': 'metaKey'}; for (let modifier in modifiers) { await page.keyboard.down(modifier); await page.click('#button-3'); if (!(await page.evaluate(mod => window.lastEvent[mod], modifiers[modifier]))) fail(modifiers[modifier] + ' should be true'); await page.keyboard.up(modifier); } await page.click('#button-3'); for (let modifier in modifiers) { if ((await page.evaluate(mod => window.lastEvent[mod], modifiers[modifier]))) fail(modifiers[modifier] + ' should be false'); } })); it('should specify repeat property', SX(async function(){ await page.goto(PREFIX + '/input/textarea.html'); await page.focus('textarea'); await page.evaluate(() => document.querySelector('textarea').addEventListener('keydown', e => window.lastEvent = e, true)); await page.keyboard.down('a', {text: 'a'}); expect(await page.evaluate(() => window.lastEvent.repeat)).toBe(false); await page.press('a'); expect(await page.evaluate(() => window.lastEvent.repeat)).toBe(true); })); // @see https://github.com/GoogleChrome/puppeteer/issues/206 it('should click links which cause navigation', SX(async function() { await page.setContent(`empty.html`); // This await should not hang. await page.click('a'); })); function dimensions() { let rect = document.querySelector('textarea').getBoundingClientRect(); return { x: rect.left, y: rect.top, width: rect.width, height: rect.height }; } }); describe('Page.setUserAgent', function() { it('should work', SX(async function() { expect(await page.evaluate(() => navigator.userAgent)).toContain('Mozilla'); page.setUserAgent('foobar'); page.goto(EMPTY_PAGE); let request = await server.waitForRequest('/empty.html'); expect(request.headers['user-agent']).toBe('foobar'); })); it('should emulate device user-agent', SX(async function() { await page.goto(PREFIX + '/mobile.html'); expect(await page.evaluate(() => navigator.userAgent)).toContain('Chrome'); await page.setUserAgent(iPhone.userAgent); expect(await page.evaluate(() => navigator.userAgent)).toContain('Safari'); })); }); describe('Page.setExtraHTTPHeaders', function() { it('should work', SX(async function() { await page.setExtraHTTPHeaders(new Map(Object.entries({ foo: 'bar' }))); page.goto(EMPTY_PAGE); let request = await server.waitForRequest('/empty.html'); expect(request.headers['foo']).toBe('bar'); })); }); describe('Page.setContent', function() { it('should work', SX(async function() { await page.setContent('
hello
'); let result = await page.evaluate(() => document.body.innerHTML); expect(result).toBe('
hello
'); })); }); describe('Network Events', function() { it('Page.Events.Request', SX(async function() { let requests = []; page.on('request', request => requests.push(request)); await page.goto(EMPTY_PAGE); expect(requests.length).toBe(1); expect(requests[0].url).toBe(EMPTY_PAGE); expect(requests[0].method).toBe('GET'); expect(requests[0].response()).toBeTruthy(); })); it('Page.Events.Request should report post data', SX(async function() { await page.goto(EMPTY_PAGE); server.setRoute('/post', (req, res) => res.end()); let request = null; page.on('request', r => request = r); await page.evaluate(() => fetch('./post', { method: 'POST', body: JSON.stringify({foo: 'bar'})})); expect(request).toBeTruthy(); expect(request.postData).toBe('{"foo":"bar"}'); })); it('Page.Events.Response', SX(async function() { let responses = []; page.on('response', response => responses.push(response)); await page.goto(EMPTY_PAGE); expect(responses.length).toBe(1); expect(responses[0].url).toBe(EMPTY_PAGE); expect(responses[0].status).toBe(200); expect(responses[0].ok).toBe(true); expect(responses[0].request()).toBeTruthy(); })); it('Page.Events.Response should provide body', SX(async function() { let response = null; page.on('response', r => response = r); await page.goto(PREFIX + '/simple.json'); expect(response).toBeTruthy(); expect(await response.text()).toBe('{"foo": "bar"}\n'); expect(await response.json()).toEqual({foo: 'bar'}); })); it('Page.Events.Response should not report body unless request is finished', SX(async() => { await page.goto(EMPTY_PAGE); // Setup server to trap request. let serverResponse = null; server.setRoute('/get', (req, res) => { serverResponse = res; res.write('hello '); }); // Setup page to trap response. let pageResponse = null; let requestFinished = false; page.on('response', r => pageResponse = r); page.on('requestfinished', () => requestFinished = true); // send request and wait for server response await Promise.all([ page.evaluate(() => fetch('./get', { method: 'GET'})), waitForEvents(page, 'response') ]); expect(serverResponse).toBeTruthy(); expect(pageResponse).toBeTruthy(); expect(pageResponse.status).toBe(200); expect(requestFinished).toBe(false); let responseText = pageResponse.text(); // Write part of the response and wait for it to be flushed. await new Promise(x => serverResponse.write('wor', x)); // Finish response. await new Promise(x => serverResponse.end('ld!', x)); expect(await responseText).toBe('hello world!'); })); it('Page.Events.RequestFailed', SX(async function() { await page.setRequestInterceptionEnabled(true); page.on('request', request => { if (request.url.endsWith('css')) request.abort(); else request.continue(); }); let failedRequests = []; page.on('requestfailed', request => failedRequests.push(request)); await page.goto(PREFIX + '/one-style.html'); expect(failedRequests.length).toBe(1); expect(failedRequests[0].url).toContain('one-style.css'); expect(failedRequests[0].response()).toBe(null); })); it('Page.Events.RequestFinished', SX(async function() { let requests = []; page.on('requestfinished', request => requests.push(request)); await page.goto(EMPTY_PAGE); expect(requests.length).toBe(1); expect(requests[0].url).toBe(EMPTY_PAGE); expect(requests[0].response()).toBeTruthy(); })); it('should fire events in proper order', SX(async function() { let events = []; page.on('request', request => events.push('request')); page.on('response', response => events.push('response')); page.on('requestfinished', request => events.push('requestfinished')); await page.goto(EMPTY_PAGE); expect(events).toEqual(['request', 'response', 'requestfinished']); })); it('should support redirects', SX(async function() { let events = []; page.on('request', request => events.push(`${request.method} ${request.url}`)); page.on('response', response => events.push(`${response.status} ${response.url}`)); page.on('requestfinished', request => events.push(`DONE ${request.url}`)); page.on('requestfailed', request => events.push(`FAIL ${request.url}`)); server.setRedirect('/foo.html', '/empty.html'); const FOO_URL = PREFIX + '/foo.html'; await page.goto(FOO_URL); expect(events).toEqual([ `GET ${FOO_URL}`, `302 ${FOO_URL}`, `DONE ${FOO_URL}`, `GET ${EMPTY_PAGE}`, `200 ${EMPTY_PAGE}`, `DONE ${EMPTY_PAGE}` ]); })); }); describe('Page.addScriptTag', function() { it('should work', SX(async function() { await page.goto(EMPTY_PAGE); await page.addScriptTag('/injectedfile.js'); expect(await page.evaluate(() => __injected)).toBe(42); })); }); describe('Page.url', function() { it('should work', SX(async function() { expect(page.url()).toBe('about:blank'); await page.goto(EMPTY_PAGE); expect(page.url()).toBe(EMPTY_PAGE); })); }); describe('Page.viewport', function() { it('should get the proper viewport size', SX(async function() { expect(page.viewport()).toEqual({width: 800, height: 600}); await page.setViewport({width: 123, height: 456}); expect(page.viewport()).toEqual({width: 123, height: 456}); })); it('should support mobile emulation', SX(async function() { await page.goto(PREFIX + '/mobile.html'); expect(await page.evaluate(() => window.innerWidth)).toBe(800); await page.setViewport(iPhone.viewport); expect(await page.evaluate(() => window.innerWidth)).toBe(375); await page.setViewport({width: 400, height: 300}); expect(await page.evaluate(() => window.innerWidth)).toBe(400); })); it('should support touch emulation', SX(async function() { await page.goto(PREFIX + '/mobile.html'); expect(await page.evaluate(() => 'ontouchstart' in window)).toBe(false); await page.setViewport(iPhone.viewport); expect(await page.evaluate(() => 'ontouchstart' in window)).toBe(true); expect(await page.evaluate(dispatchTouch)).toBe('Recieved touch'); await page.setViewport({width: 100, height: 100}); expect(await page.evaluate(() => 'ontouchstart' in window)).toBe(false); function dispatchTouch() { let fulfill; let promise = new Promise(x => fulfill = x); window.ontouchstart = function(e) { fulfill('Recieved touch'); }; window.dispatchEvent(new Event('touchstart')); fulfill('Did not recieve touch'); return promise; } })); it('should be detectable by Modernizr', SX(async function(){ await page.goto(PREFIX + '/detect-touch.html'); expect(await page.evaluate(() => document.body.textContent.trim())).toBe('NO'); await page.setViewport(iPhone.viewport); await page.goto(PREFIX + '/detect-touch.html'); expect(await page.evaluate(() => document.body.textContent.trim())).toBe('YES'); })); it('should support landscape emulation', SX(async function() { await page.goto(PREFIX + '/mobile.html'); expect(await page.evaluate(() => screen.orientation.type)).toBe('portrait-primary'); await page.setViewport(iPhoneLandscape.viewport); expect(await page.evaluate(() => screen.orientation.type)).toBe('landscape-primary'); await page.setViewport({width: 100, height: 100}); expect(await page.evaluate(() => screen.orientation.type)).toBe('portrait-primary'); })); it('should support emulate shorthand', SX(async function() { await page.goto(PREFIX + '/mobile.html'); await page.emulate(iPhone); expect(await page.evaluate(() => window.innerWidth)).toBe(375); expect(await page.evaluate(() => navigator.userAgent)).toContain('Safari'); })); }); describe('Page.evaluateOnNewDocument', function() { it('should evaluate before anything else on the page', SX(async function() { await page.evaluateOnNewDocument(function(){ window.injected = 123; }); await page.goto(PREFIX + '/tamperable.html'); expect(await page.evaluate(() => window.result)).toBe(123); })); }); // Printing to pdf is currently only supported in headless (headless ? describe : xdescribe)('Page.pdf', function() { it('should be able to save file', SX(async function() { const outputFile = __dirname + '/assets/output.pdf'; await page.pdf({path: outputFile}); expect(fs.readFileSync(outputFile).byteLength).toBeGreaterThan(0); fs.unlinkSync(outputFile); })); it('should default to printing in Letter format', SX(async function() { let pages = await getPDFPages(await page.pdf()); expect(pages.length).toBe(1); expect(pages[0].width).toBeCloseTo(8.5, 2); expect(pages[0].height).toBeCloseTo(11, 2); })); it('should support setting custom format', SX(async function() { let pages = await getPDFPages(await page.pdf({ format: 'a4' })); expect(pages.length).toBe(1); expect(pages[0].width).toBeCloseTo(8.27, 1); expect(pages[0].height).toBeCloseTo(11.7, 1); })); it('should support setting paper width and height', SX(async function() { let pages = await getPDFPages(await page.pdf({ width: '10in', height: '10in', })); expect(pages.length).toBe(1); expect(pages[0].width).toBeCloseTo(10, 2); expect(pages[0].height).toBeCloseTo(10, 2); })); it('should print multiple pages', SX(async function() { await page.goto(PREFIX + '/grid.html'); // Define width and height in CSS pixels. const width = 50 * 5 + 1; const height = 50 * 5 + 1; let pages = await getPDFPages(await page.pdf({width, height})); expect(pages.length).toBe(8); expect(pages[0].width).toBeCloseTo(cssPixelsToInches(width), 2); expect(pages[0].height).toBeCloseTo(cssPixelsToInches(height), 2); })); it('should support page ranges', SX(async function() { await page.goto(PREFIX + '/grid.html'); // Define width and height in CSS pixels. const width = 50 * 5 + 1; const height = 50 * 5 + 1; let pages = await getPDFPages(await page.pdf({width, height, pageRanges: '1,4-7'})); expect(pages.length).toBe(5); })); it('should throw if format is unknown', SX(async function() { let error = null; try { await getPDFPages(await page.pdf({ format: 'something' })); } catch (e) { error = e; } expect(error).toBeTruthy(); expect(error.message).toContain('Unknown paper format'); })); it('should throw if units are unknown', SX(async function() { let error = null; try { await getPDFPages(await page.pdf({ width: '10em', height: '10em', })); } catch (e) { error = e; } expect(error).toBeTruthy(); expect(error.message).toContain('Failed to parse parameter value'); })); }); describe('Page.plainText', function() { it('should return the page text', SX(async function(){ await page.setContent('
the result text
'); expect(await page.plainText()).toBe('the result text'); })); }); describe('Page.title', function() { it('should return the page title', SX(async function(){ await page.goto(PREFIX + '/input/button.html'); expect(await page.title()).toBe('Button test'); })); }); describe('Page.screenshot', function() { it('should work', SX(async function() { await page.setViewport({width: 500, height: 500}); await page.goto(PREFIX + '/grid.html'); let screenshot = await page.screenshot(); expect(screenshot).toBeGolden('screenshot-sanity.png'); })); it('should clip rect', SX(async function() { await page.setViewport({width: 500, height: 500}); await page.goto(PREFIX + '/grid.html'); let screenshot = await page.screenshot({ clip: { x: 50, y: 100, width: 150, height: 100 } }); expect(screenshot).toBeGolden('screenshot-clip-rect.png'); })); it('should work for offscreen clip', SX(async function() { await page.setViewport({width: 500, height: 500}); await page.goto(PREFIX + '/grid.html'); let screenshot = await page.screenshot({ clip: { x: 50, y: 600, width: 100, height: 100 } }); expect(screenshot).toBeGolden('screenshot-offscreen-clip.png'); })); it('should run in parallel', SX(async function() { await page.setViewport({width: 500, height: 500}); await page.goto(PREFIX + '/grid.html'); let promises = []; for (let i = 0; i < 3; ++i) { promises.push(page.screenshot({ clip: { x: 50 * i, y: 0, width: 50, height: 50 } })); } let screenshots = await Promise.all(promises); expect(screenshots[1]).toBeGolden('grid-cell-1.png'); })); it('should take fullPage screenshots', SX(async function() { await page.setViewport({width: 500, height: 500}); await page.goto(PREFIX + '/grid.html'); let screenshot = await page.screenshot({ fullPage: true }); expect(screenshot).toBeGolden('screenshot-grid-fullpage.png'); })); it('should run in parallel in multiple pages', SX(async function() { const N = 2; let pages = await Promise.all(Array(N).fill(0).map(async() => { let page = await browser.newPage(); await page.goto(PREFIX + '/grid.html'); return page; })); let promises = []; for (let i = 0; i < N; ++i) promises.push(pages[i].screenshot({ clip: { x: 50 * i, y: 0, width: 50, height: 50 } })); let screenshots = await Promise.all(promises); for (let i = 0; i < N; ++i) expect(screenshots[i]).toBeGolden(`grid-cell-${i}.png`); await Promise.all(pages.map(page => page.close())); })); }); describe('Tracing', function() { let outputFile = path.join(__dirname, 'assets', 'trace.json'); afterEach(function() { fs.unlinkSync(outputFile); }); it('should output a trace', SX(async function() { await page.tracing.start({screenshots: true, path: outputFile}); await page.goto(PREFIX + '/grid.html'); await page.tracing.stop(); expect(fs.existsSync(outputFile)).toBe(true); })); it('should throw if tracing on two pages', SX(async function() { await page.tracing.start({path: outputFile}); let newPage = await browser.newPage(); let error = null; try { await newPage.tracing.start({path: outputFile}); } catch (e) { error = e; } await newPage.close(); expect(error).toBeTruthy(); await page.tracing.stop(); })); }); }); if (process.env.COVERAGE) { describe('COVERAGE', function(){ let coverage = helper.publicAPICoverage(); let disabled = new Set(); if (!headless) disabled.add('page.pdf'); for (let method of coverage.keys()) { (disabled.has(method) ? xit : it)(`public api '${method}' should be called`, SX(async function(){ expect(coverage.get(method)).toBe(true); })); } }); } /** * @param {!EventEmitter} emitter * @param {string} eventName * @param {number=} eventCount * @return {!Promise} */ function waitForEvents(emitter, eventName, eventCount = 1) { let fulfill; let promise = new Promise(x => fulfill = x); emitter.on(eventName, onEvent); return promise; function onEvent() { --eventCount; if (eventCount) return; emitter.removeListener(eventName, onEvent); fulfill(); } } /** * @param {!Buffer} pdfBuffer * @return {!Promise>} */ async function getPDFPages(pdfBuffer) { const PDFJS = require('pdfjs-dist'); PDFJS.disableWorker = true; const data = new Uint8Array(pdfBuffer); const doc = await PDFJS.getDocument(data); let pages = []; for (let i = 0; i < doc.numPages; ++i) { let page = await doc.getPage(i + 1); let viewport = page.getViewport(1); // Viewport width and height is in PDF points, which is // 1/72 of an inch. pages.push({ width: viewport.width / 72, height: viewport.height / 72, }); page.cleanup(); } doc.cleanup(); return pages; } /** * @param {number} px * @return {number} */ function cssPixelsToInches(px) { return px / 96; } // Since Jasmine doesn't like async functions, they should be wrapped // in a SX function. function SX(fun) { return done => Promise.resolve(fun()).then(done).catch(done.fail); }