webkit_remote 0.1.0

data/test/webkit_remote/client/runtime_test.rb

@@ -0,0 +1,109 @@
+require File.expand_path('../../helper.rb', File.dirname(__FILE__))
+
+describe WebkitRemote::Client::Runtime do
+  before :all do
+    @client = WebkitRemote.local port: 9669
+    @client.page_events = true
+    @client.navigate_to fixture_url(:runtime)
+    @client.wait_for type: WebkitRemote::Event::PageLoaded
+  end
+  after :all do
+    @client.close
+  end
+
+  describe 'remote_eval' do
+    describe 'for a number' do
+      before :each do
+        @number = @client.remote_eval '11 + 31', group: 'no'
+      end
+      it 'returns a Ruby number' do
+        @number.must_equal 42
+      end
+      it 'does not create an object group' do
+        @client.object_group('no').must_equal nil
+      end
+    end
+
+    describe 'for a boolean' do
+      before :each do
+        @true = @client.remote_eval '!!1', group: 'no'
+        @false = @client.remote_eval '!!0', group: 'no'
+      end
+      it 'returns a Ruby boolean' do
+        @true.must_equal true
+        @false.must_equal false
+      end
+      it 'does not create an object group' do
+        @client.object_group('no').must_equal nil
+      end
+    end
+
+    describe 'for a string' do
+      before :each do
+        @string = @client.remote_eval '"hello Ruby"', group: 'no'
+      end
+      it 'returns a Ruby string' do
+        @string.must_equal 'hello Ruby'
+      end
+      it 'does not create an object group' do
+        @client.object_group('no').must_equal nil
+      end
+    end
+
+    describe 'for null' do
+      before :each do
+        @null  = @client.remote_eval 'null', group: 'no'
+      end
+      it 'returns nil' do
+        @string.must_equal nil
+      end
+      it 'does not create an object group' do
+        @client.object_group('no').must_equal nil
+      end
+    end
+
+    describe 'for an object created via new' do
+      before :each do
+        @object = @client.remote_eval 'new TestClass("hello Ruby")',
+                                      group: 'yes'
+      end
+      after :each do
+        group = @client.object_group('yes')
+        group.release_all if group
+      end
+      it 'returns an RemoteObject instance' do
+        @object.must_be_kind_of WebkitRemote::Client::RemoteObject
+      end
+      it 'sets the object properties correctly' do
+        @object.js_class_name.must_equal 'TestClass'
+        @object.description.must_equal 'TestClass'
+      end
+      it 'creates a non-released group' do
+        @client.object_group('yes').wont_equal nil
+        @client.object_group('yes').released?.must_equal false
+      end
+    end
+
+    describe 'for a JSON object' do
+      before :each do
+        @object = @client.remote_eval '({hello: "ruby", answer: 42})',
+                                      group: 'yes'
+      end
+      after :each do
+        group = @client.object_group('yes')
+        group.release_all if group
+      end
+      it 'returns an RemoteObject instance' do
+        @object.must_be_kind_of WebkitRemote::Client::RemoteObject
+      end
+      it 'sets the object properties correctly' do
+        @object.js_class_name.must_equal 'Object'
+        @object.description.must_equal 'Object'
+      end
+      it 'creates a non-released group' do
+        @client.object_group('yes').wont_equal nil
+        @client.object_group('yes').released?.must_equal false
+      end
+    end
+  end
+end

data/test/webkit_remote/client_test.rb

