Note that this document is under development, and is not currently a comprehensive listing of the DOM methods and properties implemented for Gecko. Each individual section of the document (e.g., the DOM Document Reference) is complete for the object(s) it describes, however. As reference information for the various members of the huge APIs becomes available, it is integrated into this document here.
In its introductory material, many examples, and high-level explanations, the document is a "beginners" web development guide. In general, however, the API reference should be valuable for inexperienced and experienced web developers alike.
Gecko, the software component in these browsers that handles the parsing of the HTML, the layout of the pages, the document object model, and even the rendering of the entire application interface, is a fast, standards-compliant rendering engine that implements the W3C DOM standards and the DOM-like (but not standardized) browser object model (i.e., window et al) in the context of web pages and the application interface, or chrome, of the browser.
Each description in the API reference includes the syntax, the input and output parameters (where the return type of the return type is given), an example, any additional notes, and a link to the appropriate specification.
Typically, read-only properties have a single line of syntax because those properties can only be gotten and not set. For example, the read-only property availHeight of the screen object includes the following syntax information:
In general, the object whose member is being described is given in the syntax statement with a simple type, e.g, element for all elements, document for the top-level document object, table for the TABLE object, etc. (see Important Data Types for more information about data types).
Similar functions and pages can be devised for all the object members that are not already packaged up for use. See the Testing the DOM API section in the introduction for a "test harness" that you can use to test a number of APIs all at once.