முக்கிய உள்ளடக்கத்திற்குச் செல்லவும்

கருவிகள்

பின்வரும் கருவிகள் WebdriverIO MCP சேவையகம் மூலம் கிடைக்கின்றன. இந்த கருவிகள் செயற்கை நுண்ணறிவு உதவியாளர்கள் உலாவிகள் மற்றும் மொபைல் பயன்பாடுகளை தானியங்குபடுத்த உதவுகின்றன.

அமர்வு மேலாண்மை

start_browser

Chrome உலாவி அமர்வைத் தொடங்குகிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்இயல்புநிலைவிளக்கம்
headlessbooleanஇல்லைfalseChrome-ஐ headless முறையில் இயக்கவும்
windowWidthnumberஇல்லை1920உலாவி சாளர அகலம் (400-3840)
windowHeightnumberஇல்லை1080உலாவி சாளர உயரம் (400-2160)
navigationUrlstringஇல்லை-உலாவியைத் தொடங்கிய பின் செல்ல வேண்டிய URL

எடுத்துக்காட்டு

Start a browser with 1920x1080 resolution and navigate to webdriver.io

ஆதரவு

  • டெஸ்க்டாப் உலாவிகள்

start_app_session

Appium மூலம் iOS அல்லது Android இல் மொபைல் செயலி அமர்வைத் தொடங்குகிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்இயல்புநிலைவிளக்கம்
platformstringஆம்-தானியங்குபடுத்த தளம்: iOS அல்லது Android
deviceNamestringஆம்-சாதனம் அல்லது சிமுலேட்டர்/எமுலேட்டரின் பெயர்
appPathstringஇல்லை*-செயலி கோப்புக்கான பாதை (.app, .ipa, அல்லது .apk)
platformVersionstringஇல்லை-OS பதிப்பு (எ.கா., 17.0, 14)
automationNamestringஇல்லைAutoXCUITest (iOS), UiAutomator2 அல்லது Espresso (Android)
udidstringஇல்லை-தனித்துவமான சாதன அடையாளம் (உண்மையான iOS சாதனங்களுக்கு தேவை)
noResetbooleanஇல்லைfalseஅமர்வுகளுக்கிடையே செயலி நிலையைப் பாதுகாக்கவும்
fullResetbooleanஇல்லைtrueஅமர்வுக்கு முன் செயலியை நிறுவல் நீக்கம் செய்து மீண்டும் நிறுவவும்
autoGrantPermissionsbooleanஇல்லைtrueதானாகவே செயலி அனுமதிகளை வழங்கவும்
autoAcceptAlertsbooleanஇல்லைtrueசிஸ்டம் எச்சரிக்கைகளை தானாகவே ஏற்கவும்
autoDismissAlertsbooleanஇல்லைfalseஎச்சரிக்கைகளை நிராகரிக்கவும் (ஏற்பதற்குப் பதிலாக)
appWaitActivitystringஇல்லை-தொடக்கத்தில் காத்திருக்க வேண்டிய செயல்பாடு (Android மட்டும்)
newCommandTimeoutnumberஇல்லை60செயல்பாடின்மை காரணமாக அமர்வு நேரம் முடிவதற்கு முன் உள்ள வினாடிகள்
appiumHoststringஇல்லை127.0.0.1Appium சேவையக ஹோஸ்ட்பெயர்
appiumPortnumberஇல்லை4723Appium சேவையக போர்ட்
appiumPathstringஇல்லை/Appium சேவையக பாதை

*ஒன்று appPath வழங்கப்பட வேண்டும், அல்லது ஏற்கனவே இயங்கும் செயலியுடன் இணைக்க noReset: true இருக்க வேண்டும்.

எடுத்துக்காட்டு

Start an iOS app session on iPhone 15 simulator with my app at /path/to/app.app

ஆதரவு

  • iOS சிமுலேட்டர்கள்
  • iOS உண்மை சாதனங்கள்
  • Android எமுலேட்டர்கள்
  • Android உண்மை சாதனங்கள்

