domintro

Author: noamr

source

@@ -125705,37 +125705,37 @@ interface <dfn interface>Sanitizer</dfn> {
 
   <dl class="domintro">
    <dt><code data-x=""><var>config</var> = <var>sanitizer</var>.<span data-x="dom-Sanitizer-get">get</span>()</code></dt>
-   <dd><p>Returns a copy of the sanitizer's configuration.</p></dd>
+   <dd><p>Returns a copy of the sanitizer's <span data-x="SanitizerConfig">configuration</span>.</p></dd>
 
    <dt><code data-x=""><var>sanitizer</var>.<span data-x="dom-Sanitizer-allowElement">allowElement</span>(<var>element</var>)</code></dt>
-   <dd><p>Adds an element to the allow-list.</p></dd>
+   <dd><p>Ensures that the sanitizer configuration allows the specified element.</p></dd>
 
    <dt><code data-x=""><var>sanitizer</var>.<span data-x="dom-Sanitizer-removeElement">removeElement</span>(<var>element</var>)</code></dt>
-   <dd><p>Adds an element to the remove-list.</p></dd>
+   <dd><p>Ensures that the sanitizer configuration blocks the specified element.</p></dd>
 
    <dt><code data-x=""><var>sanitizer</var>.<span data-x="dom-Sanitizer-replaceElementWithChildren">replaceElementWithChildren</span>(<var>element</var>)</code></dt>
-   <dd><p>Adds an element to the list of elements to be replaced with their children.</p></dd>
+   <dd><p>Configures the sanitizer to remove the specified element but keep its child nodes.</p></dd>
 
    <dt><code data-x=""><var>sanitizer</var>.<span data-x="dom-Sanitizer-allowAttribute">allowAttribute</span>(<var>attribute</var>)</code></dt>
-   <dd><p>Adds an attribute to the allow-list.</p></dd>
+   <dd><p>Configures the sanitizer to allow the specified attribute globally.</p></dd>
 
-   <dt><code data-x=""><var>sanitizer</var>.<span data-x="dom-San-removeAttribute">removeAttribute</span>(<var>attribute</var>)</code></dt>
-   <dd><p>Adds an attribute to the remove-list.</p></dd>
+   <dt><code data-x=""><var>sanitizer</var>.<span data-x="dom-Sanitizer-removeAttribute">removeAttribute</span>(<var>attribute</var>)</code></dt>
+   <dd><p>Configures the sanitizer to block the specified attribute globally.</p></dd>
 
    <dt><code data-x=""><var>sanitizer</var>.<span data-x="dom-Sanitizer-allowProcessingInstruction">allowProcessingInstruction</span>(<var>pi</var>)</code></dt>
-   <dd><p>Adds a processing instruction to the allow-list.</p></dd>
+   <dd><p>Configures the sanitizer to allow the specified processing instruction.</p></dd>
 
    <dt><code data-x=""><var>sanitizer</var>.<span data-x="dom-Sanitizer-removeProcessingInstruction">removeProcessingInstruction</span>(<var>pi</var>)</code></dt>
-   <dd><p>Adds a processing instruction to the remove-list.</p></dd>
+   <dd><p>Configures the sanitizer to block the specified processing instruction.</p></dd>
 
    <dt><code data-x=""><var>sanitizer</var>.<span data-x="dom-Sanitizer-setComments">setComments</span>(<var>allow</var>)</code></dt>
-   <dd><p>Sets whether comments are allowed.</p></dd>
+   <dd><p>Sets whether the sanitizer preserves comments.</p></dd>
 
    <dt><code data-x=""><var>sanitizer</var>.<span data-x="dom-Sanitizer-setDataAttributes">setDataAttributes</span>(<var>allow</var>)</code></dt>
-   <dd><p>Sets whether custom data attributes are allowed.</p></dd>
+   <dd><p>Sets whether the sanitizer preserves custom data attributes (e.g., <code>data-*</code>).</p></dd>
 
    <dt><code data-x=""><var>sanitizer</var>.<span data-x="dom-Sanitizer-removeUnsafe">removeUnsafe</span>()</code></dt>
-   <dd><p>Removes all unsafe elements and attributes from the configuration.</p></dd>
+   <dd><p>Modifies the configuration to automatically remove elements and attributes that are considered unsafe.</p></dd>
   </dl>
 
   <p>A <code>Sanitizer</code> has an associated <dfn for="Sanitizer">configuration</dfn> (a