HTML Parser in JavaScript

John must have had some downtime on Sunday afternoon, as he implemented an HTML parser in JavaScript. The library, that you can play with via this demo, lets you attack HTML in a few ways:

A SAX-style API

Handles tag, text, and comments with callbacks. For example, let's say you wanted to implement a simple HTML to XML serialization scheme - you could do so using the following:

PLAIN TEXT

JAVASCRIPT:

1.  
2. var results = " ";
3.  
4. HTMLParser("

   hello world", {

5.   start: function( tag, attrs, unary ) {
6.     results += "<" + tag;
7.  
8.     for ( var i = 0; i length; i++ )
9.       results += " " + attrs[i].name + '="' + attrs[i].escaped + '"';
10.  
11.     results += (unary ? "/" : " ") + ">";
12.   },
13.   end: function( tag ) {
14.     results += " ";
15.   },
16.   chars: function( text ) {
17.     results += text;
18.   },
19.   comment: function( text ) {
20.     results += "";
21.   }
22. });
23.  
24. results == '

    hello world

    "

XML Serializer

Now, there's no need to worry about implementing the above, since it's included directly in the library, as well. Just feed in HTML and it spits back an XML string.

PLAIN TEXT

JAVASCRIPT:

1.  
2. var results = HTMLtoXML("

   Data: ")

3. results == "

   Data: "/>

   "
4.  

DOM Builder

If you're using the HTML parser to inject into an existing DOM document (or within an existing DOM element) then htmlparser.js provides a simple method for handling that:

PLAIN TEXT

JAVASCRIPT:

1.  
2. // The following is appended into the document body
3. HTMLtoDOM("

   Hello World", document)

4.  
5. // The follow is appended into the specified element
6. HTMLtoDOM("

   Hello World", document.getElementById("test"))

7.  

DOM Document Creator

This is a more-advanced version of the DOM builder - it includes logic for handling the overall structure of a web page, returning a new DOM document.

A couple points are enforced by this method:

• There will always be a html, head, body, and title element.
• There will only be one html, head, body, and title element (if the user specifies more, then will be moved to the appropriate locations and merged).
• link and base elements are forced into the head.

You would use the method like so:

PLAIN TEXT

JAVASCRIPT:

1.  
2. var dom = HTMLtoDOM("

   Data: ");

3. dom.getElementsByTagName("body").length == 1
4. dom.getElementsByTagName("p").length == 1
5.  

One place that you could use this API would be on the server-side. For example, using Aptana Jaxer. Although, you could also interface directly to Java, or just use the Mozilla utilities directly.