Merge pull request #145 from autoscrape-labs/fix/type-text

fix: click in the input before typing and fix documentation

Author: thalissonvs

docs/api/commands/dom.md

@@ -55,4 +55,4 @@ The DOM commands module provides functions for:
 - `request_child_nodes()` - Get child elements
 
 !!! tip "High-Level APIs"
-    While these commands provide powerful low-level access, most users should use the higher-level `WebElement` class methods like `click()`, `type()`, and `get_attribute()` which use these commands internally. 
+    While these commands provide powerful low-level access, most users should use the higher-level `WebElement` class methods like `click()`, `type_text()`, and `get_attribute()` which use these commands internally. 

docs/api/commands/input.md

@@ -72,4 +72,4 @@ The input commands support human-like behavior patterns:
 - Pressure-sensitive touch events
 
 !!! tip "Element Methods"
-    For most use cases, use the higher-level element methods like `element.click()` and `element.type()` which provide a more convenient API and handle common scenarios automatically. 
+    For most use cases, use the higher-level element methods like `element.click()` and `element.type_text()` which provide a more convenient API and handle common scenarios automatically. 

docs/deep-dive/browser-domain.md

@@ -385,8 +385,8 @@ async def test_multiple_accounts():
         tab = await browser.new_tab("https://app.example.com/login", browser_context_id=context_id)
 
         # Login with account credentials
-        await tab.find(tag_name="input", name="username").type(account["username"])
-        await tab.find(tag_name="input", name="password").type(account["password"])
+        await tab.find(tag_name="input", name="username").type_text(account["username"])
+        await tab.find(tag_name="input", name="password").type_text(account["password"])
         await tab.find(tag_name="button", type="submit").click()
 
         contexts_and_tabs.append((context_id, tab, account["username"]))

docs/deep-dive/event-system.md

@@ -662,7 +662,7 @@ await tab.enable_page_events()
 async def handle_page_load(tab, event):
     print(f"Page loaded: {await tab.current_url}")
     # Perform actions after page load
-    await tab.find(id="search").type("pydoll")
+    await tab.find(id="search").type_text("pydoll")
 
 await tab.on(PageEvent.LOAD_EVENT_FIRED, partial(handle_page_load, tab))
 

docs/deep-dive/find-elements-mixin.md

@@ -652,10 +652,10 @@ Found elements are returned as WebElement instances that provide rich interactio
 ```python
 # Find and interact with form elements
 username = await tab.find(name="username")
-await username.type("[email protected]")
+await username.type_text("[email protected]")
 
 password = await tab.find(type="password")
-await password.type("secretpassword")
+await password.type_text("secretpassword")
 
 submit = await tab.find(tag_name="button", type="submit")
 await submit.click()

docs/deep-dive/tab-domain.md

@@ -507,8 +507,8 @@ tab3 = await browser.new_tab("https://github.com")
 
 # Work with different tabs
 await tab1.go_to("https://google.com")
-await tab2.find(id="search").type("Pydoll")
-await tab3.find(class_name="header-search-input").type("automation")
+await tab2.find(id="search").type_text("Pydoll")
+await tab3.find(class_name="header-search-input").type_text("automation")
 
 # Close specific tabs when done
 await tab2.close()

docs/features.md

@@ -487,7 +487,7 @@ async def iframe_interaction():
 
         # You can use all Tab methods on the frame
         form_input = await frame.find(id='captcha-input')
-        await form_input.type('verification-code')
+        await form_input.type_text('verification-code')
 
         # Find elements by various methods
         links = await frame.find(tag_name='a', find_all=True)

pydoll/elements/web_element.py

@@ -287,6 +287,7 @@ async def type_text(self, text: str, interval: float = 0.1):
 
         More realistic than insert_text() but slower.
         """
+        await self.click()
         for char in text:
             await self._execute_command(
                 InputCommands.dispatch_key_event(

tests/test_web_element.py

@@ -291,11 +291,13 @@ async def test_insert_text(self, input_element):
     async def test_type_text(self, input_element):
         """Test type_text method with character-by-character typing."""
         test_text = 'Hi'
+        input_element.click = AsyncMock()
         with patch('asyncio.sleep') as mock_sleep:
             await input_element.type_text(test_text, interval=0.05)
 
         # Should call execute_command for each character
         assert input_element._connection_handler.execute_command.call_count == len(test_text)
+        assert input_element.click.call_count == 1
 
         # Verify sleep was called between characters
         assert mock_sleep.call_count == len(test_text)
@@ -305,10 +307,12 @@ async def test_type_text(self, input_element):
     async def test_type_text_default_interval(self, input_element):
         """Test type_text with default interval."""
         test_text = 'A'
+        input_element.click = AsyncMock()
         with patch('asyncio.sleep') as mock_sleep:
             await input_element.type_text(test_text)
 
         mock_sleep.assert_called_with(0.1)  # Default interval
+        assert input_element.click.call_count == 1
 
 
 class TestWebElementKeyboardInteraction:
@@ -878,10 +882,12 @@ async def test_click_with_zero_hold_time(self, web_element):
     @pytest.mark.asyncio
     async def test_type_text_empty_string(self, input_element):
         """Test type_text with empty string."""
+        input_element.click = AsyncMock()
         await input_element.type_text('')
-        
+
         # Should not call execute_command for empty string
         input_element._connection_handler.execute_command.assert_not_called()
+        assert input_element.click.call_count == 1
 
     @pytest.mark.asyncio
     async def test_set_input_files_empty_list(self, file_input_element):