tfIdZddlZddlZddlZddlZddlmZmZm Z m Z m Z ddl m Z ddlmZmZddlmZmZddlmZddlmZe rdd lmZmZej6eZGd d eZd e ed efdZ y)zElement handle module.N)AnyDictListOptional TYPE_CHECKING) CDPSession)ExecutionContextJSHandle)ElementHandleError NetworkError) debugError) merge_dict)Frame FrameManagerc eZdZdZdededededddd f fd Zd,d Z de d fd Z d-dZ de eeffdZde e fdZdeedee eeffdZd-dZd.dededd fdZdedefdZd-dZd-dZd.dede dedd fdZd.dede dedd fdZde e eeffdZde e fd Zd.de dedefd!Zd"ede dfd#Z d"ededfd$Z!d"ed%ed&edefd'Z"d"ed%ed&edefd(Z#e Z$e!Z%e"Z&e#Z'd)ededfd*Z(e(Z)de*fd+Z+xZ,S)/ 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 frameManagerrreturnNcnt||||||_||_||_||_d|_y)NF)super__init___client _remoteObject_page _frameManager _disposed)selfrrrrr __class__s b/var/www/html/software/conda/envs/higlass/lib/python3.12/site-packages/pyppeteer/element_handle.pyrzElementHandle.__init__(s; &,7 ) )c|S)zReturn this ElementHandle.r!s r# asElementzElementHandle.asElement2s r$rc,K|jjdd|jjdid{}|jdi}t |jdt sy|j j|dS7Tw)z|Return the content frame for the element handle. Return ``None`` if this handle is not referencing iframe. zDOM.describeNodeobjectIdNnodeframeId)rsendrget isinstancestrrframe)r!nodeInfonode_objs r# contentFramezElementHandle.contentFrame6s **+= **..z:@   <<+(,,y137!!''(;<<  s;BBABcK|jjd||jjd{}|r t |y7w)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; })executionContextevaluater_javascriptEnabledr )r!errors r#_scrollIntoViewIfNeededz%ElementHandle._scrollIntoViewIfNeededCsQ++446: 55;77< $U+ + =7s5A A A cKd} |jjdd|jjdid{}|r|jds tdg}|jdD]3}|j|}t|dkDs#|j|5|s td|d}d}d}|D]} || dz }|| dz }|d z |d z d S7#t$r}t t |Yd}~d}~wwxYww) NzDOM.getContentQuadsr*quads0Node is either not visible or not an HTMLElementrxyr?r@) rr-rr. Exceptionr loggerr _fromProtocolQuad_computeQuadAreaappend) r!resulter<_quad_qquadr?r@points r#_clickablePointzElementHandle._clickablePointes? "<<,,-BD..22:>EF VZZ0$BD DZZ( !E''.B#a' R  !$BD DQx   E sOA sOA UQ''3 " vq ! ! "sHD :C&C$C&AD A D $C&& D /D?D D  D cK |jjdd|jjdid{}|S7#t$r}t t |d}Yd}~|Sd}~wwxYww)NzDOM.getBoxModelr*)rr-rr.r r rD)r!rHrIs r# _getBoxModelzElementHandle._getBoxModelsq +/<<+<+<!T//33J?@,&F &  vq !F  s>A0:AAAA0A A-A("A0(A--A0rLcV|d|dd|d|dd|d|dd|d|d dgS) Nrr>rBrAr&)r!rLs r#rEzElementHandle._fromProtocolQuadsLq'Q (q'Q (q'Q (q'Q (   r$cK|jd{|jd{}|jdd}|jdd}|jjj ||d{y7o7Y7 w)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``. Nr?rr@)r:rNr.rmousemove)r!objr?r@s r#hoverzElementHandle.hoversx **,,,((** GGCO GGCOjj##Aq))) -* *2B BB BAB B B B  B optionskwargsc6Kt||}|jd{|jd{}|jdd}|jdd}|jj j |||d{y7p7Z7 w)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. Nr?rr@)rr:rNr.rrXclick)r!r]r^rZr?r@s r#r`zElementHandle.clicksWf-**,,,((** GGCO GGCOjj$$Q7333 -* 4s2 BBBBAB BBBB filePathscK|Dcgc]!}tjj|#}}|jj d}|j j d||dd{Scc}w7 w)z Upload files.r*zDOM.setFileInputFiles)r*filesN)ospathabspathrr.rr-)r!raprcr*s r# uploadFilezElementHandle.uploadFilesm-67#77%%))*5\\&& #!E 2   8 sA8&A1?A8,A6- A8cK|jd{|jd{}|jdd}|jdd}|jjj ||d{y7o7Y7 w)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``. Nr?rr@)r:rNr.r touchscreentap)r!centerr?r@s r#rkzElementHandle.tapsz **,,,++-- JJsA  JJsA jj$$((A... -- /r\cXK|jjd|d{y7w)zFocus on this element.zelement => element.focus()Nr6r7r's r#focuszElementHandle.focuss)##,, ($0 0 0s *(*textcKt||}|jd{|jjj ||d{y737w)zqFocus the element and then type text. Details see :meth:`pyppeteer.input.Keyboard.type` method. N)rrorkeyboardtype)r!rpr]r^s r#rszElementHandle.typesL Wf-jjljj!!&&tW555 5! AA-AAAAkeycKt||}|jd{|jjj ||d{y737w)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)rrorrrpress)r!rur]r^s r#rwzElementHandle.presssL"Wf-jjljj!!''W555 5rtc>K|jd{}|sy|dd}t|d|d|d|d}t|d|d |d |d }t|d|d|d|d|z }t|d|d |d |d |z }||||d S7w) 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. NmodelborderrrRrArUr>rSrTrV)r?r@widthheight)rPminmax)r!rHrLr?r@r{r|s r# boundingBoxzElementHandle.boundingBoxs((**gx( Qa$q'47 3 Qa$q'47 3DGT!Wd1gtAw7!;T!Wd1gtAwQ81<Q&AA+sBBBBcK|jd{}|sy|jdi}|j|jd|j|jd|j|jd|j|jd|jd|jdd S7w) 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. Nrycontentpaddingrzmarginr{r|)rrrzrr{r|)rPr.rE)r!rHrys r#boxModelzElementHandle.boxModels ((** 7B'--eii .BC--eii .BC,,UYYx-@A,,UYYx-@AYYw'ii)   +sCCB9Cc*Kt||}d}|jd{}|s tdtj|j j }|d|dkDs |d|dkDrt|dtj|dt|dtj|dd}tj|}|j||j j|d{d}|jd{|jd{}|s td|jjdd{}|d d } |d d } i} | j|| d | z| d <| d | z| d <d| i} | j||j j| d{} |r#|j j|d{| S77777777w)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`. FNr=r{r|)r{r|TzPage.getLayoutMetricslayoutViewportpageXpageYr?r@clip)rrr copydeepcopyrviewportr~mathceilupdate setViewportr:rr- screenshot)r!r]r^needsViewportResetroriginal_viewport newViewport new_viewport_objrrropt imageDatas r#rzElementHandle.screenshot's'Wf-" ,,.. $BD D!MM$***=*=>  #4W#= =H%(9((CC%g.IIk'23%h/IIk(34 K ==):;L    ,**((6 6 6!% **,,, ,,.. $BD D\\&&'>??%&w/%&w/ K I%S I%S tn 7**//44 **(():; ; ;[/* 7 -. @5 element.querySelector(selector)N)r6evaluateHandler(dispose)r!rhandleelements r# querySelectorzElementHandle.querySelectorasa ,,;; D (  ""$ Nnn  s!!AA+AAAAc:K|jjd||d{}|jd{}|jd{g}|j D]&}|j }|s|j |(|S7q7[7Ew)zReturn all elements which match ``selector`` under this element. If no element matches the ``selector``, returns empty list (``[]``). z9(element, selector) => element.querySelectorAll(selector)Nr6r getPropertiesrvaluesr(rG)r!r arrayHandle propertiesrHprop elementHandles r#querySelectorAllzElementHandle.querySelectorAllps !11@@ G (  '4466 !!###%%' -D NN,M m, -  7#7!BBBBBB+BBBB pageFunctionargscK|j|d{}|std|d|jj||g|d{}|j d{|S7U7 7 w)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 "")rr r6r7r)r!rrrrrHs r#querySelectorEvalzElementHandle.querySelectorEvals,#00:: $CH:QO 6t,,55 -0*.00##%%% ; 0%s3A3A-6A3A/A3&A1'A3/A31A3cK|jjd||d{}|jj||g|d{}|jd{|S7D7 7 w)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)r6rr7r)r!rrrrrHs r#querySelectorAllEvalz"ElementHandle.querySelectorAllEvals}4!11@@ S (  6t,,55 +.(,..!!###  .#s3!A.A(%A. A* A.!A,"A.*A.,A. expressionc:K|jjd||d{}|jd{}|jd{g}|j D]&}|j }|s|j |(|S7q7[7Ew)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)r!rrrrHpropertyrs r#xpathzElementHandle.xpaths!11@@   $ $ '4466 !!###"))+ -H$..0M m, - ' $7#rcVK|jjd|d{S7w)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; }Nrnr's r#isIntersectingViewportz$ElementHandle.isIntersectingViewports3**33 5     s )'))rr)rN)N)-__name__ __module__ __qualname____doc__r rdictrrr(rr4r:rr0floatrNrPrintrEr[r`rhrkrorsrwrrbytesrrrrrJJJJevalJJevalrJxboolr __classcell__)r"s@r#rrs!  0*#+.-26 =HW$5 = ,D(tCJ'7(< HTN  d3i Dc3h4H  *444#4$4* 3 4  /0 6s6T6C666s6T6C66*B8De,<#=B0  >88s8u8t C H_4M stO7L$3'*/2@!3!c!*-!25!H A B E !Fcd?.C: B d r$rrLrcd}t|D];\}}||}||dzt|z}||d|dz|d|dzz dz z }=|S)Nrr>r?r@rR) enumeratelen)rLareai_p1p2s r#rFrFss D$<1 !W 1q5CI% & C2c7"RWr#w%66!;;< Kr$)!rrloggingros.pathrdtypingrrrrrpyppeteer.connectionrpyppeteer.execution_contextr r pyppeteer.errorsr r pyppeteer.helperr pyppeteer.utilrpyppeteer.frame_managerrr getLoggerrrDrrrFr&r$r#rsk  ;;+B='%;   8 $_H_D4:%r$