close_session

தற்போதைய உலாவி அல்லது செயலி அமர்வை மூடுகிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்இயல்புநிலைவிளக்கம்
detachbooleanஇல்லைfalseஅமர்வை மூடாமல் பிரிக்கவும் (உலாவி/செயலி இயங்குவதைத் தொடரும்)

குறிப்புகள்

noReset: true அல்லது appPath இல்லாத அமர்வுகள் நிலையைப் பாதுகாக்க மூடும்போது தானாகவே பிரிக்கின்றன.

ஆதரவு

  • டெஸ்க்டாப் உலாவிகள்
  • மொபைல் செயலிகள்

வழிசெலுத்தல்

ஒரு URL-க்கு வழிசெலுத்துகிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்விளக்கம்
urlstringஆம்வழிசெலுத்த வேண்டிய URL

எடுத்துக்காட்டு

Navigate to https://webdriver.io

ஆதரவு

  • டெஸ்க்டாப் உலாவிகள்

தனிமம் ஊடாடல்

click_element

தேர்வி மூலம் அடையாளம் காணப்பட்ட தனிமத்தைக் கிளிக் செய்கிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்இயல்புநிலைவிளக்கம்
selectorstringஆம்-CSS தேர்வி, XPath, அல்லது மொபைல் தேர்வி
scrollToViewbooleanஇல்லைtrueகிளிக் செய்வதற்கு முன் தனிமத்தை காட்சிக்கு ஸ்க்ரோல் செய்யவும்
timeoutnumberஇல்லை3000தனிமத்திற்காக காத்திருக்க அதிகபட்ச நேரம் (மில்லி வினாடிகள்)

குறிப்புகள்

  • WebdriverIO உரை தேர்விகளை ஆதரிக்கிறது: button=Exact text அல்லது a*=Contains text
  • ஸ்க்ரோல் நிலைப்படுத்தலுக்கு மைய சீரமைப்பைப் பயன்படுத்துகிறது

எடுத்துக்காட்டு

Click the element with selector "#submit-button"

ஆதரவு

  • டெஸ்க்டாப் உலாவிகள்
  • மொபைல் நேட்டிவ் செயலிகள்

set_value

உள்ளீட்டு புலத்தில் உரையை தட்டச்சு செய்கிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்இயல்புநிலைவிளக்கம்
selectorstringஆம்-உள்ளீட்டு தனிமத்திற்கான தேர்வி
valuestringஆம்-தட்டச்சு செய்ய வேண்டிய உரை
scrollToViewbooleanஇல்லைtrueதட்டச்சு செய்வதற்கு முன் தனிமத்தை காட்சிக்கு ஸ்க்ரோல் செய்யவும்
timeoutnumberஇல்லை3000தனிமத்திற்காக காத்திருக்க அதிகபட்ச நேரம் (மில்லி வினாடிகள்)

குறிப்புகள்

புதிய உரையை தட்டச்சு செய்வதற்கு முன் இருக்கும் மதிப்பை அழிக்கிறது.

எடுத்துக்காட்டு

Set the value "john@example.com" in the element with selector "#email"

ஆதரவு

  • டெஸ்க்டாப் உலாவிகள்
  • மொபைல் நேட்டிவ் செயலிகள்

பக்க பகுப்பாய்வு

get_visible_elements

தற்போதைய பக்கம் அல்லது திரையில் தெரியக்கூடிய மற்றும் ஊடாடக்கூடிய தனிமங்களைப் பெறுகிறது. ஊடாடலுக்கு எந்த தனிமங்கள் கிடைக்கின்றன என்பதைக் கண்டறிவதற்கான முதன்மைக் கருவி இதுவாகும்.

அளவுருக்கள்

