Spec-Zone.ru › Web Extensions

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API