xml-twig 1.9.0 → 1.9.3

package/doc/twig.md

@@ -127,6 +127,7 @@ You can specify a <code>function</code> or a <code>event</code> name</p>
     * [.children](#Twig+children) : [<code>Array.&lt;Twig&gt;</code>](#Twig) ℗
     * [.parent](#Twig+parent) : [<code>Twig</code>](#Twig) \| <code>undefined</code> ℗
     * [.pinned](#Twig+pinned) : <code>boolean</code> ℗
+    * [.trim](#Twig+trim) : <code>boolean</code> ℗
     * [.purge](#Twig+purge)
     * [.purgeUpTo](#Twig+purgeUpTo)
     * [.escapeEntity](#Twig+escapeEntity)
@@ -240,6 +241,13 @@ The parent object. Undefined on root element
 ### twig.pinned : <code>boolean</code> ℗
 Determines whether twig is needed in partial load
 
+**Kind**: instance property of [<code>Twig</code>](#Twig)  
+**Access**: private  
+<a name="Twig+trim"></a>
+
+### twig.trim : <code>boolean</code> ℗
+Determines whether text is trimmed
+
 **Kind**: instance property of [<code>Twig</code>](#Twig)  
 **Access**: private  
 <a name="Twig+purge"></a>
@@ -332,7 +340,8 @@ Returns the name of the element. Synonym for `twig.name`
 <a name="Twig+text"></a>
 
 ### twig.text ⇒ <code>string</code>
-The text of the element. No matter if given as text or CDATA entity
+The text of the element. No matter if given as text or CDATA entity.
+If option `trim: true`, then whitespace from both ends of the string are removed
 
 **Kind**: instance property of [<code>Twig</code>](#Twig)  
 **Returns**: <code>string</code> - Element text or empty string  
@@ -793,6 +802,7 @@ Common function to filter Twig element
     * [.children](#Twig+children) : [<code>Array.&lt;Twig&gt;</code>](#Twig) ℗
     * [.parent](#Twig+parent) : [<code>Twig</code>](#Twig) \| <code>undefined</code> ℗
     * [.pinned](#Twig+pinned) : <code>boolean</code> ℗
+    * [.trim](#Twig+trim) : <code>boolean</code> ℗
     * [.purge](#Twig+purge)
     * [.purgeUpTo](#Twig+purgeUpTo)
     * [.escapeEntity](#Twig+escapeEntity)
@@ -906,6 +916,13 @@ The parent object. Undefined on root element
 ### twig.pinned : <code>boolean</code> ℗
 Determines whether twig is needed in partial load
 
+**Kind**: instance property of [<code>Twig</code>](#Twig)  
+**Access**: private  
+<a name="Twig+trim"></a>
+
+### twig.trim : <code>boolean</code> ℗
+Determines whether text is trimmed
+
 **Kind**: instance property of [<code>Twig</code>](#Twig)  
 **Access**: private  
 <a name="Twig+purge"></a>
@@ -998,7 +1015,8 @@ Returns the name of the element. Synonym for `twig.name`
 <a name="Twig+text"></a>
 
 ### twig.text ⇒ <code>string</code>
-The text of the element. No matter if given as text or CDATA entity
+The text of the element. No matter if given as text or CDATA entity.
+If option `trim: true`, then whitespace from both ends of the string are removed
 
 **Kind**: instance property of [<code>Twig</code>](#Twig)  
 **Returns**: <code>string</code> - Element text or empty string  
@@ -1510,7 +1528,7 @@ Generic error for unsupported condition
 
 ## SAX
 **Kind**: global constant  
-**Version:**: 1.9.0  
+**Version:**: 1.9.3  
 **Author:**: Wernfried Domscheit  
 **Copyright:**: Copyright (c) 2025 Wernfried Domscheit. All rights reserved.  
 **Website:**: https://www.npmjs.com/package/xml-twig  

package/package.json

@@ -5,7 +5,7 @@
   },
   "name": "xml-twig",
   "description": "Node module for processing huge XML documents in tree mode",
-  "version": "1.9.0",
+  "version": "1.9.3",
   "main": "twig.js",
   "directories": {
     "doc": "doc"
@@ -15,8 +15,8 @@
     "doc/*.md"
   ],
   "devDependencies": {
-    "jsdoc-to-markdown": "^9.1.1",
-    "luxon": "^3.6.1",
+    "jsdoc-to-markdown": "^9.1.3",
+    "luxon": "^3.7.2",
     "node-expat": "^2.4.1"
   },
   "scripts": {

package/twig.js

@@ -1,5 +1,5 @@
 /**
-* @version: 1.9.0
+* @version: 1.9.3
 * @author: Wernfried Domscheit
 * @copyright: Copyright (c) 2025 Wernfried Domscheit. All rights reserved.
 * @website: https://www.npmjs.com/package/xml-twig
@@ -278,6 +278,12 @@ function createParser(handler, options = {}) {
       enumerable: true
    });
 
+   Object.defineProperty(parser, 'trimText', {
+      value: options.trim,
+      writable: false,
+      enumerable: true
+   });
+
    if (options.file != null) {
       Object.defineProperty(parser, 'file', {
          value: options.file,
@@ -289,7 +295,7 @@ function createParser(handler, options = {}) {
    // Common events
    parser.on('text', function (str) {
       if (parser.twig.current === null) return;
-      parser.twig.current.text = options.trim ? str.trim() : str;
+      parser.twig.current.text = str;
    });
 
    parser.on("comment", function (str) {
@@ -513,6 +519,12 @@ class Twig {
    */
    #pinned = false;
 
+   /**
+    * Determines whether text is trimmed
+   * @type {boolean}
+   */
+   #trim = true;
+
    /**
    * Create a new Twig object
    * @param {Parser} parser - The main parser object
@@ -525,6 +537,7 @@ class Twig {
       if (index === undefined)
          parser.twig.current = this;
 
+      this.#trim = parser.trimText;
       if (name === null) {
          // Root element not available yet
          parser.twig.tree = this;
@@ -698,11 +711,15 @@ class Twig {
    }
 
    /**
-   * The text of the element. No matter if given as text or CDATA entity
+   * The text of the element. No matter if given as text or CDATA entity.
+   * If option `trim: true`, then whitespace from both ends of the string are removed
    * @returns {string} Element text or empty string
    */
    get text() {
-      return this.#text ?? '';
+      if (this.#text === null)
+         return ''
+      else
+         return this.#trim ? this.#text.trim() : this.#text;
    }
 
    /**