pydoll-python 2.15.1__tar.gz → 2.16.0__tar.gz

{pydoll_python-2.15.1 → pydoll_python-2.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pydoll-python
-Version: 2.15.1
+Version: 2.16.0
 Summary: Pydoll is a library for automating chromium-based browsers without a WebDriver, offering realistic interactions.
 License-File: LICENSE
 Author: Thalison Fernandes

{pydoll_python-2.15.1 → pydoll_python-2.16.0}/pydoll/browser/chromium/base.py

@@ -906,9 +906,9 @@ class Browser(ABC):  # noqa: PLR0904
     def _validate_ws_address(ws_address: str):
         """Validate WebSocket address."""
         min_slashes = 4
-        if not ws_address.startswith('ws://'):
-            logger.error('Invalid WebSocket address: missing ws:// prefix')
-            raise InvalidWebSocketAddress('WebSocket address must start with ws://')
+        if not ws_address.startswith(('ws://', 'wss://')):
+            logger.error('Invalid WebSocket address: missing ws:// or wss:// prefix')
+            raise InvalidWebSocketAddress('WebSocket address must start with ws:// or wss://')
         if len(ws_address.split('/')) < min_slashes:
             logger.error('Invalid WebSocket address: not enough slashes')
             raise InvalidWebSocketAddress(

{pydoll_python-2.15.1 → pydoll_python-2.16.0}/pydoll/browser/tab.py

@@ -34,7 +34,7 @@ from pydoll.commands import (
     StorageCommands,
 )
 from pydoll.connection import ConnectionHandler
-from pydoll.constants import By
+from pydoll.constants import By, PageLoadState
 from pydoll.elements.mixins import FindElementsMixin
 from pydoll.exceptions import (
     DownloadTimeout,
@@ -104,6 +104,8 @@ class Tab(FindElementsMixin):
     like Cloudflare bypass.
     """
 
+    _READY_STATE_ORDER = (PageLoadState.LOADING, PageLoadState.INTERACTIVE, PageLoadState.COMPLETE)
+
     def __init__(
         self,
         browser: Browser,
@@ -231,6 +233,14 @@ class Tab(FindElementsMixin):
         )
         return response['result']['result']['value']
 
+    @property
+    async def title(self) -> str:
+        """Get current page title."""
+        response: EvaluateResponse = await self._execute_command(
+            RuntimeCommands.evaluate('document.title')
+        )
+        return response['result']['result'].get('value', '')
+
     async def enable_page_events(self):
         """Enable CDP Page domain events (load, navigation, dialogs, etc.)."""
         logger.debug('Enabling Page events')
@@ -1409,17 +1419,28 @@ class Tab(FindElementsMixin):
         """
         Wait for page to finish loading.
 
+        Waits until ``document.readyState`` reaches **at least** the level
+        configured in ``browser.options.page_load_state``.  For example, when
+        the target state is ``interactive``, both ``"interactive"`` and
+        ``"complete"`` satisfy the condition — this prevents an infinite
+        polling loop when the page transitions past ``interactive`` before the
+        first check runs.
+
         Raises:
-            asyncio.TimeoutError: If page doesn't load within timeout.
+            WaitElementTimeout: If page doesn't load within *timeout* seconds.
         """
+        target_state = self._browser.options.page_load_state.value
+        target_index = self._READY_STATE_ORDER.index(target_state)
         start_time = asyncio.get_event_loop().time()
         logger.debug(f'Waiting for page load (timeout={timeout}s)')
         while True:
             response: EvaluateResponse = await self._execute_command(
                 RuntimeCommands.evaluate(expression='document.readyState')
             )
-            if response['result']['result']['value'] == self._browser.options.page_load_state.value:
-                logger.debug(f'Page load state reached: {self._browser.options.page_load_state}')
+            current_state = response['result']['result']['value']
+            current_index = self._READY_STATE_ORDER.index(current_state)
+            if current_index >= target_index:
+                logger.debug(f'Page load state reached: {current_state} (target: {target_state})')
                 break
             if asyncio.get_event_loop().time() - start_time > timeout:
                 raise WaitElementTimeout('Page load timed out')

{pydoll_python-2.15.1 → pydoll_python-2.16.0}/pydoll/constants.py

@@ -13,6 +13,7 @@ class By(str, Enum):
 class PageLoadState(str, Enum):
     COMPLETE = 'complete'
     INTERACTIVE = 'interactive'
+    LOADING = 'loading'
 
 
 class ScrollPosition(str, Enum):
@@ -436,6 +437,30 @@ new Promise((resolve) => {{
     }
     """
 
+    CLEAR_INPUT = """
+    function() {
+        const el = this;
+
+        // Standard input/textarea
+        if (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA') {
+            el.value = '';
+            el.dispatchEvent(new Event('input', { bubbles: true }));
+            el.dispatchEvent(new Event('change', { bubbles: true }));
+            return true;
+        }
+
+        // ContentEditable elements
+        if (el.isContentEditable) {
+            el.focus();
+            el.innerHTML = '';
+            el.dispatchEvent(new Event('input', { bubbles: true }));
+            return true;
+        }
+
+        return false;
+    }
+    """
+
     IS_EDITABLE = """
     function() {
         const el = this;

{pydoll_python-2.15.1 → pydoll_python-2.16.0}/pydoll/elements/mixins/find_elements_mixin.py

@@ -646,11 +646,11 @@ class FindElementsMixin:
     async def _execute_command(
         self, command: Command[T_CommandParams, T_CommandResponse]
     ) -> T_CommandResponse:
-        """Execute CDP command via resolved handler (60s timeout)."""
+        """Execute CDP command via resolved handler (10s timeout)."""
         handler, session_id = self._resolve_routing()
         if session_id:
             command['sessionId'] = session_id
-        return await handler.execute_command(command, timeout=60)
+        return await handler.execute_command(command, timeout=10)
 
     def _get_find_element_command(
         self,

{pydoll_python-2.15.1 → pydoll_python-2.16.0}/pydoll/elements/web_element.py

@@ -123,6 +123,11 @@ class WebElement(FindElementsMixin):  # noqa: PLR0904
             self._iframe_resolver = IFrameContextResolver(self)
         return self._iframe_resolver
 
+    @property
+    def attributes(self) -> dict[str, str]:
+        """Read-only copy of the element's cached attributes."""
+        return dict(self._attributes)
+
     @property
     def value(self) -> Optional[str]:
         """Element's value attribute (for form elements)."""
@@ -530,6 +535,25 @@ class WebElement(FindElementsMixin):  # noqa: PLR0904
         await asyncio.sleep(hold_time)
         await self._connection_handler.execute_command(release_command)
 
+    async def clear(self):
+        """
+        Clear the current value of the element.
+
+        Supports standard inputs, textareas, and contenteditable elements.
+        Dispatches ``input`` and ``change`` events so frameworks detect the update.
+
+        Raises:
+            ElementNotInteractable: If the element does not accept text input.
+        """
+        logger.info('Clearing element value')
+        result = await self.execute_script(Scripts.CLEAR_INPUT, return_by_value=True)
+        success = result['result'].get('result', {}).get('value', False)
+        if not success:
+            logger.error('Element does not accept text input')
+            raise ElementNotInteractable('Element does not accept text input')
+        if self._attributes.get('tag_name', '').lower() in {'input', 'textarea'}:
+            self._attributes['value'] = ''
+
     async def insert_text(self, text: str):
         """
         Insert text into element using JavaScript.

{pydoll_python-2.15.1 → pydoll_python-2.16.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "pydoll-python"
-version = "2.15.1"
+version = "2.16.0"
 description = "Pydoll is a library for automating chromium-based browsers without a WebDriver, offering realistic interactions."
 authors = ["Thalison Fernandes <thalissfernandes99@gmail.com>"]
 readme = "README.md"