Class ContextMenu

contextView$

contextView$$

elem$

elem$$

itemConstructor$

itemConstructor$$

itemElement$

itemElement$$

itemLabel$

itemLabel$$

itemNesting$

itemNesting$$

itemText$

itemText$$

viewBlock$

viewBlock$$

elem

• get elem(): ChainablePromiseElement<Element>

• Base element of given page object

  Returns ChainablePromiseElement<Element>

locators

• get locators(): PageLocators

• Get the locator map of given page object

  Returns PageLocators

parent

• get parent(): ChainablePromiseElement<Element>

• Parent element of given page object

  Returns ChainablePromiseElement<Element>

getItem

• getItem(name): Promise<undefined | MenuItem<{
      contextView: string;
      elem: string;
      itemConstructor: ((label) => string);
      itemElement: string;
      itemLabel: string;
      itemNesting: string;
      itemText: string;
      viewBlock: string;
  }>>

• Get context menu item by name

  Parameters

  • name: string

    name of the item to search by

  Returns Promise<undefined | MenuItem<{
      contextView: string;
      elem: string;
      itemConstructor: ((label) => string);
      itemElement: string;
      itemLabel: string;
      itemNesting: string;
      itemText: string;
      viewBlock: string;
  }>>

  Promise resolving to ContextMenuItem object

getItems

• getItems(): Promise<ContextMenuItem[]>

• Get all context menu items

  Returns Promise<ContextMenuItem[]>

  Promise resolving to array of ContextMenuItem objects

hasItem

• hasItem(name): Promise<boolean>

• Find whether the menu has an item of a given name

  Parameters

  • name: string

    name of the item to search for

  Returns Promise<boolean>

  true if menu has an item with the given name, false otherwise

poll

• poll(timeout?, interval?): Promise<ContextMenu>

• Poll for the element to become visible

  Parameters

  • timeout: number = 10000

    custom timeout for the wait

  • interval: number = 2000

    custom interval to control polling

  Returns Promise<ContextMenu>

  thenable self reference

select

• select(...path): Promise<undefined | Menu<{
      contextView: string;
      elem: string;
      itemConstructor: ((label) => string);
      itemElement: string;
      itemLabel: string;
      itemNesting: string;
      itemText: string;
      viewBlock: string;
  }>>

• Recursively select an item with a given path.

  E.g. calling select('File', 'Preferences', 'Settings') will open the 'File' -> 'Preferences' submenus and then click on 'Settings'.

  Selection happens in order of the arguments, if one of the items in the middle of the path has no children, the consequent path arguments will be ignored.

  Parameters

  • Rest ...path: string[]

    path to the item to select, represented by a sequence of strings

  Returns Promise<undefined | Menu<{
      contextView: string;
      elem: string;
      itemConstructor: ((label) => string);
      itemElement: string;
      itemLabel: string;
      itemNesting: string;
      itemText: string;
      viewBlock: string;
  }>>

  void if the last clicked item is a leaf, Menu item representing its submenu otherwise

wait

• wait(timeout?): Promise<ContextMenu>

• Wait for the menu to appear and load all its items

  Parameters

  • timeout: number = 5000

  Returns Promise<ContextMenu>