Appium_Python_Api文檔 [轉(zhuǎn)載]
1.contexts
contexts(self):
Returns the contexts within the current session.
返回當(dāng)前會(huì)話中的上下文赫悄,使用后可以識(shí)別H5頁(yè)面的控件
:Usage:
driver.contexts用法 driver.contexts
2. current_context
current_context(self):
Returns the current context of the current session.
返回當(dāng)前會(huì)話的當(dāng)前上下文
:Usage:
driver.current_context用法driver. current_context
3. context
context(self):
Returns the current context of the current session.
返回當(dāng)前會(huì)話的當(dāng)前上下文。
:Usage:
driver.context用法driver. Context
4. find_element_by_ios_uiautomation
find_element_by_ios_uiautomation(self, uia_string):
Finds an element by uiautomation in iOS.
通過(guò)iOS uiautomation查找元素
:Args:
- uia_string - The element name in the iOS UIAutomation library
:Usage:
driver.find_element_by_ios_uiautomation('.elements()[1].cells()[2]')用法dr. find_element_by_ios_uiautomation(‘elements’)
5. find_element_by_accessibility_id
find_element_by_accessibility_id(self, id):
Finds an element by accessibility id.
通過(guò)accessibility id查找元素
:Args:
- id - a string corresponding to a recursive element search using the
Id/Name that the native Accessibility options utilize
:Usage:
driver.find_element_by_accessibility_id()用法driver.find_element_by_accessibility_id(‘id’)
6.scroll
scroll(self, origin_el, destination_el):
Scrolls from one element to another 從元素origin_el滾動(dòng)至元素destination_el :Args: - originalEl - the element from which to being scrolling - destinationEl - the element to scroll to :Usage: driver.scroll(el1, el2)
用法 driver.scroll(el1,el2)
7. drag_and_drop
drag_and_drop(self, origin_el, destination_el):
Drag the origin element to the destination element
將元素origin_el拖到目標(biāo)元素destination_el
:Args:
- originEl - the element to drag
- destinationEl - the element to drag to用法 driver.drag_and_drop(el1,el2)
8.tap
tap(self, positions, duration=None):
Taps on an particular place with up to five fingers, holding for a certain time模擬手指點(diǎn)擊(最多五個(gè)手指)痰憎,可設(shè)置按住時(shí)間長(zhǎng)度(毫秒)
:Args:
- positions - an array of tuples representing the x/y coordinates of
the fingers to tap. Length can be up to five.
- duration - (optional) length of time to tap, in ms
:Usage:
driver.tap([(100, 20), (100, 60), (100, 100)], 500)用法 driver.tap([(x,y),(x1,y1)],500)
9. swipe
swipe(self, start_x, start_y, end_x, end_y, duration=None):
Swipe from one point to another point, for an optional duration. 從A點(diǎn)滑動(dòng)至B點(diǎn)谦秧,滑動(dòng)時(shí)間為毫秒 :Args: - start_x - x-coordinate at which to start - start_y - y-coordinate at which to start - end_x - x-coordinate at which to stop - end_y - y-coordinate at which to stop - duration - (optional) time to take the swipe, in ms. :Usage: driver.swipe(100, 100, 100, 400)
用法 driver.swipe(x1,y1,x2,y2,500)
10.flick
flick(self, start_x, start_y, end_x, end_y):
Flick from one point to another point. 按住A點(diǎn)后快速滑動(dòng)至B點(diǎn) :Args: - start_x - x-coordinate at which to start - start_y - y-coordinate at which to start - end_x - x-coordinate at which to stop - end_y - y-coordinate at which to stop :Usage: driver.flick(100, 100, 100, 400)
用法 driver.flick(x1,y1,x2,y2)
11.pinch
pinch(self, element=None, percent=200, steps=50):
Pinch on an element a certain amount
在元素上執(zhí)行模擬雙指捏(縮小操作)
:Args:
- element - the element to pinch
- percent - (optional) amount to pinch. Defaults to 200%
- steps - (optional) number of steps in the pinch action
:Usage:
driver.pinch(element)
用法 driver.pinch(element)
12.zoom
zoom(self, element=None, percent=200, steps=50):
Zooms in on an element a certain amount
在元素上執(zhí)行放大操作
:Args:
- element - the element to zoom
- percent - (optional) amount to zoom. Defaults to 200%
- steps - (optional) number of steps in the zoom action
:Usage:
driver.zoom(element)
用法 driver.zoom(element)
13.reset
reset(self):
Resets the current application on the device.重置應(yīng)用(類(lèi)似刪除應(yīng)用數(shù)據(jù))用法 driver.reset()
14. hide_keyboard
hide_keyboard(self, key_name=None, key=None, strategy=None):
Hides the software keyboard on the device. In iOS, use `key_name` to press a particular key, or `strategy`. In Android, no parameters are used.
隱藏鍵盤(pán),iOS使用key_name隱藏晋柱,安卓不使用參數(shù)
:Args:
- key_name - key to press
- strategy - strategy for closing the keyboard (e.g., `tapOutside`)driver.hide_keyboard()
15. keyevent
keyevent(self, keycode, metastate=None):
Sends a keycode to the device. Android only. Possible keycodes can be found in http://developer.android.com/reference/android/view/KeyEvent.html.
發(fā)送按鍵碼(安卓?jī)H有),按鍵碼可以上網(wǎng)址中找到
:Args:
- keycode - the keycode to be sent to the device
- metastate - meta information about the keycode being sent用法 dr.keyevent(‘4’)
16. press_keycode
press_keycode(self, keycode, metastate=None):
Sends a keycode to the device. Android only. Possible keycodes can be found in http://developer.android.com/reference/android/view/KeyEvent.html.
發(fā)送按鍵碼(安卓?jī)H有),按鍵碼可以上網(wǎng)址中找到
:Args:
- keycode - the keycode to be sent to the device
- metastate - meta information about the keycode being sent用法 driver.press_ keycode(‘4’)
dr.keyevent(‘4’)與driver.press_ keycode(‘4’) 功能實(shí)現(xiàn)上一樣的,都是按了返回鍵
17. long_press_keycode
long_press_keycode(self, keycode, metastate=None):
Sends a long press of keycode to the device. Android only. Possible keycodes can be
found in http://developer.android.com/reference/android/view/KeyEvent.html.
發(fā)送一個(gè)長(zhǎng)按的按鍵碼(長(zhǎng)按某鍵)
詳細(xì)的按鍵代碼見(jiàn)這里 http://developer.android.com/reference/android/view/KeyEvent.html.
:Args:
- keycode - the keycode to be sent to the device
- metastate - meta information about the keycode being sent
用法 driver.long_press_keycode(4) 謝謝@t880216t童鞋反饋
18.current_activity
current_activity(self):
Retrieves the current activity on the device.獲取當(dāng)前的activity用法 print(driver.current_activity)
19. wait_activity
wait_activity(self, activity, timeout, interval=1):
Wait for an activity: block until target activity presents or time out.
This is an Android-only method.
等待指定的activity出現(xiàn)直到超時(shí)列粪,interval為掃描間隔1秒即每隔幾秒獲取一次當(dāng)前的activity返回的True 或 False
:Agrs:
- activity - target activity
- timeout - max wait time, in seconds
- interval - sleep interval between retries, in seconds用法driver.wait_activity(‘.activity.xxx’,5,2)
20. background_app
background_app(self, seconds):
Puts the application in the background on the device for a certain duration.
后臺(tái)運(yùn)行app多少秒
:Args:
- seconds - the duration for the application to remain in the background用法 driver.background_app(5) 置后臺(tái)5秒后再運(yùn)行
21.is_app_installed
is_app_installed(self, bundle_id):
Checks whether the application specified by `bundle_id` is installed on the device.
檢查app是否有安裝返回 True or False
:Args:
- bundle_id - the id of the application to query用法 driver.is_app_installed(“com.xxxx”)
22.install_app
install_app(self, app_path):
Install the application found at `app_path` on the device.
安裝app,app_path為安裝包路徑
:Args:
- app_path - the local or remote path to the application to install用法 driver.install_app(app_path)
23.remove_app
remove_app(self, app_id):
Remove the specified application from the device. 刪除app :Args: - app_id - the application id to be removed用法 driver.remove_app(“com.xxx.”)
24.launch_app
launch_app(self):
Start on the device the application specified in the desired capabilities.啟動(dòng)app用法 driver.launch_app()
25.close_app
close_app(self):
Stop the running application, specified in the desired capabilities, on the device.關(guān)閉app用法 driver.close_app()啟動(dòng)和關(guān)閉app運(yùn)行好像會(huì)出錯(cuò)
26. start_activity
start_activity(self, app_package, app_activity, **opts):
Opens an arbitrary activity during a test. If the activity belongs to
another application, that application is started and the activity is opened.
This is an Android-only method.
在測(cè)試過(guò)程中打開(kāi)任意活動(dòng)。如果活動(dòng)屬于另一個(gè)應(yīng)用程序谈飒,該應(yīng)用程序的啟動(dòng)和活動(dòng)被打開(kāi)岂座。這是一個(gè)安卓的方法
:Args:
- app_package - The package containing the activity to start.
- app_activity - The activity to start.
- app_wait_package - Begin automation after this package starts (optional).
- app_wait_activity - Begin automation after this activity starts (optional).
- intent_action - Intent to start (optional).
- intent_category - Intent category to start (optional).
- intent_flags - Flags to send to the intent (optional).
- optional_intent_arguments - Optional arguments to the intent (optional).
- stop_app_on_reset - Should the app be stopped on reset (optional)?用法 driver.start_activity(app_package, app_activity)
27.lock
lock(self, seconds):
Lock the device for a certain period of time. iOS only.
鎖屏一段時(shí)間 iOS專(zhuān)有
:Args:
- the duration to lock the device, in seconds用法 driver.lock()
28.shake
shake(self):
Shake the device.搖一搖手機(jī)用法 driver.shake()
29.open_notifications
open_notifications(self):
Open notification shade in Android (API Level 18 and above)打系統(tǒng)通知欄(僅支持API 18 以上的安卓系統(tǒng))用法 driver.open_notifications()
30.network_connection
network_connection(self):
Returns an integer bitmask specifying the network connection type.
Android only.返回網(wǎng)絡(luò)類(lèi)型 數(shù)值
Possible values are available through the enumeration `appium.webdriver.ConnectionType`用法 driver.network_connection
31. set_network_connection
set_network_connection(self, connectionType):
Sets the network connection type. Android only.
Possible values:
Value (Alias) | Data | Wifi | Airplane Mode
-------------------------------------------------
0 (None) | 0 | 0 | 0
1 (Airplane Mode) | 0 | 0 | 1
2 (Wifi only) | 0 | 1 | 0
4 (Data only) | 1 | 0 | 0
6 (All network on) | 1 | 1 | 0
These are available through the enumeration `appium.webdriver.ConnectionType`
設(shè)置網(wǎng)絡(luò)類(lèi)型
:Args:
- connectionType - a member of the enum appium.webdriver.ConnectionType用法 先加載from appium.webdriver.connectiontype import ConnectionTypedr.set_network_connection(ConnectionType.WIFI_ONLY)ConnectionType的類(lèi)型有NO_CONNECTION = 0AIRPLANE_MODE = 1WIFI_ONLY = 2DATA_ONLY = 4ALL_NETWORK_ON = 6
32. available_ime_engines
available_ime_engines(self):
Get the available input methods for an Android device. Package and activity are returned (e.g., ['com.android.inputmethod.latin/.LatinIME'])
Android only.返回安卓設(shè)備可用的輸入法用法print(driver.available_ime_engines)
33.is_ime_active
is_ime_active(self):
Checks whether the device has IME service active. Returns True/False.
Android only.檢查設(shè)備是否有輸入法服務(wù)活動(dòng)。返回真/假杭措。安卓用法 print(driver.is_ime_active())
34.activate_ime_engine
activate_ime_engine(self, engine):
Activates the given IME engine on the device.
Android only.
激活安卓設(shè)備中的指定輸入法费什,設(shè)備可用輸入法可以從“available_ime_engines”獲取
:Args:
- engine - the package and activity of the IME engine to activate (e.g.,
'com.android.inputmethod.latin/.LatinIME')用法 driver.activate_ime_engine(“com.android.inputmethod.latin/.LatinIME”)
35.deactivate_ime_engine
deactivate_ime_engine(self):
Deactivates the currently active IME engine on the device.
Android only.關(guān)閉安卓設(shè)備當(dāng)前的輸入法用法 driver.deactivate_ime_engine()
36.active_ime_engine
active_ime_engine(self):
Returns the activity and package of the currently active IME engine (e.g.,
'com.android.inputmethod.latin/.LatinIME').
Android only.
返回當(dāng)前輸入法的包名用法 driver.active_ime_engine
37. toggle_location_services
toggle_location_services(self):
Toggle the location services on the device. Android only.打開(kāi)安卓設(shè)備上的位置定位設(shè)置用法 driver.toggle_location_services()
38.set_location
set_location(self, latitude, longitude, altitude):
Set the location of the device
設(shè)置設(shè)備的經(jīng)緯度
:Args:
- latitude緯度 - String or numeric value between -90.0 and 90.00
- longitude經(jīng)度 - String or numeric value between -180.0 and 180.0
- altitude海拔高度- String or numeric value用法 driver.set_location(緯度,經(jīng)度手素,高度)
39.tag_name
tag_name(self):
This element's ``tagName`` property.返回元素的tagName屬性經(jīng)實(shí)踐返回的是class name用法 element.tag_name()
40.text
text(self):
The text of the element.
返回元素的文本值用法 element.text
41.click
click(self):
Clicks the element.
點(diǎn)擊元素用法 element.click()
42.submit
submit(self):
Submits a form.
提交表單用法 暫無(wú)
43.clear
clear(self):
Clears the text if it's a text entry element. 清除輸入的內(nèi)容用法 element.clear()
44.get_attribute
get_attribute(self, name):
詳見(jiàn)@chenhengjie123 的超級(jí)鏈接
Gets the given attribute or property of the element.1鸳址、獲取 content-desc 的方法為 get_attribute("name") 瘩蚪,而且還不能保證返回的一定是 content-desc (content-desc 為空時(shí)會(huì)返回 text 屬性值)2、get_attribute 方法不是我們?cè)?uiautomatorviewer 看到的所有屬性都能獲取的(此處的名稱(chēng)均為使用 get_attribute 時(shí)使用的屬性名稱(chēng)):可獲取的:字符串類(lèi)型:name(返回 content-desc 或 text)text(返回 text)className(返回 class稿黍,只有 API=>18 才能支持)resourceId(返回 resource-id疹瘦,只有 API=>18 才能支持)
This method will first try to return the value of a property with the
given name. If a property with that name doesn't exist, it returns the value of the attribute with the same name. If there's no attribute with
that name, ``None`` is returned.
Values which are considered truthy, that is equals "true" or "false",
are returned as booleans. All other non-``None`` values are returned
as strings. For attributes or properties which do not exist, ``None``
is returned.
:Args:
- name - Name of the attribute/property to retrieve.
Example::
# Check if the "active" CSS class is applied to an element.
is_active = "active" in target_element.get_attribute("class")用法 暫無(wú)
45.is_selected
is_selected(self):
Returns whether the element is selected.
Can be used to check if a checkbox or radio button is selected.返回元素是否選擇⊙睬颍可以用來(lái)檢查一個(gè)復(fù)選框或單選按鈕被選中言沐。用法 element.is_slected()
46.is_enabled
is_enabled(self):
Returns whether the element is enabled.
返回元素是否可用True of False用法 element.is_enabled()
47.find_element_by_id
find_element_by_id(self, id_):
Finds element within this element's children by ID. 通過(guò)元素的ID定位元素 :Args: - id_ - ID of child element to locate.用法 driver. find_element_by_id(“id”)
48. find_elements_by_id
find_elements_by_id(self, id_):
Finds a list of elements within this element's children by ID. 通過(guò)元素ID定位,含有該屬性的所有元素 :Args: - id_ - Id of child element to find.用法 driver. find_elements_by_id(“id”)
49. find_element_by_name
find_element_by_name(self, name):
Finds element within this element's children by name. 通過(guò)元素Name定位(元素的名稱(chēng)屬性text) :Args: - name - name property of the element to find.用法 driver.find_element_by_name(“name”)
50. find_elements_by_name
find_elements_by_name(self, name):
Finds a list of elements within this element's children by name. 通過(guò)元素Name定位(元素的名稱(chēng)屬性text),含有該屬性的所有元素 :Args: - name - name property to search for.用法 driver.find_element_by_name(“name”)
51. find_element_by_link_text
find_element_by_link_text(self, link_text):
Finds element within this element's children by visible link text. 通過(guò)元素可見(jiàn)鏈接文本定位 :Args: - link_text - Link text string to search for.用法 driver.find_element_by_link_text(“text”)
52. find_elements_by_link_text
find_element_by_link_text(self, link_text):
Finds a list of elements within this element's children by visible link text 通過(guò)元素可見(jiàn)鏈接文本定位,含有該屬性的所有元素 :Args: - link_text - Link text string to search for.用法 driver.find_elements_by_link_text(“text”)
53. find_element_by_partial_link_text
find_element_by_partial_link_text(self, link_text):
Finds element within this element's children by partially visible link text. 通過(guò)元素部分可見(jiàn)鏈接文本定位 :Args: - link_text - Link text string to search for.driver. find_element_by_partial_link_text(“text”)
54. find_elements_by_partial_link_text
find_elements_by_partial_link_text(self, link_text):
Finds a list of elements within this element's children by link text. 通過(guò)元素部分可見(jiàn)鏈接文本定位,含有該屬性的所有元素 :Args: - link_text - Link text string to search for.driver. find_elements_by_partial_link_text(“text”)
55. find_element_by_tag_name
find_element_by_tag_name(self, name):
Finds element within this element's children by tag name. 通過(guò)查找html的標(biāo)簽名稱(chēng)定位元素 :Args: - name - name of html tag (eg: h1, a, span)用法 driver.find_element_by_tag_name(“name”)
56. find_elements_by_tag_name
find_elements_by_tag_name(self, name):
Finds a list of elements within this element's children by tag name. 通過(guò)查找html的標(biāo)簽名稱(chēng)定位所有元素 :Args: - name - name of html tag (eg: h1, a, span)用法driver.find_elements_by_tag_name(“name”)
57. find_element_by_xpath
find_element_by_xpath(self, xpath):
Finds element by xpath.
通過(guò)Xpath定位元素酣栈,詳細(xì)方法可參閱http://www.w3school.com.cn/xpath/
:Args:
xpath - xpath of element to locate. "http://input[@class='myelement']"
Note: The base path will be relative to this element's location. This will select the first link under this element. :: myelement.find_elements_by_xpath(".//a") However, this will select the first link on the page. :: myelement.find_elements_by_xpath("http://a")用法 find_element_by_xpath(“//*”)
58. find_elements_by_xpath
find_elements_by_xpath(self, xpath):
Finds elements within the element by xpath.
:Args:
- xpath - xpath locator string.
Note: The base path will be relative to this element's location. This will select all links under this element. :: myelement.find_elements_by_xpath(".//a") However, this will select all links in the page itself. :: myelement.find_elements_by_xpath("http://a")用法find_elements_by_xpath(“//*”)
59. find_element_by_class_name
find_element_by_class_name(self, name):
Finds element within this element's children by class name. 通過(guò)元素class name屬性定位元素 :Args: - name - class name to search for.用法 driver. find_element_by_class_name(“android.widget.LinearLayout”)
60. find_elements_by_class_name
find_elements_by_class_name(self, name):
Finds a list of elements within this element's children by class name. 通過(guò)元素class name屬性定位所有含有該屬性的元素 :Args: - name - class name to search for.用法 driver. find_elements_by_class_name(“android.widget.LinearLayout”)
61. find_element_by_css_selector
find_element_by_css_selector(self, css_selector):
Finds element within this element's children by CSS selector. 通過(guò)CSS選擇器定位元素 :Args: - css_selector - CSS selctor string, ex: 'a.nav#home'
62.send_keys
send_keys(self, *value):
Simulates typing into the element.
在元素中模擬輸入(開(kāi)啟appium自帶的輸入法并配置了appium輸入法后险胰,可以輸入中英文)
:Args:
- value - A string for typing, or setting form fields. For setting
file inputs, this could be a local file path.
Use this to send simple key events or to fill out form fields::
form_textfield = driver.find_element_by_name('username')
form_textfield.send_keys("admin")
This can also be used to set file inputs.
::
file_input = driver.find_element_by_name('profilePic')
file_input.send_keys("path/to/profilepic.gif")
# Generally it's better to wrap the file path in one of the methods
# in os.path to return the actual path to support cross OS testing.
# file_input.send_keys(os.path.abspath("path/to/profilepic.gif"))driver.element.send_keys(“中英”)
63. is_displayed
is_displayed(self):
Whether the element is visible to a user. 此元素用戶(hù)是否可見(jiàn)。簡(jiǎn)單地說(shuō)就是隱藏元素和被控件擋住無(wú)法操作的元素(僅限 Selenium钉嘹,appium是否實(shí)現(xiàn)了類(lèi)似功能不是太確定)這一項(xiàng)都會(huì)返回 False用法 driver.element.is_displayed()
64. location_once_scrolled_into_view
location_once_scrolled_into_view(self):
"""THIS PROPERTY MAY CHANGE WITHOUT WARNING. Use this to discover
where on the screen an element is so that we can click it. This method
should cause the element to be scrolled into view.
Returns the top lefthand corner location on the screen, or ``None`` if
the element is not visible.
暫不知道用法
"""
65.size
size(self):
The size of the element.獲取元素的大醒炷恕(高和寬)new_size["height"] = size["height"]new_size["width"] = size["width"]用法 driver.element.size
66. value_of_css_property
value_of_css_property(self, property_name):
The value of a CSS property.CSS屬性用法 暫不知
67.location
location(self):
The location of the element in the renderable canvas.
獲取元素左上角的坐標(biāo)用法 driver.element.location'''返回element的x坐標(biāo), int類(lèi)型'''driver.element.location.get('x')'''返回element的y坐標(biāo), int類(lèi)型'''driver.element.location.get('y')
68.rect
rect(self):
A dictionary with the size and location of the element.
元素的大小和位置的字典
69. screenshot_as_base64
screenshot_as_base64(self):
Gets the screenshot of the current element as a base64 encoded string.
獲取當(dāng)前元素的截圖為Base64編碼的字符串
:Usage:
img_b64 = element.screenshot_as_base64
70.execute_script
execute_script(self, script, *args):
Synchronously Executes JavaScript in the current window/frame.在當(dāng)前窗口/框架(特指 Html 的 iframe )同步執(zhí)行 javascript 代碼。你可以理解為如果這段代碼是睡眠5秒跋涣,這五秒內(nèi)主線程的 javascript 不會(huì)執(zhí)行
:Args:
- script: The JavaScript to execute.
- \*args: Any applicable arguments for your JavaScript.
:Usage:
driver.execute_script('document.title')
71.execute_async_script
execute_async_script(self, script, *args):
Asynchronously Executes JavaScript in the current window/frame.插入 javascript 代碼缨睡,只是這個(gè)是異步的,也就是如果你的代碼是睡眠5秒陈辱,那么你只是自己在睡奖年,頁(yè)面的其他 javascript 代碼還是照常執(zhí)行
:Args:
- script: The JavaScript to execute.
- \*args: Any applicable arguments for your JavaScript.
:Usage:
driver.execute_async_script('document.title')
72.current_url
current_url(self):
Gets the URL of the current page.
獲取當(dāng)前頁(yè)面的網(wǎng)址。
:Usage:
driver.current_url用法 driver.current_url
73. page_source
page_source(self):
Gets the source of the current page.
獲取當(dāng)前頁(yè)面的源沛贪。
:Usage:
driver.page_source
74.close
close(self):
Closes the current window.
關(guān)閉當(dāng)前窗口
:Usage:
driver.close()
75.quit
quit(self):
Quits the driver and closes every associated window.
退出腳本運(yùn)行并關(guān)閉每個(gè)相關(guān)的窗口連接
:Usage:
driver.quit()
76.get_screenshot_as_file
get_screenshot_as_file(self, filename):
Gets the screenshot of the current window. Returns False if there is
any IOError, else returns True. Use full paths in your filename.
截取當(dāng)前窗口的截圖陋守,如果有寫(xiě)入錯(cuò)誤會(huì)返回False,其它返回True
filename 使用絕對(duì)路徑
:Args:
- filename: The full path you wish to save your screenshot to.
:Usage:
driver.get_screenshot_as_file('c:/foo.png')
77.get_window_size
get_window_size(self, filename):
Gets the width and height of the current window.
獲取當(dāng)前屏幕的分辨率(長(zhǎng)和寬)
:Usage:
driver.get_window_size()