ACtl.runInTab

ACtl.runInTab(tabSpec,scriptName) tabSpec Type: TabSpec One or more tabs in which to run func or scriptName. 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 more than one tab is specified, the code given by func or scriptName runs concurrently on each tab, not sequentially.
Therefore, errors thrown in one tab don't prevent the execution of the code in the other tabs.

---

Limitation: Tabs containing protected pages will be omitted from the list. i.e. no attemp to run func or scriptName will be made for those tabs. args Type: Array Default: undefined An array of values to be passed as arguments to the func function. If a single argument is passed, it can be passed as is, without being enclosed in an array.
All values must be JSONable, since they have to be moved between contexts. func Type: Function The function to run in each tab specified by tabSpec. This function cannot use closure variables since it will run in a different browsing context. However, it can still use global variables that exist in the page in which it will run. scriptName Type: string

---

The name of any script created by the user.

---

The name matching is done ignoring letter case and redundant white spaces. Returns Type: Promise Resolves to: Array Returns immediately. The Promise will resolve to an array containing the return value of func or scriptName for each tab in tabSpec (minus tabs containing protected pages). These values must be JSONable, since they have to be moved between contexts. Throws Type: JSONable Error description if tabSpec is not a valid Tab Specifier or if func is not a function or if scriptName doesn't exist.

---

This function also rethrows any errors thrown by func or scriptName. If tabSpec specifies multiple tabs, only the first error that occurs in one of the tabs is rethrown.

---

The error value must be JSONable, since it has to be moved between contexts.

Examples

	let textToSearch = 'Not found' ;
	//Run a function on all tabs in the current window and get its result
	let tabIds = await ACtl.runInTab('#currWinTabs', textToSearch, text =>{
		//If the page contains the text we are looking for
		if( document.body.innerText.match( RegExp(`\\b${text}\\b`) ) )
			//Return its tab ID
			return ACtl.TAB_ID ;
		//Otherwise, return nothing
	}) ;
	//Close all tabs found above
	ACtl.closeTab(tabIds) ;
	

	//Run a function in all audible Youtube tabs
	let [timeMark] = await ACtl.runInTab('Youtube audible tabs', ()=>{
		//Click on the play/pause button
		document.querySelector('.ytp-play-button').click() ;
		//Get the video's current time and return it 
		return document.querySelector('.ytp-time-current').innerText ;
	}) ;
	//If there were audible Youtube tabs, `timeMark` will be defined
	if(timeMark)
		alert('Video stopped at ' + timeMark) ;
	else
		alert('No Youtube videos playing.') ;