அளவுருவகைகட்டாயம்இயல்புநிலைவிளக்கம்
elementTypestringஇல்லைinteractableதனிமங்களின் வகை: interactable (பொத்தான்கள்/இணைப்புகள்/உள்ளீடுகள்), visual (படங்கள்/SVGகள்), அல்லது all
inViewportOnlybooleanஇல்லைtrueவியூபோர்ட்டில் தெரியும் தனிமங்களை மட்டும் திருப்பி அளிக்கவும்
includeContainersbooleanஇல்லைfalseதள அமைப்பு கொள்கலன்களையும் சேர்க்கவும் (ViewGroup, ScrollView போன்றவை)
includeBoundsbooleanஇல்லைfalseதனிம ஆயத்தொலைவுகளை சேர்க்கவும் (x, y, width, height)
limitnumberஇல்லை0திருப்பி அளிக்க அதிகபட்ச தனிமங்கள் (0 = வரம்பற்றது)
offsetnumberஇல்லை0தவிர்க்க வேண்டிய தனிமங்களின் எண்ணிக்கை (பக்கமாற்றத்திற்கு)

திருப்பி அளிக்கப்படுபவை

{
"total": 42,
"showing": 20,
"hasMore": true,
"elements": [...]
}

வெப் தனிமங்களில் அடங்குபவை: tagName, type, id, className, textContent, value, placeholder, href, ariaLabel, role, cssSelector, isInViewport

மொபைல் தனிமங்களில் அடங்குபவை: பல இருப்பிட உத்திகள் (accessibility ID, resource ID, XPath, UiAutomator/predicates), தனிம வகை, உரை, மற்றும் விருப்பமாக எல்லைகள்

குறிப்புகள்

  • வெப்: வேகமான தனிம கண்டறிதலுக்கு உகந்த உலாவி ஸ்கிரிப்டைப் பயன்படுத்துகிறது
  • மொபைல்: திறமையான XML பக்க மூல பகுப்பாய்வைப் பயன்படுத்துகிறது (தனிம வினவல்களுக்கு 600+ HTTP அழைப்புகளுக்குப் பதிலாக 2 HTTP அழைப்புகள்)
  • பெரிய பக்கங்களுக்கு டோக்கன் பயன்பாட்டைக் குறைக்க பக்கமாற்றத்தைப் (limit மற்றும் offset) பயன்படுத்தவும்

எடுத்துக்காட்டு

Get all visible elements on the page with their coordinates

ஆதரவு

  • டெஸ்க்டாப் உலாவிகள்
  • மொபைல் செயலிகள்

get_accessibility

தற்போதைய பக்கத்தின் அணுகல்தன்மை மரத்தை பங்குகள், பெயர்கள் மற்றும் நிலைகள் பற்றிய சொற்பொருள் தகவலுடன் பெறுகிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்இயல்புநிலைவிளக்கம்
limitnumberஇல்லை100திருப்பி அளிக்க அதிகபட்ச நோடுகள் (0 = வரம்பற்றது)
offsetnumberஇல்லை0தவிர்க்க வேண்டிய நோடுகளின் எண்ணிக்கை (பக்கமாற்றத்திற்கு)
rolesstring[]இல்லைஅனைத்தும்குறிப்பிட்ட பங்குகளுக்கு வடிகட்டவும் (எ.கா., ["button", "link", "textbox"])
namedOnlybooleanஇல்லைtrueபெயர்/லேபிள் கொண்ட நோடுகளை மட்டும் திருப்பி அளிக்கவும்

திருப்பி அளிக்கப்படுபவை

{
"total": 85,
"showing": 100,
"hasMore": false,
"nodes": [
{ "role": "button", "name": "Submit" },
{ "role": "link", "name": "Home" }
]
}

குறிப்புகள்

  • உலாவிக்கு மட்டுமே. மொபைல் செயலிகளுக்கு, அதற்கு பதிலாக get_visible_elements பயன்படுத்தவும்
  • get_visible_elements எதிர்பார்த்த தனிமங்களைத் திருப்பி அளிக்காதபோது பயனுள்ளதாக இருக்கும்
  • namedOnly: true அநாமதேய கொள்கலன்களை வடிகட்டி சத்தத்தைக் குறைக்கிறது

ஆதரவு

  • டெஸ்க்டாப் உலாவிகள்

