bookmarks.onMoved
Вызывается при перемещении закладки или папки в другую родительскую папку или изменение позиции внутри папки.
Примечание: При перемещении нескольких закладок, поскольку этот API асинхронный, вызовы перемещения могут обрабатываться в любом порядке. Вследствие этого, значение индекса каждой закладки может измениться или быть неизвестным до завершения всех вызовов перемещения. Если индекс, связанный с закладкой, важен для вашей расширения, то — при перемещении нескольких закладок — расширение должно дождаться завершения каждого вызова bookmarks.move перед перемещением следующей закладки. Ожидание гарантирует, что индекс, связанный с каждой закладкой, не будет изменен вызовом перемещения, выполняющимся параллельно, пока исходный вызов находится в процессе.
Синтаксис
browser.bookmarks.onMoved.addListener(listener) browser.bookmarks.onMoved.removeListener(listener) browser.bookmarks.onMoved.hasListener(listener)
События имеют три функции:
addListener(callback)-
Добавляет обработчик события.
removeListener(listener)-
Прекращает прослушивание этого события. Аргумент
listener— это обработчик, который нужно удалить. hasListener(listener)-
Проверяет, зарегистрирован ли
listenerдля этого события. Возвращаетtrueесли обработчик зарегистрирован,falseв противном случае.
Синтаксис addListener
Параметры
callback-
Функция, которая будет вызвана при возникновении этого события. Функция получит следующие аргументы:
id-
string. Идентификатор перемещенного элемента. moveInfo-
object. Объект, содержащий дополнительные данные о перемещении. См. раздел moveInfo для получения более подробной информации.
Дополнительные объекты
moveInfo
parentId-
string. Новая родительская папка. index-
integer. Новый индекс этого элемента в родительской папке. oldParentId-
string. Старая родительская папка. oldIndex-
integer. Старый индекс элемента в родительской папке.
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | |
onMoved |
Да | 79 | 52 | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
Примеры
function handleMoved(id, moveInfo) { console.log(`Item: ${id} moved`); console.log(`Old index: ${moveInfo.oldIndex}`); console.log(`New index: ${moveInfo.index}`); console.log(`Old folder: ${moveInfo.oldParentId}`); console.log(`New folder: ${moveInfo.parentId}`); } function handleClick() { browser.bookmarks.onMoved.addListener(handleMoved); } browser.browserAction.onClicked.addListener(handleClick);
Примечание: Этот API основан на API chrome.bookmarks Chromium. Данная документация получена из bookmarks.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/bookmarks/onMoved