--- trunk/doc/manual.html 2009/10/04 05:35:23 474 +++ trunk/doc/manual.html 2009/12/27 18:30:02 497 @@ -194,8 +194,7 @@

The "Browser" tab contains an <iframe>, which is initially empty. -You can load a page into this frame by -entering its URL into the "URL" input field. +You can load a URL into this frame by entering it into the "URL" input field and clicking the "Open in frame" button. You can load any page located in DESTINATION-DIRECTORY/ or a subdirectory underneath DESTINATION-DIRECTORY/; loading a page from outside DESTINATION-DIRECTORY/, or from a foreign web @@ -254,17 +253,33 @@ Reloading jscoverage.html resets all code coverage statistics to zero.

-

Inverted mode

+

Window mode

-In some situations it may be difficult to execute your code within the +In some situations it may be difficult to execute your code within the <iframe> in the JSCoverage "Browser" tab. For example, the code may assume that it is running in the top-level browser window, generating errors if it is executed from within a -frame. JSCoverage has an alternative mode of operation, called inverted +frame. JSCoverage has an alternative mode of operation, called window mode, which may be useful in this case.

+To use JSCoverage in window mode, load your URL by clicking the "Open in window" +button instead of the "Open in frame" button. This will cause your URL to be +opened in a new window. (Depending on your browser settings, it may be opened in +a new browser tab instead.) Execute your code in this new window, and +then return to the jscoverage.html window and click the "Summary" +tab to get code coverage statistics. +

+ +

Inverted mode

+ +

+There is another alternative mode of operation, called inverted +mode. Like window mode, this allows you to avoid running your code inside an <iframe>. +

+ +

Normally you load jscoverage.html in your web browser, and in its "Browser" tab you launch your test code. In inverted mode, you do the opposite: you load your test page directly in your web browser, and from there @@ -369,14 +384,16 @@ When accessing jscoverage.html in a web browser, you may provide a query string consisting of options separated by ampersand (&) or semicolon (;). Any option not containing an equals sign -(=) is considered to be a URL which will be loaded in the "Browser" -tab. +(=) is considered to be a URL which will be loaded in the +<iframe> within the "Browser" tab.

-
u=URL, url=URL -
Load URL in the "Browser" tab. (This is the same as specifying +
u=URL, url=URL, frame=URL, f=URL +
Load URL in the <iframe> within the "Browser" tab. (This is the same as specifying an option without an equals sign.) +
w=URL, window=URL +
Load URL in a new window (window mode).
m=BOOLEAN, missing=BOOLEAN
Determines whether to initially display the "Missing" column in the "Summary" tab. BOOLEAN can be