The renewal maintenance has officially ended for Progress iMacros effective November 30, 2023.
This Wiki site will also no longer be moderated from the Progress side.
Thank you again for your business and support.
Sincerely, The Progress Team
Difference between revisions of "iMacros for Firefox"
(6 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
==Scope== | ==Scope== | ||
− | iMacros for Firefox (version 10 and above) is one of [[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. | + | 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]]. | For the legacy versions (9 and below) refer to [[iMacros for Firefox Legacy]]. | ||
Line 64: | Line 64: | ||
==Scripting Firefox== | ==Scripting Firefox== | ||
− | iMacros for Firefox 10 | + | 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. |
+ | |||
+ | 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: | ||
+ | |||
+ | 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") | iimOpen("-fx -fxProfile MyProfile") | ||
− | + | ||
− | 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). | + | 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: | Source folder: | ||
Line 102: | Line 106: | ||
** File upload is not supported | ** File upload is not supported | ||
** iMacros for Firefox is disabled in Private Browsing mode due to restrictions in Firefox | ** 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]]. | ||
* The following commands and variables are newly supported in iMacros 10: | * The following commands and variables are newly supported in iMacros 10: | ||
Line 122: | Line 128: | ||
==See Also== | ==See Also== | ||
− | [[Webextensions]], [[iMacros for Chrome]], [[Features Comparison]], [[iMacros for Firefox Legacy]] | + | [[Webextensions]], [[Personal Edition]], [[iMacros for Chrome]], [[Features Comparison]], [[iMacros for Firefox Legacy]] |
Revision as of 15:49, 16 November 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
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.
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
- Copy imtcp.dll to %programfiles(x86)%\Ipswitch\iMacros
- Copy imtcp64.dll to %programfiles%\Ipswitch\iMacros
- On 32-bit systems
- 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 56 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.
- 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 iMacros Scripting Interface (API) included with some of the iMacros paid editions. This API allows you to control Chrome and Firefox from 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, a new method is described here.
- 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!)
See Also
Webextensions, Personal Edition, iMacros for Chrome, Features Comparison, iMacros for Firefox Legacy