The target locator is accessed through browser.switchTo() and enables you to switch frames, tabs, or browser windows. As well as access the activeElement or an alert box.


Locates the DOM element on the current page that corresponds to document.activeElement or document.body if the active element is not available.


Navigates to the topmost frame


  • id number | string | ElementHandle
  • returns: <Promise>

Changes the active target to another frame.

Accepts either:

number: Switch to frame by index in window.frames, string: Switch to frame by or, whichever matches first, ElementHandle: Switch to a frame using the supplied ElementHandle of a frame.