Subversion Repositories Kolibri OS

Rev

Go to most recent revision | Blame | Last modification | View Log | Download | RSS feed

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  2. "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3. <html
  4. xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
  5. <head>
  6. <meta http-equiv="Content-Type" content="text/html;
  7. charset=us-ascii" />
  8. <title>Document Object Model (DOM) Conformance Test
  9.         Suites, Level 1 HTML</title>
  10. <link type="text/css" rel="stylesheet" href="resources/activity-home.css" />
  11. <script type="text/javascript"
  12. src="resources/toc.js">
  13. </script>
  14. </head>
  15.  
  16.  
  17. <body onload="init()">
  18. <p class="navbar" align="right"><a href="http://www.w3.org/"><img
  19. align="left" src="resources/w3c_home.png" border="0"
  20. alt="W3C" /></a><a href="http://www.nist.gov/"><img
  21. src="resources/nist_home.gif" alt="National Institute of
  22. Standards and Technology" height="45" width="231" align="left"
  23. border="0" /></a><small><a href="http://www.w3.org/DOM/">About
  24. DOM</a> .
  25. <a href="http://www.w3.org/DOM/Activity">DOM Activity statement</a><br />
  26. <a href="http://www.w3.org/DOM/DOMTR">Technical Reports</a> . <a
  27. href="http://www.w3.org/DOM/DOMTM">Technical
  28. Materials</a><br />
  29. <a href="http://www.w3.org/DOM/Test/">Test Suites</a> . <a
  30. href="http://www.w3.org/DOM/Test/Documents/DOMTSFAQ">Test Suites FAQ</a> .
  31. <a href="http://www.w3.org/DOM/Test/MailingList">Mailing
  32. Lists</a><br />
  33. Members only resource: <a href="http://www.w3.org/DOM/Group/">DOM Working
  34. Group</a></small></p>
  35.  
  36. <h1>DOM Conformance Test Suite, Level 1 HTML</h1>
  37.  
  38. <div id="thisdoc">
  39. <h2>This document</h2>
  40. </div>
  41.  
  42. <p>
  43. This document describes how to run the DOM Level 1 HTML Test Suite. It also includes pointers to relevant software as well as relevant resources.
  44. </p>
  45. <p>The DOM TS has been developed in accordance with the <a
  46. href="http://www.w3.org/DOM/DOMTS-Process">DOM Conformance Test Suites Process Document</a>. For
  47. additional information and to download other DOM Test Suites, visit the <a
  48. href="http://www.w3.org/DOM/Test">DOM Conformance Test Suites page</a>.</p>
  49.  
  50. <div id="overview">
  51. <h2>Overview</h2>
  52. </div>
  53.  
  54. <p>
  55. The DOM Conformance Test Suite consist of a series of tests that have been generated from XML test descriptions, then transformed into the two official DOM
  56. bindings, Java and ECMA. In order to run the test suite, we have provided  the possibility to run the
  57. tests using the <a href="http://www.junit.org">JUnit</a> and <a href="http://www.jsunit.net">JsUnit</a> testing frameworks, both included in this
  58. distribution.
  59. </p>
  60. <p>The DOM Level 1 HTML TS was released on February 13, 2002.</p>
  61.  
  62. <div id="latestVersion">
  63. <h2>Latest Version</h2>
  64. </div>
  65. <p>Download the <a
  66. href="http://www.w3.org/DOM/Test/Downloads/DOMTSL1HTML">latest version</a>
  67. of the DOM Level 1 HTML Test Suite.</p>
  68.  
  69. <div id="distribution">
  70. <h2>Distribution</h2>
  71. </div>
  72. <p>This distribution is organized as follows:</p>
  73. <table width="100%" border="0">
  74. <tr>
  75.     <td width="20%">index.html</td><td>This file</td>
  76. </tr>
  77. <tr>
  78.     <td><a href="dom1-html-matrix.html">dom1-html-matrix.html</a></td>
  79.     <td>A cross reference of the tests to the DOM 1 HTML Recommendation, pointers to the tests and documentation.</td>
  80. </tr>
  81. <tr>
  82.     <td><a href="ecmascript/jsunit/testRunner.html">ecmascript/jsunit/testRunner.html</a></td>
  83.     <td>A modified <a href="http://www.jsunit.net">JSUnit</a> test runner.  JSUnit is licensed under the <a href="ecmascript/jsunit/docs/gnugpl.html">GNU Public License</a></td>
  84. </tr>
  85. <tr>
  86.     <td>ecmascript/jsunit/app, ecmascript/jsunit/docs, ecmascript/jsunit/images, ecmascript/jsunit/tests</td>
  87.     <td>JSUnit support files</td>
  88. </tr>
  89. <tr>
  90.         <td>ecmascript/level1/html</td>
  91.     <td>DOM tests for use with JSUnit</td>
  92. </tr>
  93. <tr>
  94.     <td>java/dom1-html.jar</td>
  95.     <td>DOM tests for Java implementations, includes source code.</td>
  96. </tr>
  97. <tr>
  98.     <td>java/junit-run.jar</td>
  99.     <td>A test framework adapter that supports running dom1-html.jar with the JUnit 3.7 test framework.</td>
  100. </tr>
  101. <tr>
  102.     <td>java/junit.jar</td>
  103.     <td><a href="http://www.junit.org">JUnit 3.7</a>.  JUnit 3.7 is licensed under the <a href="java/junit-license.html">IBM Public License</a>.</td>
  104. </tr>
  105. <tr>
  106.     <td>tests/*.xml</td>
  107.     <td>Test definitions in XML.</td>
  108. </tr>
  109. <tr>
  110.     <td><a href="tests/dom1.dtd">tests/dom1.dtd</a></td>
  111.     <td>Document Type Definition for DOM 1 HTML tests.</td>
  112. </tr>
  113. <tr>
  114.     <td><a href="tests/dom1.xsd">tests/dom1.xsd</a></td>
  115.     <td>XML Schema for DOM 1 HTML tests.</td>
  116. </tr>
  117. <tr>
  118.     <td>tests/files/</td>
  119.     <td>Test documents</td>
  120. </tr>
  121. <tr>
  122.     <td>doxygen/</td>
  123.     <td>Documentation generated by <a href="http://www.doxygen.org">doxygen</a> from the generated Java code.  Useful in diagnosing test failures.  
  124.     Click <a href="doxygen/html/hierarchy.html">here</a> for a class hierarchy.</td>
  125. </tr>
  126. </table>
  127.  
  128. <div id="runningECMA">
  129. <h2>Running the ECMAScript tests</h2>
  130. </div>
  131. <p>The DOM TS currently tests XML and SVG implementations of DOM Level 1 HTML. Later revisions will provide testing of HTML implementation conformance with DOM Level
  132. 1.</p>
  133. <p>To run the ECMAScript tests, open the <a
  134. href="ecmascript/jsunit/testRunner.html">JsUnit test runner</a> in the browser
  135. you want to test, press the browse button and look for the file
  136. "ecmascript/level1/html/alltests.html".
  137. After that,  press Run to run all DOM 1 tests compatible
  138. with the implementation.  If you choose to run individual tests, the
  139. above procedure works similarly, just browse for the test you want to
  140. run in the "ecmascript/level1/html" directory.</p>
  141. <p>These tests have been run with Microsoft
  142. Internet Explorer 5.0 and later for Microsoft Windows and
  143. Mozilla 0.9.8 and Netscape Navigator 6.2 and later for Microsoft Windows, Linux and Apple OS X.  
  144. Use on Apple OS X required replacing colon (:) in the test case name with slashes (/).</p>
  145. <p>To test the DOM implementation of the <a href="http://www.adobe.com/svg">Adobe SVG Viewer</a>, select
  146. "ecmascript/level1/html/svg-alltests.html" and press Run.</p>
  147. <p>For JsUnit reference, please visit the <a href="http://www.jsunit.net">JsUnit
  148. home page</a>.  JsUnit will provide output with indication on how many tests that were run, how many failed and
  149. how many errors were found while running. The error log points to the actual test, so identifying
  150. what you need to do in your implementation is simplified.</p>
  151.  
  152. <div id="runningJava">
  153. <h2>Running the Java tests</h2>
  154. </div>
  155. <p>Running the Java tests will require placing a JAXP 1.1 compatible parser on the classpath or
  156. placing a common JAXP 1.1 parser (<a href="http://xml.apache.org/crimson/index.html">Apache Xerces</a>, <a href="http://xml.apache.org/crimson/index.html">Apache Crimson</a>, <a href="http://otn.oracle.com/software/tech/xml/xdk_java/content.html">Oracle XML Developer Kit</a>, or <a href="http://www.gnu.org/software/classpathx/jaxp/">GNUJAXP</a>) in the java/ directory.</p>
  157. <p>Running "java -jar dom1-html.jar" from the java/ directory will write to the console a summary of the parser under
  158. test and the results of the tests run in two distinct configurations.  The parser under test can
  159. be selected by any mechanism supported by JAXP 1.1.</p>
  160.  
  161. <p>The Java tests may also be run using from JUnit TestRunner's.   To run
  162. all tests against the default JAXP parser in a default configuration from the JUnit text user interface, run "
  163. java -classpath dom1-html.jar junit.textui.TestRunner org.w3c.domts.level1.html.TestDefaultParser".  
  164. The run the Swing or AWT user interfaces, replace "textui" with "swingui" or "awtui" and add "-noloading" before the
  165. test case to not use JUnit's custom ClassLoader, for example, "java -classpath dom1-html.jar
  166. junit.swingui.TestRunner -noloading org.w3c.domts.level1.html.TestDefaultParser"</p>
  167.  
  168. <p>Running "java -jar junit-run.jar" will launch the JUnit SwingUI without the custom ClassLoader.</p>
  169.  
  170. <p>The following TestSuite's are provided for use within JUnit TestRunner's.  These provide
  171. the only mechanism for testing implementations that do not support JAXP 1.1 such as Batik or
  172. DOM4J.</p>
  173. <table border="0" width="100%">
  174. <tr><td width="20%">org.w3c.domts.level1.html.TestBatik</td><td>Tests the <a href="http://xml.apache.org/batik">Apache Batik</a> SVG project (currently fails loading test documents).</td></tr>
  175. <tr><td>org.w3c.domts.level1.html.TestCrimson</td><td>Tests the Apache Crimson Parser in the default configuration.</td></tr>
  176. <tr><td>org.w3c.domts.level1.html.TestCrimsonAltConfig</td><td>Tests the Apache Crimson Parser in an alternative configuration.</td></tr>
  177. <tr><td>org.w3c.domts.level1.html.TestDefaultParser</td><td>Tests the current JAXP 1.1 Parser in the default configuration.</td></tr>
  178. <tr><td>org.w3c.domts.level1.html.TestDefaultParserAltConfig</td><td>Tests the current JAXP 1.1 Parser in an alternative configuration.</td></tr>
  179. <tr><td>org.w3c.domts.level1.html.TestDOM4J</td><td>Tests <a href="http://www.dom4j.org">DOM4J</a>.</td></tr>
  180. <tr><td>org.w3c.domts.level1.html.TestGNUJAXP</td><td>Tests the GNUJAXP Parser in the default configuration.</td></tr>
  181. <tr><td>org.w3c.domts.level1.html.TestGNUJAXPAltConfig</td><td>Tests the GNUJAXP Parser in an alternative configuration.</td></tr>
  182. <tr><td>org.w3c.domts.level1.html.TestOracle</td><td>Tests the Oracle XML Parser in the default configuration.</td></tr>
  183. <tr><td>org.w3c.domts.level1.html.TestOracleAltConfig</td><td>Tests the Oracle XML Parser in an alternative configuration.</td></tr>
  184. <tr><td>org.w3c.domts.level1.html.TestXerces</td><td>Tests the Apache Xerces Parser in the default configuration.</td></tr>
  185. <tr><td>org.w3c.domts.level1.html.TestXercesAltConfig</td><td>Tests the Apache Xerces Parser in an alternative configuration.</td></tr>
  186. </table>
  187.  
  188.  
  189.  
  190. <div id="feedback">
  191. <h2>Feedback</h2>
  192. </div>
  193. <p>We look forward to your comments. The DOM TS Group communicates primarily through the <a href="mailto:www-dom-ts@w3.org">DOM TS mailing list</a> (<a
  194. href="http://lists.w3.org/Archives/Public/www-dom-ts/">archive</a>).</p>
  195.  
  196.  
  197. <div id="copyright">
  198. <h2>Copyright</h2>
  199. </div>
  200. <p>Tests in this table are released under the <a
  201. href="http://www.w3.org/Consortium/Legal/copyright-software-19980720.html">W3C
  202. Software Copyright Notice and license</a>:<br /><a
  203. href="resources/COPYRIGHT.html">Copyright</a> (c)
  204. 2002 World Wide Web Consortium,
  205.                         (Massachusetts Institute of Technology, Institut National de
  206.                         Recherche en Informatique et en Automatique, Keio University). All
  207.                         Rights Reserved. This program is distributed under the W3C's Software
  208.                         Intellectual Property License. This program is distributed in the
  209.                         hope that it will be useful, but WITHOUT ANY WARRANTY; without even
  210.                         the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
  211.                         PURPOSE.<br />See W3C License <a href="http://www.w3.org/Consortium/Legal/">http://www.w3.org/Consortium/Legal/</a> for more
  212. details.</p>
  213.  
  214.  
  215.  
  216. <div id="Acknowledgments">
  217. <h2>Acknowledgments</h2>
  218. </div>
  219.  
  220. <p>The DOM TS was jointly launched by the <a href="www.w3.org">W3C</a> and <a
  221. href="www.nist.org">NIST</a>. It is, however, a publically developed and open
  222. framework. Reaching the point of being able to finalize and release the DOM
  223. TS would not have been possible were it not for the contribution from several
  224. people in the developer community, especially <a
  225. href="mailto:Curt.Arnold@hyprotech.com">Curt Arnold</a> and <a
  226. href="mailto:fdrake@acm.org">Fred Drake</a>.</p>
  227. <hr />
  228. <address>
  229. <small><a href="mailto:mary.brady@nist.gov">Mary Brady</a>, <a
  230. href="http://www.nist.gov">NIST</a> representative<br />
  231. <a href="mailto:dimitris@ontologicon.com">Dimitris Dimitriadis</a>, DOM TS
  232.  Representative for the <a href="Group/">W3C DOM Working Group</a> <br />
  233. <a href="/People/LeHegaret/">Philippe Le&nbsp;H&eacute;garet</a>, DOM
  234.  Activity Lead<br />
  235. </small>
  236. </address>
  237. </body>
  238. </html>
  239.  
  240.  
  241.