PROXY

From iMacros
Jump to: navigation, search

Connect to a proxy server to run the current macro. The iMacros Browser then connects to the Internet through a proxy server by using the settings you specify. You can define a specific proxy server for each macro. Each running instance of the iMacros Browser can have its own proxy server. The proxy setting remains in effect until you specify a different proxy or restart the browser.

If you have proxy server settings defined in the Internet Explorer settings then you will not need to use a PROXY command since iMacros automatically applies the Internet Explorer settings.

Syntax iMacros Browser IE Plug-in Firefox Chrome

PROXY ADDRESS=proxy_URL:port [BYPASS=page_name]

Parameters

  • ADDRESS
    The URL and port of the proxy server. You can define separate proxy servers for http and https connections (see the example below).
  • BYPASS
    The URLs for which the Proxy server is not to be used. If you want to connect to a computer on your intranet make sure you include its address here (see the example below). If no BYPASS is specified then the default setting is used, which means no proxy server is used for local addresses inside your network. In Internet Explorer, you may use the wildcard *.
The iMacros PROXY command overwrites the default IE Proxy settings, which are used in IE and the iMacros Browser.
  • Firefox: There are three differences compared to the iMacros/IE syntax:
    • The setting is profile-wide, so if you have two macros running on one Firefox profile simultaneously then both of them will be affected by PROXY command in one macro. If you need to run Firefox instances with a different proxy server for each one, use the iimInit ("-fx -fxProfile <name>") method to launch each instance with its own profile.
    • Double "http=.. https=.." parameter in ADDRESS is not possible, however it is possible to use two subsequent PROXY commands. One for http and one https.
    • In Firefox, the wildcard is not supported and required for the bypass settings. Example: In IE you use *.imacros.net and in Firefox simply ".imacros.net",

Examples

The following command uses a local proxy server for both http and https at the address 192.1.8.1 and the port number 8080. Since no bypass is specified the default settings are used.

PROXY ADDRESS=192.1.8.1:8080  

This command specifies two different proxy server for the http and https protocol. Defines no bypass so iMacros uses these proxy servers even for local addresses.

PROXY ADDRESS=http=192.1.8.1:8080<SP>https=192.1.8.2:8080 BYPASS=NULL 

To use a proxy server at address 66.98.229.110, but not for URLs including the word "imacros" use

PROXY ADDRESS=66.98.229.110:8080 BYPASS=*imacros* 

You can also use the same command, but with URL instead of IP address.

PROXY ADDRESS=imacros.net:8080 BYPASS=*imacros*

To enter a list of addresses to bypass, enter one after each other separated by a blank space.

PROXY ADDRESS=127.0.0.1:3128 BYPASS= *google* *youtube*

Test Proxy

Do you need a local proxy to test iMacros? Or want to use iMacros with a local proxy to debug your website? We recommend the Fiddler tool. It is a Web Debugging Proxy which logs all HTTP(S) traffic between your computer and the Internet - and it can be set to work as local proxy (port 8888 is default).

  PROXY ADDRESS=127.0.0.1:8888 

=> Redirects all traffic to flow through Fiddler. The PROXY command is not a global setting, so only the macro with the PROXY command is affected.

See Also