o _cK@sdZddlZddlZddlZddlZddlmZmZm Z m Z m Z ddl m Z ddlmZmZddlmZmZddlmZddlmZe rLdd lmZmZeeZGd d d eZd e ed efddZ dS)zElement handle module.N)AnyDictListOptional TYPE_CHECKING) CDPSession)ExecutionContextJSHandle)ElementHandleError NetworkError) debugError) merge_dict)Frame FrameManagerc seZdZdZdededededddd f fd d ZdCd d Z de dfddZ dDddZ de eeffddZde e fddZdeedee eeffddZdDddZdEdededd fddZd edefd!d"ZdDd#d$ZdDd%d&ZdEd'ede dedd fd(d)ZdEd*ede dedd fd+d,Zde e eeffd-d.Zde e fd/d0ZdEde dedefd1d2Zd3ede dfd4d5Z d3ededfd6d7Z!d3ed8ed9edefd:d;Z"d3ed8ed9edefdededfd?d@Z(e(Z)de*fdAdBZ+Z,S)F ElementHandleaElementHandle class. This class represents an in-page DOM element. ElementHandle can be created by the :meth:`pyppeteer.page.Page.querySelector` method. ElementHandle prevents DOM element from garbage collection unless the handle is disposed. ElementHandles are automatically disposed when their origin frame gets navigated. ElementHandle isinstance can be used as arguments in :meth:`pyppeteer.page.Page.querySelectorEval` and :meth:`pyppeteer.page.Page.evaluate` methods. contextclient remoteObjectpage frameManagerrreturnNcs2t|||||_||_||_||_d|_dS)NF)super__init___client _remoteObject_page _frameManagerZ _disposed)selfrrrrr __class__C/usr/local/lib/python3.10/dist-packages/pyppeteer/element_handle.pyr(s  zElementHandle.__init__cCs|S)zReturn this ElementHandle.r rr r r! asElement2szElementHandle.asElementrcsR|jdd|jdiIdH}|di}t|dts!dS|j|dS)z|Return the content frame for the element handle. Return ``None`` if this handle is not referencing iframe. zDOM.describeNodeobjectIdNnodeZframeId)rsendrget isinstancestrrframe)rZnodeInfoZnode_objr r r! contentFrame6s  zElementHandle.contentFramecs,|jd||jjIdH}|rt|dS)Na async (element, pageJavascriptEnabled) => { if (!element.isConnected) return 'Node is detached from document'; if (element.nodeType !== Node.ELEMENT_NODE) return 'Node is not of type HTMLElement'; // force-scroll if page's javascript is disabled. if (!pageJavascriptEnabled) { element.scrollIntoView({ block: 'center', inline: 'center', behavior: 'instant', }); return false; } const visibleRatio = await new Promise(resolve => { const observer = new IntersectionObserver(entries => { resolve(entries[0].intersectionRatio); observer.disconnect(); }); observer.observe(element); }); if (visibleRatio !== 1.0) element.scrollIntoView({ block: 'center', inline: 'center', behavior: 'instant', }); return false; })executionContextevaluaterZ_javascriptEnabledr )rerrorr r r!_scrollIntoViewIfNeededCs z%ElementHandle._scrollIntoViewIfNeededc sd}z|jdd|jdiIdH}Wnty,}z tt|WYd}~nd}~ww|r4|ds8tdg}|dD]}||}t |dkrQ| |q?|sXtd|d}d}d}|D]} || d7}|| d7}qb|d |d d S) NzDOM.getContentQuadsr$quads0Node is either not visible or not an HTMLElementrxyr3r4) rr&rr' Exceptionr loggerr _fromProtocolQuad_computeQuadAreaappend) rresulter0Z_quadZ_qquadr3r4pointr r r!_clickablePointes>     zElementHandle._clickablePointc s^z|jdd|jdiIdH}W|Sty.}ztt|d}WYd}~|Sd}~ww)NzDOM.getBoxModelr$)rr&rr'r r r8)rr<r=r r r! _getBoxModels  zElementHandle._getBoxModelr>cCsD|d|dd|d|dd|d|dd|d|d dgS) Nrr2r6r5r )rr>r r r!r9s zElementHandle._fromProtocolQuadcP|IdH|IdH}|dd}|dd}|jj||IdHdS)zMove mouse over to center of this element. If needed, this method scrolls element into view. If this element is detached from DOM tree, the method raises an ``ElementHandleError``. Nr3rr4)r/r@r'rmousemove)robjr3r4r r r!hover   zElementHandle.hoveroptionskwargscs\t||}|IdH|IdH}|dd}|dd}|jj|||IdHdS)aClick the center of this element. If needed, this method scrolls element into view. If the element is detached from DOM, the method raises ``ElementHandleError``. ``options`` can contain the following fields: * ``button`` (str): ``left``, ``right``, of ``middle``, defaults to ``left``. * ``clickCount`` (int): Defaults to 1. * ``delay`` (int|float): Time to wait between ``mousedown`` and ``mouseup`` in milliseconds. Defaults to 0. Nr3rr4)r r/r@r'rrHclick)rrMrNrJr3r4r r r!rOs   zElementHandle.click filePathscs6dd|D}|jd}|jd||dIdHS)z Upload files.cSsg|]}tj|qSr )ospathabspath).0pr r r! sz,ElementHandle.uploadFile..r$zDOM.setFileInputFiles)r$filesN)rr'rr&)rrPrWr$r r r! uploadFiles  zElementHandle.uploadFilecrG)zTap the center of this element. If needed, this method scrolls element into view. If the element is detached from DOM, the method raises ``ElementHandleError``. Nr3rr4)r/r@r'rZ touchscreentap)rcenterr3r4r r r!rYrLzElementHandle.tapcs|jd|IdHdS)zFocus on this element.zelement => element.focus()Nr,r-r"r r r!focusszElementHandle.focustextc4t||}|IdH|jj||IdHdS)zqFocus the element and then type text. Details see :meth:`pyppeteer.input.Keyboard.type` method. N)r r\rkeyboardtype)rr]rMrNr r r!r`s zElementHandle.typekeycr^)aPress ``key`` onto the element. This method focuses the element, and then uses :meth:`pyppeteer.input.keyboard.down` and :meth:`pyppeteer.input.keyboard.up`. :arg str key: Name of key to press, such as ``ArrowLeft``. This method accepts the following options: * ``text`` (str): If specified, generates an input event with this text. * ``delay`` (int|float): Time to wait between ``keydown`` and ``keyup``. Defaults to 0. N)r r\rr_press)rrarMrNr r r!rbs zElementHandle.presscs|IdH}|s dS|dd}t|d|d|d|d}t|d|d |d |d }t|d|d|d|d|}t|d|d |d |d |}||||d S) aReturn bounding box of this element. If the element is not visible, return ``None``. This method returns dictionary of bounding box, which contains: * ``x`` (int): The X coordinate of the element in pixels. * ``y`` (int): The Y coordinate of the element in pixels. * ``width`` (int): The width of the element in pixels. * ``height`` (int): The height of the element in pixels. NmodelborderrrBr5rEr2rCrDrF)r3r4widthheight)rAminmax)rr<r>r3r4rerfr r r! boundingBoxs  ""zElementHandle.boundingBoxcsr|IdH}|s dS|di}||d||d||d||d|d|dd S) a8Return boxes of element. Return ``None`` if element is not visible. Boxes are represented as an list of points; each Point is a dictionary ``{x, y}``. Box points are sorted clock-wise. Returned value is a dictionary with the following fields: * ``content`` (List[Dict]): Content box. * ``padding`` (List[Dict]): Padding box. * ``border`` (List[Dict]): Border box. * ``margin`` (List[Dict]): Margin box. * ``width`` (int): Element's width. * ``height`` (int): Element's height. Nrccontentpaddingrdmarginrerf)rjrkrdrlrerf)rAr'r9)rr<rcr r r!boxModels zElementHandle.boxModelcsrt||}d}|IdH}|stdt|jj}|d|dks,|d|dkrZt|dt |dt|dt |dd}t|}| ||j |IdHd}| IdH|IdH}|sntd|j dIdH}|d d } |d d } i} | || d | | d <| d | | d <d| i} | ||j| IdH} |r|j |IdH| S)zTake a screenshot of this element. If the element is detached from DOM, this method raises an ``ElementHandleError``. Available options are same as :meth:`pyppeteer.page.Page.screenshot`. FNr1rerf)rerfTzPage.getLayoutMetricsZlayoutViewportpageXpageYr3r4clip)r rir copydeepcopyrZviewportrhmathceilupdateZ setViewportr/rr& screenshot)rrMrNZneedsViewportResetriZoriginal_viewportZ newViewportZ new_viewport_objrnrorpoptZ imageDatar r r!rv'sX        zElementHandle.screenshotselectorcs:|jd||IdH}|}|r|S|IdHdS)zReturn first element which matches ``selector`` under this element. If no element matches the ``selector``, returns ``None``. z6(element, selector) => element.querySelector(selector)N)r,evaluateHandler#dispose)rryhandleelementr r r! querySelectoras zElementHandle.querySelectorc`|jd||IdH}|IdH}|IdHg}|D] }|}|r-||q |S)zReturn all elements which match ``selector`` under this element. If no element matches the ``selector``, returns empty list (``[]``). z9(element, selector) => element.querySelectorAll(selector)Nr,rzZ getPropertiesr{valuesr#r;)rry arrayHandle propertiesr<prop elementHandler r r!querySelectorAllps   zElementHandle.querySelectorAll pageFunctionargscsT||IdH}|std|d|jj||g|RIdH}|IdH|S)aRun ``Page.querySelectorEval`` within the element. This method runs ``document.querySelector`` within the element and passes it as the first argument to ``pageFunction``. If there is no element matching ``selector``, the method raises ``ElementHandleError``. If ``pageFunction`` returns a promise, then wait for the promise to resolve and return its value. ``ElementHandle.Jeval`` is a shortcut of this method. Example: .. code:: python tweetHandle = await page.querySelector('.tweet') assert (await tweetHandle.querySelectorEval('.like', 'node => node.innerText')) == 100 assert (await tweetHandle.Jeval('.retweets', 'node => node.innerText')) == 10 Nz1Error: failed to find element matching selector "")r~r r,r-r{)rryrrrr<r r r!querySelectorEvals zElementHandle.querySelectorEvalcsF|jd||IdH}|jj||g|RIdH}|IdH|S)a+Run ``Page.querySelectorAllEval`` within the element. This method runs ``Array.from(document.querySelectorAll)`` within the element and passes it as the first argument to ``pageFunction``. If there is no element matching ``selector``, the method raises ``ElementHandleError``. If ``pageFunction`` returns a promise, then wait for the promise to resolve and return its value. Example: .. code:: html
Hello!
Hi!
.. code:: python feedHandle = await page.J('.feed') assert (await feedHandle.JJeval('.tweet', '(nodes => nodes.map(n => n.innerText))')) == ['Hello!', 'Hi!'] zE(element, selector) => Array.from(element.querySelectorAll(selector))N)r,rzr-r{)rryrrrr<r r r!querySelectorAllEvals z"ElementHandle.querySelectorAllEval expressioncr)zEvaluate the XPath expression relative to this elementHandle. If there are no such elements, return an empty list. :arg str expression: XPath string to be evaluated. a(element, expression) => { const document = element.ownerDocument || element; const iterator = document.evaluate(expression, element, null, XPathResult.ORDERED_NODE_ITERATOR_TYPE); const array = []; let item; while ((item = iterator.iterateNext())) array.push(item); return array; }Nr)rrrrr<propertyrr r r!xpaths    zElementHandle.xpathcs|jd|IdHS)z:Return ``True`` if the element is visible in the viewport.a}async element => { const visibleRatio = await new Promise(resolve => { const observer = new IntersectionObserver(entries => { resolve(entries[0].intersectionRatio); observer.disconnect(); }); observer.observe(element); }); return visibleRatio > 0; }Nr[r"r r r!isIntersectingViewports z$ElementHandle.isIntersectingViewport)rr)rN)N)-__name__ __module__ __qualname____doc__rrdictrrr#rr+r/rr)floatr@rArintr9rKrOrXrYr\r`rbrirmbytesrvr~rrrJZJJZJevalZJJevalrZJxboolr __classcell__r r rr!rsd   ""      :   $rr>rcCs^d}t|D]&\}}||}||dt|}||d|d|d|dd7}q|S)Nrr2r3r4rB) enumeratelen)r>areai_p1p2r r r!r:s *r:)!rrqloggingrsos.pathrQtypingrrrrrZpyppeteer.connectionrZpyppeteer.execution_contextrr Zpyppeteer.errorsr r Zpyppeteer.helperr Zpyppeteer.utilr Zpyppeteer.frame_managerrr getLoggerrr8rrr:r r r r!s&    e