/** * 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. */ import fs from 'fs'; import path from 'path'; import expect from 'expect'; import { getTestState, describeChromeOnly } from './mocha-utils'; // eslint-disable-line import/extensions describeChromeOnly('Tracing', function () { let outputFile; let browser; let page; /* we manually manage the browser here as we want a new browser for each * individual test, which isn't the default behaviour of getTestState() */ beforeEach(async () => { const { defaultBrowserOptions, puppeteer } = getTestState(); browser = await puppeteer.launch(defaultBrowserOptions); page = await browser.newPage(); outputFile = path.join(__dirname, 'assets', 'trace.json'); }); afterEach(async () => { await browser.close(); browser = null; page = null; if (fs.existsSync(outputFile)) { fs.unlinkSync(outputFile); outputFile = null; } }); it('should output a trace', async () => { const { server } = getTestState(); await page.tracing.start({ screenshots: true, path: outputFile }); await page.goto(server.PREFIX + '/grid.html'); await page.tracing.stop(); expect(fs.existsSync(outputFile)).toBe(true); }); it('should run with custom categories if provided', async () => { await page.tracing.start({ path: outputFile, categories: ['-*', 'disabled-by-default-devtools.timeline.frame'], }); await page.tracing.stop(); const traceJson = JSON.parse( fs.readFileSync(outputFile, { encoding: 'utf8' }) ); const traceConfig = JSON.parse(traceJson.metadata['trace-config']); expect(traceConfig.included_categories).toEqual([ 'disabled-by-default-devtools.timeline.frame', ]); expect(traceConfig.excluded_categories).toEqual(['*']); expect(traceJson.traceEvents).not.toContainEqual( expect.objectContaining({ cat: 'toplevel', }) ); }); it('should run with default categories', async () => { await page.tracing.start({ path: outputFile, }); await page.tracing.stop(); const traceJson = JSON.parse( fs.readFileSync(outputFile, { encoding: 'utf8' }) ); expect(traceJson.traceEvents).toContainEqual( expect.objectContaining({ cat: 'toplevel', }) ); }); it('should throw if tracing on two pages', async () => { await page.tracing.start({ path: outputFile }); const newPage = await browser.newPage(); let error = null; await newPage.tracing .start({ path: outputFile }) .catch((error_) => (error = error_)); await newPage.close(); expect(error).toBeTruthy(); await page.tracing.stop(); }); it('should return a buffer', async () => { const { server } = getTestState(); await page.tracing.start({ screenshots: true, path: outputFile }); await page.goto(server.PREFIX + '/grid.html'); const trace = await page.tracing.stop(); const buf = fs.readFileSync(outputFile); expect(trace.toString()).toEqual(buf.toString()); }); it('should work without options', async () => { const { server } = getTestState(); await page.tracing.start(); await page.goto(server.PREFIX + '/grid.html'); const trace = await page.tracing.stop(); expect(trace).toBeTruthy(); }); it('should return null in case of Buffer error', async () => { const { server } = getTestState(); await page.tracing.start({ screenshots: true }); await page.goto(server.PREFIX + '/grid.html'); const oldBufferConcat = Buffer.concat; Buffer.concat = () => { throw 'error'; }; const trace = await page.tracing.stop(); expect(trace).toEqual(null); Buffer.concat = oldBufferConcat; }); it('should support a buffer without a path', async () => { const { server } = getTestState(); await page.tracing.start({ screenshots: true }); await page.goto(server.PREFIX + '/grid.html'); const trace = await page.tracing.stop(); expect(trace.toString()).toContain('screenshot'); }); it('should properly fail if readProtocolStream errors out', async () => { await page.tracing.start({ path: __dirname }); let error: Error = null; try { await page.tracing.stop(); } catch (error_) { error = error_; } expect(error).toBeDefined(); }); });