async-webdriver 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ee23c04114676fa39b6838b560ad843f0d011e8c89ac1de1038c66c2f7bd5e26
-  data.tar.gz: aa95efc428c3cdfcb362c8a9f6fbc80aaa4cec6258630adb2f057479ba051537
+  metadata.gz: 8a6324ffc2dfcde7982396b2dbda22df843948de94ba4e61811a777b64156a05
+  data.tar.gz: 25cc350a2093f0bc1651500139bb654c5ed0af2f8ac553ecbc5d3544691e9999
 SHA512:
-  metadata.gz: bf32864d5c72d2529151f4de5f1f72d6e4a5a3731d0598e49df758d97371f176ec34504d9922d6f56499855c9d21726fb7fba641b08c19f2ae084960a35ec90f
-  data.tar.gz: 67f0fd5bdba22e79cba73c2db37e69da65ddc3dc22a8603584a59d1cae158902ac1ca501a7d80304683e56f831aa621ca852acd3b31079c4c7a2b19d2a36711c
+  metadata.gz: 4a39e3446f54eeb665252c3cb7f76bcdf5b6dc8ba0fcc8e67f0570d5e93f783e77e833cb499211562e26f922fbe14f507a6e7645cbe45c5f7c9af921e3c4f9b7
+  data.tar.gz: 0205a411504dac570476a891f849542d337f9cf1d44b4462811e3bfdc006b24f3eddd338c27822f7119a9467676cad6f17efdb30c57ddd14ceaf4e15537066d6

data/lib/async/webdriver/bridge/pool.rb

@@ -91,7 +91,25 @@ module Async
 					
 					reply = @sessions.pop
 					
-					Session.open(@bridge.endpoint, reply["sessionId"], reply["capabilities"], &block)
+					session = Session.open(@bridge.endpoint, reply["sessionId"], reply["capabilities"])
+					
+					return session unless block_given?
+					
+					begin
+						yield session
+						
+						# Try to reuse the session for extreme performance:
+						reuse(session)
+						session = nil
+					ensure
+						session&.close
+					end
+				end
+				
+				def reuse(session)
+					session.reset!
+					
+					@sessions << {"sessionId" => session.id, "capabilities" => session.capabilities}
 				end
 			end
 		end

data/lib/async/webdriver/element.rb

@@ -114,13 +114,6 @@ module Async
 				self
 			end
 			
-			include Scope::Alerts
-			include Scope::Cookies
-			include Scope::Elements
-			include Scope::Fields
-			include Scope::Printing
-			include Scope::ScreenCapture
-			
 			# Execute a script in the context of the element. `this` will be the element.
 			# @parameter script [String] The script to execute.
 			# @parameter arguments [Array] The arguments to pass to the script.
@@ -135,6 +128,13 @@ module Async
 				@session.execute_async("return (function(){#{script}}).call(...arguments)", self, *arguments)
 			end
 			
+			include Scope::Alerts
+			include Scope::Cookies
+			include Scope::Elements
+			include Scope::Fields
+			include Scope::Printing
+			include Scope::ScreenCapture
+			
 			# Get the value of an attribute.
 			#
 			# Given an attribute name, e.g. `href`, this method will return the value of the attribute, as if you had executed the following JavaScript:

data/lib/async/webdriver/scope/document.rb

@@ -10,30 +10,14 @@ module Async
 			module Document
 				# Get the current document title.
 				# @returns [String] The document title.
-				def title
-					get("title")
+				def document_title
+					session.get("title")
 				end
 				
 				# Get the current document source.
 				# @returns [String] The document source.
-				def source
-					get("source")
-				end
-				
-				# Execute a script in the current document.
-				# @parameter script [String] The script to execute.
-				# @parameter arguments [Array] The arguments to pass to the script.
-				# @returns [Object] The result of the script.
-				def execute(script, *arguments)
-					post("execute/sync", {script: script, args: arguments})
-				end
-				
-				# Execute a script in the current document asynchronously.
-				# @parameter script [String] The script to execute.
-				# @parameter arguments [Array] The arguments to pass to the script.
-				# @returns [Object] The result of the script.
-				def execute_async(script, *arguments)
-					post("execute/async", {script: script, args: arguments})
+				def document_source
+					session.get("source")
 				end
 			end
 		end

data/lib/async/webdriver/session.rb

@@ -97,6 +97,22 @@ module Async
 				self
 			end
 			
+			# Execute a script in the current document.
+			# @parameter script [String] The script to execute.
+			# @parameter arguments [Array] The arguments to pass to the script.
+			# @returns [Object] The result of the script.
+			def execute(script, *arguments)
+				post("execute/sync", {script: script, args: arguments})
+			end
+			
+			# Execute a script in the current document asynchronously.
+			# @parameter script [String] The script to execute.
+			# @parameter arguments [Array] The arguments to pass to the script.
+			# @returns [Object] The result of the script.
+			def execute_async(script, *arguments)
+				post("execute/async", {script: script, args: arguments})
+			end
+			
 			include Scope::Alerts
 			include Scope::Cookies
 			include Scope::Document
@@ -107,6 +123,19 @@ module Async
 			include Scope::Printing
 			include Scope::ScreenCapture
 			include Scope::Timeouts
+			
+			# Reset the session to a clean state.
+			def reset!
+				# Go to a blank page (in theory this should also invalidate any Element instances):
+				self.navigate_to("about:blank")
+				
+				# Clear cookies and local storage:
+				self.delete_all_cookies
+				self.execute("localStorage.clear();")
+				
+				# Detach the session instance from the underlying HTTP client:
+				@delegate = nil
+			end
 		end
 	end
 end

data/lib/async/webdriver/version.rb

@@ -5,6 +5,6 @@
 
 module Async
 	module WebDriver
-		VERSION = "0.2.0"
+		VERSION = "0.3.0"
 	end
 end

data/readme.md

@@ -8,7 +8,7 @@ Provides a client implementation of the W3C WebDriver specification with support
 
 In the past, I've used [selenium-webdriver](https://github.com/SeleniumHQ/selenium) for testing web applications. However, I found it to be slow. I wanted to improve the performance of my tests, so I decided to write a new implementation from scratch. The W3C WebDriver specification is quite simple, so it wasn't too difficult to implement, and I was able to get a significant performance improvement, between 2x-10x depending on the usage. Specifically, most test suites can take advantage of pre-warmed sessions, which can minimise the overhead of each test running in a new session. Additionally, I'd like to explore reusing sessions between tests, which could provide even more performance improvements.
 
-In addition, building on top of [async](https://github.com/socketry/async) allows us to take advantage of [async-http](https://github.com/socketry/async-http) running in the same reactor, which can provide a significant performance improvement over the existing HTTP servers like [capybara](https://github.com/teamcapybara/capybara) which need to start a separate application server process. This also makes it possible to share a single database transaction between the client and server, which can significantly reduce the overhead of "cleaning" the database after each test, and improve the opportunity for parallelisation.
+In addition, building on top of [async](https://github.com/socketry/async) allows us to take advantage of [async-http](https://github.com/socketry/async-http) and run the web server in the same reactor as the test itself, which can provide a performance improvement over [capybara](https://github.com/teamcapybara/capybara) which usually needs to start a separate server process. This also makes it possible to share a single database transaction between the client and server, which can significantly reduce the overhead of "cleaning" the database after each test, and improve the opportunity for parallelisation.
 
 ## Usage
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-webdriver
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Samuel Williams