https://github.com/kudashevs/strip-code-webpack-plugin
A webpack plugin that strips marked blocks from any code processed by webpack.
https://github.com/kudashevs/strip-code-webpack-plugin
strip-code strip-unwanted webpack-plugin
Last synced: 4 months ago
JSON representation
A webpack plugin that strips marked blocks from any code processed by webpack.
- Host: GitHub
- URL: https://github.com/kudashevs/strip-code-webpack-plugin
- Owner: kudashevs
- License: mit
- Created: 2024-11-29T16:19:23.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-12-02T15:48:13.000Z (about 1 year ago)
- Last Synced: 2025-03-24T07:05:13.178Z (11 months ago)
- Topics: strip-code, strip-unwanted, webpack-plugin
- Language: JavaScript
- Homepage: https://kudashevs.com/posts/2024/12/strip-code-library-and-plugins
- Size: 85 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
Strip Code Webpack Plugin 
==========================
The `strip-code-webpack-plugin` strips marked blocks from any type of code.
## Install
```bash
# NPM
npm install --save-dev strip-code-webpack-plugin
# Yarn
yarn add --dev strip-code-webpack-plugin
```
## Options
`blocks` is an array of blocks' representations. Each element of this array describes a unique pair of tags with start, end,
prefix, suffix and optional replacement. These values are represented by a string or an object with the following properties:
```
start: 'dev-start' # a string defines a name for the start tag (unique)
end: 'dev-end' # a string defines a name for the end tag (unique)
prefix: '/*' # a string defines the beginning of a tag
suffix: '*/' # a string defines the end of a tag
replacement: 'optional' # a string defines a substitution for a removed block
```
The plugin supports zero config. When no options are provided, it uses default start, end, prefix and suffix values.
## Usage example
For example, suppose the task is to strip some debug information and non-production code from this code sample.
```javascript
function makeFoo(bar, baz) {
console.log('creating Foo');
if (bar instanceof Bar !== true) {
throw new Error('makeFoo: bar param must be an instance of Bar');
}
if (baz instanceof Baz !== true) {
throw new Error('makeFoo: baz param must be an instance of Baz');
}
return new Foo(bar, baz);
}
```
The plugin strips blocks of code marked with two paired tags (a block). A block is represented by a string or an object
with the properties described in "[Options](#options)" above. Let's identify two different blocks and describe them in the configuration:
```javascript
// webpack.config.js
const StripCodePlugin = require('strip-code-webpack-plugin');
module.exports = {
...
plugins: [
new StripCodePlugin({
blocks: [
'debug',
{
start: 'dev-start',
end: 'dev-end',
prefix: '//',
suffix: '',
},
],
}),
],
}
```
Once the blocks are described in the configuration, the unwanted areas of code can be marked in the code:
```javascript
function makeFoo(bar, baz) {
/* debug-start */ console.log('creating Foo'); /* debug-end */
// dev-start
if (bar instanceof Bar !== true) {
throw new Error('makeFoo: bar param must be an instance of Bar');
}
// dev-end
// dev-start
if (baz instanceof Baz !== true) {
throw new Error('makeFoo: baz param must be an instance of Baz');
}
// dev-end
// This code will remain
return new Foo(bar, baz);
}
```
After the building process, the marked blocks will be completely removed.
```javascript
function makeFoo(bar, baz) {
// This code will remain
return new Foo(bar, baz);
}
```
## License
The MIT License (MIT). Please see the [License file](LICENSE.md) for more information.