AutoControl Control your browser your way Forum               Install now from theChrome Web Store


Executes either a preset action or a custom action defined in the user configuration page.

ACtl.execAction(actionName[,targetTabs]) actionName Type: string | RegExp The name of either a preset action or a custom action.
Preset action: One of the preset names starting with a # character (see remarks below). These names are case-sensitive.
Custom action: If the name doesn't match any preset action, it must match a custom action defined by the user (ignoring letter case and redundant white spaces). If multiple actions match, all of them are executed from top to bottom.
If a regular expression is passed, all custom actions matching the expression will be executed.
targetTabs Type: TabSpec Default: undefined One or more tabs to apply the action to. It can be either a tab ID, a filter object, a tab-selection name or an array combining all that. Full details at Tab Specifier.
If omitted, the default will be as follows:
For preset actions: The tab the script is running in or the #currentTab in background scripts.
For custom actions: The target tabs of the action, specified in the Apply to select box.
Returns Type: Promise Resolves to: Array Returns immediately. The Promise will resolve with an array of tab IDs. These are the tabs the action was applied to or the tabs the action created. Throws Type: string Error description if actionName doesn't match any action or if targetTabs is not a valid Tab Specifier.


The following list shows the supported preset action names and their equivalent AutoControl action in the GUI.
#goBackTabs Go back
#goForwardTabs Go forward
#reloadTabs Reload tabs
#unloadTabs Unload tabs
#goUpURL Go upper URL
#openInIncognito Open in incognito
#zoomIn Zoom in
#zoomOut Zoom out
#duplicateTabs Duplicate tabs
#detachTabs Detach tabs
#reopen Reopen closed tab
#sendWinsToBottom Send to bottom
#clpbrdCut Clipbrd cut
#clpbrdCopy Clipbrd copy
#clpbrdPaste Clipbrd paste
#copyLinks Copy links
#extractURLs Extract URLs
#delDupLines Erase dup. lines

Actions that are not in this list can be performed by other ACtl functions. See GUI vs API for more details.


Go back on all tabs in the current window.

	ACtl.execAction('#goBackTabs', '#currWinTabs') ;

Duplicate the current tab and then pin the duplicate.

	let [newTabId] = await ACtl.execAction('#duplicateTabs', '#currentTab') ;
	ACtl.setTabState(newTabId, 'pinned') ;

Trigger a custom action to reopen the last closed tab and move it to the rightmost position in the window.

	let [newTabId] = await ACtl.execAction('Reopen to rightmost') ;

Reopen to rightmost must be an action defined in the user configuration page, like this:
Scripting API Script Isolation Asynchronicity Backgrnd Scripts GUI vs API ACtl.include ACtl.import ACtl.getFile ACtl.saveFile ACtl.saveURL ACtl.openURL ACtl.closeTab ACtl.runInTab ACtl.runInFrames ACtl.runInPageCtx ACtl.getTabInfo ACtl.getTabIds ACtl.TAB_ID ACtl.setTabState ACtl.captureTab ACtl.execAction ACtl.runCommand ACtl.getClipboard ACtl.setClipboard ACtl.expand ACtl.switchState ACtl.var ACtl.pubVar ACtl.on ACtl.sleep ACtl.STOP_CHAIN ACtl.STOP_FULL_SEQ