aboutsummaryrefslogtreecommitdiff
path: root/files/de/web/api/domparser/index.html
blob: 808219765874d468a5741e2ba725b9225405c779 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
---
title: DOMParser
slug: Web/API/DOMParser
translation_of: Web/API/DOMParser
---
<p>{{APIRef("DOM")}}{{SeeCompatTable}}</p>

<p>Der DOMParser kann XML oder HTML aus einem String in ein DOM-<a href="/en-US/docs/DOM/document" title="document">Document</a> parsen. Der DOMParser ist spezifiziert in <a href="http://html5.org/specs/dom-parsing.html" title="http://html5.org/specs/dom-parsing.html">DOM Parsing and Serialization</a>.</p>

<p><a href="/en-US/docs/DOM/XMLHttpRequest" title="DOM/XMLHttpRequest">XMLHttpRequest</a> unterstützt das parsen von XML- und HTML-Dokumenten auf die über eine URL zugegriffen wird.</p>

<h2 id="DOMParser_erzeugen">DOMParser erzeugen</h2>

<p>Um einen neuen <code>DOMParser</code> zu erzeugen benutze einfach <code>new DOMParser()</code>.</p>

<p>Für mehr Informationen über das Erstellen von einem <code>DOMParser</code> in einer Firefox-Erweiterung, konsultiere die <a href="/en-US/docs/nsIDOMParser" title="nsIDOMParser"><code>nsIDOMParser</code></a>-Dokumentation.</p>

<h2 id="XML_parsen">XML parsen</h2>

<p>Nachdem du einmal ein Parser-Objekt erzeugt hast, kannst du XML-Strings mit der <code>parseFromString</code>-Methode parsen.</p>

<pre class="brush: js">const parser = new DOMParser();
const doc = parser.parseFromString(stringContainingXMLSource, "application/xml");
</pre>

<h3 id="Error_handling" name="Error_handling">Fehlerbehandlung</h3>

<p>Beachte dass derzeit keine Exception ausgelöst wird, wenn es beim Ausführen des Parser-Prozesses zu einem Fehler kommen sollte. Stattdessen wird ein Fehler-Dokument  (s.a. {{Bug(45566)}}) ausgelöst:</p>

<pre class="brush:xml">&lt;parsererror xmlns="http://www.mozilla.org/newlayout/xml/parsererror.xml"&gt;
(error description)
&lt;sourcetext&gt;(a snippet of the source XML)&lt;/sourcetext&gt;
&lt;/parsererror&gt;
</pre>

<p>Die Parsing-Fehler werden auch in der Error-Console, zusammen mit dem Dokument-URl als Fehlerquelle ausgegeben (s.u.).</p>

<h2 id="Ein_SVG-_oder_HTML-Dokument_parsen">Ein SVG- oder HTML-Dokument parsen</h2>

<p>Der <code>DOMParser</code> beherrscht auch SVG {{geckoRelease("10.0")}} und HTML {{geckoRelease("12.0")}}. Es gibt drei mögliche Ergebnisse, die mit der Übergabe eines MIME-Typen ausgewählt werden können. Ist der MIME-Typ <code>text/xml</code>, ist das resultierende Dokument ein <code>XMLDocument</code>, ist er <code>image/svg+xml</code>, wird ein <code>SVGDocument</code> zurückgegeben und für <code>text/html</code> erhält man ein <code>HTMLDocument</code>.</p>

<pre class="brush: js">const xmlDoc = new DOMParser().parseFromString(stringContainingXMLSource, "application/xml");
// returns a Document, but not a SVGDocument nor a HTMLDocument

const svgDoc = new DOMParser().parseFromString(stringContainingXMLSource, "image/svg+xml");
// returns a SVGDocument, which also is a Document.

const htmlDoc = new DOMParser().parseFromString(stringContainingHTMLSource, "text/html");
// returns a HTMLDocument, which also is a Document.
</pre>

<h3 id="DOMParser_HTML-Erweiterung_für_andere_Browser">DOMParser HTML-Erweiterung für andere Browser</h3>

<pre class="brush: js">/* inspiriert von https://gist.github.com/1129031 */
/*global document, DOMParser*/

(function(DOMParser) {
    "use strict";

    const proto = DOMParser.prototype;
    const nativeParse = <span style="font-size: 1rem;">proto</span><span style="font-size: 1rem;">.parseFromString</span>;

    // Firefox/Opera/IE werfen bei unbekannten Typen Fehler
    try {
        // WebKit gibt bei bei unbekannten Typen `null` zurück
        if (new DOMParser().parseFromString("", "text/html")) {
            // text/html wird unterstützt
            return;
        }
    } catch (ex) {}

    <span style="font-size: 1rem;">proto</span><span style="font-size: 1rem;">.parseFromString = function(markup, type) {</span>
        if (/^\s*text\/html\s*(?:;|$)/i.test(type)) {
            const doc = document.implementation.createHTMLDocument("");
            if (markup.toLowerCase().includes('&lt;!doctype')) {
                doc.documentElement.innerHTML = markup;
            } else {
                doc.body.innerHTML = markup;
            }
            return doc;
        } else {
            return <span style="font-size: 1rem;">nativeParse</span><span style="font-size: 1rem;">.apply(this, arguments);</span>
        }
    };
}(DOMParser));
</pre>

<h3 id="Den_DOMParser_im_ChromeJSMXPCOMPrivileged-Scope_aufrufen">Den DOMParser im Chrome/JSM/XPCOM/Privileged-Scope aufrufen</h3>

<p>Siehe <a href="/en-US/docs/nsIDOMParser">nsIDOMParser</a></p>

<h2 id="Browser_compatibility" name="Browser_compatibility">Browser-Kompatibilität</h2>

<div>{{CompatibilityTable}}</div>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari (WebKit)</th>
  </tr>
  <tr>
   <td>XML support</td>
   <td>{{CompatChrome(1)}}</td>
   <td>{{CompatGeckoDesktop(1)}}</td>
   <td>{{CompatIE(9)}}</td>
   <td>{{CompatOpera(8)}}</td>
   <td>{{CompatSafari(3.2)}}</td>
  </tr>
  <tr>
   <td>SVG support</td>
   <td>{{CompatChrome(4)}}</td>
   <td>{{CompatGeckoDesktop(10.0)}}</td>
   <td>{{CompatIE(10)}}</td>
   <td>{{CompatOpera(15)}}</td>
   <td>{{CompatSafari(3.2)}}</td>
  </tr>
  <tr>
   <td>HTML support</td>
   <td>{{CompatChrome(30)}}</td>
   <td>{{CompatGeckoDesktop(12.0)}}</td>
   <td>{{CompatIE(10)}}</td>
   <td>{{CompatOpera(17)}}</td>
   <td>{{CompatSafari(7.1)}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>XML support</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td>SVG support</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatGeckoMobile(10.0)}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td>HTML support</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatGeckoMobile(12.0)}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
 </tbody>
</table>
</div>

<h2 id="See_also" name="See_also">Siehe auch</h2>

<ul>
 <li><a href="/en-US/docs/Parsing_and_serializing_XML" title="Parsing_and_serializing_XML">Parsing and serializing XML</a></li>
 <li><a href="/en-US/docs/DOM/XMLHttpRequest" title="DOM/XMLHttpRequest">XMLHttpRequest</a></li>
 <li><a href="/en-US/docs/XMLSerializer" title="XMLSerializer">XMLSerializer</a></li>
 <li><a href="/en-US/Add-ons/Code_snippets/HTML_to_DOM">Parsing HTML to DOM</a></li>
</ul>