திரைக்காட்சிகள்

take_screenshot

தற்போதைய காட்சிப்புலத்தின் திரைக்காட்சியைக் கைப்பற்றுகிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்விளக்கம்
outputPathstringஇல்லைதிரைக்காட்சி கோப்பை சேமிக்க பாதை. விடப்பட்டால், base64 தரவைத் திருப்பி அளிக்கிறது

திருப்பி அளிக்கப்படுபவை

அளவு தகவலுடன் Base64-குறியாக்கப்பட்ட படத் தரவு (PNG அல்லது JPEG).

குறிப்புகள்

திரைக்காட்சிகள் தானாகவே உகந்ததாக்கப்படுகின்றன:

  • அதிகபட்ச பரிமாணம்: 2000px (பெரிதாக இருந்தால் அளவிடப்படும்)
  • அதிகபட்ச கோப்பு அளவு: 1MB
  • வடிவம்: அதிகபட்ச சுருக்கத்துடன் PNG, அல்லது அளவு வரம்பை பூர்த்தி செய்ய தேவைப்பட்டால் JPEG

ஆதரவு

  • டெஸ்க்டாப் உலாவிகள்
  • மொபைல் செயலிகள்

ஸ்க்ரோலிங்

scroll

பக்கத்தை குறிப்பிட்ட பிக்செல்கள் அளவிற்கு மேலே அல்லது கீழே ஸ்க்ரோல் செய்கிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்இயல்புநிலைவிளக்கம்
directionstringஆம்-ஸ்க்ரோல் திசை: up அல்லது down
pixelsnumberஇல்லை500ஸ்க்ரோல் செய்ய வேண்டிய பிக்செல்களின் எண்ணிக்கை

குறிப்புகள்

உலாவிக்கு மட்டுமே. மொபைல் ஸ்க்ரோலிங்கிற்கு, அதற்கு பதிலாக swipe கருவியைப் பயன்படுத்தவும்.

ஆதரவு

  • டெஸ்க்டாப் உலாவிகள்

குக்கீ மேலாண்மை

get_cookies

தற்போதைய அமர்விலிருந்து குக்கீகளைப் பெறுகிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்விளக்கம்
namestringஇல்லைகுறிப்பிட்ட குக்கீ பெயரை பெற (அனைத்து குக்கீகளுக்கும் விடவும்)

திருப்பி அளிக்கப்படுபவை

name, value, domain, path, expiry, secure, மற்றும் httpOnly பண்புகளைக் கொண்ட குக்கீ பொருள்கள்.

ஆதரவு

  • டெஸ்க்டாப் உலாவிகள்

தற்போதைய அமர்வில் ஒரு குக்கீயை அமைக்கிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்இயல்புநிலைவிளக்கம்
namestringஆம்-குக்கீ பெயர்
valuestringஆம்-குக்கீ மதிப்பு
domainstringஇல்லைதற்போதையதுகுக்கீ டொமைன்
pathstringஇல்லை/குக்கீ பாதை
expirynumberஇல்லை-யூனிக்ஸ் டைம்ஸ்டாம்பாக காலாவதி (வினாடிகள்)
securebooleanஇல்லை-பாதுகாப்பு கொடி
httpOnlybooleanஇல்லை-HttpOnly கொடி
sameSitestringஇல்லை-SameSite பண்பு: strict, lax, அல்லது none

ஆதரவு

  • டெஸ்க்டாப் உலாவிகள்

delete_cookies

தற்போதைய அமர்விலிருந்து குக்கீகளை நீக்குகிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்விளக்கம்
namestringஇல்லைநீக்க வேண்டிய குறிப்பிட்ட குக்கீ பெயர் (அனைத்தையும் நீக்க விடவும்)

ஆதரவு

  • டெஸ்க்டாப் உலாவிகள்

தொடு சைகைகள் (மொபைல்)

tap_element

