tabs.onMoved
Fired when a tab is moved within a window.
Only one move event is fired, representing the tab the user directly moved. Move events are not fired for the other tabs that must move in response. This event is not fired when a tab is moved between windows. For that, see tabs.onDetached
.
Syntax
browser.tabs.onMoved.addListener(listener)
browser.tabs.onMoved.removeListener(listener)
browser.tabs.onMoved.hasListener(listener)
Events have three functions:
-
addListener(callback)
-
Adds a listener to this event.
-
removeListener(listener)
-
Stop listening to this event. The listener
argument is the listener to remove.
-
hasListener(listener)
-
Check whether listener
is registered for this event. Returns true
if it is listening, false
otherwise.
Parameters
-
callback
-
Function that will be called when this event occurs. The function will be passed the following arguments:
-
tabId
-
integer
. ID of the tab the user moved.
-
moveInfo
-
object
. Information about the move. See the moveInfo section for more details.
moveInfo
-
windowId
-
integer
. ID of this tab's window.
-
fromIndex
-
integer
. Initial index of this tab in the window.
-
toIndex
-
integer
. Final index of this tab in the window.
Examples
Listen for and log move events:
function handleMoved(tabId, moveInfo) {
console.log(`Tab ${tabId} moved from ${moveInfo.fromIndex} to ${moveInfo.toIndex}`);
}
browser.tabs.onMoved.addListener(handleMoved);
Browser compatibility
|
Desktop |
Mobile |
|
Chrome |
Edge |
Firefox |
Internet Explorer |
Opera |
Safari |
WebView Android |
Chrome Android |
Firefox for Android |
Opera Android |
Safari on IOS |
Samsung Internet |
onMoved |
Yes |
79 |
45 |
? |
Yes |
14 |
? |
? |
No |
? |
15 |
? |
Note: This API is based on Chromium's chrome.tabs
API. This documentation is derived from tabs.json
in the Chromium code.