document more changes

rbri · rbri · commit 96c054dd573f · 2025-09-29T18:42:12.000+02:00
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
@@ -7,12 +7,21 @@
     </properties>
 
     <body>
-        <release version="4.17.0" date="September xx, 2025" description="Chrome/Edge 140, Firefox 142, Bugfixes">
+        <release version="4.17.0" date="September xx, 2025" description="Chrome/Edge 140, Firefox 142, css :has(), :is(), :where(), BroadcastChannel, Bugfixes">
+            <action type="update" dev="Rene Schwietzke">
+                Use a new HTMLElementsWithCache object for each neko parser run to avoid race conditions under load.
+            </action>
+            <action type="update" dev="Rene Schwietzke">
+                neko: some optimizations for HTMLElementsProvider/HTMLElements/HTMLElementsWithCache.
+            </action>
+            <action type="add" dev="rbri">
+                neko: introduce HTMLElementsProvider and HTMLElementsWithCache.
+            </action>
             <action type="fix" dev="RhinoTeam">
-                core-js: 'eval'of a function is now undefined
+                core-js: 'eval'of a function is now undefined.
             </action>
             <action type="fix" dev="RhinoTeam">
-                core-js: duplicate properties in object literal now allowed
+                core-js: duplicate properties in object literal now allowed.
             </action>
             <action type="fix" dev="rbri">
                 Window.top has no setter.
diff --git a/src/main/java/org/htmlunit/html/parser/neko/HtmlUnitNekoDOMBuilder.java b/src/main/java/org/htmlunit/html/parser/neko/HtmlUnitNekoDOMBuilder.java
@@ -207,6 +207,10 @@ public void pushInputString(final String html) {
      * @return the configuration
      */
     private static XMLParserConfiguration createConfiguration(final BrowserVersion browserVersion) {
+        // HTMLElements.HTMLElementsWithCache are not thread safe
+        // because the cache is not synchronized
+        // we have to create a new one for each parser run
+
         if (browserVersion.hasFeature(HTML_COMMAND_TAG)) {
             return new HTMLConfiguration(new HTMLElements.HTMLElementsWithCache(HTMLELEMENTS_WITH_CMD));
         }