ஒரு தனிமம் அல்லது திரை ஆயத்தொலைவுகளைத் தட்டுகிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்விளக்கம்
selectorstringஇல்லை*தட்ட வேண்டிய தனிமத்திற்கான தேர்வி
xnumberஇல்லை*தட்டுவதற்கான X ஆயத்தொலைவு
ynumberஇல்லை*தட்டுவதற்கான Y ஆயத்தொலைவு

*ஒன்று selector அல்லது x மற்றும் y இரண்டும் தேவைப்படுகிறது.

ஆதரவு

  • மொபைல் செயலிகள்

swipe

குறிப்பிட்ட திசையில் ஒரு ஸ்வைப் சைகையைச் செய்கிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்இயல்புநிலைவிளக்கம்
directionstringஆம்-ஸ்வைப் திசை: up, down, left, right
durationnumberஇல்லை500மில்லி வினாடிகளில் ஸ்வைப் கால அளவு (100-5000)
percentnumberஇல்லை0.5/0.95ஸ்வைப் செய்ய வேண்டிய திரையின் சதவீதம் (0-1)

குறிப்புகள்

  • இயல்புநிலை சதவீதம்: செங்குத்து ஸ்வைப்களுக்கு 0.5, கிடைமட்ட ஸ்வைப்களுக்கு 0.95
  • திசை உள்ளடக்க இயக்கத்தைக் குறிக்கிறது: "மேலே ஸ்வைப்" உள்ளடக்கத்தை மேலே ஸ்க்ரோல் செய்கிறது

எடுத்துக்காட்டு

Swipe up to scroll down the screen

ஆதரவு

  • மொபைல் செயலிகள்

drag_and_drop

ஒரு தனிமத்தை மற்றொரு தனிமத்திற்கு அல்லது ஆயத்தொலைவுகளுக்கு இழுக்கிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்விளக்கம்
sourceSelectorstringஆம்இழுக்க வேண்டிய மூல தனிமத் தேர்வி
targetSelectorstringஇல்லை*விட வேண்டிய இலக்கு தனிமத் தேர்வி
xnumberஇல்லை*இலக்கு X ஆஃப்செட் (targetSelector இல்லை என்றால்)
ynumberஇல்லை*இலக்கு Y ஆஃப்செட் (targetSelector இல்லை என்றால்)
durationnumberஇல்லைஇயல்புநிலை

*ஒன்று targetSelector அல்லது x மற்றும் y இரண்டும் தேவைப்படுகிறது.

ஆதரவு

  • மொபைல் செயலிகள்

செயலி வாழ்க்கை சுழற்சி (மொபைல்)

get_app_state

ஒரு செயலியின் தற்போதைய நிலையைப் பெறுகிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்விளக்கம்
bundleIdstringஆம்செயலி அடையாளங்காட்டி (iOS-க்கு bundle ID, Android-க்கு package name)

திருப்பி அளிக்கப்படுபவை

செயலி நிலை: not installed, not running, running in background (suspended), running in background, அல்லது running in foreground.

ஆதரவு

  • மொபைல் செயலிகள்

சூழல் மாற்றம் (ஹைபிரிட் செயலிகள்)

get_contexts

கிடைக்கக்கூடிய அனைத்து சூழல்களையும் (நேட்டிவ் மற்றும் வெப்வியூகள்) பட்டியலிடுகிறது.

அளவுருக்கள்

எதுவும் இல்லை

திருப்பி அளிக்கப்படுபவை

சூழல் பெயர்களின் வரிசை (எ.கா., ["NATIVE_APP", "WEBVIEW_com.example.app"]).

ஆதரவு

  • மொபைல் ஹைபிரிட் செயலிகள்

get_current_context

தற்போது செயலில் உள்ள சூழலைப் பெறுகிறது.

அளவுருக்கள்

எதுவும் இல்லை

திருப்பி அளிக்கப்படுபவை

தற்போதைய சூழல் பெயர் (எ.கா., NATIVE_APP அல்லது WEBVIEW_*).

ஆதரவு

  • மொபைல் ஹைபிரிட் செயலிகள்

switch_context

