winzik/skeleton-chrome/tests/helpers.cjs

49 lines
2.2 KiB
JavaScript

// Test helpers: a headless Chrome (Chrome for Testing, through Puppeteer) with this extension loaded unpacked.
// `bin/jumphp chrome:test <folder>` runs `node --test tests/` in Docker (Puppeteer's image): nothing to install here.
'use strict';
const fs = require('fs');
const path = require('path');
const puppeteer = require('puppeteer');
const ROOT = path.resolve(__dirname, '..');
const FIXTURES = path.join(__dirname, 'fixtures');
/** Starts Chrome with the extension; returns { browser, id, worker, url(page), fixture(page) }. */
async function launch() {
const browser = await puppeteer.launch({
headless: 'new',
args: ['--no-sandbox', '--lang=en-US', `--disable-extensions-except=${ROOT}`, `--load-extension=${ROOT}`],
});
const target = await browser.waitForTarget((t) => t.type() === 'service_worker' && t.url().startsWith('chrome-extension://'), { timeout: 15000 });
const id = new URL(target.url()).host;
const worker = await target.worker();
return {
browser,
id,
worker,
/** chrome-extension://<id>/<page> */
url: (page) => `chrome-extension://${id}/${page}`,
/** A new tab whose requests to https://example.com/ get tests/fixtures/<file> (offline; the content script runs). */
async fixturePage(file = 'page.html', url = 'https://example.com/') {
const page = await browser.newPage();
await page.setRequestInterception(true);
page.on('request', (request) => {
if (/^https:\/\/(www\.)?example\.com\//.test(request.url())) {
request.respond({ status: 200, contentType: 'text/html; charset=utf-8', body: fs.readFileSync(path.join(FIXTURES, file)) });
} else {
request.abort();
}
});
await page.goto(url, { waitUntil: 'load' });
return page;
},
/** The id of the tab of a Puppeteer page (for popup.html?tab=<id>): brought to the front, it is the active tab
* (without the "tabs" permission chrome.tabs.query cannot filter by URL). */
async tabId(page) {
await page.bringToFront();
return worker.evaluate(async () => (await chrome.tabs.query({ active: true, lastFocusedWindow: true }))[0]?.id);
},
};
}
module.exports = { launch, ROOT };