@rgrove/parse-xml 4.0.1 → 4.2.0

package/README.md

@@ -38,7 +38,7 @@ Or, if you like living dangerously, you can load [the minified bundle](https://u
 
 ## Not Features
 
-This parser currently discards document type declarations (`<!DOCTYPE ... >`) and all their contents, because they're rarely useful and some of their features aren't safe when the XML being parsed comes from an untrusted source.
+While this parser is capable of parsing document type declarations (`<!DOCTYPE ... >`) and including them in the node tree, it doesn't actually do anything with them. External document type definitions won't be loaded, and the parser won't validate the document against a DTD or resolve custom entity references defined in a DTD.
 
 In addition, the only supported character encoding is UTF-8 because it's not feasible (or useful) to support other character encodings in JavaScript.
 
@@ -149,64 +149,79 @@ Also, it was fun.
 
 ## Benchmark
 
-Here's how parse-xml stacks up against two comparable libraries, [libxmljs2](https://github.com/marudor/libxmljs2) (which is based on the native libxml library) and [xmldoc](https://github.com/nfarina/xmldoc) (which is based on [sax-js](https://github.com/isaacs/sax-js)).
+Here's how parse-xml's performance stacks up against a few comparable libraries:
+
+-   [fast-xml-parser](https://github.com/NaturalIntelligence/fast-xml-parser), which claims to be the fastest pure JavaScript XML parser
+-   [libxmljs2](https://github.com/marudor/libxmljs2), which is based on the native libxml library written in C
+-   [xmldoc](https://github.com/nfarina/xmldoc), which is based on [sax-js](https://github.com/isaacs/sax-js)
 
 While libxmljs2 is faster at parsing medium and large documents, its performance comes at the expense of a large C dependency, no browser support, and a [history of security vulnerabilities](https://www.cvedetails.com/vulnerability-list/vendor_id-1962/product_id-3311/Xmlsoft-Libxml2.html) in the underlying libxml2 library.
 
+In these results, "ops/s" refers to operations per second. Higher is faster.
+
 ```
-Node.js v18.9.1 / Darwin arm64
+Node.js v22.10.0 / Darwin arm64
 Apple M1 Max
 
 Running "Small document (291 bytes)" suite...
 Progress: 100%
 
-  @rgrove/parse-xml 4.0.0:
-    189 074 ops/s, ±0.10%   | fastest
+  @rgrove/parse-xml 4.2.0:
+    253 082 ops/s, ±0.16%   | fastest
+
+  fast-xml-parser 4.5.0:
+    127 232 ops/s, ±0.44%   | 49.73% slower
 
-  libxmljs2 0.30.1 (native):
-    74 006 ops/s, ±0.32%    | 60.86% slower
+  libxmljs2 0.35.0 (native):
+    68 709 ops/s, ±2.77%    | slowest, 72.85% slower
 
-  xmldoc 1.2.0 (sax-js):
-    68 045 ops/s, ±0.08%    | slowest, 64.01% slower
+  xmldoc 1.3.0 (sax-js):
+    122 345 ops/s, ±0.15%   | 51.66% slower
 
-Finished 3 cases!
-  Fastest: @rgrove/parse-xml 4.0.0
-  Slowest: xmldoc 1.2.0 (sax-js)
+Finished 4 cases!
+  Fastest: @rgrove/parse-xml 4.2.0
+  Slowest: libxmljs2 0.35.0 (native)
 
 Running "Medium document (72081 bytes)" suite...
 Progress: 100%
 
-  @rgrove/parse-xml 4.0.0:
-    1 066 ops/s, ±0.11%   | 49.12% slower
+  @rgrove/parse-xml 4.2.0:
+    1 350 ops/s, ±0.18%   | 29.5% slower
 
-  libxmljs2 0.30.1 (native):
-    2 095 ops/s, ±2.68%   | fastest
+  fast-xml-parser 4.5.0:
+    560 ops/s, ±0.48%     | slowest, 70.76% slower
 
-  xmldoc 1.2.0 (sax-js):
-    459 ops/s, ±0.10%     | slowest, 78.09% slower
+  libxmljs2 0.35.0 (native):
+    1 915 ops/s, ±2.64%   | fastest
 
-Finished 3 cases!
-  Fastest: libxmljs2 0.30.1 (native)
-  Slowest: xmldoc 1.2.0 (sax-js)
+  xmldoc 1.3.0 (sax-js):
+    824 ops/s, ±0.20%     | 56.97% slower
+
+Finished 4 cases!
+  Fastest: libxmljs2 0.35.0 (native)
+  Slowest: fast-xml-parser 4.5.0
 
 Running "Large document (1162464 bytes)" suite...
 Progress: 100%
 
-  @rgrove/parse-xml 4.0.0:
-    91 ops/s, ±0.11%    | 51.85% slower
+  @rgrove/parse-xml 4.2.0:
+    109 ops/s, ±0.17%   | 40.11% slower
+
+  fast-xml-parser 4.5.0:
+    48 ops/s, ±0.55%    | slowest, 73.63% slower
 
-  libxmljs2 0.30.1 (native):
-    189 ops/s, ±0.99%   | fastest
+  libxmljs2 0.35.0 (native):
+    182 ops/s, ±1.16%   | fastest
 
-  xmldoc 1.2.0 (sax-js):
-    39 ops/s, ±0.08%    | slowest, 79.37% slower
+  xmldoc 1.3.0 (sax-js):
+    73 ops/s, ±0.50%    | 59.89% slower
 
-Finished 3 cases!
-  Fastest: libxmljs2 0.30.1 (native)
-  Slowest: xmldoc 1.2.0 (sax-js)
+Finished 4 cases!
+  Fastest: libxmljs2 0.35.0 (native)
+  Slowest: fast-xml-parser 4.5.0
 ```
 
-See the [parse-xml-benchmark](https://github.com/rgrove/parse-xml-benchmark) repo for instructions on running this benchmark yourself.
+See the [parse-xml-benchmark](https://github.com/rgrove/parse-xml-benchmark) repo for instructions on how to run this benchmark yourself.
 
 ## License