SetIEMode command: Difference between revisions
No edit summary |
No edit summary |
||
(One intermediate revision by the same user not shown) | |||
Line 2: | Line 2: | ||
{| | {| | ||
|width=" | |width="125px"| '''Action:''' | ||
|width=" | |width="775px"| | ||
<span class="f_Para">Controls whether, and the host URLs for which, the Debugger will serve as the </span><span class="f_ListBul1">[[ | <span class="f_Para">Controls whether, and the host URLs for which, the Debugger will serve as the </span><span class="f_ListBul1">[[Configure web browser (Janus Debugger only)|proxy server]]</span><span class="f_Para"> for users of the Internet Explorer or Chrome browser. The command has options to set or remove the setting of the Client as the proxy server for IE or Chrome browser requests. The command also has an option to create a [[Configure web browser (Janus Debugger only)#Using the Client as proxy exclusively for designated addresses|PAC (Proxy Auto Config) file]], which restricts the host URLs for which the Client will act as proxy server, and an option to merge such a PAC file with a preexisting PAC file, if any. </span> | ||
'''Syntax:''' | '''Syntax:''' | ||
Line 12: | Line 12: | ||
*<span class="f_Monospace">none</span><span class="f_ListBul1"> </span> | *<span class="f_Monospace">none</span><span class="f_ListBul1"> </span> | ||
**<span class="f_ListContinue">Makes no changes to the [[ | **<span class="f_ListContinue">Makes no changes to the [[Configure web browser (Janus Debugger only)#Navigating to and within the Internet Properties dialog box|Internet Properties tool]], which contains configuration settings for Internet Explorer and Chrome browsers, and undoes any such setting changes made since the </span><span class="f_ListBul1">Debugger Client</span><span class="f_ListContinue"> was started. </span> | ||
: <span class="f_ListContinue">This option also undoes the effects of any other </span><span class="f_Monospace">setIEMode</span><span class="f_ListContinue"> commands issued since the Client was started. </span> | : <span class="f_ListContinue">This option also undoes the effects of any other </span><span class="f_Monospace">setIEMode</span><span class="f_ListContinue"> commands issued since the Client was started. </span> | ||
*<span class="f_Monospace">proxy</span><span class="f_ListBul1"> </span> | *<span class="f_Monospace">proxy</span><span class="f_ListBul1"> </span> | ||
**<span class="f_ListContinue">Makes the Debugger Client the proxy server for Internet Explorer and Chrome</span><span class="f_EmphItal">.</span><span class="f_ListContinue"> This is the same as setting the </span>< | **<span class="f_ListContinue">Makes the Debugger Client the proxy server for Internet Explorer and Chrome</span><span class="f_EmphItal">.</span><span class="f_ListContinue"> This is the same as setting the </span><var>Preferences</var><span class="f_ListContinue"> dialog box equivalent, the</span><var> proxy </var><span class="f_ListContinue">option</span><span class="f_GUIlabel"> </span><span class="f_ListContinue">for </span><var>IE Mode.</var><span class="f_ListContinue"> </span> | ||
*<span class="f_Monospace">newPac</span><span class="f_ListBul1"> </span> | *<span class="f_Monospace">newPac</span><span class="f_ListBul1"> </span> | ||
**<span class="f_ListContinue">Generates a PAC file using the [[ | **<span class="f_ListContinue">Generates a PAC file using the [[Customize debuggerConfig file#Basic configuration steps |hosts and ports specified]] in the Debugger configuration file (</span><span class="f_Monospace">debuggerConfig.xml</span><span class="f_ListContinue">) settings, and sets IE and Chrome to use it. Any existing PAC file (that is, specified in the [[Configure web browser (Janus Debugger only)#Navigating to and within the Internet Properties dialog box|Internet Properties tool]]) is </span><span class="f_EmphItal">not</span><span class="f_ListContinue"> used. </span> | ||
*<span class="f_Monospace">mergedPac</span><span class="f_ListBul1"> </span> | *<span class="f_Monospace">mergedPac</span><span class="f_ListBul1"> </span> | ||
Line 26: | Line 26: | ||
*<span class="f_Monospace">file</span><span class="f_ListBul1"> or </span><span class="f_Monospace">http</span> | *<span class="f_Monospace">file</span><span class="f_ListBul1"> or </span><span class="f_Monospace">http</span> | ||
**<span class="f_ListContinue">If you are using </span><span class="f_Monospace">newPac</span><span class="f_ListContinue"> or </span><span class="f_Monospace">mergedPac</span><span class="f_ListContinue"> to produce a PAC, specifying </span><span class="f_Monospace">file</span><span class="f_ListContinue"> or </span><span class="f_Monospace">http</span><span class="f_ListContinue"> sets the type of the URL that is sent to the browser. </span><span class="f_Monospace">file</span><span class="f_ListContinue"> is the default. </span><span class="f_ListContinue">To take advantage of an </span><span class="f_Monospace">http</span><span class="f_ListContinue"> setting, you must also [[ | **<span class="f_ListContinue">If you are using </span><span class="f_Monospace">newPac</span><span class="f_ListContinue"> or </span><span class="f_Monospace">mergedPac</span><span class="f_ListContinue"> to produce a PAC, specifying </span><span class="f_Monospace">file</span><span class="f_ListContinue"> or </span><span class="f_Monospace">http</span><span class="f_ListContinue"> sets the type of the URL that is sent to the browser. </span><span class="f_Monospace">file</span><span class="f_ListContinue"> is the default. </span><span class="f_ListContinue">To take advantage of an </span><span class="f_Monospace">http</span><span class="f_ListContinue"> setting, you must also [[Configure web browser (Janus Debugger only)#Setting up an HTTP server for PAC files|configure an HTTP server]] to service the PAC file. </span> | ||
<span class="f_Para">For parameter options that modify the </span>< | <span class="f_Para">For parameter options that modify the </span><var>Internet Properties</var><span class="f_Para"> configuration, no restart of the browser is necessary, and the Debugger provides automatic maintenance (makes the </span><var>Internet Properties</var><span class="f_Para"> modifications at Client startup, then removes them when the Client closes). </span> | ||
'''Example:''' | '''Example:''' | ||
<span class="f_Para">If you issue the following command, the Debugger Client immediately generates a merged PAC file and configures the browser to run it; then at Client shutdown, the command restores the </span>< | <span class="f_Para">If you issue the following command, the Debugger Client immediately generates a merged PAC file and configures the browser to run it; then at Client shutdown, the command restores the </span><var>Internet Properties</var><span class="f_Para"> initial settings: </span> | ||
<p class="syntax"> setIEMode mergedPac </p> | <p class="syntax"> setIEMode mergedPac </p> | ||
<span class="f_Para">Once the above command is issued, the browser runs the script each time a URL is requested, and the Debugger Client serves as proxy only for the hosts specified in the script. The merged PAC file specification will persist through Client closes and starts until you use </span><span class="f_Monospace">setIEMode</span><span class="f_Para"> or the </span>< | <span class="f_Para">Once the above command is issued, the browser runs the script each time a URL is requested, and the Debugger Client serves as proxy only for the hosts specified in the script. The merged PAC file specification will persist through Client closes and starts until you use </span><span class="f_Monospace">setIEMode</span><span class="f_Para"> or the </span><var>Preferences</var><span class="f_Para"> dialog box to change or remove it. </span> | ||
<span class="f_Para">See also: </span> | <span class="f_Para">See also: </span> |
Latest revision as of 18:38, 9 February 2023
Action: |
Controls whether, and the host URLs for which, the Debugger will serve as the proxy server for users of the Internet Explorer or Chrome browser. The command has options to set or remove the setting of the Client as the proxy server for IE or Chrome browser requests. The command also has an option to create a PAC (Proxy Auto Config) file, which restricts the host URLs for which the Client will act as proxy server, and an option to merge such a PAC file with a preexisting PAC file, if any. Syntax: setIEMode {none|proxy|newPac|mergedPac} [file|http] Where:
For parameter options that modify the Internet Properties configuration, no restart of the browser is necessary, and the Debugger provides automatic maintenance (makes the Internet Properties modifications at Client startup, then removes them when the Client closes). Example: If you issue the following command, the Debugger Client immediately generates a merged PAC file and configures the browser to run it; then at Client shutdown, the command restores the Internet Properties initial settings: setIEMode mergedPac Once the above command is issued, the browser runs the script each time a URL is requested, and the Debugger Client serves as proxy only for the hosts specified in the script. The merged PAC file specification will persist through Client closes and starts until you use setIEMode or the Preferences dialog box to change or remove it. See also:
|
Client menu: | -- |
Introduced: | Build 62 |