@@ -0,0 +1,99 @@
+require File.expand_path('../helper.rb', File.dirname(__FILE__))
+
+describe WebkitRemote::Client do
+  before :each do
+    @process = WebkitRemote::Process.new port: 9669
+    @process.start
+    @browser = WebkitRemote::Browser.new process: @process, stop_process: true
+    tab = @browser.tabs.first
+    @client = WebkitRemote::Client.new tab: tab
+  end
+  after :each do
+    @client.close if @client
+    @browser.close if @browser
+    @process.stop if @process
+  end
+
+  it 'sets close_browser to false, browser to the given Browser instance' do
+    @client.close_browser?.must_equal false
+    @client.browser.must_equal @browser
+  end
+
+  describe 'close with close_browser is true' do
+    before do
+      @client.close_browser = true
+      @client.close
+    end
+
+    it 'closes the client debugging connection' do
+      @client.closed?.must_equal true
+    end
+
+    it 'closes the browser master debugging session' do
+      @browser.closed?.must_equal true
+    end
+  end
+
+  describe 'each_event' do
+    before do
+      @client.rpc.call 'Page.enable'
+      @client.rpc.call 'Page.navigate', url: fixture_url(:load)
+      @events = []
+      @client.each_event do |event|
+        @events << event
+        break if event.kind_of?(WebkitRemote::Event::PageLoaded)
+      end
+    end
+
+    it 'only yields events' do
+      @events.each do |event|
+        event.must_be_kind_of WebkitRemote::Event
+      end
+    end
+
+    it 'contains a PageLoaded instance' do
+      @events.map(&:class).must_include WebkitRemote::Event::PageLoaded
+    end
+  end
+
+  describe 'wait_for' do
+    describe 'with page_events enabled' do
+      before do
+        @client.page_events = true
+        @client.rpc.call 'Page.navigate', url: fixture_url(:load)
+      end
+
+      it 'returns a PageLoaded instance' do
+        @client.wait_for(type: WebkitRemote::Event::PageLoaded).
+                must_be_kind_of WebkitRemote::Event::PageLoaded
+      end
+    end
+
+    describe 'with page_events disabled' do
+      it 'raises ArgumentError' do
+        lambda {
+          @client.wait_for(type: WebkitRemote::Event::PageLoaded)
+        }.must_raise ArgumentError
+      end
+    end
+  end
+
+  describe 'rpc' do
+    it 'is is a non-closed WebkitRemote::Rpc instance' do
+      @client.rpc.must_be_kind_of WebkitRemote::Rpc
+      @client.rpc.closed?.must_equal false
+    end
+
+    describe 'after calling close' do
+      before do
+        @client_rpc = @client.rpc
+        @client.close
+      end
+
+      it 'the Rpc instance is closed' do
+        @client_rpc.closed?.must_equal true
+      end
+    end
+  end
+end
+

data/test/webkit_remote/event_test.rb

@@ -0,0 +1,83 @@
+require File.expand_path('../helper.rb', File.dirname(__FILE__))
+
+describe WebkitRemote::Event do
+  before do
+    @client = WebkitRemote.local port: 9669
+  end
+  after do
+    @client.close
+  end
+
+  describe 'on a PageLoaded event' do
+    before do
+      @url = fixture_url(:load)
+      @client.page_events = true
+      @client.navigate_to @url
+      events = []
+      # NOTE: wait_for uses Event#matches, and we're testing that here
+      @client.each_event do |event|
+        events << event
+        break if event.kind_of?(WebkitRemote::Event::PageLoaded)
+      end
+      @event = events.last
+    end
+
+    describe 'matches' do
+      it 'handles single conditions' do
+        @event.matches?(:class => WebkitRemote::Event::PageLoaded).
+               must_equal true
+        @event.matches?(type: WebkitRemote::Event).must_equal true
+        @event.matches?(:class => WebkitRemote::Event::PageDomReady).
+               must_equal false
+        @event.matches?(name: 'Page.loadEventFired').must_equal true
+        @event.matches?(name: 'loadEventFired').must_equal false
+        @event.matches?(domain: 'Page').must_equal true
+        @event.matches?(domain: 'Runtime').must_equal false
+      end
+
+      it 'handles multiple conditions' do
+        @event.matches?(type: WebkitRemote::Event::PageLoaded,
+                        domain: 'Page').must_equal true
+        @event.matches?(type: WebkitRemote::Event::PageLoaded,
+                        domain: 'Runtime').must_equal false
+        @event.matches?(type: WebkitRemote::Event::PageDomReady,
+                        domain: 'Page').must_equal false
+      end
+    end
+  end
+
+  describe 'can_receive?' do
+    describe 'when page_events is false' do
+      before do
+        @client.page_events = false
+      end
+      it 'should be true for the base class' do
+        WebkitRemote::Event.can_receive?(@client, type: WebkitRemote::Event).
+                            must_equal true
+      end
+      it 'should be false for PageLoaded' do
+        WebkitRemote::Event.can_receive?(@client,
+            type: WebkitRemote::Event::PageLoaded).must_equal false
+      end
+      it 'should be false for Page.loadEventFired' do
+        WebkitRemote::Event.can_receive?(@client, name: 'Page.loadEventFired').
+                            must_equal false
+      end
+    end
+
+    describe 'when page_events is true' do
+      before do
+        @client.page_events = true
+      end
+      it 'should be true for PageLoaded' do
+        WebkitRemote::Event.can_receive?(@client,
+            type: WebkitRemote::Event::PageLoaded).must_equal true
+      end
+      it 'should be true for Page.loadEventFired' do
+        WebkitRemote::Event.can_receive?(@client, name: 'Page.loadEventFired').
+                            must_equal true
+      end
+    end
+  end
+end
+

