htmlclean

   

Since v3, the CLI was separated into htmlclean-cli.

---

* Command Line Tool: htmlclean-cli
* Grunt plugin: grunt-htmlclean
* gulp plugin: gulp-htmlclean
* webpack loader: htmlclean-loader

Simple and safety HTML/SVG cleaner to minify without changing its structure.

For example, more than two whitespaces (even if those are divided by tags) in a line are reduced.

Before:

``html


The clean HTML is here.


`

After:

`html


The clean HTML is here.


`

The whitespace that was on the right side of the was removed, and one on the left side was kept. And whitespaces on the both side of the were removed.

For example, unneeded whitespaces in path data of SVG are reduced. In the case of this SVG file, 4,784 bytes were reduced without changing its structure:

Removing

htmlclean removes following texts.

+ Leading and trailing whitespaces (tabs and line-breaks are included)
+ Unneeded whitespaces between HTML/SVG tags
+ More than two whitespaces (reduced to one space)
+ HTML/SVG comments
+ Unneeded whitespaces, meaningless zeros, numbers, signs, etc. in path data of SVG (e.g. d attribute of path element, path attribute of animateMotion element, etc.)

Protecting

Following texts are protected (excluded from the Removing list).

+ Texts in textarea, script and style elements, and text nodes in pre elements
+ Quoted texts in tag attributes except path data of SVG
+ Texts in SSI tags (PHP, JSP, ASP/ASP.NET and Apache SSI)
+ IE conditional comments (e.g. and
+ Texts that is matched by protect option

Usage

`js
cleanCode = htmlclean(sourceCode[, options])
`

require('htmlclean') returns a Function. This Function accepts a HTML/SVG source code, and returns a clean HTML/SVG source code. You can specify an options Object for second argument (see Options).

`js
var htmlclean = require('htmlclean');
html = htmlclean(html);

// Or
html = require('htmlclean')(html);
`

$3

You can specify an options Object for second argument. This Object can have following properties.

#### protect

Type: RegExp or Array

Texts which are matched to this RegExp are protected in addition to the Protecting list. Multiple RegExps can be specified via an Array.

#### unprotect

Type: RegExp or Array

Texts which are matched to this RegExp are cleaned even if those text are included in the Protecting list. Multiple RegExps can be specified via an Array.

For example, a HTML source code as template in ';, ?> in PHP code, etc..
Some language parsers also mistake by those, then they recommend us to write code like '<' + '/script>'. This is better even if htmlclean is not used.

$3

htmlclean removes HTML/SVG comments that include SSI tags like . I think it's no problem because htmlclean is used to minify HTML. If that SSI tag includes a important code for logic, use protect option, or and `.

$3

htmlclean never changes structure of document even if elements or attributes look like meaningless, because those might be used by your program, and the structuring is not job htmlclean should do. It should prevent unexpectedly breaking the data after all your efforts.
If you would like to enforce rules relating to code style, check out documents such as code style guide.
Also, htmlclean supposes valid HTML code. Since htmlclean never checks the syntax, it might not work correctly when wrong document was passed. (Also: Malformed Nested Tags, and Close Tags in Script)

See Also

If you want to control details of editing, HtmlCompressor, HTMLMinifier and others are better choice.

---

Thanks for images: Wikimedia Commons