o _c6@sdZddlZddlmZddlmZddlmZmZm Z m Z m Z m Z ddl mZddlmZddlmZdd lmZdd lmZeeZGd d d eZGd ddeZdS)zBrowser module.N)Popen)SimpleNamespace)Any AwaitableCallableDictListOptional) EventEmitter) Connection) BrowserError)Page)TargetcseZdZdZedddddZ  d;ded eed e d e e d e e d e gedfdeddffdd Zede e fddZdBrowserzBrowser class. A Browser object is created when pyppeteer connects to chrome, either through :func:`~pyppeteer.launcher.launch` or :func:`~pyppeteer.launcher.connect`. targetcreatedtargetdestroyed targetchanged disconnected) TargetCreatedTargetDestroyed TargetChanged DisconnectedN connection contextIdsignoreHTTPSErrorsdefaultViewportprocess closeCallbackkwargsreturnc  st|_|_|_g_|_jjdtdffdd }|r)|_ n|_ t d_ t _ |D] } t | j | <q8t _jfddjdfddjdfd djd fd ddS) Nrcs}|d|SN) create_future set_result)fut)loop._dummy_callbackcstjjSr )emitrEventsrr%selfr%r&Bsz"Browser.__init__..zTarget.targetCreatedc|Sr ) create_task_targetCreatedeventr$r+r%r&r,FzTarget.targetDestroyedcr-r )r._targetDestroyedr0r2r%r&r,Jr3zTarget.targetInfoChangedcr-r )r._targetInfoChangedr0r2r%r&r,Nr3)super__init___ignoreHTTPSErrors_defaultViewport_process_screenshotTaskQueue _connection_loopr_closeCallbackBrowserContext_defaultContextdict _contexts_targetsZsetClosedCallbackon) r+rrrrrrrr' contextId __class__r2r&r7$s>      zBrowser.__init__cC|jS)zReturn process of this browser. If browser instance is created by :func:`pyppeteer.launcher.connect`, return ``None``. )r:r*r%r%r&rQszBrowser.processr?cstd|IdHS)zm[Deprecated] Miss spelled method. Use :meth:`createIncognitoBrowserContext` method instead. zWcreateIncogniteBrowserContext is deprecated. Use createIncognitoBrowserContext instead.N)loggerwarningcreateIncognitoBrowserContextr*r%r%r&createIncogniteBrowserContextZs z%Browser.createIncogniteBrowserContextcs4|jdIdH}|d}t||}||j|<|S)aCreate a new incognito browser context. This won't share cookies/cache with other browser contexts. .. code:: browser = await launch() # Create a new incognito browser context. context = await browser.createIncognitoBrowserContext() # Create a new page in a pristine context. page = await context.newPage() # Do stuff await page.goto('https://example.com') ... zTarget.createBrowserContextNbrowserContextId)r<sendr?rB)r+objrMcontextr%r%r&rKes   z%Browser.createIncognitoBrowserContextcCs|jgdd|jDS)zReturn a list of all open browser contexts. In a newly created browser, this will return a single instance of ``[BrowserContext]`` cSsg|]}|qSr%r%).0rPr%r%r& r3z+Browser.browserContexts..)r@rBvaluesr*r%r%r&browserContexts{szBrowser.browserContextsrEcs,|jdd|iIdH|j|ddS)NzTarget.disposeBrowserContextrM)r<rNrBpop)r+rEr%r%r&_disposeContexts  zBrowser._disposeContextcs.t||||||}|dddiIdH|S)zCreate browser object.zTarget.setDiscoverTargetsdiscoverTN)rrN)rrrrrrrbrowserr%r%r&creates zBrowser.creater1cs|dd}|r|jvrj|}nj}t|fddjjjjj}dj vr9t d|j d<|j IdHrX t jj|| tjj|dSdS)N targetInforMcs jSr )r<Z createSessionr%r+rZr%r&r,s z(Browser._targetCreated..targetIdz&target should not exist before create.)getrBr@rr8r9r;r<r=rCr _initializedPromiser(rr)rr?)r+r1rMrPtargetr%r[r&r/s,     zBrowser._targetCreatedcs`|j|d}|j|d=||jIdHr)|tjj||jtjj|| ddS)Nr\F) rCZ_closedCallbackr^r(rr)rbrowserContextr?_initializedCallback)r+r1r_r%r%r&r4s  zBrowser._targetDestroyedcsx|j|dd}|std|j}|j}||d|r8||jkr:|tjj ||j t jj |dSdSdS)NrZr\z,target should exist before targetInfoChanged) rCr]r url_isInitializedr5r(rr)rr`r?)r+r1r_Z previousURLZwasInitializedr%r%r&r5szBrowser._targetInfoChangedcCs|jjS)zReturn websocket end point url.)r<rbr*r%r%r& wsEndpointszBrowser.wsEndpointcs|jIdHS)z4Make new page on this browser and return its object.N)r@newPager*r%r%r&reszBrowser.newPagecsddi}|r ||d<|jd|IdHd}|j|}|dur&td|jIdHs0td|IdH}|dur?td|S)Nrbz about:blankrMzTarget.createTargetr\z!Failed to create target for page.zFailed to create page.)r<rNr]rCr r^page)r+rEoptionsr\r_rfr%r%r&_createPageInContexts$  zBrowser._createPageInContextcCsdd|jDS)zGet a list of all active targets inside the browser. In case of multiple browser contexts, the method will return a list with all the targets in all browser contexts. cSsg|]}|jr|qSr%)rc)rQr_r%r%r&rRs z#Browser.targets..)rCrSr*r%r%r&targetsszBrowser.targetscs,t}|jD] }||IdHq|S)aCGet all pages of this browser. Non visible pages, such as ``"background_page"``, will not be listed here. You can find then using :meth:`pyppeteer.target.Target.page`. In case of multiple browser contexts, this method will return a list with all the pages in all browser contexts. N)listrTextendpages)r+rlrPr%r%r&rls  z Browser.pagescs|IdH}|dS)zGet version of the browser.Nproduct) _getVersionr+versionr%r%r&rpszBrowser.versioncs|IdH}|ddS)zReturn browser's original user agent. .. note:: Pages can override browser user agent with :meth:`pyppeteer.page.Page.setUserAgent`. N userAgent)rnr]ror%r%r&rqs zBrowser.userAgentcs|IdHdS)z0Close connections and terminate browser process.N)r>r*r%r%r&closesz Browser.closecs6|jIdH|jD] }|js|dqdS)zDisconnect browser.NF)r<ZdisposerCrSrcra)r+r_r%r%r& disconnects zBrowser.disconnectcCs |jdS)NzBrowser.getVersion)r<rNr*r%r%r&rns zBrowser._getVersion)NN)rr?rN))__name__ __module__ __qualname____doc__rr)r rstrboolr rrrrrr7propertyrrLrKrTrV staticmethodrYr/r4r5rdr rerhrrirlrprqrsrtrn __classcell__r%r%rFr&rsx -        rcseZdZdZeddddZdedeedd ffd d Z de e fd d Z de e fddZdefddZdefddZde fddZedefddZdddZZS)r?aBrowserContext provides multiple independent browser sessions. When a browser is launched, it has a single BrowserContext used by default. The method `browser.newPage()` creates a page in the default browser context. If a page opens another page, e.g. with a ``window.open`` call, the popup will belong to the parent page's browser context. Pyppeteer allows creation of "incognito" browser context with ``browser.createIncognitoBrowserContext()`` method. "incognito" browser contexts don't write any browser data to disk. .. code:: # Create new incognito browser context context = await browser.createIncognitoBrowserContext() # Create a new page inside context page = await context.newPage() # ... do stuff with page ... await page.goto('https://example.com') # Dispose context once it's no longer needed await context.close() rrr)rrrrXrErNcst||_||_dSr )r6r7_browser_id)r+rXrErFr%r&r73s  zBrowserContext.__init__cCs,g}|jD] }|j|kr||q|S)z?Return a list of all active targets inside the browser context.)rrir`append)r+rir_r%r%r&ri8s   zBrowserContext.targetscs>g}|D]}|jdkr|IdH}|r||q|S)zReturn list of all open pages. Non-visible pages, such as ``"background_page"``, will not be listed here. You can find them using :meth:`pyppeteer.target.Target.page`. rfN)rityperfr)r+rlr_rfr%r%r&rl@s   zBrowserContext.pagescCstd|S)z[[Deprecated] Miss spelled method. Use :meth:`isIncognito` method instead. z3isIncognite is deprecated. Use isIncognito instead.)rIrJ isIncognitor*r%r%r& isIncogniteOszBrowserContext.isIncognitecCs t|jS)zReturn whether BrowserContext is incognito. The default browser context is the only non-incognito browser context. .. note:: The default browser context cannot be closed. )r{rr*r%r%r&rZs zBrowserContext.isIncognitocs|j|jIdHS)z)Create a new page in the browser context.N)rrhrr*r%r%r&redszBrowserContext.newPagecCrH)z3Return the browser this browser context belongs to.)rr*r%r%r&rXhszBrowserContext.browsercs,|jdur td|j|jIdHdS)zClose the browser context. All the targets that belongs to the browser context will be closed. .. note:: Only incognito browser context can be closed. Nz&Non-incognito profile cannot be closed)rr rrVr*r%r%r&rsms zBrowserContext.closeru)rvrwrxryrr)rr rzr7rrrir rlr{rrrer|rXrsr~r%r%rFr&r?s   r?)rylogging subprocessrtypesrtypingrrrrrr Zpyeer Zpyppeteer.connectionr Zpyppeteer.errorsr Zpyppeteer.pager Zpyppeteer.targetr getLoggerrvrIrr?r%r%r%r&s