Add BuilderOption: keepEntityCharRefs

src/interfaces.ts

@@ -101,6 +101,10 @@ export interface XMLBuilderOptions {
    * - str - the input string
    */
   invalidCharReplacement: string | ((char: string, offset: number, str: string) => string) | undefined
+  /**
+   * Whether predefined entities and character references in text nodes are converted or not.
+   */
+  keepEntityCharRefs: boolean
   /**
    * Defines custom parser functions.
    */
@@ -143,6 +147,7 @@ export const DefaultBuilderOptions: XMLBuilderOptions = {
     xlink: "http://www.w3.org/1999/xlink"
   },
   invalidCharReplacement: undefined,
+  keepEntityCharRefs: false,
   parser: undefined
 }
 
@@ -1342,6 +1347,10 @@ export type XMLBuilderCBOptions = CBWriterOptions & {
  * a replacement character.
  */
   invalidCharReplacement: string | ((substring: string, ...args: any[]) => string) | undefined
+  /**
+   * Whether predefined entities and character references in text nodes are converted or not.
+   */
+  keepEntityCharRefs: boolean
 }
 
 /**
@@ -1507,7 +1516,8 @@ export const DefaultXMLBuilderCBOptions: Partial<XMLBuilderCBOptions> = {
     mathml: "http://www.w3.org/1998/Math/MathML",
     svg: "http://www.w3.org/2000/svg",
     xlink: "http://www.w3.org/1999/xlink"
-  }
+  },
+  keepEntityCharRefs: false
 }
 
 type RecursivePartial<T> = {

src/readers/BaseReader.ts

@@ -67,7 +67,7 @@ export abstract class BaseReader<U extends string | ExpandObject> {
    * @param text - text value to serialize
    */
   _decodeText(text: string): string {
-    if (text == null) return text
+    if (text == null || this._builderOptions.keepEntityCharRefs) return text
 
     return text.replace(/&(quot|amp|apos|lt|gt);/g, (_match, tag) =>
       BaseReader._entityTable[tag]

src/writers/BaseWriter.ts

@@ -910,6 +910,7 @@ export abstract class BaseWriter<T extends BaseWriterOptions, U extends XMLSeria
    * @param level - current depth of the XML tree
    */
   private _serializeText(node: CharacterData, requireWellFormed: boolean): void {
+    if (this._builderOptions.keepEntityCharRefs) return
 
     /**
      * 1. If the require well-formed flag is set (its value is true), and 
@@ -932,6 +933,8 @@ export abstract class BaseWriter<T extends BaseWriterOptions, U extends XMLSeria
       .replace(/</g, '&lt;')
       .replace(/>/g, '&gt;')
 
+    if (this._builderOptions.keepEntityCharRefs) markup = node.data
+
     this.text(markup)
   }