tabs.onMoved
Вызывается, когда вкладка перемещается в пределах окна.
Срабатывает только одно событие перемещения, представляющее вкладку, которую пользователь непосредственно переместил. События перемещения не срабатывают для других вкладок, которые должны переместиться в ответ. Это событие не срабатывает, когда вкладка перемещается между окнами. Для этого см. tabs.onDetached.
Синтаксис
browser.tabs.onMoved.addListener(listener) browser.tabs.onMoved.removeListener(listener) browser.tabs.onMoved.hasListener(listener)
События имеют три функции:
addListener(callback)-
Добавляет обработчик для этого события.
removeListener(listener)-
Прекращает прослушивание этого события. Аргумент
listener— это обработчик, который нужно удалить. hasListener(listener)-
Проверяет, зарегистрирован ли
listenerдля этого события. Возвращаетtrue, если он прослушивает, иfalse, в противном случае.
Синтаксис addListener
Параметры
callback-
Функция, которая будет вызываться при возникновении этого события. Функции будут переданы следующие аргументы:
tabId-
integer. ID вкладки, которую пользователь переместил. moveInfo-
object. Информация о перемещении. Дополнительные сведения см. в разделе moveInfo.
Дополнительные объекты
moveInfo
windowId-
integer. ID окна этой вкладки. fromIndex-
integer. Начальный индекс этой вкладки в окне. toIndex-
integer. Конечный индекс этой вкладки в окне.
Примеры
Прослушивание и регистрация событий перемещения:
function handleMoved(tabId, moveInfo) { console.log(`Tab ${tabId} moved from ${moveInfo.fromIndex} to ${moveInfo.toIndex}`); } browser.tabs.onMoved.addListener(handleMoved);
Примеры расширений
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | |
onMoved |
Да | 79 | 45 | ? | Да | 14 | ? | ? | Нет | ? | 15 | ? |
Примечание: Этот API основан на API chrome.tabs Chromium. Данная документация основана на tabs.json в коде Chromium.
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/tabs/onMoved