xml-twig 1.9.4 → 1.10.0

package/README.md

@@ -57,6 +57,10 @@ API Documentation: see [Twig](./doc/twig.md)
    const parser = twig.createParser({ tag: twig.Root, function: rootHandler }, { method: 'sax' })
    fs.createReadStream(`${__dirname}/bookstore.xml`).pipe(parser)
 
+   parser.on('error', function (err) {
+      console.error(err);
+   });
+
    // Output -> <bookstore> finished after 48 lines
    ```
 

package/doc/twig.md

@@ -1528,7 +1528,7 @@ Generic error for unsupported condition
 
 ## SAX
 **Kind**: global constant  
-**Version:**: 1.9.4  
+**Version:**: 1.10.0  
 **Author:**: Wernfried Domscheit  
 **Copyright:**: Copyright (c) 2025 Wernfried Domscheit. All rights reserved.  
 **Website:**: https://www.npmjs.com/package/xml-twig  
@@ -1600,7 +1600,7 @@ Optional settings for the Twig parser
 | method | <code>&#x27;sax&#x27;</code> \| <code>&#x27;expat&#x27;</code> | The underlying parser. Either `'sax'`, `'expat'`. |
 | xmlns | <code>boolean</code> | If `true`, then namespaces are accessible by `namespace` property. |
 | trim | <code>boolean</code> | If `true`, then turn any whitespace into a single space. Text and comments are trimmed. |
-| resumeAfterError | <code>boolean</code> | If `true` then parser continues reading after an error. Otherwise it throws exception. |
+| resumeAfterError | <code>boolean</code> | If `true` then parser continues reading after an error.<br> Only relevant for `sax`, `expat` always terminates on error. |
 | partial | <code>boolean</code> | If `true` then unhandled elements are purged. |
 | file | <code>string</code> | Optional. The name of file to be parsed. Just used for information and logging purpose. |
 

package/package.json

@@ -5,7 +5,7 @@
   },
   "name": "xml-twig",
   "description": "Node module for processing huge XML documents in tree mode",
-  "version": "1.9.4",
+  "version": "1.10.0",
   "main": "twig.js",
   "directories": {
     "doc": "doc"

package/twig.js

@@ -1,5 +1,5 @@
 /**
-* @version: 1.9.4
+* @version: 1.10.0
 * @author: Wernfried Domscheit
 * @copyright: Copyright (c) 2025 Wernfried Domscheit. All rights reserved.
 * @website: https://www.npmjs.com/package/xml-twig
@@ -65,7 +65,8 @@ const Any = new AnyHandler();
 * @property {'sax' | 'expat'} method - The underlying parser. Either `'sax'`, `'expat'`.
 * @property {boolean} xmlns - If `true`, then namespaces are accessible by `namespace` property.
 * @property {boolean} trim - If `true`, then turn any whitespace into a single space. Text and comments are trimmed.
-* @property {boolean} resumeAfterError - If `true` then parser continues reading after an error. Otherwise it throws exception.
+* @property {boolean} resumeAfterError - If `true` then parser continues reading after an error.<br>
+* Only relevant for `sax`, `expat` always terminates on error.
 * @property {boolean} partial - If `true` then unhandled elements are purged.
 * @property {string} [file - Optional. The name of file to be parsed. Just used for information and logging purpose.
 * @example { method: 'expat', xmlns: true }
@@ -222,6 +223,15 @@ function createParser(handler, options = {}) {
          parser.emit("close");
       });
 
+      parser.on('error', function (err) {
+         if (options.resumeAfterError) {
+            parser._parser.error = null;
+            parser._parser.resume();
+         } else {
+            parser._parser.close();
+         }
+      });
+
    } else if (EXPAT.includes(options.method)) {
       parser = require("node-expat").createParser();
       Object.defineProperty(parser, 'currentLine', {
@@ -262,6 +272,13 @@ function createParser(handler, options = {}) {
          parser.emit("finish");
       });
 
+      parser.on('error', function (err) {
+         // convert 'err' string into Error object
+         if (typeof err === 'string')
+            parser.emit('error', Error(`${err}\nLine: ${parser.currentLine}\nColumn: ${parser.currentColumn}`))
+         // resume not supported
+      });
+
    } else {
       throw new UnsupportedParser(options.method);
    }
@@ -315,14 +332,6 @@ function createParser(handler, options = {}) {
       }
    });
 
-   parser.on('error', function (err) {
-      console.error(`error at line [${parser.currentLine}], column [${parser.currentColumn}]`, err);
-      if (options.resumeAfterError) {
-         parser.underlyingParser.error = null;
-         parser.underlyingParser.resume();
-      }
-   });
-
    return parser;
 }