நேட்டிவ் மற்றும் வெப்வியூ சூழல்களுக்கிடையே மாறுகிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்விளக்கம்
contextstringஆம்get_contexts-இலிருந்து சூழல் பெயர் அல்லது குறியீடு (1-அடிப்படையில்)

எடுத்துக்காட்டு

Switch to the WEBVIEW_com.example.app context

ஆதரவு

  • மொபைல் ஹைபிரிட் செயலிகள்

சாதன கட்டுப்பாடு (மொபைல்)

rotate_device

சாதனத்தை ஒரு குறிப்பிட்ட நோக்குநிலைக்கு சுழற்றுகிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்விளக்கம்
orientationstringஆம்PORTRAIT அல்லது LANDSCAPE

ஆதரவு

  • மொபைல் செயலிகள்

hide_keyboard

திரையில் தோன்றும் விசைப்பலகையை மறைக்கிறது.

அளவுருக்கள்

எதுவும் இல்லை

ஆதரவு

  • மொபைல் செயலிகள்

get_geolocation

தற்போதைய GPS ஆயத்தொலைவுகளைப் பெறுகிறது.

அளவுருக்கள்

எதுவும் இல்லை

திருப்பி அளிக்கப்படுபவை

latitude, longitude, மற்றும் altitude கொண்ட பொருள்.

ஆதரவு

  • மொபைல் செயலிகள்

set_geolocation

சாதன GPS ஆயத்தொலைவுகளை அமைக்கிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்விளக்கம்
latitudenumberஆம்அட்சரேகை ஆயத்தொலைவு (-90 முதல் 90 வரை)
longitudenumberஆம்தீர்க்கரேகை ஆயத்தொலைவு (-180 முதல் 180 வரை)
altitudenumberஇல்லைமீட்டர்களில் உயரம்

எடுத்துக்காட்டு

Set geolocation to San Francisco (37.7749, -122.4194)

ஆதரவு

  • மொபைல் செயலிகள்

ஸ்கிரிப்ட் இயக்கம்

execute_script

உலாவியில் JavaScript அல்லது Appium வழியாக மொபைல் கட்டளைகளை இயக்குகிறது.

அளவுருக்கள்

அளவுருவகைகட்டாயம்விளக்கம்
scriptstringஆம்JavaScript குறியீடு (உலாவி) அல்லது மொபைல் கட்டளை (எ.கா., mobile: pressKey)
argsarrayஇல்லைஸ்கிரிப்டிற்கான வாதங்கள்

உலாவி எடுத்துக்காட்டுகள்

// Get page title
execute_script({ script: "return document.title" })

// Get scroll position
execute_script({ script: "return window.scrollY" })

// Click element by selector
execute_script({ script: "arguments[0].click()", args: ["#myButton"] })

மொபைல் (Appium) எடுத்துக்காட்டுகள்

// Press back key (Android)
execute_script({ script: "mobile: pressKey", args: [{ keycode: 4 }] })

// Activate app
execute_script({ script: "mobile: activateApp", args: [{ appId: "com.example" }] })

// Terminate app
execute_script({ script: "mobile: terminateApp", args: [{ appId: "com.example" }] })

// Deep link
execute_script({ script: "mobile: deepLink", args: [{ url: "myapp://screen", package: "com.example" }] })

// Shell command (Android)
execute_script({ script: "mobile: shell", args: [{ command: "dumpsys", args: ["battery"] }] })

பொதுவான Android விசை குறியீடுகள்

விசைகுறியீடு
BACK4
HOME3
ENTER66
MENU82
SEARCH84

மேலும் மொபைல் கட்டளைகள்

கிடைக்கக்கூடிய அனைத்து Appium மொபைல் கட்டளைகளின் முழு பட்டியலுக்கு, காண்க:

ஆதரவு

  • டெஸ்க்டாப் உலாவிகள்
  • மொபைல் செயலிகள் (Appium மொபைல் கட்டளைகள் வழியாக)

Welcome! How can I help?

WebdriverIO AI Copilot