Microsoft Script Debugger Release Notes

© Microsoft Corporation, 1997

This document provides information about using the Microsoft Script Debugger, including tips for installing and using the debugger successfully, notes about features that are not completely implemented, and descriptions of known problems.

Important  Look for a more recent version of this information in the file Readme.htm, which is installed in the folder where the Microsoft Script Debugger (Msscrdbg.exe) is located.

Contents

Installing and Starting the Script Debugger

Using the correct version  Microsoft Script Debugger works with Microsoft Internet Explorer 4.0 or with Internet Information Server 4.0. Because the Script Debugger is designed to be generic across script hosts, Setup does not check for specific versions of products being installed, so you must ensure that you are running the correct versions of these products. If you attempt to use the Script Debugger with earlier versions of Internet Explorer (such as Internet Explorer 3.0 or the Platform Preview release of Internet Explorer 4.0), or with earlier versions of Internet Information Server, the debugger will not work and could disrupt IIS service.

Uninstalling previous versions of the Script Debugger   If you installed the Script Debugger for Internet Explorer 3.0, you must uninstall that version before proceeding with this installation.

Using IE4 in browser-only mode  You can install Internet Explorer 4.0 either as a stand-alone browser or an integrated suite with shell updates and the Active Desktop. Although you can use it in either mode, it is highly recommended that you run the Script Debugger in browser-only mode for debugging.

Choosing an installation directory name  If you change the default directory for the Script Debugger while installing it, make sure that target directory does not contain a single quotation mark. If it does, the debugger might operate unreliably.

Uninstalling IIS  If you uninstall Internet Information Server 4.0, the uninstall process will also remove the Script Debugger, even if you installed the Script Debugger separately. You can reinstall the Script Debugger by running the IIS installation and choosing to install just the Script Debugger.

Running multiple instances  If you use more than one instance of Script Debugger at a time, unexpected results can occur. It is recommended that you run only one instance of the Script Debugger at a time.

Requesting documents that contain syntax errors  If you request a page that contains invalid syntax, and then start the Script Debugger by choosing Yes in response to the resulting error message, the Script Debugger might hang or generate a General Protection Fault.

Viewing Debugger Documentation

Starting a browser before displaying Help  Help is displayed in the default Web browser. If you are running Internet Information Server, start Internet Explorer 4.0 before choosing Help Topics from the Help menu. If the browser is not already running when you display Help, the debugger might display a blank window, and the Script Debugger might hang.

Viewing Help if no browser is installed on the server  If you are debugging on a server that has no browser installed, you might not be able to view Help, because Help is displayed in the default browser. However, if you have permission to access the Web server as a file server, you can try using a browser on another machine to view the Help file. Look for a file on the server called SDbug.htm, and use file protocol (file://), not HTTP protocol (http://).

HTML Source Editor

Entering file names when opening HTML documents  When you choose Open from the File menu to open an existing document in the Script Debugger, you must provide a complete file name, including extension, in the File Name box.

Opening HTML documents from the Desktop in Windows NT  In Windows NT, when you open a file in the Script Debugger using the Open dialog box, you can display documents by selecting Desktop from the Look In list. However, in this version of the debugger, the content of the Open dialog box reflects the desktop setting for the default user, not for the current user.

Script Debugging in Internet Explorer 4.0

Browsing a document after closing the debugger  If you finish a debugging session and close the Script Debugger, and then return to Internet Explorer and continue working with the document you were just debugging, the browser sometimes restarts the debugger.

Working with multiple documents  If you open two documents in two windows in Internet Explorer, you can debug only one of them. For example, if you try to set breakpoints in both documents, the second debugger session is not active. You must close the second session in order to continue debugging in the first.

Entering commands in the Command window  You can display the Command window at any time while the Script Debugger is open, but commands that you type into the Command window have no effect unless you are in break mode (are at a breakpoint or are stepping through code).

Setting breakpoints on invalid lines  If you attempt to set a breakpoint on a line that does not contain script (such as a line of HTML code) the Script Debugger sets the breakpoint on the next valid code statement, even if that statement is many lines away from where you tried to set the breakpoint.

Displaying the line indicator correctly  The Script Debugger might not display the current line indicator properly in the following instances:

• If you are stepping through inline JScript code.
• If the document you are debugging is displayed in a frame.
• If you call a function from the Command window that contains a breakpoint.
• If you are debugging a document, move to a new document in the browser, and then use the browser's Back button to return to the document you were debugging. In this case a second instance of the debugger is opened, but the current line is not indicated.

Note  If the line indicator is not properly displayed, you can try stepping into the next line, which can restore the indicator.

Features not fully implemented  The following features are not fully implemented in this version of the Script Debugger:

• Viewing variable values  To see the value of a variable, use the Command window. The Script Debugger does not include a Watch window, as in some other debuggers. For more details, see the Script Debugger documentation.
• Setting breakpoints by clicking  To set a breakpoint, choose Toggle Breakpoint from the Debug menu, or press F9. You cannot set a breakpoint on a line by clicking in the margin to the left of the line, as you can in some environments.

Known issues when debugging client scripts  The following are additional known issues with using this version of the Script Debugger in Internet Explorer 4.0:

• If you are debugging a document, return to it and then refresh it, continue debugging it, refresh it again, and repeat this process, you might see an assertion error which causes the Script Debugger and Internet Explorer to hang.
• If you minimize a child window in the debugger, such as the Command window or Running Documents window, the Restore command on the Control menu is unavailable. To restore the minimized child window, maximize it, and then resize it by dragging its corners.

Script Debugging in Internet Information Server 4.0

Seeing a blank document when debugging  Occasionally the Script Debugger displays what appears to be a blank document. If the debugger was invoked in response to an error, you might be able to view the document by running it (press F5). You can also try closing the document in the debugger, and then re-opening it from the Running Documents window. If neither of these strategies works, however, you might have to close the debugger, and then stop and restart the IIS service.

Inspecting variables after a runtime error  If you invoke the debugger after a runtime error, the Command window cannot be used to inspect the variables values in an ASP page. However, you can still evaluate expressions using the default language.

Debugging after IIS has been shut down  If you shut down Internet Information Server while a debugging session is running, and then attempt to continue debugging, the Script Debugger will generate a General Protection Fault.

Known issues when debugging server scripts  The following are additional known issues with using this version of the Script Debugger in Internet Information Server:

Debugging Java

Debugging Java  This release of the Script Debugger includes only limited support for debugging Java code. You cannot debug Java code on Internet Information Server. Debugging Java code on Internet Explorer 4.0 can result in unexpected errors.