xml-twig 1.5.0 → 1.6.1

package/doc/twig.md

@@ -1506,6 +1506,7 @@ Optional settings for the Twig parser
 | [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. |
 | [partial] | <code>boolean</code> | If `true` then unhandled elements are purged. |
+| [file] | <code>string</code> | The filename to be parsed. Just used for information and logging purpose. |
 
 **Example**  
 ```js

package/package.json

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

package/twig.js

@@ -63,6 +63,7 @@ const Any = new AnyHandler();
 * @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} [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 }
 * @default  { method: 'sax', xmlns: false, trim: true, resumeAfterError: false, partial: false }
 */
@@ -266,6 +267,14 @@ function createParser(handler, options = {}) {
       enumerable: true
    });
 
+   if (options.file != null) {
+      Object.defineProperty(parser, 'file', {
+         value: options.file,
+         writable: false,
+         enumerable: true
+      });
+   }
+
    // Common events
    parser.on('text', function (str) {
       if (current === undefined || current === null) return;