menus.onShown

Вызывается, когда браузер отобразил меню.

Расширение может использовать это событие для обновления элементов меню с помощью информации, доступной только после отображения меню. Обычно расширение определит обновление в обработчике onShown и затем вызовет menus.refresh() для обновления самого меню.

Обработчик может добавлять, удалять или обновлять элементы меню.

Например, расширение menu-labelled-open добавляет элемент меню, который отображается, когда пользователь нажимает на ссылку, и при нажатии просто открывает ссылку. Оно использует onShown и refresh() для аннотации элемента меню именем хоста ссылки, чтобы пользователь мог легко увидеть, куда он перейдёт, прежде чем нажать.

Обратите внимание, что расширение не должно тратить слишком много времени, прежде чем вызывать refresh(), или обновление будет заметно для пользователя.

Обработчик получает некоторую информацию о меню и его содержимом, а также некоторые данные со страницы (например, ссылку и/или текст выделения). Для доступа к информации со страницы ваше расширение должно иметь разрешение host permission для неё.

Если обработчик onShown вызывает любые асинхронные API, то возможно, что меню было закрыто ещё раз, прежде чем обработчик возобновит выполнение. Из-за этого, если обработчик вызывает асинхронные API, он должен проверить, отображается ли меню до обновления меню. Например:

let lastMenuInstanceId = 0;
let nextMenuInstanceId = 1;

browser.menus.onShown.addListener(async (info, tab) => {
  let menuInstanceId = nextMenuInstanceId++;
  lastMenuInstanceId = menuInstanceId;

  // Call an async function
  await /* the function to call */ ;

  // After completing the async operation, check whether the menu is still shown.
  if (menuInstanceId !== lastMenuInstanceId) {
    return; // Menu was closed and shown again.
  }
  // Now use menus.create/update + menus.refresh.
});

browser.menus.onHidden.addListener(() => {
  lastMenuInstanceId = 0;
});

Обратите внимание, что можно вызвать функции API меню синхронно, и в этом случае вам не нужно выполнять эту проверку:

browser.menus.onShown.addListener(async (info, tab) => {
  browser.menus.update(menuId /*, …*/);
  // Note: Not waiting for returned promise.
  browser.menus.refresh();
});

Однако, если вы вызываете эти API асинхронно, тогда вам нужно выполнить проверку:

browser.menus.onShown.addListener(async (info, tab) => {
  let menuInstanceId = nextMenuInstanceId++;
  lastMenuInstanceId = menuInstanceId;

  await browser.menus.update(menuId /*, …*/);
  // must now perform the check
  if (menuInstanceId !== lastMenuInstanceId) {
    return;
  }
  browser.menus.refresh();
});

Firefox предоставляет это событие через пространство имён contextMenus , а также через пространство имён menus.