Stripping down RemoteWebDriver

How does Selenium actually drive a remote browser.

Transcript

1. Stripping down Remote WebDriver How does Selenium actually drive a remove browser http://bit.ly/stripping-down-remote-webdriver
2. Intro Santiago Suarez Ordoñez >5 years with Selenium and test automation Selenium committer Sauce Ninja at Sauce Labs @santiycr sso@saucelabs.com
3. Sauce Labs
4. Agenda • What's Remote WebDriver • The JSON Wire Protocol • The Desired Capabilities object • Augmenters • Handling local files • API Docs • The codebase
5. How is Remote WebDriver different Remote WebDriver is all drivers!! Pros • Separates where tests run from where the browser is • Allows tests to use browsers not available on the current OS Cons • Requires an external server • Introduces extra latency to tests
6. Graphs!
7. Demo!!
8. Step by step 1. get the Selenium server 2. start your remote WebDriver server 3. choose your desired capabilities 4. point Remote WebDriver to the right location 5. run your tests remotely
9. Show me!!
10. The JSON Wire Protocol WebDriver's communication channel • RESTful protocol • JSON over HTTP • Intent in the test, actions through the wire http://code.google.com/p/selenium/wiki/JsonWireProtocol
11. The internals WebDriver API WebDriver SPI JSON Wire Protocol Selenium Server
12. API vs SPI API: Object oriented (WebDriver's style) username = driver.find_element_by_id("username") username.send_keys("santi") SPI: Procedural and stateless (RC's style) find_element(using="id", value="username") send_keys(element="e0", value="santi")
13. Show me!!
14. The Desired Capabilities object • A hash sent to the server • Used to start the right driver • Drivers have special capabilities • Server sends capabilities back (informing what has been given) http://code.google.com/p/selenium/wiki/DesiredCapabilities
15. Choose your tests' capabilities DesiredCapabilities caps = DesiredCapabilities.firefox(); caps.setCapability("version", "5"); caps.setCapability("platform", Platform.XP);
16. Dumping the Capabilities object: Java: caps.toString() Python: print(caps) Ruby: caps.to_json C#: caps.ToString()
17. Augmenters WebDriver augmented = new Augmenter().augment(driver); File screenshot = ((TakesScreenshot)augmented). getScreenshotAs(OutputType.FILE);
18. How about browser profiles? Stick to the FirefoxProfile class. Remote base64 encodes and sends it transparently!! File file = new File("firebug-1.8.1.xpi"); FirefoxProfile firefoxProfile = new FirefoxProfile(); firefoxProfile.addExtension(file); firefoxProfile.setPreference("extensions.firebug.currentVersion", "1.8.1"); DesiredCapabilities capabilities = new DesiredCapabilities.Firefox(); capabilities.setFirefoxProfile(firefoxProfile); WebDriver driver = new RemoteWebDriver(capabilities);
19. How about file uploads? I introduce you setFileDetector! driver.setFileDetector(newLocalFileDetector()); fileinput.sendKeys("/Users/sso/local/file"); 1. WebDriver detects a path and finds the file 2. Sends it base64 encoded and gets the remote path 3. Uses sendKeys with the new (remote) path https://gist.github.com/1508946
20. API Documentation • Java API Docs • Ruby API Docs • Python API Docs • C# API Docs All linked from: http://code.google.com/p/selenium/
21. Where's the code? Java: selenium/trunk/java/client/src/org/openqa/selenium/remote Ruby: selenium/trunk/rb/lib/selenium/webdriver/remote Python: selenium/trunk/py/selenium/webdriver/remote C#: selenium/trunk/dotnet/src/WebDriver/Remote
22. QA?
23. Thanks! Santiago Suarez Ordoñez @santiycr Sauce Labs http://bit.ly/stripping-down-remote-webdriver