About
Deadcode elimination via running end-to-end tests.
Sample project: DCE for threejs
Install
npm i -D ycw/e2edce
Usage
First, create a configuration file in project root
Then, config package.json
{
"scripts": {
"build": "e2edce e2edce.config.js"
}
}
Finally, run npm run build to build artifacts
- index.build.js (min)
- index.build.js.gz (min + gzipped)
Configuration File
e2edce.config.js
export default {
// --- required ---
configs: [ // array of configs
{
// --- required ---
input: 'src/index.js', // path to entry
output: 'index.build.js', // path to output file
test: 'e2e/test.js', // path to test file
// --- optional ---
compress: true, // compress?
mangle: true, // mangle?
minify: true, // trim whitespaces?
debug: false, // create a debug build?
port: 8081, // dev server port
headless: true, // run tests in headless browser?
}
],
// --- optional ---
setup: async() => {}, // run once before processing
teardown: async() => {}, // run once after processing
resolve: async() => {}, // custom module resolve
}
-
compressis https://github.com/terser/terser#compress-options -
debugif true, all uncovered fns willthrowat runtime instead of removal at compile time;compress,mangleandminifyare forced to befalse. -
resolveis https://rollupjs.org/guide/en/#resolveidWe could generate tmp modules (in
setup) for module replacement (inresolve) and finally remove those tmp modules (inteardown)
Test File
e2e/test.js
Export a async fn or an object
export default async (page) => {
await page.goto('http://localhost:8081', { waitUntil: 'networkidle' })
// ...
}
export default {
// --- required ---
test: async () => {
await page.goto('http://localhost:8081', { waitUntil: 'networkidle' })
},
// --- optional ---
inject: () => {..}
}
-
inject, a fn to be run at the end of input file.We could add mocks inside
inject()to directly cover certain code branches instead of writing complex e2e tests insidetest()
74 Aug 20, 2022
5 Dec 20, 2022
1 Jan 1, 2022
6 Dec 3, 2022
5 May 12, 2022
3 Jun 15, 2022
74 Dec 26, 2022
89 Dec 20, 2022
0 Jan 11, 2022
15 Aug 6, 2022