$(selector)

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Open source

$(selector)

Warning

Use locator-based frame.locator(selector) instead.

The method finds an element matching the specified selector within the frame. If no elements match the selector, the return value resolves to null. To wait for an element on the frame, use locator.waitFor([options]).

Returns

TypeDescription
Promise<ElementHandle | null>A Promise that fulfills with the ElementHandle of the selector when a matching element is found or null.