Update DOMParser type (#839)

Author: saschanaz

baselines/dom.generated.d.ts

@@ -3923,7 +3923,16 @@ declare var DOMMatrixReadOnly: {
 
 /** Provides the ability to parse XML or HTML source code from a string into a DOM Document. */
 interface DOMParser {
-    parseFromString(str: string, type: SupportedType): Document;
+    /**
+     * Parses string using either the HTML or XML parser, according to type, and returns the resulting Document. type can be "text/html" (which will invoke the HTML parser), or any of "text/xml", "application/xml", "application/xhtml+xml", or "image/svg+xml" (which will invoke the XML parser).
+     * 
+     * For the XML parser, if string can be parsed, then the returned Document will contain elements describing the resulting error.
+     * 
+     * Note that script elements are not evaluated during parsing, and the resulting document's encoding will always be UTF-8.
+     * 
+     * Values other than the above for type will cause a TypeError exception to be thrown.
+     */
+    parseFromString(string: string, type: DOMParserSupportedType): Document;
 }
 
 declare var DOMParser: {
@@ -19922,6 +19931,7 @@ type ColorSpaceConversion = "default" | "none";
 type CompositeOperation = "accumulate" | "add" | "replace";
 type CompositeOperationOrAuto = "accumulate" | "add" | "auto" | "replace";
 type CredentialMediationRequirement = "optional" | "required" | "silent";
+type DOMParserSupportedType = "application/xhtml+xml" | "application/xml" | "image/svg+xml" | "text/html" | "text/xml";
 type DirectionSetting = "" | "lr" | "rl";
 type DisplayCaptureSurfaceType = "application" | "browser" | "monitor" | "window";
 type DistanceModelType = "exponential" | "inverse" | "linear";
@@ -20022,7 +20032,6 @@ type ServiceWorkerState = "activated" | "activating" | "installed" | "installing
 type ServiceWorkerUpdateViaCache = "all" | "imports" | "none";
 type ShadowRootMode = "closed" | "open";
 type SpeechSynthesisErrorCode = "audio-busy" | "audio-hardware" | "canceled" | "interrupted" | "invalid-argument" | "language-unavailable" | "network" | "not-allowed" | "synthesis-failed" | "synthesis-unavailable" | "text-too-long" | "voice-unavailable";
-type SupportedType = "application/xhtml+xml" | "application/xml" | "image/svg+xml" | "text/html" | "text/xml";
 type TextTrackKind = "captions" | "chapters" | "descriptions" | "metadata" | "subtitles";
 type TextTrackMode = "disabled" | "hidden" | "showing";
 type TouchType = "direct" | "stylus";

inputfiles/idl/DOM Parsing and Serialization.widl

@@ -1,17 +1,3 @@
-[Exposed=Window]
-interface DOMParser {
-  constructor();
-  [NewObject] Document parseFromString(DOMString str, SupportedType type);
-};
-
-enum SupportedType {
-  "text/html",
-  "text/xml",
-  "application/xml",
-  "application/xhtml+xml",
-  "image/svg+xml"
-};
-
 [Exposed=Window]
 interface XMLSerializer {
   constructor();

inputfiles/idl/HTML - Dynamic markup insertion.commentmap.json

@@ -0,0 +1,8 @@
+{
+    "document-open": "Causes the Document to be replaced in-place, as if it was a new Document object, but reusing the previous object, which is then returned.\n\nThe resulting Document has an HTML parser associated with it, which can be given data to parse using document.write().\n\nThe method has no effect if the Document is still being parsed.\n\nThrows an \"InvalidStateError\" DOMException if the Document is an XML document.\n\nThrows an \"InvalidStateError\" DOMException if the parser is currently executing a custom element constructor.",
+    "document-close": "Closes the input stream that was opened by the document.open() method.\n\nThrows an \"InvalidStateError\" DOMException if the Document is an XML document.\n\nThrows an \"InvalidStateError\" DOMException if the parser is currently executing a custom element constructor.",
+    "document-write": "In general, adds the given string(s) to the Document's input stream.\n\nThis method has very idiosyncratic behavior. In some cases, this method can affect the state of the HTML parser while the parser is running, resulting in a DOM that does not correspond to the source of the document (e.g. if the string written is the string \"<plaintext>\" or \"<!--\"). In other cases, the call can clear the current page first, as if document.open() had been called. In yet more cases, the method is simply ignored, or throws an exception. Users agents are explicitly allowed to avoid executing script elements inserted via this method. And to make matters even worse, the exact behavior of this method can in some cases be dependent on network latency, which can lead to failures that are very hard to debug. For all these reasons, use of this method is strongly discouraged.\n\nThrows an \"InvalidStateError\" DOMException when invoked on XML documents.\n\nThrows an \"InvalidStateError\" DOMException if the parser is currently executing a custom element constructor.",
+    "document-writeln": "Adds the given string(s) to the Document's input stream, followed by a newline character. If necessary, calls the open() method implicitly first.\n\nThrows an \"InvalidStateError\" DOMException when invoked on XML documents.\n\nThrows an \"InvalidStateError\" DOMException if the parser is currently executing a custom element constructor.",
+    "domparser-constructor": "Constructs a new DOMParser object.",
+    "domparser-parsefromstring": "Parses string using either the HTML or XML parser, according to type, and returns the resulting Document. type can be \"text/html\" (which will invoke the HTML parser), or any of \"text/xml\", \"application/xml\", \"application/xhtml+xml\", or \"image/svg+xml\" (which will invoke the XML parser).\n\nFor the XML parser, if string can be parsed, then the returned Document will contain elements describing the resulting error.\n\nNote that script elements are not evaluated during parsing, and the resulting document's encoding will always be UTF-8.\n\nValues other than the above for type will cause a TypeError exception to be thrown."
+}

inputfiles/idl/HTML - Dynamic markup insertion.widl

@@ -0,0 +1,14 @@
+[Exposed=Window]
+interface DOMParser {
+  constructor();
+
+  [NewObject] Document parseFromString(DOMString string, DOMParserSupportedType type);
+};
+
+enum DOMParserSupportedType {
+  "text/html",
+  "text/xml",
+  "application/xml",
+  "application/xhtml+xml",
+  "image/svg+xml"
+};

inputfiles/idlSources.json

@@ -260,6 +260,10 @@
         "url": "https://html.spec.whatwg.org/multipage/dnd.html",
         "title": "HTML - Drag and drop"
     },
+    {
+        "url": "https://html.spec.whatwg.org/multipage/dynamic-markup-insertion.html",
+        "title": "HTML - Dynamic markup insertion"
+    },
     {
         "url": "https://html.spec.whatwg.org/multipage/edits.html",
         "title": "HTML - Edits"