data/test/webkit_remote/process_test.rb

@@ -0,0 +1,52 @@
+require File.expand_path('../helper.rb', File.dirname(__FILE__))
+
+describe WebkitRemote::Process do
+  before :each do
+    @process = WebkitRemote::Process.new port: 9669
+  end
+  after :each do
+    @process.stop if @process
+  end
+
+  describe '#running' do
+    it 'returns false before #start is called' do
+      @process.running?.must_equal false
+    end
+  end
+
+  describe '#start' do
+    before :each do
+      @browser = @process.start
+    end
+    after :each do
+      @browser.close if @browser
+      @process.stop if @process
+    end
+
+    it 'makes running? return true' do
+      @process.running?.must_equal true
+    end
+
+    it 'returns a Browser instance that does not auto-stop the process' do
+      @browser.must_be_kind_of WebkitRemote::Browser
+      @browser.closed?.must_equal false
+      @browser.stop_process?.must_equal false
+    end
+
+    describe '#stop' do
+      before :each do
+        @process.stop
+      end
+
+      it 'makes running? return false' do
+        @process.running?.must_equal false
+      end
+
+      it 'kills the http server that responds to /json' do
+        lambda {
+          @browser.tabs
+        }.must_raise EOFError
+      end
+    end
+  end
+end

data/test/webkit_remote/rpc_test.rb

@@ -0,0 +1,55 @@
+require File.expand_path('../helper.rb', File.dirname(__FILE__))
+
+describe WebkitRemote::Rpc do
+  before :each do
+    @process = WebkitRemote::Process.new port: 9669
+    @process.start
+    @browser = WebkitRemote::Browser.new process: @process, stop_process: true
+    tab = @browser.tabs.first
+    @rpc = WebkitRemote::Rpc.new tab: tab
+  end
+  after :each do
+    @rpc.close if @rpc
+    @browser.close if @browser
+    @process.stop if @process
+  end
+
+  describe 'call' do
+    before do
+      @result = @rpc.call 'Runtime.evaluate', expression: '1 + 2',
+                                                returnByValue: true
+    end
+
+    it 'produces the correct result' do
+      @result.must_include 'result'
+      @result['result'].must_include 'value'
+      @result['result']['value'].must_equal 3
+      @result['result'].must_include 'type'
+      @result['result']['type'].must_equal 'number'
+    end
+  end
+
+  describe 'each_event' do
+    before do
+      @rpc.call 'Page.enable'
+      @rpc.call 'Page.navigate', url: fixture_url(:load)
+      @events = []
+      @rpc.each_event do |event|
+        @events << event
+        break if event[:name] == 'Page.loadEventFired'
+      end
+    end
+
+    it 'only yields events' do
+      @events.each do |event|
+        event.must_include :name
+        event.must_include :data
+      end
+    end
+
+    it 'contains a Page.loadEventFired event' do
+      @events.map { |e| e[:name] }.must_include 'Page.loadEventFired'
+    end
+  end
+end
+

data/test/webkit_remote_test.rb

@@ -0,0 +1,63 @@
+require File.expand_path('helper.rb', File.dirname(__FILE__))
+
+describe WebkitRemote do
+  describe 'local' do
+    before do
+      @client = WebkitRemote.local port: 9669
+    end
+    after do
+      @client.close
+    end
+
+    it 'returns a working client' do
+      @client.must_be_kind_of WebkitRemote::Client
+      @client.closed?.must_equal false
+    end
+
+    describe 'after #close' do
+      before do
+        @client.close
+      end
+
+      it 'the client tears down everything' do
+        @client.closed?.must_equal true
+        @client.browser.closed?.must_equal true
+        @client.browser.process.running?.must_equal false
+      end
+    end
+  end
+
+  describe 'remote' do
+    before do
+      @process = WebkitRemote::Process.new port: 9669
+      browser = @process.start
+      browser.close
+      @client = WebkitRemote.remote host: 'localhost', port: 9669
+    end
+
+    after do
+      @client.close
+      @process.stop
+    end
+
+    it 'returns a working client' do
+      @client.must_be_kind_of WebkitRemote::Client
+      @client.closed?.must_equal false
+    end
+
+    describe 'after #close' do
+      before do
+        @client.close
+      end
+
+      it 'the client tears the connection' do
+        @client.closed?.must_equal true
+        @client.browser.closed?.must_equal true
+      end
+
+      it 'the client does not impact the browser process' do
+        @process.running?.must_equal true
+      end
+    end
+  end
+end