}
* @template T
* @memberof Utils
* @alias retry
*/
export async function retry(
fn,
{timeout = () => Promise.resolve(), times = 10} = {},
) {
try {
return await fn();
} catch (err) {
if (times > 1) {
await timeout();
return retry(fn, {timeout, times: times - 1});
}
throw err;
}
}
================================================
FILE: src/utils/retry.test.js
================================================
import {describe, expect, it, jest} from '@jest/globals';
import {retry} from './retry';
describe('retry', () => {
it('returns value if first attempt succeeds', async () => {
await expect(retry(() => 'answer 0')).resolves.toBe('answer 0');
});
it('returns value after failed attempts', async () => {
await expect(
retry(
jest
.fn()
.mockImplementationOnce(() => {
throw new Error('reason 0');
})
.mockImplementationOnce(() => 'answer 1'),
),
).resolves.toBe('answer 1');
});
it('returns last error if no attempt succeeds', async () => {
let i = 0;
const func = jest.fn(() => {
throw new Error(`reason ${i++}`);
});
await expect(retry(func)).rejects.toMatchObject({message: 'reason 9'});
expect(func).toBeCalledTimes(10);
});
it('tries after a timeout', async () => {
let i = 0;
const func = jest.fn(() => {
throw new Error(`reason ${i++}`);
});
const timeout = jest.fn(() => Promise.resolve());
const retryPromise = retry(func, {timeout});
expect(timeout).toBeCalledTimes(1);
await expect(retryPromise).rejects.toMatchObject({message: 'reason 9'});
expect(timeout).toBeCalledTimes(9);
});
it('tries n times', async () => {
let i = 0;
const func = jest.fn(() => {
throw new Error(`reason ${i++}`);
});
await expect(retry(func, {times: 2})).rejects.toMatchObject({
message: 'reason 1',
});
expect(func).toBeCalledTimes(2);
});
});
================================================
FILE: src/utils/rxChrome.ts
================================================
import {fromEventPattern, Observable} from 'rxjs';
import {chrome} from '../chrome';
import {ChromeDebuggerAPIEvent} from '../devtools/DebuggerAttachEventController';
/**
* Create a function that returns an observable that completes when the api
* calls back.
* @param method `chrome` api method whose last argument is a callback
* @param thisArg `this` inside of the method
* @returns observable that completes when the method is done
*/
export function bindChromeCallback(
method: (...args: [...params: P, callback: (...values: R) => void]) => void,
thisArg = null,
) {
return (...args: P) =>
new Observable(
(subscriber) => {
method.call(thisArg, ...args, (...returnValues: R) => {
if (chrome.runtime.lastError) {
subscriber.error(chrome.runtime.lastError);
} else {
if (returnValues.length === 0) {
subscriber.next();
} else if (returnValues.length === 1) {
subscriber.next(returnValues[0]);
} else if (returnValues.length > 1) {
subscriber.next(returnValues as any);
}
subscriber.complete();
}
});
},
);
}
export const fromChromeEvent = any>(
onEvent: Chrome.Event,
) =>
fromEventPattern<
Parameters extends infer T1
? T1 extends []
? void
: T1 extends [infer T2]
? T2
: T1
: never
>(onEvent.addListener.bind(onEvent), onEvent.removeListener.bind(onEvent));
================================================
FILE: src/utils/rxInterop.ts
================================================
import {Observable} from 'rxjs';
import {Observer} from './Observer';
import {Utils} from './Types';
/**
* Wrap a `Utils.Observer` instance with `rxjs.Observable` instance.
*
* This is a workaround so `rxjs.Observable` can use `Utils.Observer` as a source
* until said `Observer` instances can be replaced with `Observable` instances.
*
* @param observer observer to wrap
* @returns observable wrapping an observer
*/
export function toRX(observer: Utils.Observer): Observable {
return new Observable((subscriber) =>
observer.observe(
(value) => subscriber.next(value),
() => subscriber.complete(),
(err) => subscriber.error(err),
),
);
}
export function toUtilsObserver(
observable: Observable,
): Utils.Observer {
return new Observer((next, complete, error) => {
const subscription = observable.subscribe({next, complete, error});
return () => {
subscription.unsubscribe();
};
});
}
================================================
FILE: src/webpack.config.js
================================================
const {resolve} = require('path');
const CopyPlugin = require('copy-webpack-plugin');
module.exports = (env, argv) => ({
context: __dirname,
entry: {
'audion-devtools': './devtools/main',
'audion-panel': './panel/main',
'audion-panelWorker': './panel/worker',
},
output: {
path: resolve(__dirname, '../build/audion'),
},
devtool: argv.mode === 'development' ? 'source-map' : false,
resolve: {
extensions: ['', '.webpack.js', '.web.js', '.ts', '.tsx', '.js'],
},
plugins: [
new CopyPlugin({
patterns: [
{from: './extraSettingPage/options.html', to: 'options.html'},
{from: './extraSettingPage/options.js', to: 'options.js'},
],
}),
],
module: {
rules: [
{
test: /\.css$/,
use: ['style-loader', {loader: 'css-loader', options: {modules: true}}],
},
{test: /\.tsx?$/, loader: 'ts-loader'},
{test: /\.js$/, loader: 'source-map-loader'},
{
test: /\.(png|jpe?g|gif|svg|eot|ttf|woff|woff2)$/i,
// More information here https://webpack.js.org/guides/asset-modules/
type: 'asset',
},
],
},
});
================================================
FILE: test/.jest-puppeteer.config.json
================================================
{
"launch": {
"headless": false,
"devtools": true,
"args": [
"--no-sandbox",
"--disable-extensions-except=build/audion",
"--load-extension=build/audion"
]
}
}
================================================
FILE: test/.jest.config.json
================================================
{
"preset": "jest-puppeteer",
"injectGlobals": false,
"transform": {
"\\.[jt]sx?$": "babel-jest"
},
"testMatch": ["!**/.*", "**/*.js"]
}
================================================
FILE: test/README.md
================================================
A directory of integration tests.
================================================
FILE: test/browserLaunch.js
================================================
/* global browser */
import {it} from '@jest/globals';
it('browser launches with extension', async () => {
const browserTargets = await browser.targets();
const devtoolsTarget = browserTargets.find(
(target) => target.type() === 'browser',
);
await devtoolsTarget.browser();
});
================================================
FILE: test/updateGraphRender.js
================================================
import {resolve} from 'path';
import {expect, it} from '@jest/globals';
import {from, fromEvent, lastValueFrom, takeUntil, toArray} from 'rxjs';
it('updateGraphRender does not error', async () => {
const page = globalThis.page;
await page.goto(
`file://${resolve(__dirname, '../simulations/updateGraphRender.html')}`,
);
const pageErrors = await lastValueFrom(
fromEvent(page, 'pageerror').pipe(
takeUntil(from(page.waitForSelector('.complete'))),
toArray(),
),
);
expect(pageErrors).toHaveLength(0);
});
================================================
FILE: tsconfig.json
================================================
{
"compilerOptions": {
"allowJs": true,
"target": "es2020",
"moduleResolution": "node",
"allowSyntheticDefaultImports": true,
"esModuleInterop": true
},
"include": ["./src/**/*"]
}