Selenium Documentation - Revision history

Ed at 17:47, 21 September 2020

2020-09-21T17:47:06Z

Ed at 17:34, 21 September 2020

2020-09-21T17:34:28Z

Ed at 17:20, 20 September 2020

2020-09-20T17:20:13Z

Ed at 17:12, 20 September 2020

2020-09-20T17:12:25Z

Peterjalbert at 17:37, 22 December 2017

2017-12-22T17:37:24Z

Peterjalbert at 21:03, 21 December 2017

2017-12-21T21:03:56Z

Peterjalbert at 20:48, 21 December 2017

2017-12-21T20:48:51Z

Peterjalbert at 20:47, 21 December 2017

2017-12-21T20:47:37Z

Peterjalbert at 17:21, 20 December 2017

2017-12-20T17:21:21Z

Peterjalbert at 17:19, 20 December 2017

2017-12-20T17:19:15Z

@@ Line 1: / Line 1: @@
 {{Project
-|Has project output=
+|Has project output=How-to
 |Has sponsor=McNair Center
 |Has Image=selenium.jpg

@@ Line 1: / Line 1: @@
 {{Project
 |Has sponsor=McNair Center
 |Has Image=selenium.jpg

@@ Line 1: / Line 1: @@
 {{Project
 |Has Image=selenium.jpg
 |Has title=Selenium Documentation

@@ Line 1: / Line 1: @@
-{{McNair Projects
+{{Project
 |Has Image=selenium.jpg
 |Has title=Selenium Documentation

@@ Line 71: / Line 71: @@
 This will route you to the linked page, or execute the action of the button. The driver will now be on the new page, and commands will deal with elements on the new page.
 ===Open a New Window===
@@ Line 79: / Line 86: @@
   from selenium.webdriver.common.action_chains import ActionChains
   from selenium.webdriver.common.keys import Keys
 OPTION 2: Open Blank Window + get()
 -----------------------------------
 ===Downloading Files===

← Older revision		Revision as of 21:03, 21 December 2017
Line 65:		Line 65:
	For example, the following could be used to scroll to the bottom of the page:		For example, the following could be used to scroll to the bottom of the page:
	driver.execute_script("window.scrollTo(0, document.body.scrollHeight);")		driver.execute_script("window.scrollTo(0, document.body.scrollHeight);")
		+
		+	===Clicking===
		+	If an element is clickable (such as a link or a button), you can click on that element by doing:
		+	element.click()
		+
		+	This will route you to the linked page, or execute the action of the button. The driver will now be on the new page, and commands will deal with elements on the new page.
		+
		+	===Open a New Window===
		+	OPTION 1: Cntrl + Click
		+	-----------------------
		+
		+	This method will utilize Action Chains and Keys. Action Chains simply queue commands, and the string of commands are executed once the perform() method is called. First, import these dependencies:
		+	from selenium.webdriver.common.action_chains import ActionChains
		+	from selenium.webdriver.common.keys import Keys
		+
		+	OPTION 2: Open Blank Window + get()
		+	-----------------------------------
		+
		+	===Downloading Files===
		+	In general, I recommend using Selenium to do browsing, and use another method to download the file.
		+	driver.current_url
		+
		+	This will get the current url. From there, standard libraries such as wget or urlretrieve can be used to download the file if the url ends in .pdf, or the html of the page if it is a regular webpage.
		+
		+	If you are trying to retrieve a body of text, find the element using selectors. Then:
		+	element.text
		+
		+	will retrieve the text in that element as a string. This can then be written to a file in any way you see fit.
		+
		+	[http://stackabuse.com/download-files-with-python/ Helpful link for downloading files in python]
		+

← Older revision		Revision as of 17:21, 20 December 2017
Line 57:		Line 57:

	A tutorial on XPATH can be found [https://www.w3schools.com/xml/xpath_intro.asp here].		A tutorial on XPATH can be found [https://www.w3schools.com/xml/xpath_intro.asp here].
		+
		+	===Javascript===
		+	If you are familiar with Javascript, you can inject Javascript into the driver to envoke certain behaviors. Simply use:
		+	driver.execute_script(someJavascriptCode)
		+
		+	For example, the following could be used to scroll to the bottom of the page:
		+	driver.execute_script("window.scrollTo(0, document.body.scrollHeight);")

← Older revision		Revision as of 17:19, 20 December 2017
Line 33:		Line 33:

	===Selectors===		===Selectors===
		+	These functions deal with web elements on the current page the driver is on. Any function that contains find_element_by returns a single web element, and any function that contains find_elements_by returns a list of web elements.
		+
		+	driver.find_element_by_class_name(class_name)
		+	This function takes a string class name of the element you're looking for, and finds the first element on the page that has that class name. If there is a possibility that more than one web element on the page has the same class, you are probably better of using find_elements_by_class_name.
		+
		+	driver.find_element_by_name(name)
		+	This function takes a string name of the element you're looking for, and finds the first element on the page that has a name attribute matching the string. Similar to the find_element_by_class_name function, this is not your best bet if there are multiple objects with the same name attribute.
		+
		+	driver.find_element_by_id(id)
		+	This function takes a string id of the element you're looking for, and finds the element on the page that has an id attribute matching the string. Since ids are guaranteed to be unique, this will always find the element you're looking for. This function is not helpful if the element you want to select does not have an id attribute.
		+
		+	driver.find_element_by_xpath(xpath)
		+	This function takes an XPATH, and returns the first web element that matches the path. This should not be your first choice if many elements can share the same XPATH. Contrary to all the above functions, XPATH can be used to find any web element, regardless of its attributes. However, XPATH takes some time to learn, and is more complex than all of the above. After investing some time, XPATH is the most secure way to find the elements you're looking for.
		+
		+	driver.find_elements_by_class_name(class_name)
		+	This is similar to find_element_by_class_name, except it returns a list of all matches with the class name. This allows you to iterate over the results or index them accordingly. This is often useful for search results, or any sort of list based queries.
		+
		+	driver.find_elements_by_name(name)
		+	Same as find_element_by_name, except it returns a list of all matches.
		+
		+	driver.find_elements_by_xpath(xpath)
		+	Same as find_element_by_xpath, but returns a list of all matches.
		+
		+	A tutorial on XPATH can be found [https://www.w3schools.com/xml/xpath_intro.asp here].