/[jscoverage]/trunk/doc/faq.html
ViewVC logotype

Contents of /trunk/doc/faq.html

Parent Directory Parent Directory | Revision Log Revision Log


Revision 147 - (show annotations)
Fri Jun 20 02:19:40 2008 UTC (11 years, 4 months ago) by siliconforks
File MIME type: text/html
File size: 6401 byte(s)
Make icon local instead of external.

1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
2 <html>
3 <head>
4 <title>JSCoverage - FAQ</title>
5 <link rel="stylesheet" type="text/css" href="reset-fonts-grids.css">
6 <link rel="stylesheet" type="text/css" href="style.css">
7 </head>
8 <body>
9 <div id="doc3" class="yui-t5">
10 <div id="hd"><h1><a href="./">JSCoverage</a><br><span class="tag">code coverage for JavaScript</span></h1></div>
11 <div id="bd">
12 <div id="yui-main">
13 <div id="jscoverage-main" class="yui-b">
14 <h2><abbr title="Frequently Asked Questions">FAQ</abbr></h2>
15
16 <h3>Can I use JSCoverage to measure code coverage for a page on <code>http://<var>example.com</var>/</code>?</h3>
17
18 <p>
19 In order to measure the code coverage of a page on <code>http://example.com/</code>,
20 you must run <code>jscoverage</code> to create a <code>jscoverage.html</code> file on the
21 <code>example.com</code> server. You cannot use <code>http://example.org/jscoverage.html</code>
22 to measure the code coverage of a page located on <code>http://example.com/</code>.
23 </p>
24
25 <p>
26 The fundamental reason for this limitation is the
27 <a href="http://www.mozilla.org/projects/security/components/same-origin.html">Same Origin Policy</a>
28 for untrusted JavaScript.
29 </p>
30
31 <p>
32 (In fact, the current version of JSCoverage is slightly more restrictive
33 than this: it requires that the JavaScript being measured reside under the
34 same <strong>directory</strong> as the <code>jscoverage.html</code> file.)
35 </p>
36
37 <h3>Why doesn't my test suite run under JSCoverage in Firefox 3?</h3>
38
39 <p>
40 Beta versions of Firefox 3 introduced <a
41 href="http://tech.groups.yahoo.com/group/jsunit/message/1075">new
42 security restrictions</a> on local files. Depending on the way your
43 test suite is organized, this may cause problems for JSCoverage.
44 (You may get the error "uncaught exception: Permission denied to get property Window._$jscoverage".)
45 These restrictions are not present in the final release of Firefox 3.
46 </p>
47
48 <h3>I'm trying to load my code with the URL
49 <code>file:///C:/foo/bar/jscoverage.html?foo/bar.html</code>
50 and I'm getting all kinds of JavaScript errors.</h3>
51
52 <p>
53 Internet Explorer 6 seems to have problems with a <code>file:</code> URL
54 that has a query string with a slash in it.
55 </p>
56 <p>
57 As a workaround:
58 </p>
59 <ul class="list">
60 <li><p>Place your files on a web server instead of loading them from the file system.
61 (<code>http:</code> URLs work fine.)</p>
62 <li><p>Do not use a query string; enter your URL in the "URL" field in the "Browser" tab.</p>
63 <li><p>Rearrange your directory structure so that <code>bar.html</code>
64 ends up in the same directory as <code>jscoverage.html</code>; then
65 you can use the URL
66 <code>file:///C:/foo/bar/jscoverage.html?bar.html</code>
67 with no slash in the query string.</p>
68 <li><p>Use a different browser. (IE 7 seems to work.)</p>
69 </ul>
70
71 <h3>JSCoverage changes my cursor to a busy cursor, and it never changes back!</h3>
72
73 <p>
74 Certain browsers (<i>e. g</i>., Internet Explorer 6, Opera, Safari) have trouble changing
75 the cursor. Try moving the mouse and your cursor should change back to normal.
76 </p>
77
78 <p>
79 See <a href="http://groups.google.com/group/Google-Web-Toolkit/browse_thread/thread/631908bd63241136/783c307480f95d8c">this discussion</a> for more information.
80 </p>
81
82 <h3>JSCoverage hangs sometimes when rendering the coverage report.</h3>
83
84 <p>
85 With Internet Explorer 6 (I think I see a pattern here), garbage collection can cause performance problems.
86 (More information <a href="http://ajaxian.com/archives/garbage-collection-in-ie6">here</a>.)
87 </p>
88
89 <h3>Can JSCoverage be used with <a href="http://www.jsunit.net/">JsUnit</a>?</h3>
90
91 <p>
92 It is necessary to run JSCoverage in <dfn>inverted mode</dfn>. You will have to
93 modify JsUnit to launch JSCoverage.
94 </p>
95
96 <p>
97 See the directory <code>doc/example-jsunit</code> for an example. It
98 contains a copy of JsUnit version 2.2alpha11, with the file
99 <code>jsunit/app/main-data.html</code> slightly modified to add a button
100 which launches JSCoverage. It also contains a simple unit test file <code>test.html</code>. You
101 can instrument this example as follows:
102 </p>
103
104 <pre>
105 jscoverage --no-instrument=jsunit doc/example-jsunit doc/instrumented-jsunit
106 </pre>
107
108 <p>
109 You can then run the <code>test.html</code> file in JsUnit's <code>jsunit/testRunner.html</code>.
110 The simplest way to do this is probably to copy the contents of <code>doc/instrumented-jsunit</code>
111 to the root of a web server and then access the URL
112 </p>
113
114 <pre>
115 http://127.0.0.1/jsunit/testRunner.html?testPage=http://127.0.0.1/test.html&amp;autoRun=true
116 </pre>
117
118 <p>
119 After the test suite has been run, click on the "Coverage report" button
120 to get a coverage report.
121 </p>
122
123 </div>
124 </div>
125 <div id="jscoverage-sidebar" class="yui-b">
126 <ul>
127 <li><a href="./">Home</a>
128 <li><a href="news.html">News</a> <a href="http://siliconforks.com/jscoverage/news.xml" type="application/rss+xml" title="RSS feed for JSCoverage"><img src="feed-icon-14x14.png" alt="RSS feed"></a>
129 <li><a href="manual.html">Documentation</a>
130 <li><a href="demo.html">Demo</a>
131 <li><a href="http://siliconforks.com/jscoverage/download.html">Download</a>
132 <li>FAQ
133 <li><a href="help.html">Help</a>
134 <li><a href="license.html">License</a>
135 <li><a href="links.html">Links</a>
136 </ul>
137 </div>
138 </div>
139 <div id="ft">
140 <address>
141 Copyright &copy; 2007, 2008 <a href="http://siliconforks.com/"><img src="siliconforks-16x16.png" width="16" height="16" class="icon" alt="Silicon Forks"></a> <a href="http://siliconforks.com/">siliconforks.com</a><br>
142 Last updated June 18, 2008<br>
143 <a href="mailto:jscoverage@siliconforks.com">jscoverage@siliconforks.com</a>
144 </address>
145 </div>
146 </div>
147 </body>
148 </html>

  ViewVC Help
Powered by ViewVC 1.1.24