NAME

EV::WebKit::Client::Element - a remote element handle

DESCRIPTION

What EV::WebKit::Client's find, find_all, find_js, find_all_js and wait_for give you. It has the same methods as EV::WebKit::Element -- text, html, value, tag, attr, prop, box, is_visible, click, focus, hover, type, send_keys, clear, check, uncheck, select_option, scroll_into_view, submit, find, find_all -- and each one is a request to the browser process. handle is the id the browser knows it by. frame_id is the one local accessor with no counterpart here: it reads state the browser process holds, and a remote handle does not carry it.

use v5.10;                 # for say()
my $el = $c->find('h1');
say $el->text;

A handle stops working when the page navigates: it answers 'stale element', exactly as an in-process handle does, rather than quietly reading the wrong node on the new page.

release frees the handle in the browser process early. You rarely need it -- navigating frees them all, and so does disconnecting.