Add throwErrors option

Author: pilafmon

README.md

@@ -75,6 +75,7 @@ Error: HTML validation error(s) found
 ```
 
 ## 4) Options
+### analyzer()
 | Option            | Type       | Description                                                                                                 | Default |
 | ----------------- | ---------- | ----------------------------------------------------------------------------------------------------------- | ------- |
 | **proxy**         | `string`   | HTTP address of the proxy server if you are running behind a firewall, e.g. `'http://proxy:8080'`           | `null` |
@@ -95,6 +96,11 @@ const task = {
    };
 ```
 
+### reporter()
+| Option          | Type      | Description                                                                           | Default |
+| --------------- | --------- | ------------------------------------------------------------------------------------- | ------- |
+| **throwErrors** | `boolean` | Throw an [error](https://github.com/gulpjs/plugin-error) on HTTP validation failure.  | `false` |
+
 ## 5) Deprecated CommonJS (gulp-w3c-html-validator v2.0)
 If your build system is using `require()` statements for CommonJS modules, install the older v2.0:
 ```shell

html-validator.js

@@ -100,10 +100,12 @@ const htmlValidator = {
       return through2.obj(transform);
       },
 
-   reporter() {
+   reporter(options) {
+      const defaults = { throwErrors: false };
+      const settings = { ...defaults, ...options };
       const transform = (file, encoding, done) => {
          done(null, file);
-         if (file.validationResults && !file.validationResults.success)
+         if (settings.throwErrors && file.validationResults && !file.validationResults.success)
             throw new PluginError(pluginName, 'HTML validation failed');
          };
       return through2.obj(transform);

spec/mocha.js

@@ -143,7 +143,7 @@ describe('The htmlValidator.reporter() function', () => {
          success:  false,
          messages: ['HTML is valid']
          };
-      const stream = htmlValidator.reporter();
+      const stream = htmlValidator.reporter({ throwErrors: true });
       const writeToStream = () => stream.write(mockFile);
       writeToStream.should.throw(/HTML validation failed/);
       stream.end();