What is strip-comments?
The strip-comments npm package is designed to remove comments from code. It supports stripping both line comments and block comments from source code strings, making it useful for cleaning up code or preparing it for minification.
What are strip-comments's main functionalities?
Remove line comments
This feature allows you to remove single line comments from your code. It's particularly useful for cleaning up code by removing unnecessary or explanatory comments that are not needed in production.
"use strict";\n// This is a line comment\nconst x = 1;\n// Another comment\nconsole.log(x);
Remove block comments
This feature enables the removal of block comments, which can span multiple lines. It's useful for eliminating large sections of commented-out code or detailed explanations that are not required in the final codebase.
"use strict";\n/* This is a block comment\n that spans multiple lines */\nconst x = 1;\nconsole.log(x);
Preserve important comments
Strip-comments can be configured to preserve comments that are marked as important, usually with a specific syntax like `/*!`. This is useful for keeping license information or other critical comments while removing the rest.
"use strict";\n/*! Preserve this comment */\n// This is a line comment\nconst x = 1;\nconsole.log(x);
Other packages similar to strip-comments
esprima
Esprima is a JavaScript parser that can be used to analyze and manipulate JavaScript code. While not specifically designed for removing comments, it can be used to parse code, manipulate the AST (Abstract Syntax Tree), and then regenerate the code without comments. It offers more flexibility but is more complex than strip-comments.
uglify-js
UglifyJS is a JavaScript minifier that can remove comments as part of its minification process. It provides more comprehensive code optimization features beyond just comment removal, including variable name mangling and dead code elimination. Compared to strip-comments, it's a more powerful tool for preparing code for production but might be overkill for just comment removal.
Strip line and/or block comments from a string. Blazing fast, and works with JavaScript, Sass, CSS, Less.js, and a number of other languages.
Please consider following this project's author, Jon Schlinkert, and consider starring the project to show your :heart: and support.
(TOC generated by verb using markdown-toc)
Install
Install with npm (requires Node.js >=10):
$ npm install --save strip-comments
What does this do?
Takes a string and returns a new string with comments removed. Works with line comments and/or block comments. Optionally removes the first comment only or ignores protected comments.
Works with:
- ada
- apl
- applescript
- c
- csharp
- css
- hashbang
- haskell
- html
- java
- javascript
- less
- lua
- matlab
- ocaml
- pascal
- perl
- php
- python
- ruby
- sass
- shebang
- sql
- swift
- typscript
- xml
Usage
By default all comments are stripped.
const strip = require('strip-comments');
const str = strip('const foo = "bar";// this is a comment\n /* me too *\/');
console.log(str);
For more use-cases see the tests
API
Strip all code comments from the given input
, including protected comments that start with !
, unless disabled by setting options.keepProtected
to true.
Params
input
{String}: string from which to strip commentsoptions
{Object}: optional options, passed to extract-comments
line
{Boolean}: if false
strip only block comments, default true
block
{Boolean}: if false
strip only line comments, default true
keepProtected
{Boolean}: Keep ignored comments (e.g. /*!
and //!
)preserveNewlines
{Boolean}: Preserve newlines after comments are stripped
returns
{String}: modified input
Example
const str = strip('const foo = "bar";// this is a comment\n /* me too */');
console.log(str);
Strip only block comments.
Params
input
{String}: string from which to strip commentsoptions
{Object}: pass opts.keepProtected: true
to keep ignored comments (e.g. /*!
)returns
{String}: modified string
Example
const strip = require('..');
const str = strip.block('const foo = "bar";// this is a comment\n /* me too */');
console.log(str);
Strip only line comments.
Params
input
{String}: string from which to strip commentsoptions
{Object}: pass opts.keepProtected: true
to keep ignored comments (e.g. //!
)returns
{String}: modified string
Example
const str = strip.line('const foo = "bar";// this is a comment\n /* me too */');
console.log(str);
Strip the first comment from the given input
. Or, if opts.keepProtected
is true, the first non-protected comment will be stripped.
Params
input
{String}options
{Object}: pass opts.keepProtected: true
to keep comments with !
returns
{String}
Example
const output = strip.first(input, { keepProtected: true });
console.log(output);
Parses a string and returns a basic CST (Concrete Syntax Tree).
Params
input
{String}: string from which to strip commentsoptions
{Object}: pass opts.keepProtected: true
to keep ignored comments (e.g. /*!
)returns
{String}: modified string
Example
const strip = require('..');
const str = strip.block('const foo = "bar";// this is a comment\n /* me too */');
console.log(str);
About
Contributing
Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.
Running Tests
Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:
$ npm install && npm test
Building docs
(This project's readme.md is generated by verb, please don't edit the readme directly. Any changes to the readme must be made in the .verb.md readme template.)
To generate the readme, run the following command:
$ npm install -g verbose/verb
Related projects
You might also be interested in these projects:
Contributors
Author
Jon Schlinkert
License
Copyright © 2019, Jon Schlinkert.
Released under the MIT License.
This file was generated by verb-generate-readme, v0.8.0, on November 13, 2019.