selenium API 随记

webdriver

查找元素

• find_element_by_id
• find_element_by_xpath
• find_element_by_link_text
• find_element_by_partial_link_text
• find_element_by_name
• find_element_by_tag_name
• find_element_by_class_name
• find_element_by_css_selector

所有的以上操作，都有查找多个元素的对应操作find_elements_by_[option]

获取内容

操作	注释
get	Loads a web page in the current browser session.
title	Returns the title of the current page.
current_url	Gets the URL of the current page.
page_source	Gets the source of the current page.
get_screenshot_as_file(filename)	Gets the screenshot of the current window. Returns False if there is any IOError, else returns True. Use full paths in your filename.
get_screenshot_as_png	Gets the screenshot of the current window as a binary data.
get_screenshot_as_base64	Gets the screenshot of the current window as a base64 encoded string which is useful in embedded images in HTML.
get_log(log_type)	Gets the log for a given log type
log_types	Gets a list of the available log types

窗口操作

操作	注释
close	Closes the current window.
quit	Quits the driver and closes every associated window.
current_window_handle	Returns the handle of the current window.
window_handles	Returns the handles of all windows within the current session.
maximize_window	Maximizes the current window that webdriver is using

执行js脚本

操作	注释
execute_script(script, *args)	Synchronously Executes JavaScript in the current window/frame. - script: The JavaScript to execute. - *args: Any applicable arguments for your JavaScript.
execute_async_script(script, *args)	Asynchronously Executes JavaScript in the current window/frame.

cookie相关

操作	注释
get_cookie(name)	Get a single cookie by name. Returns the cookie if found, None if not.
delete_cookie(name)	Deletes a single cookie with the given name.
delete_all_cookies	Delete all cookies in the scope of the session.
add_cookie(cookie_dict)	Adds a cookie to your current session. - cookie_dict: A dictionary object, with required keys - “name” and “value”; optional keys - “path”, “domain”, “secure”, “expiry”

超时设置

操作	注释
implicitly_wait(time_to_wait)	Sets a sticky timeout to implicitly wait for an element to be found, or a command to complete. This method only needs to be called one time per session. To set the timeout for calls to execute_async_script, see set_script_timeout.
set_script_timeout	Set the amount of time that the script should wait during an execute_async_script call before throwing an error.
set_page_load_timeout	Set the amount of time to wait for a page load to complete before throwing an error.

webelement

操作	注释
tag_name	This element’s tagName property.
text	The text of the element.
click	Clicks the element.
submit	Submits a form.
clear	Clears the text if it’s a text entry element.
get_attribute(name)	Gets the given attribute or property of the element. name - Name of the attribute/property to retrieve. If there’s no attribute with that name, None is returned.
is_selected	Returns whether the element is selected. Can be used to check if a checkbox or radio button is selected.
is_enabled	Returns whether the element is enabled.
find_element_by_[option]	Finds element within this element’s children by option
send_keys(value)	Simulates typing into the element. - value - A string for typing, or setting form fields. For setting file inputs, this could be a local file path.
size	The size of the element.
value_of_css_property	The value of a CSS property.
location	The location of the element in the renderable canvas.
rect	A dictionary with the size and location of the element.
screenshot_as_base64	Gets the screenshot of the current element as a base64 encoded string.
screenshot_as_png	Gets the screenshot of the current element as a binary data.
screenshot	Gets the screenshot of the current element. Returns False if there is any IOError, else returns True. Use full paths in your filename.
parent	Internal reference to the WebDriver instance this element was found from.