vchrome 0.0.0__py3-none-any.whl → 0.0.2__py3-none-any.whl

vchrome/__init__.py

@@ -1,4 +1,4 @@
-__version__ = '0.0.0'
+__version__ = '0.0.2'
 __author__ = 'v'
 # ----------------------------------------------------------------------------------------------------
 _allowed = {'Chrome'}
@@ -1100,7 +1100,7 @@ def cdp_client(hostname, port, debug=False):
                     raise Exception('wait show over time.')
                 time.sleep(0.08)
             if pretime:
-                time.sleep(pretime) # 组件出现时，可能事件并未挂上去，稍微等待一下
+                time.sleep(pretime) # When the component appears, the event might not have been attached yet. Please wait a moment.
         def drag(self, x=1, y=2, zero='center', button='left', count=1):
             self.wait_show()
             self._set_in_view()
@@ -1162,8 +1162,9 @@ def cdp_client(hostname, port, debug=False):
             self.wait_show()
             if try_use_img and self.className == 'HTMLImageElement':
                 try:
-                    # 如果是 <img> 标签，就尝试通过标签采集，采集不到再走屏幕截图。
-                    # 因为 img 标签的图片最好接近原生图片，这样效果会更好，当然也可以配置 try_use_img=False 直接关掉这种图片获取方式，就用截图，那样比较统一。
+                    # If it’s an <img> tag, try to capture it via the element first; if that fails, fall back to a screenshot.
+                    # Images from <img> tags are best captured as native images for better quality. 
+                    # Of course, you can also set try_use_img=False to disable this method and use screenshots only, which makes the process more uniform.
                     src = self['src']
                     if src:
                         if src.startswith('http'):
@@ -1362,9 +1363,19 @@ def cdp_client(hostname, port, debug=False):
                         _trav(snode)
             _trav(rnode)
             return clist
+        def _get_doc_tree(self):
+            start = perf_counter()
+            while True:
+                doc = self.f.cdp('DOM.getDocument', {'depth':-1, 'pierce':True})
+                if 'root' in doc:
+                    return doc
+                else:
+                    time.sleep(0.1)
+                if perf_counter() - start > 2:
+                    break
         def _get_flattened_node(self, nodeId=None):
             if nodeId == None:
-                rnode = self.f.cdp('DOM.getDocument', {'depth':-1, 'pierce':True})['root']
+                rnode = self._get_doc_tree()['root']
             else:
                 rnode = self.f.cdp('DOM.describeNode', {'nodeId':nodeId, 'depth':-1, 'pierce':True})['node']
             mnodes = {"nodes": self._trav_node_tree(rnode)}
@@ -1961,8 +1972,8 @@ def cdp_client(hostname, port, debug=False):
                 #     'sourcePort': 443,
                 #     'sourceScheme': 'Secure',
                 #     'value': '2826F2D60D5E56C841B9E33F82051E8A'},...]
-                # str 作用于当前 url 页面，只能在访问页面后执行。
-                # list 是用于完美还原 cookies 状态，可以在访问页面前执行。
+                # A str applies to the current URL page and can only be executed after visiting the page.
+                # A list is used to perfectly restore the cookies state and can be executed before visiting the page.
                 raise Exception('cookies must be (str/list/CookieManager)')
         def _get_remote_list(self):
             _self = self
@@ -2196,7 +2207,8 @@ def cdp_client(hostname, port, debug=False):
             else:
                 pf = finfo.get('parent')
                 if not pf:
-                    # 初始化阶段，frame 并没有进去对象管理时才可能走的分支
+                    # TODO
+                    # This branch is only taken during the initialization phase, when the frame has not yet entered object management.
                     return
                 lf = AbsFrame(rootf, {
                     "contextId": finfo.get("contextId"),
@@ -2551,13 +2563,13 @@ class Chrome:
                 height: '5px',
                 backgroundColor: 'red',
                 borderRadius: '50%',
-                pointerEvents: 'none',       // 禁止鼠标交互
-                userSelect: 'none',          // 禁止选中
-                webkitUserSelect: 'none',    // Safari 兼容
-                mozUserSelect: 'none',       // Firefox 兼容
-                msUserSelect: 'none',        // IE/Edge 兼容
-                zIndex: '2147483647',        // 最大 z-index 确保置顶
-                willChange: 'transform',     // 优化渲染性能
+                pointerEvents: 'none',
+                userSelect: 'none',
+                webkitUserSelect: 'none',
+                mozUserSelect: 'none',
+                msUserSelect: 'none',
+                zIndex: '2147483647',
+                willChange: 'transform',
               });
               document.body.appendChild(nDiv)
               setTimeout(function(){ nDiv.remove(); },1000)

{vchrome-0.0.0.dist-info → vchrome-0.0.2.dist-info}/METADATA

@@ -1,3 +1,3 @@
 Metadata-Version: 2.4
 Name: vchrome
-Version: 0.0.0
+Version: 0.0.2

vchrome-0.0.2.dist-info/RECORD

@@ -0,0 +1,5 @@
+vchrome/__init__.py,sha256=GaD-j4I3g4mHbDtGiCd8-5M7iXKaC7CWJiXqJH_XXyk,205606
+vchrome-0.0.2.dist-info/METADATA,sha256=irZzBMagQl2VCh9fQTf-sLyWJOLcc2f0P4TWbvRpRBM,54
+vchrome-0.0.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+vchrome-0.0.2.dist-info/top_level.txt,sha256=oB919Fa09PCy48Ptj8iy-1QUcvhEeY97MOR42281Fk0,8
+vchrome-0.0.2.dist-info/RECORD,,

vchrome-0.0.0.dist-info/RECORD

@@ -1,5 +0,0 @@
-vchrome/__init__.py,sha256=0kIovhQyN2I2MGbc7GfqQxZoEBPxN4ALaiL5fk8utX8,205268
-vchrome-0.0.0.dist-info/METADATA,sha256=Ir4Nm9UhfuSB1-rBnjIcDSXOsLBOAN1OvjIpNcyXBa4,54
-vchrome-0.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-vchrome-0.0.0.dist-info/top_level.txt,sha256=oB919Fa09PCy48Ptj8iy-1QUcvhEeY97MOR42281Fk0,8
-vchrome-0.0.0.dist-info/RECORD,,