Difference between revisions of "iMacros for Firefox"

From iMacros
Jump to: navigation, search
(Version History)
(Version History)
 
(34 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This page documents features that are unique to iMacros for ''Firefox''. For the standard features of the iMacros series, please see the [[Form Filling]], [[Browser Automation]], [[Data Extraction]] and [[Web Testing]] chapters.  
+
==Scope==
 +
iMacros for Firefox (version 10 and above) is one of the [[Webextensions|iMacros Webextensions]]. A detailed documentation of features and limitations is found in that page. Here we document the few differences to that common page.
 +
 
 +
For the legacy versions (9 and below) refer to [[iMacros for Firefox Legacy]].
  
 
== License ==
 
== License ==
[http://wiki.imacros.net/EULA_Freeware iMacros for Firefox End User License Agreement]
+
[[EULA|iMacros End User License Agreement]]
  
 
== Installation ==
 
== Installation ==
  
[[Image:Ff-icon.png|Firefox]] Download from [https://addons.mozilla.org/en-US/firefox/addon/imacros-for-firefox/ iMacros @ Mozilla Addons]  
+
[[Image:Ff-icon.png|Firefox]] Download from [https://addons.mozilla.org/en-US/firefox/addon/imacros-for-firefox/ iMacros @ Mozilla Addons]  
  
No administrative rights are required for the installation. Win, Mac and Linux are supported.
+
==Downloading Files==
  
==Bookmarking ==
+
If you have iMacro File Access installed you can use the [[ONDOWNLOAD]] command to automate the download of files in Firefox. If the File Access is not installed, the [[ONDOWNLOAD]] parameters are ignored but the file is downloaded with its default file name, to Firefox default downloads folder. However, by default, Firefox will prompt you to choose between saving or opening a file upon download. iMacros cannot handle this prompt and will only be able to download the file if Firefox default action for this file type is ''Save File''.
You can '''use iMacros as super-bookmarks''': To open the bookmark dialog right-click on the macro that you want to bookmark and select the "local" option. This option adds a link to the macro ''on your computer'' to your bookmarks.
+
[[File:FirefoxPreferencesApplications.png|400px|thumb|center|In order to have the download handled by iMacros, the action in Firefox preferences has to be set as ''Save File''. See [https://support.mozilla.org/en-US/kb/change-firefox-behavior-when-open-file|'''Change what Firefox does when you click on or download a file''']]]
  
[[Image:Run-right-click.png|left|thumb|250px|(1) Right-click the macro you want to bookmark]]
+
If the file type you are downloading is not listed under ''Content Type'', you will have to edit Firefox ''handlers.js'' file manually. In the example below we included .exe and .msi in handlers.json, using "action":0 for save.
 +
{
 +
    "defaultHandlersVersion": {
 +
        "en-GB": 4
 +
    },
 +
    "mimeTypes": {
 +
        "application/pdf": {
 +
            "action": 3,
 +
            "extensions": [
 +
                "pdf"
 +
            ]
 +
        },
 +
        "application/x-7z-compressed": {
 +
            "action": 0,
 +
            "extensions": [
 +
                "7z"
 +
            ]
 +
        },
 +
        "application/x-msi": {
 +
            "action": 0,
 +
            "extensions": [
 +
                "msi"
 +
            ]
 +
        },
 +
        "application/x-executable": {
 +
            "action": 0,
 +
            "extensions": [
 +
                "exe"
 +
            ]
 +
        }
 +
    },
 +
    "schemes":{...
 +
    }
 +
}
  
[[Image:Run-bookmark-local.png|left|thumb|400px| (2) Select the '''''Local''''' option for "normal" bookmarks]]
+
To locate the handlers.json file, type in Firefox navigation bar "about:support" and under General Information/Profile Folder you can click on the button Open Folder.
  
[[Image:Firefox-bookmarks.png|left|thumb|300px| (3a) A link (reference) to your macro is added to the Firefox bookmark menu. iMacros opens automatically if you select an iMacros super-bookmark.]]
+
==Clearing Cookies and Cache==
  
[[Image:Firefox bookmarks toolbar.png|left|thumb|300px| (3b) You can place your most-used macros on the Bookmarks Toolbar.]]
+
When you clear the browser history in Firefox, iMacros stored data is also removed. Thus all your iMacros preferences are lost. iMacros will work again, but you preferences will be reset to their defaults. This also happens if you set Firefox to ''Clear history when Firefox closes'' in about:preferences#privacy.
  
<br style="clear:both" />
+
The [[CLEAR]] command, on the other hand, does not delete iMacros data, while clearing cache and cookies. It also accepts an argument to filter the cookies to be cleared by domain name. Using CLEAR with no argument clears all cookies and cache. Using e.g.  
 
+
CLEAR facebook.com  
If you run a bookmarked macro and the iMacros sidebar is not open, the sidebar will open to run the macro and close again after the macro is complected. If the sidebar was visible before the macro is started, it will remain visible after the macro is completed.
+
will clear all of the cache, but only cookies from Facebook. If you only want to clear the cache, then specify a nonexistent domain name
 
+
CLEAR xxx.yyy.zzz
For experts: The bookmarked URL has the format:
+
imacros://run/?m=my_saved_macro.iim
+
iMacros intercepts this URL and runs the local macro file instead. If the macro is inside subfolder(s), please use this format (%5C stands for /):
+
imacros://run/?m=subfolder1%5subfolder2%5Cmy_saved_macro.iim
+
 
+
== Videos ==
+
 
+
User created iMacros tutorials:
+
 
+
{{#ev:youtube|6CkVGmuP8pM}}
+
 
+
 
+
 
+
{{#ev:youtube|OOpj9vT6858}}
+
 
+
 
+
Know other good tutorials or screencasts? Please let us know at support@iopus.com!
+
 
+
== Keyboard Shortcuts ==
+
 
+
Press the '''F8''' function key to open and close the iMacros sidebar. If required, you can change this shortcut with another [http://forum.iopus.com/viewtopic.php?f=11&t=9272&p=27882#p27882 Firefox extension].
+
 
+
==Bookmarklets==
+
The iMacros bookmark dialog gives you the option to '''embed your macros directly into a link (bookmarklet)''' and share it with others. Note: You can only create bookmarklets from macro (.iim) files and not Javascript (.js) files.
+
 
+
'''Important:''' If you want to add the embedded macro as a link on an HTML page, make sure it is url-encoded using e.g. [http://meyerweb.com/eric/tools/dencoder/ this tool].
+
 
+
See the following forum posts for more details.
+
* [http://forum.iopus.com/viewtopic.php?t=3201 A guide to sharing macros via bookmarklets]
+
* [http://forum.iopus.com/viewtopic.php?f=11&t=21823&p=55027#p55027 Running Remote Script from URL]
+
* [http://del.icio.us/imacros/imacro Shared Sample Macros on del.icio.us]
+
* [http://forum.iopus.com/viewtopic.php?t=3604 Create scripts on the fly (for experts)]
+
* [http://forum.iopus.com/viewtopic.php?t=10692 Calling iMacros bookmarks with a shortcut]
+
[[Image:imacros-social-scripting.png|left|thumb|400px|iMacros offers several options to share your macros and scripts]]
+
<br style="clear:both" />
+
 
+
Since iMacros for Firefox V6.5 the [[iMacros_for_Chrome#iMacros_as_Bookmarklets|bookmarklet format]] introduced with [[iMacros for Chrome]] is also supported in Firefox.
+
 
+
==Password Security==
+
iMacros allows you to [[Password Security|store passwords using secure 256-bit AES encryption]]. In addition, iMacros for Firefox '''integrates directly with the [[Firefox Password Manager]]''' and uses it to store the master password (if you decide to store it).
+
 
+
==Command Line Support==
+
You can start imacros (or Javascript scripts) inside of Firefox via the command line:
+
 
+
  "C:\Program Files (x86)\Mozilla Firefox\firefox.exe"  imacros://run/?m=...
+
 
+
or
+
 
+
  "C:\Program Files (x86)\Mozilla Firefox\firefox.exe"  imacros://run/?code=...
+
 
+
for instance:
+
 
+
  "C:\Program Files (x86)\Mozilla Firefox\firefox.exe"  imacros://run/?m=Demo-FillForm.iim
+
 
+
 
+
'''Note:'''
+
When you first start Firefox via the command line the iMacros extension is not immediately active . It takes a few seconds for Firefox to activate it. So the imacros://run/ command does get intercepted already but not yet processed by iMacros and a blank page appears.
+
 
+
'''Solution:'''
+
''Make sure that Firefox is already running.'' If you start Firefox a second time, Firefox will direct this new command automatically to the already running instance. Now iMacros can "see" the imacros://run/ URL and start the macro.
+
 
+
You can use a batch file like this:
+
 
+
Code:
+
  start "" "C:\Program Files\Mozilla Firefox\firefox.exe"  http://www.google.com
+
  ping 127.1.1.1 (or pause or sleep ... it is just to cause a small delay)
+
  start "" "C:\Program Files\Mozilla Firefox\firefox.exe"  imacros://run/?m=Demo-FillForm.iim
+
 
+
Note: If you use the batch '''start''' command, [http://forum.iopus.com/viewtopic.php?f=8&t=6487 Firefox must be the default browser].
+
 
+
'''For Mac OS X users:''' to start a macro from the OS X command line or as a scheduled job, you can use the following command syntax:
+
 
+
/Applications/Firefox.app/Contents/MacOS/firefox-bin imacros://run/?m=Demo-FillForm.iim
+
 
+
''More information:'' Our users created several useful forum posts about the command line feature:
+
* [http://forum.iopus.com/viewtopic.php?t=3343 Automating task each day]
+
* [http://forum.iopus.com/viewtopic.php?t=3355 Problem with starting imacros]
+
* [http://forum.iopus.com/viewtopic.php?t=3647 Starting a script from DOS cmd line?]
+
* [http://forum.iopus.com/viewtopic.php?f=11&t=4888 Batch File: Load Firefox, Run Macro(s), Close]
+
* [http://forum.iopus.com/viewtopic.php?f=11&t=21475&p=53936#p53938 Firefox issues and blank pages]
+
* [http://www.slideshare.net/beeshields/automation-201 Schedule macros with the "My Weekly Browsing Schedule" add-on (slides 30-31)]
+
 
+
''Alternative solution:'' If you need more control over Firefox you can use the [[Web Scripting|iMacros Scripting Interface]] that comes with the [http://www.iopus.com/imacros/compare/all/ iMacros Enterprise Edition]. This method gives you complete control over Firefox and Internet Explorer. For example, you can return error codes or extracted data from the browser to your program or script.
+
 
+
==Javascript Scripting Interface==
+
 
+
Automate complex tasks: iMacros [[Command Reference|commands]] refer to web page elements, so any programming logic must be put into a script that then uses iMacros to automate the website. For this purpose iMacros for Firefox contains a '''built-in Javascript Scripting Interface''', which runs directly inside the browser. Just like Firefox this interface is cross-platform (Win, Mac, Linux).
+
 
+
The following information focuses on this built-in Javascript Scripting Interface.
+
 
+
Supported commands:
+
* [[iimDisplay]]
+
* [[iimSet]]
+
* [[iimPlay]]
+
* [[iimPlayCode]]
+
* [[iimGetExtract]]
+
* [[iimGetErrorText]]
+
* [[iimClose]] is not supported, but you can [http://forum.iopus.com/viewtopic.php?t=4389 use window.close()] inside of Firefox
+
 
+
Note that the syntax of the regular, commercial Windows [[Web Scripting]] Interface and the built-in Firefox Javascript Scripting Interface is identical (unless where explicitly noted). Therefore they use the same documentation.
+
 
+
[[Image:Javascript display speed.png|frame|By default each Javascript step is shown during replay. This option is useful for testing and debugging, but it slows down the Javascript execution artificially. To run Javascript at its normal (very fast) speed please uncheck this option.]]
+
 
+
[[Image:Javascript showsteps.png|frame|Javascript code running inside iMacros. The the '''//imacros-js:showsteps yes/no''' comment at the top of your Javascript file (including the //) overrides the global setting of "Show Javascript" checkbox in the option dialog.]]
+
 
+
 
+
[[Image:Javascript_examples.png|frame|left]]'''Examples:''' iMacros for Firefox automatically installs the SI-Run-Test.js, SI-Get-Exchange-Rate.js, [[Self-Test.js]] and [http://run.imacros.net/?code=DQp2YXIgTXlNYWNyb0NvZGUNCnZhciBqc05ld0xpbmU9IlxuIg0KTXlNYWNyb0NvZGUgPSAiQ09ERToiDQpNeU1hY3JvQ29kZSA9IE15TWFjcm9Db2RlKyJWRVJTSU9OIEJVSUxEPTUyMDA4MTQiICsganNOZXdMaW5lDQpNeU1hY3JvQ29kZSA9IE15TWFjcm9Db2RlKyJUQUIgVD0xIiArIGpzTmV3TGluZSAgICANCk15TWFjcm9Db2RlID0gTXlNYWNyb0NvZGUrIlRBQiBDTE9TRUFMTE9USEVSUyIgKyBqc05ld0xpbmUgIA0KTXlNYWNyb0NvZGUgPSBNeU1hY3JvQ29kZSsiVVJMIEdPVE89aHR0cDovL3d3dy5pb3B1cy5jb20iICsganNOZXdMaW5lDQpNeU1hY3JvQ29kZSA9IE15TWFjcm9Db2RlKyJVUkwgR09UTz1odHRwOi8vZm9ydW0uaW9wdXMuY29tIg0KDQppaW1EaXNwbGF5KCJTdGFydCBkZW1vIikNCmlpbVBsYXkoTXlNYWNyb0NvZGUpDQppaW1QbGF5KCJDT0RFOlVSTCBHT1RPPWh0dHA6Ly93d3cuaW9wdXMuY29tL2ltYWNyb3MvaXJwIikNCmlpbURpc3BsYXkoIlNjcmlwdCBjb21wbGV0ZWQuIikNCi8vaWltRXhpdCgpDQo%3D SI-Send-Macro-Code.js] ([[SI-Send-Macro-Code.js|View Script Source Code]]) example javascripts.
+
 
+
'''Important:''' iMacros macros must have the '''".iim"''' file extension and Javascript scripts must have the '''".js"''' file extension.
+
 
+
 
+
Note: Firefox can be ''remote'' controlled by the regular [[Web Scripting|iMacros Scripting Interface]] via [[iimInit]] ("-fx"). The Javascript Scripting Interface does not include [[iimInit]] and [[iimExit]], because they are not required. The Javascript runs ''inside'' the browser. The regular iMacros Scripting Interface is''' now available for [[Linux]]'''. It allows you to remote control Firefox [[iMacros for Chrome| and Chrome]] via Python.
+
 
+
===Running multiple iMacros js scripts simultaneously===
+
If you need to run more than one js script in iMacros for Firefox at the same time, you have to use a different [http://support.mozilla.org/en-US/kb/profile-manager-create-and-remove-firefox-profiles Firefox profile] for each script and make sure [http://kb.mozillazine.org/Opening_a_new_instance_of_Firefox_with_another_profile each opens as a different process].
+
 
+
===Interesting forum posts about the Javascript interface===
+
* [http://forum.iopus.com/viewtopic.php?f=11&t=5267 Read and write data from and to a file]
+
* [http://forum.iopus.com/viewtopic.php?f=11&t=4971 Output data to a file]
+
* [http://forum.iopus.com/viewtopic.php?f=2&t=5663 Different options to read input data from a CSV file]
+
* [http://forum.iopus.com/viewtopic.php?f=8&t=13614&p=40996#p40996 How to access the DOM from iMacros Javascript]
+
  
 
==Scripting Firefox==
 
==Scripting Firefox==
Mozilla Firefox, the complete browser, can be scripted with the commercial iMacros Enterprise Edition (= [[Web Scripting|iMacros Scripting API]]). So while the free  Java scripting runs '''inside''' Firefox, the API  allows you to control Firefox from [[Sample Code|external software (C++, C#, Python, Perl,...)]]. For details, see the chapter with the [[iimOpen|iimOpen command]].
 
  
==Automatic Updates==
+
Due to the WebExtensions framework adopted by Mozilla and released with Firefox 56 (a.k.a. Quantum), iMacros for Firefox 10 no longer includes the built-in Javascript scripting interface for playing .js files directly from the iMacros sidebar. However, as mentioned in [[Webextensions#Scripting_Chrome_and_Firefox|Scripting Chrome and Firefox]], you can still control iMacros for Firefox via external scripts and programs.
  
By default Firefox will attempt to keep your add-ons (including iMacros for Firefox) up-to-date. This is a function of the Firefox browser itself and not specifically the iMacros add-on. To prevent iMacros for Firefox from automatically updating, find the entry for iMacros in the list of Extensions using the Firefox Add-ons Manager, then click the "More" link:
+
iMacros for Firefox requires the latest version of the iMacros scripting interface (API) included with the [[Webextensions#Add_File_Access|File Access installer]] under the following scenario:
  
[[File:iMacros_extension.png]]
+
If you use the iMacros Enterprise (v12.0 or older) scripting interface to connect to iMacros for Firefox '''*and*''' specify a non-default Firefox profile using e.g.:
<br><br>
+
Next, scroll to the bottom of the page and turn Automatic Updates off:
+
<br><br>
+
[[File:iMacros-FF_Automatic_Update.png]]
+
  
==Website Monitoring==
+
  iimOpen("-fx -fxProfile MyProfile")
  
[[File:Alertfox_small_logo.png‎]]
+
then you will need to copy and overwrite the following dlls first before this functionality will work with the current version of iMacros for Firefox. This is not required if you are already using a newer version of iMacros Enterprise (newer than v12.0) or if you are not using -fxProfile.
iMacros is ideally suited for web performance monitoring and [http://wiki.alertfox.com/Synthetic_Monitoring synthetic user monitoring].  
+
  
Sometimes this is also called transaction monitoring or real user monitoring. In all these cases it means the ability to test websites '''and their functionality''' with real web browsers as opposed to simple uptime monitoring with "ping" or "http" requests. For this purpose the iMacros team has created the popular AlertFox [http://alertfox.com website monitoring] service. It runs 1000s of iMacros for Firefox instances on the [http://wiki.alertfox.com/Monitoring_Server backend]. Give it a try and sign up for a [http://alertfox.com/free-website-monitoring/?ref=wiki free website monitoring] account. And continuously test and measure your website performance with your iMacros macros.
+
Source folder:  
  
AlertFox is a great and affordable alternative to the old bulls of website monitoring like Keynote, Gomez or Webmetrics.
+
%localappdata%\Programs\iMacros
  
==Portable Firefox==
+
* On 64-bit systems
Mozilla Firefox®, Portable Edition is the popular Mozilla Firefox web browser bundled with a PortableApps.com Launcher as a portable app, so you can take your bookmarks, extensions and saved passwords with you on a USB stick. iMacros is optimized and tested to work well with the Portable Edition. If you plan to use iMacros with the Firefox Portable please ''check "Store data in profile" folder'' on the the PATH tab in the OPTIONS dialog. Then iMacros stores all data inside the Firefox data folder (which typically is on your USB stick) instead of using absolute paths. No data gets lost or moved while switching the folder location.
+
# Copy imtcp.dll to %programfiles(x86)%\Ipswitch\iMacros
 +
# Copy imtcp64.dll to %programfiles%\Ipswitch\iMacros
  
==Languages==
+
* On 32-bit systems
Thanks to the contribution of iMacros for Firefox users around the world, iMacros for Firefox is currently offered in the following locales:
+
# Copy imtcp.dll to %programfiles%\Ipswitch\iMacros
* en-US
+
* ru-RU
+
* de-DE
+
* fr-FR
+
* nl-NL
+
* pl-PL
+
* es-ES
+
* ko-KR
+
* zh-TW
+
* zh-CN
+
* it-IT
+
* pt-BR
+
  
However, most of the above locales are still only partially supported.
+
==Known Issues==
 
+
Current known issues with the latest version of iMacros for Firefox:
When installing, Firefox will load the locale matching the language of Firefox itself.
+
* Docking the iMacros panel (sidebar) can break the ability to drag and drop tabs in Firefox.
 
+
* Search and replace dialog no longer work in the macro editor due to Firefox CSP (Content Security Policy) for Web Extensions.
<!---
+
== iMacros for Firefox Mobile ==
+
 
+
If there is one place where web browsing is more work then fun, then it is on the small screen of your mobile phone. iMacros will help you to automate your logins and form filling on your mobile soon. See [[iMacros for Firefox Mobile|this page]] for more information.
+
 
+
We are currently working on it! It will allow you to replay your bookmarked macros directly on your Android. '''If you want to help us with testing, please email info@iopus.com with "iMacros for Firefox Mobile" in your email subject.'''
+
--->
+
 
+
==Privacy Policy==
+
 
+
'''Our privacy policy is simple: iMacros stores ''everything'' on your PC.''' In other words, ''no'' iMacros information is stored on our website. iMacros is ''not'' an online service. We ''never'' have access to your macros or scripts. This includes the [[iMacros for Firefox#Social_Scripting|social scripting]] feature. Even in this case our servers are ''not'' involved.
+
 
+
Technical background information for those who are interested in how it works:
+
 
+
If you want share you macros ([[iMacros for Firefox#Social_Scripting|social scripting]]) and select the option "Run everywhere: Embed macro in URL" in the bookmark menu then the macro is encoded in the URL (link). This feature is useful if you want to email the URL (= macro) to your friends and coworkers or want to embed the macro in your website or blog. This means visitors of your website or Intranet page can run the macro. Again, no macro information is stored on our website. The URL contains the complete macro (For experts: The macro is [http://forum.iopus.com/viewtopic.php?t=3604 BASE64] encoded).
+
 
+
You can add the iMacros bookmark url with the embedded macro to a social bookmarking service like [http://del.icio.us/imacros/imacro http://del.icio.us/]. Then the information is stored on their website and other users can run your macros. We think this is a very cool feature. But it is your decision to share your scripts, and our website is not involved in this.  
+
 
+
Technically what happens if you call a URL that starts with <nowiki>javascript:(function()...</nowiki> is that iMacros intercepts the URL and executes the macro. That's all and it happens locally ''on your machine''. If no iMacros add-on is installed, then a simple web page is opened that provides the user with a download link to iMacros.
+
 
+
Passwords are stored 256-bit AES encrypted inside the macro files. AES is a very strong encryption that can not be broken. So even if somebody would get a hold of your macros, they will useless to him/her without your master password.
+
 
+
Last but not least, you do not have to take our word for it. iMacros for Firefox is open source, so everybody can view and inspect it.
+
  
 
==Version History==
 
==Version History==
  
''Read what's new:''
+
===Version 10.0.2, released July 9, 2018===
 
+
This is the first version which supports Firefox Quantum (Firefox 57 and above). It is a complete new version for the Firefox Webextension API, which has more similarities with [[iMacros for Chrome]] than [[iMacros for Firefox Legacy|previous versions of iMacros for Firefox]]. In particular, there are some commands, variables, and functionality that were previously supported but currently are not mostly because the WebExtension API provided by Mozilla still lacks support for it.
*'''2016-08-10 V9.0.3 '''  => [http://download.imacros.net/archive/iMacros-Fx/imacros_for_firefox-9.0.3-fx.xpi Download now]
+
** This version is  a '''major upgrade''' to add compatibility with Multi Process Firefox released in Firefox 48 (codename [https://wiki.mozilla.org/Electrolysis Electrolysis], e10s). Unfortunately, this change imposes the following limitations:
+
*** [[SCREENSHOT]] TYPE=BROWSER is no longer possible,
+
*** [[SAVEAS]] TYPE=CPL is not available anymore,
+
*** [[TAG#File_Upload|File Upload]] in the TAG command cannot be supported.
+
*** [[CLICK]] (X/Y) record mode is now deprecated, use [[EVENT]] mode instead. However, existing macros that contain [[CLICK]] commands can be replayed.
+
** The following were never officially supported and had to be removed as well, since Firefox no longer allows access to the page DOM from the browser context (only [https://developer.mozilla.org/en-US/Firefox/Multiprocess_Firefox/Limitations_of_frame_scripts frame scripts] can do so now)
+
*** No access to webpage DOM from javascript in .js files (window, content objects) or macros (URL GOTO=javascript:...),
+
*** imns (iMacros namespace) is no longer accessible.
+
 
+
 
+
----
+
 
+
'''Please note that [http://download.imacros.net/archive/iMacros-Fx/imacros_for_firefox-8.9.7-fx.xpi iMacros version 8.9.7] will work with Firefox 48 if [http://techdows.com/2016/08/firefox-48-e10s-enabled-or-disabled-if-disabled-enable.html multi process (e10s) is disabled.]''' See also [[iMacros_for_Firefox#How_to_Downgrade|How to downgrade iMacros]]
+
 
+
----
+
 
+
 
+
*'''2016-04-22 V8.9.7 '''  => [http://download.imacros.net/archive/iMacros-Fx/imacros_for_firefox-8.9.7-fx.xpi Download now] (To install: Download, and then drag-and-drop the .xpi file onto an open instance of Firefox).
+
** Fixes compatibility with Firefox V46: playback not working.
+
 
+
<!--
+
*'''2016-02-12 V9.0 BETA 2 '''  => [http://download.imacros.net/archive/iMacros-Fx/imacros-9.0.0b2.xpi Download now] (To install: Download, and then drag-and-drop the .xpi file onto an open instance of Firefox).
+
** This version is a '''major upgrade''' to add compatibility with the upcoming "multi-process" version of Firefox (codename [https://wiki.mozilla.org/Electrolysis Electrolysis], e10s). Please report any found issues in the [http://forum.imacros.net/viewforum.php?f=11 iMacros for Firefox Forum] and use '''[V9]''' as part of your subject line. Note that this version also works just fine in the regular, classic Firefox mode. But then, there is no advantage as compared to the current V8.94 production version.
+
**  iMacros is no longer a "legacy add-on" but a modern restartless add-on :-)
+
** Fixes in beta 2:
+
*** iMacros icon is back on the Firefox toolbar and works
+
*** "Scroll to object when found" option works properly
+
** Known issues:
+
*** Download of files with a .exe extension fails with an error "ONDOWNLOAD command was used but no download occurred. Error code - 804"
+
*** iMacros upgrade does not overwrite the demo macros. Workaround: A fresh iMacros install includes the latest version of the demos.
+
** Commands not yet supported (they require Firefox API improvements):
+
*** [[SCREENSHOT]] TYPE=BROWSER, [[SAVEAS]] TYPE=CPL
+
*** [http://wiki.imacros.net/TAG#File_Upload File Upload] in the TAG command cannot be supported
+
*** [[CLICK]] command is now replaced by [[EVENT]] mode in the Recorder. However, already existing macros that contain [[CLICK]] command can be replayed
+
-->
+
 
+
*'''2015-12-29 V8.9.6 '''  => [http://download.imacros.net/archive/iMacros-Fx/imacros-8.9.6.xpi Download now] (To install: Download, and then drag-and-drop the .xpi file onto an open instance of Firefox).
+
** Fixes a UI issue that was introduced by a Firefox BETA channel update (all buttons stopped working)
+
 
+
 
+
*'''2015-08-21 V8.9.4 '''  => [http://download.imacros.net/archive/iMacros-Fx/imacros-8.9.4.xpi Download now] (To install: Download, and then drag-and-drop the .xpi file onto an open instance of Firefox).
+
** Fixes several reported issues with some dialogs not being handled by e.g. [[ONLOGIN]], [[ONDIALOG]]
+
 
+
 
+
*'''2015-03-25 V8.9.2 '''  => [http://download.imacros.net/archive/iMacros-Fx/imacros_for_firefox-8.9.2-fx.xpi Download now] (To install: Download, and then drag-and-drop the .xpi file onto an open instance of Firefox).
+
** Fixes several reported issues with automating file downloads
+
 
+
 
+
*'''2015-03-04 V8.9.1'''  => [http://download.imacros.net/archive/iMacros-Fx/imacros-8.9.1.xpi Download now] (To install: Download, and then drag-and-drop the .xpi file onto an open instance of Firefox.).
+
** Added Firefox 36 compatibility
+
*** Fixes "NS_ERROR_XPC_NOT_ENOUGH_ARGS: Not enough arguments [nsIWebBrowserPersist.saveURI]"
+
*** Fixes problem with JS code executed twice instead of once
+
 
+
 
+
*'''2015-02-05 V8.8.9'''  => [http://download.imacros.net/archive/iMacros-Fx/imacros_for_firefox-8.8.9-fx.xpi Download now] (To install: Download, and then drag-and-drop the .xpi file onto an open instance of Firefox).
+
** Minor error code change related to the EVENT command
+
 
+
 
+
*'''2014-12-16 V8.8.8'''  => [http://download.imacros.net/archive/iMacros-Fx/imacros_for_firefox-8.8.8-fx.xpi Download now] (To install: Download, and then drag-and-drop the .xpi file onto an open instance of Firefox).
+
** TAG command fails since the FRAME number is not set to 0
+
** Specifying a file name without extension in the ONDOWNLOAD FILE parameter should save the file with the original extension
+
** SCREENSHOT FOLDER=* results in error general closed
+
** Clicking Apply in the settings dialog no longer dismisses the dialog
+
** Upgrading to Yosemite breaks some iMacros macros
+
** Using the +something syntax in ONDOWNLOAD FILE does not follow the rules outlined in the wiki
+
 
+
 
+
*'''2014-11-07 V8.8.7'''  => [http://download.imacros.net/archive/iMacros-Fx/imacros_for_firefox-8.8.7-fx.xpi Download now] (To install: Download, and then drag-and-drop the .xpi file onto an open instance of Firefox).
+
** Added: Firefox 33 compatibility
+
** Fixed: Some strange freeze [http://forum.imacros.net/viewtopic.php?f=11&t=23513 issue].
+
** Fixed: [[ONDOWNLOAD]] checksum issue
+
 
+
 
+
*'''2014-9-26 V8.8.5'''  => [http://download.imacros.net/archive/iMacros-Fx/imacros_for_firefox-8.8.5-fx.xpi Download now] (To install: Download, and then drag-and-drop the .xpi file onto an open instance of Firefox).
+
** Added: Firefox 32 compatibility
+
** Fixed: ANSI issue
+
** Fixed: CLEAR command issue (caused by Firefox API changes)
+
** Fixed: More fixes for ANSI encoded file issues (on Windows)
+
** Fixed: [http://forum.imacros.net/viewtopic.php?t=23163 Replay problem introduced in Firefox 31] affecting macros using ONDOWNLOAD
+
 
+
 
+
*'''2014-05-15 V8.8.2'''  => [http://download.imacros.net/archive/iMacros-Fx/imacros_for_firefox-8.8.2-fx.xpi Download now] (To install: Download, and then drag-and-drop the .xpi file onto an open instance of Firefox).
+
** Fixed: Firefox 28 issue that prevented ANSI files from being loaded correctly
+
 
+
 
+
*'''2014-02-06 V8.8.1'''  => [http://download.imacros.net/archive/iMacros-Fx/imacros_for_firefox-8.8.1-fx.xpi Download now] (To install: Download, and then drag-and-drop the .xpi file onto an open instance of Firefox).
+
** Added: Firefox 27 support
+
** Added: [http://alertfox.com AlertFox] support - test and upload transaction tests from within iMacros (see the Manage tab).
+
** Fixed: Several bug fixes and tweaks
+
 
+
[[Image:new_manage_tab.jpg|200px|thumb|center|New MANAGE tab in iMacros for Firefox 8.80]]
+
 
+
*'''2013-11-20 V8.6.0''' => [http://download.imacros.net/archive/iMacros-Fx/imacros_for_firefox-8.6.0-fx.xpi Download now] (To install: Download, and then drag-and-drop the .xpi file onto an open instance of Firefox).
+
** Added: Firefox 25 and Firefox 26 support
+
** Improved: Floating iMacros icon only during recording, blue frames back during replay
+
** Fixed: 16 other bug fixes and tweaks
+
 
+
 
+
*'''2013-9-12 V8.5.3'''  => [http://download.imacros.net/archive/iMacros-Fx/imacros_for_firefox-8.5.3-fx.xpi Download now] (To install: Download, and then drag-and-drop the .xpi file onto an open instance of Firefox).
+
** Fixed: URL GOTO not working with local files on Firefox 23 and later
+
** Fixed: Bookmark macros not working with Firefox 22 and later
+
** Fixed: iimDisplay was not working
+
 
+
 
+
*'''2013-3-28 V8.5.1 '''  => [http://download.imacros.net/archive/iMacros-Fx/imacros_for_firefox-8.5.1-fx.xpi Download now] (To install: Download, and then drag-and-drop the .xpi file onto an open instance of Firefox).
+
** New: [[IMAGESEARCH]] also available in Firefox on Windows (requires iMacros Standard or Enterprise Edition)
+
** Improved: Bookmarklet support
+
** Removed: support for run.imacros.net. This has been deprecated since V6.2.4 and replaced with the [[iMacros_for_Firefox#Command_Line_Support|imacros://run/]] URI. With this release, using run.imacros.net will no longer work.
+
** Fixed: Tab Mix Plus issue (caused by a recent Firefox update)
+
** Fixed: Many other bug fixes
+
** Only tested with Firefox V21 (the most recent release). For use with older Firefox version, please use a previous iMacros version from the [https://addons.mozilla.org/en-US/firefox/addon/imacros-for-firefox/versions/ iMacros for Firefox archive].
+
 
+
 
+
'''Important note for iMacros Enterprise Edition users:''' The updated iMacros Firefox Scripting Interface requires iMacros V9.50 (not yet released) or [http://www.iopus.com/download/imacros_scripting_patch_v9.50.zip this patch]. After downloading the patch, unzip and run "install.cmd" as administrator. It updates the Firefox connector to the latest version. This patch supports both, iMacros 8 and 9.
+
 
+
 
+
*2013-3-28 V8.3.0.0
+
** Fixed: Two issues reported by the Mozilla review team
+
 
+
 
+
*2013-3-12 V8.2.4.0
+
** Added: [[EVENT]] is a new '''experimental''' command to automate web controls that the classic [[TAG]] command can not automate:
+
*** Drag & Drop
+
*** Sliders
+
*** Tricky date control
+
*** Ajax drop&down boxes
+
** Fixed: Firefox 18/19 compatibility issues
+
 
+
 
+
*2012-11-05 V7.6.0.2
+
** Added: [[ONERRORDIALOG]] Firefox 16 support ([http://forum.iopus.com/viewtopic.php?f=11&t=18781&p=49534#p49534 forum post])
+
** Added: Warning about Firefox 16 Javascript replay issues (real solution available soon)
+
 
+
 
+
'''Update tip:'''
+
You can verify that you have the latest version with the [[VERSION]] command.
+
It should display ''VERSION BUILD='''7601105''' RECORDER=FX''
+
 
+
This command is added to the first line whenever you record a new macro.
+
 
+
 
+
 
+
*2012-10-16 V7.6.0.0
+
** Added: Updated iMacros bookmarklet support - now 100% compatible to iMacros for Chrome
+
** Added: Full support for the latest Firefox version
+
** Fixed: The default !TIMEOUT_STEP value is no longer calculated as a percentage of !TIMEOUT[_PAGE]
+
** Fixed: Saving macros as bookmarks does not work since Firefox 14
+
** Fixed: Many smaller improvements
+
 
+
 
+
*2012-07-25 V7.5.0.4
+
** Fixed: Demo files not installed correctly
+
 
+
 
+
*2012-07-10 V7.5.0.3 
+
** Improved: page load timing
+
** Fixed: Memory leak
+
 
+
 
+
*2012-06-12 V7.5.1.0
+
** Added: Firefox 13 support
+
** Fixed: Several smaller issues
+
 
+
 
+
 
+
*2011-11-10 V7.4.0.8
+
** Added: Firefox 8 support
+
** Fixed: Javascript performance issue (debug api bug)
+
 
+
 
+
*2011-11-04 V7.4.0.7
+
** Added: [[EVAL]] demo macro
+
** Added: [[Performance Profiler]] support
+
** Added: [[iimGetPerformance]] support
+
** Improved: [[EVAL]]- detect e. g. if a date is older than x days or if a number is > then y. Inside EVAL, you have the full power of Javascript available!
+
** Fixed: A crash triggered by a few websites
+
 
+
 
+
 
+
*'''2011-09-19 V7.4.0.1 ''' => [https://addons.mozilla.org/en-US/firefox/addon/imacros-for-firefox/ Mozilla Download Page]
+
** Added: Firefox 6 and 7 support
+
** Added: [[EVAL]]
+
** Enterprise Edition users [[iimInit]] ("-fx"): Updated Scripting Interface, now separate binary -> [http://www.iopus.com/download/iimfirefoxconnector.dll download], install [[iimfirefoxconnector.dll]] in iMacros installation folder, alongside iMacros.exe
+
** Fixed: Some smaller bug fixes
+
 
+
 
+
*2011-07-01 V7.3.0.0
+
(Note: This production version works also with Firefox 6&7, except the Scripting Interface)
+
** Added: Firefox 5 support
+
** Added: New [[Cloud_Services|cloud services]] tab. First supported service is AlertFox [http://alertfox.com Website Monitoring]
+
** Fixed: Some smaller bug fixes
+
 
+
 
+
*2011-05-26 V7.2.2.0
+
** Improved: Demo macros are now installed in their own /demo-firefox folder
+
** Improved: Checkbox toggled if CONTENT=YES/NO is not specified
+
** Fixed: ''Many'' smaller bug fixes!
+
 
+
 
+
*2011-04-20 V7.2.1.0
+
** Added: [[URL]] GOTO command returns http response codes e. g. 404
+
** Improved: Start-up performance
+
** Fixed: run.imacros.net [http://forum.iopus.com/viewtopic.php?f=2&t=12762&p=37914#p37914 issue]
+
 
+
 
+
*2011-03-28 V7.2.0.8
+
** Added: Full Firefox 4 support
+
** Added: [[iimRunner]] support for new iMacros Scripting Interface.
+
** Added: Firefox 4 Javascript scripting [http://forum.iopus.com/viewtopic.php?f=11&t=11443 see forum]
+
** Added: [[SAVE_ELEMENT_SCREENSHOT]] - Save screenshot of specified element (image, text,...)
+
** Added: [[PROXY]] command
+
** Fixed: Internal namespace cleaned up
+
** Fixed: Several smaller items
+
 
+
 
+
*2011-02-03 V7.1.0.2  => [https://addons.mozilla.org/en-US/firefox/downloads/latest/3863/addon-3863-latest.xpi Click here to download this version!] (or go to [https://addons.mozilla.org/en-US/firefox/addon/3863/ extension page])
+
** Added: New iMacros Scripting Interface. Requires use of [[Test Builds|iMacros Enterprise Edition V7.20 Beta]] => See [http://forum.iopus.com/viewtopic.php?f=8&t=12254 forum post]
+
** Added: Firefox 4 Support (except Javascript scripting... [http://forum.iopus.com/viewtopic.php?f=11&t=11443 will be added soon])
+
** Fixed: Mac installation issue
+
** Fixed: Firefox 4 Beta 10 issue
+
** Fixed: Several smaller items
+
 
+
 
+
*2010-11-12 V7.0.0.3
+
** Added: Demo-ExtractTable.iim demo macro
+
** Fixed: [http://forum.iopus.com/viewtopic.php?f=2&t=11330 Removed the debug log file] that was left over in V7.0.2.
+
 
+
 
+
 
+
*2010-10-26 V7.0.0.2 [http://forum.iopus.com/_uploads/imacros.7.02.xpi Click here to download]
+
** Fixed: Firefox treats the NAME of select option as ID % while IE does not (improves FX/IE macro compatibility)
+
** Fixed: [http://forum.iopus.com/viewtopic.php?t=11160 Issue] with ONDOWNLOAD command was used but no download occurred error 
+
 
+
 
+
*2010-10-12 V7.0.0.1
+
**Fixes several smaller bugs introduced with V7.0.0
+
 
+
 
+
 
+
*2010-09-17 V7.0.0.0
+
** Added: Firefox 4.0 support!
+
** Added: [[!TIMEOUT_STEP]] (same as [[!TIMEOUT_TAG]])
+
** Fixed: Irregularly failing to handle download ([http://forum.iopus.com/viewtopic.php?f=11&t=8947 forum])
+
** Fixed: Several smaller bugfixes
+
** Important info for iMacros Enterprise Edition users: The iMacros Scripting Interface DLL ''XpcomOpusConnector.dll/xpt'' are missing in this installer to circumvent a [https://bugzilla.mozilla.org/show_bug.cgi?id=574334 bug in Firefox 3.6.4 and later]. So if you want to use [[iimInit]] ("-fx") please [http://forum.iopus.com/_uploads/Firefox_Setup_3.6.3.exe downgrade to Firefox V3.6.3] or lower and [http://www.iopus.com/download/imacros-6.7.0.0.xpi install iMacros for Firefox 6.7.0.0]. Or copy the missing xpt file into the V7.0.0 component folder. For detailed instructions please see this [http://forum.iopus.com/viewtopic.php?f=8&t=11007&p=32896#p32896 forum post].
+
 
+
 
+
*2010-06-24 V6.7.0.1
+
**Temporarily Removed: iMacros Scripting Interface DLL ''XpcomOpusConnector.dll'' to circumvent a [https://bugzilla.mozilla.org/show_bug.cgi?id=574334 bug in Firefox 3.6.4]
+
**'''Important:''' If you want to use [[iimInit]] ("-fx") please downgrade to Firefox V3.6.3 or lower and [http://www.iopus.com/download/imacros-6.7.0.0.xpi install iMacros for Firefox 6.7.0.0]
+
 
+
 
+
*2010-05-07 V6.7.0.0 [http://www.iopus.com/download/imacros-6.7.0.0.xpi Click here to download this version!]
+
**Added: SET [[!POPUP_ALLOWED]] to dynamically white-list popup URLs. This is useful for web testing and macro portability.
+
 
+
 
+
*2010-04-15 V6.6.5.0
+
**Improved: [[STOPWATCH]] command, [http://forum.iopus.com/viewtopic.php?f=11&t=8979&p=28990#p28990 see forum discussion for details]
+
**Fixed: Several smaller issues
+
 
+
 
+
*2010-02-22 V6.6.0.1
+
**Added: New [[SEARCH]] command, assert, search & extract from the page source code
+
**Fixed:  RuntimeError: Wrong format of CONTENT value [http://forum.iopus.com/viewtopic.php?f=11&t=9124&p=27023#p27023 bug] (introduced with V6.5.0.0)
+
**Fixed: Several smaller issues
+
 
+
 
+
*2010-01-28 V6.5.0.0
+
**Added: [[STOPWATCH]] LABEL and [[iimGetLastPerformance]]
+
**Added: [[iMacros_for_Chrome#iMacros_as_Bookmarklets|Bookmarklet]] support for Firefox- [http://www.iopus.com/imacros/chrome/ Examples here!]
+
**Added: "Never ask again" option for the "Would you like to close all tabs" message
+
**Added: Support for new iMacros for Chrome encryption format
+
**Added: Support for type=* (=> ignore type in the TAG search)
+
**Added: Use frame ID to specify frame in addition to number (see [[FRAME]])
+
**Added: [[ONDOWNLOAD]] File=* Folder=* WAIT=YES [[CHECKSUM]]='''MD5:'''AF2D... support (MD5 and SHA1 are supported)
+
**Added: Take Screenshot button (adds SAVEAS TYPE=PNG to the macro)
+
**Improved: Change form recording ACTION syntax, now fully compatible to iMacros for IE/Chrome
+
**Improved: Xpcom DLL signed
+
**Improved: AJAX support, now waits TIMEOUT_TAG long for select box entries to appear
+
**Fixed: Drag & Drop issue in iMacros tree view
+
**Fixed: FX recording DropDown differs from the iMacros software recording.
+
**Fixed: Issue wit UnMHT addon
+
**Fixed: Colon (:) in CONTENT not possible
+
**Fixed: Wrong year in !NOW
+
 
+
 
+
*2010-01-01 V6.3.1.1
+
**Added: Demo-Fillform-XPath macro
+
**Added: Error and [[iimDisplay]] messages now displayed inside the tab (no longer extra dialog box to close)
+
**Added: FAIL_IF_FOUND support (example use: trigger error if a text '''is''' found)
+
**Added: SET [[!TIMEOUT_MACRO]] support
+
**Added: [[iimTakeBrowserScreenshot]] (path, 1) support
+
**Added: !X_FX_CLICKMODE DOM/API experimental switch to a new Clickmode
+
**Improved: HTML Clickmode includes TXT now
+
**Fixed: Many other smaller issues
+
 
+
 
+
*2009-12-07 V6.2.5
+
**Added: Firefox 3.7a1pre support
+
 
+
 
+
*2009-07-14 V6.2.4
+
**Added: Firefox 3.6a1pre support
+
**Added: Local macro bookmarks now with ''imacros://run/?m=macro.iim'' syntax
+
**Added: Full path support for Scripting Interface: i = iim1.iimPlay("d:\a\demo-fillform.iim", 60)
+
**Fixed: [http://forum.iopus.com/viewtopic.php?f=11&t=7203&p=21096#p21096 Firefox stops page loading when macro stops]
+
**Fixed: Many other smaller issues
+
 
+
 
+
*'''2009-06-10 V6.2.3
+
**Added: [[!CLIPBOARD|<nowiki>{{!CLIPBOARD}}</nowiki> support]]
+
**Added: Right-click menu to iMacros Editor
+
**Added: TAG [[XPATH]] support
+
**Added: Error return codes
+
**Added: TAG.. CONTENT=EVENT:[[TAG#Triggering_events|FAIL_IF_FOUND]] support
+
**Added: Editor Help Button links to the popular ''AlertFox [http://www.alertfox.com Website Monitoring]'' and [http://wiki.alertfox.com Wiki]
+
**Added: [[Demo-Open6Tabs]] macro
+
**Improved: Click X/Y command
+
**Fixed: [[iimGetLastError]] did not return an error text
+
**Fixed: Many smaller issues
+
 
+
 
+
*2009-05-06 V6.2.1.5
+
**Added: Firefox 3.5 Beta support
+
 
+
 
+
*2009-03-26 V6.2.1.4
+
**Fixed: [[PAUSE]] issue
+
**Fixed: Other smaller issues
+
 
+
 
+
*2009-03-20 V6.2.1.3
+
**Added: Editor: maximize/minimize buttons added
+
**Fixed: [http://forum.iopus.com/viewtopic.php?f=11&t=6747 Bookmark issue]
+
**Fixed: [http://forum.iopus.com/viewtopic.php?f=11&t=6742 TAG wait isssue]
+
**Fixed: Freeze with JS script runs and sidebar was closed
+
**Fixed: [[SAVEAS]] issue
+
**Fixed: Issue with tricky CSV files
+
 
+
 
+
 
+
*2009-03-18 V6.2.1.1
+
**Added: New, completely redesigned, super-fast iMacros Player engine.
+
**Added: New macro editor with syntax-coloring
+
**Added: [[!SINGLESTEP]] support
+
**Added: Password dialog link to our [http://www.iopus.com/imacros/support/passwordtool/ password tool]
+
**Added: [[ONDOWNLOAD]] sub folder creation, e. g. FOLDER=d:\F1\F2 => Folder F2 will be created
+
**Fixed: [http://forum.iopus.com/viewtopic.php?f=11&t=6519 Syntax error for ATTR=TXT:]
+
**Fixed: Issue with Mac OSX default paths.
+
**Fixed: Several smaller issues
+
**Changed: Removed Firefox 1.x support. This allowed us to improve and enhance iMacros further.
+
 
+
 
+
*2009-01-09 V6.1.1.4
+
**Changed: Removed Seamonkey and Flock support because of issues with the latest versions of these browsers. We plan to add support again in the future.
+
 
+
 
+
*2008-12-15 V6.1.1.3
+
**Added: Better error messages if some paths do not exist
+
**Fixed: [http://forum.iopus.com/viewtopic.php?f=11&t=6161&p=17499 #NOVAR# support]
+
**Fixed: [[STOPWATCH]] timer issue
+
**Fixed: [[TAB]] recording issue
+
**Fixed: [[ONLOGIN]] recording issue
+
**Fixed: [[URL]] GOTO syntax check issue (redesigned URL syntax check)
+
**Fixed: Issue with F5 (Refresh)
+
 
+
 
+
*2008-12-03 V6.1.1.0
+
**Added: Take screenshots of the complete page in PNG format with the new [[SAVEAS|SAVEAS TYPE=PNG]] command.
+
**Added: New demo macro: Demo-TakeScreenshot-FX.iim
+
**Added: [http://forum.iopus.com/viewtopic.php?f=11&t=5652&p=16971#p16971 Support for Portable Firefox] (Check the "Store data in Profile Folder" box on the Folder options tab)
+
**Added: Added line numbers to Javascript error messages
+
**Added: Hide or show Javascript execution with //imacros-js:showsteps yes|no command
+
**Added: Support for using "", as in CONTENT="Hello Firefox"
+
**Added: CONTENT=EVENT:[[SAVEITEM]] support (in Firefox, this is currently the same as [[SAVEPICTUREAS]])
+
**Added: [[TAB]] T=x generates and error messgae if Tab# x does not exist
+
**Added: ASCII macro format now supported (in addition to Unicode and UTF-8)
+
**Added: iMacros Macro Bookmarks show iMacros icon now
+
**Added: Automatic POS detection for check boxes
+
**Added: User can press STOP when macro is paused
+
**Added: Closing of a tab now recorded ([[TAB]] CLOSE)
+
**Improved: iMacros preferences storage consolidated in the imacros: workspace. Old settings are transferred to the new settings.
+
**Improved: The error window after SET !ERRORIGNORE YES does not steal focus
+
**Fixed: [[iimInit]] ("-fx", FALSE) support
+
**Fixed: CLICK X/Y command issue
+
**Fixed: Many smaller issues
+
 
+
 
+
*2008-10-24 V6.0.7.6
+
**Added: Firefox 3.1 Beta support
+
 
+
 
+
[[iMacros_for_Firefox_Version_History|Older versions:]] Read the [[iMacros_for_Firefox_Version_History|previous version history here]]. You can download all older versions [https://addons.mozilla.org/en-US/firefox/addons/versions/3863 here]. Be careful with old versions. These versions are provided for reference and testing purposes. You should always use the [http://www.iopus.com/download/imacros-firefox/ latest version].
+
 
+
==Known Issues==
+
 
+
Known issues with the latest version of iMacros for Firefox:
+
 
+
* [[SCREENSHOT]] TYPE=BROWSER is no longer possible
+
* [[SAVEAS]] TYPE=CPL is not available anymore
+
* [[TAG#File_Upload|File Upload]] in the TAG command cannot be supported
+
* The following were never officially supported and had to be removed as well, since Firefox no longer allows access to the page DOM from the browser context (only [https://developer.mozilla.org/en-US/Firefox/Multiprocess_Firefox/Limitations_of_frame_scripts frame scripts] can do so now)
+
** No access to webpage DOM from javascript in .js files (window, content objects) or macros (URL GOTO=javascript:...)
+
** imns (iMacros namesapce) is no longer accessible
+
 
+
Please report any problem in our '''[http://forum.iopus.com/viewforum.php?f=11 user forum]'''. ''We can only fix issues that you report!'' Thank you for your help.
+
 
+
''Most issues will be fixed as soon as possible.''
+
 
+
Note 1: [[Firefox_Error_Console|How to use the Firefox Error Console?]]
+
  
Note 2: If you run iMacros non-stop (24 x 7), you should [[Firefox_Nags|disable some of Firefox "nag" dialogs]] and see [[Web_Testing#Q:_How_can_I_set_up_a_24_hours_a_day.2C_7_days_a_week_.28non-stop.29_operation_with_iMacros.3F|this FAQ]].
+
* Not supported in this version:
 +
** CLICK
 +
** EVENT, EVENTS
 +
** FILEDELETE
 +
** FILTER
 +
** ONDIALOG
 +
** PROXY
 +
** !POPUP_ALLOWED
 +
** !SINGLESTEP
 +
** File upload is not supported
 +
** iMacros for Firefox is disabled in Private Browsing mode due to restrictions in Firefox
 +
** The built-in Javascript scripting interface for playing .js files is no longer available. Please use the [[Web Scripting|iMacros Scripting Interface (API)]] included with some of the [[Features Comparison|iMacros paid editions]]. This API allows you to control Chrome and Firefox from [[Sample Code|external scripts and programs (C++, C#, Javascript, Python, Perl, etc.)]]
 +
** The imacros://run/ URI is no longer supported for running macros from the command line, however, [[Webextensions#Command_Line_Support|a new method is described here]].
  
Do you want to be informed when the next iMacros update is available? => Please [http://forum.iopus.com/viewforum.php?f=20 subscribe to the iMacros announcement forum].
+
* The following commands and variables are newly supported in iMacros 10:
 +
** SIZE
 +
** !FOLDER_DOWNLOAD
 +
** !FOLDER_MACROS
 +
** !IMAGEX, !IMAGEY
 +
** !PLAYBACKDELAY
  
==How to Downgrade==
+
* Known Issues:
 +
** Docking the iMacros panel (sidebar) can break the ability to drag and drop tabs in Firefox
 +
** Search and replace dialog no longer work in the macro editor due to Firefox CSP (Content Security Policy) for Web Extensions.
 +
** For security reasons in Firefox, you cannot navigate using URL GOTO to a privileged URL such as file:, data:, and about: (although about:home and about:blank are allowed)
  
If you want to downgrade iMacros for Firefox to a previous version and disable automatic updates, follow the steps below:
+
* Additional tweaks/enhancements made during the beta period:
 +
** Accept input and confirm PROMPT and other dialogs with a keyboard Enter
 +
** Editor Save and Save As buttons feedback on successful save
 +
** Changed Play button text to Resume when macro is paused
 +
** Added setting to ignore UnsupportedCommand errors bypassing parsing of line (use with care!)
  
#Go to Tools - Add-ons in Firefox
+
===[[iMacros_for_Firefox_Legacy#Version_History|Legacy versions (9.0.3 and older)]]===
#Find iMacros in the list of Extensions
+
#Click Remove and restart Firefox
+
#Install an older version of iMacros from the [https://addons.mozilla.org/en-US/firefox/addon/imacros-for-firefox/versions/ archive]
+
#After restarting the browser again, go back to the Add-ons page and click the "More" link for iMacros
+
#[[iMacros_for_Firefox#Automatic_Updates|Turn Automatic Updates Off]]
+
  
 
==See Also==
 
==See Also==
iMacros [[Community Editions]], [[iMacros for Firefox Mobile]], [[iMacros for Chrome]], [[Linux]], [[Mac]], [http://www.iopus.com/imacros/compare/all/ Compare all iMacros versions], iMacros 7 [[Version History]]
+
[[Webextensions]], [[Personal Edition]], [[iMacros for Chrome]], [[Features Comparison]], [[iMacros for Firefox Legacy]]

Latest revision as of 13:52, 4 December 2018

Scope

iMacros for Firefox (version 10 and above) is one of the iMacros Webextensions. A detailed documentation of features and limitations is found in that page. Here we document the few differences to that common page.

For the legacy versions (9 and below) refer to iMacros for Firefox Legacy.

License

iMacros End User License Agreement

Installation

Firefox Download from iMacros @ Mozilla Addons

Downloading Files

If you have iMacro File Access installed you can use the ONDOWNLOAD command to automate the download of files in Firefox. If the File Access is not installed, the ONDOWNLOAD parameters are ignored but the file is downloaded with its default file name, to Firefox default downloads folder. However, by default, Firefox will prompt you to choose between saving or opening a file upon download. iMacros cannot handle this prompt and will only be able to download the file if Firefox default action for this file type is Save File.

In order to have the download handled by iMacros, the action in Firefox preferences has to be set as Save File. See Change what Firefox does when you click on or download a file

If the file type you are downloading is not listed under Content Type, you will have to edit Firefox handlers.js file manually. In the example below we included .exe and .msi in handlers.json, using "action":0 for save.

{
   "defaultHandlersVersion": {
       "en-GB": 4
   },
   "mimeTypes": {
       "application/pdf": {
           "action": 3,
           "extensions": [
               "pdf"
           ]
       },
       "application/x-7z-compressed": {
           "action": 0,
           "extensions": [
               "7z"
           ]
       },
       "application/x-msi": {
           "action": 0,
           "extensions": [
               "msi"
           ]
       },
       "application/x-executable": {
           "action": 0,
           "extensions": [
               "exe"
           ]
       }
   },
   "schemes":{...
   }
}

To locate the handlers.json file, type in Firefox navigation bar "about:support" and under General Information/Profile Folder you can click on the button Open Folder.

Clearing Cookies and Cache

When you clear the browser history in Firefox, iMacros stored data is also removed. Thus all your iMacros preferences are lost. iMacros will work again, but you preferences will be reset to their defaults. This also happens if you set Firefox to Clear history when Firefox closes in about:preferences#privacy.

The CLEAR command, on the other hand, does not delete iMacros data, while clearing cache and cookies. It also accepts an argument to filter the cookies to be cleared by domain name. Using CLEAR with no argument clears all cookies and cache. Using e.g.

CLEAR facebook.com 

will clear all of the cache, but only cookies from Facebook. If you only want to clear the cache, then specify a nonexistent domain name

CLEAR xxx.yyy.zzz

Scripting Firefox

Due to the WebExtensions framework adopted by Mozilla and released with Firefox 56 (a.k.a. Quantum), iMacros for Firefox 10 no longer includes the built-in Javascript scripting interface for playing .js files directly from the iMacros sidebar. However, as mentioned in Scripting Chrome and Firefox, you can still control iMacros for Firefox via external scripts and programs.

iMacros for Firefox requires the latest version of the iMacros scripting interface (API) included with the File Access installer under the following scenario:

If you use the iMacros Enterprise (v12.0 or older) scripting interface to connect to iMacros for Firefox *and* specify a non-default Firefox profile using e.g.:

  iimOpen("-fx -fxProfile MyProfile")

then you will need to copy and overwrite the following dlls first before this functionality will work with the current version of iMacros for Firefox. This is not required if you are already using a newer version of iMacros Enterprise (newer than v12.0) or if you are not using -fxProfile.

Source folder:

%localappdata%\Programs\iMacros
  • On 64-bit systems
  1. Copy imtcp.dll to %programfiles(x86)%\Ipswitch\iMacros
  2. Copy imtcp64.dll to %programfiles%\Ipswitch\iMacros
  • On 32-bit systems
  1. Copy imtcp.dll to %programfiles%\Ipswitch\iMacros

Known Issues

Current known issues with the latest version of iMacros for Firefox:

  • Docking the iMacros panel (sidebar) can break the ability to drag and drop tabs in Firefox.
  • Search and replace dialog no longer work in the macro editor due to Firefox CSP (Content Security Policy) for Web Extensions.

Version History

Version 10.0.2, released July 9, 2018

This is the first version which supports Firefox Quantum (Firefox 57 and above). It is a complete new version for the Firefox Webextension API, which has more similarities with iMacros for Chrome than previous versions of iMacros for Firefox. In particular, there are some commands, variables, and functionality that were previously supported but currently are not mostly because the WebExtension API provided by Mozilla still lacks support for it.

  • The following commands and variables are newly supported in iMacros 10:
    • SIZE
    •  !FOLDER_DOWNLOAD
    •  !FOLDER_MACROS
    •  !IMAGEX, !IMAGEY
    •  !PLAYBACKDELAY
  • Known Issues:
    • Docking the iMacros panel (sidebar) can break the ability to drag and drop tabs in Firefox
    • Search and replace dialog no longer work in the macro editor due to Firefox CSP (Content Security Policy) for Web Extensions.
    • For security reasons in Firefox, you cannot navigate using URL GOTO to a privileged URL such as file:, data:, and about: (although about:home and about:blank are allowed)
  • Additional tweaks/enhancements made during the beta period:
    • Accept input and confirm PROMPT and other dialogs with a keyboard Enter
    • Editor Save and Save As buttons feedback on successful save
    • Changed Play button text to Resume when macro is paused
    • Added setting to ignore UnsupportedCommand errors bypassing parsing of line (use with care!)

Legacy versions (9.0.3 and older)

See Also

Webextensions, Personal Edition, iMacros for Chrome, Features Comparison, iMacros for Firefox Legacy