sockjs 0.2.1

data/spec/sockjs/transports/websocket_spec.rb

@@ -0,0 +1,101 @@
+#!/usr/bin/env bundle exec rspec
+# encoding: utf-8
+
+require "spec_helper"
+
+require "sockjs"
+require "sockjs/transports/websocket"
+
+describe SockJS::Transports::WebSocket, :type => :transport do
+  transport_handler_eql "/websocket", "GET"
+
+  let :request_options do
+    {}
+  end
+
+  let :request do
+    env = {
+      "HTTP_CONNECTION" => "Upgrade",
+      "HTTP_UPGRADE" => "WebSocket"}
+    FakeRequest.new(env.merge(request_options)).tap do |request|
+      request.path_info = "/a/b/websocket"
+    end
+  end
+
+  describe "#handle(request)" do
+    context "if the transport is disabled" do
+      let :transport_options do
+        {:websocket => false}
+      end
+
+      it "should report itself disabled" do
+        transport.should be_disabled
+      end
+
+      it "should respond with 404 and an error message" do
+        response.status.should eql(404)
+        response.chunks.last.should eql("WebSockets Are Disabled")
+      end
+    end
+
+    context "if HTTP_UPGRADE isn't WebSocket" do
+      let :request_options do
+        { "HTTP_UPGRADE" => "something" }
+      end
+
+      it "should respond with 400 and an error message" do
+        response.status.should eql(400)
+        response.chunks.last.should eql('Can "Upgrade" only to "WebSocket".')
+      end
+    end
+
+
+    context "if HTTP_CONNECTION isn't Upgrade" do
+      let :request_options do
+        {"HTTP_CONNECTION" => "something"}
+      end
+
+      it "should respond with 400 and an error message" do
+        response.status.should eql(400)
+        response.chunks.last.should eql('"Connection" must be "Upgrade".')
+      end
+    end
+
+    # The following three statements are meant to be documentation rather than specs itselves.
+    it "should call #handle_open(request) when the connection is being open"
+
+    it "should call #handle_message(request, event) on a new message"
+
+    it "should call #handle_close(request, event) when the connection is being closed"
+  end
+
+  describe "#handle_open(request)" do
+    it "should send the opening frame"
+    it "should open a new session"
+  end
+
+  describe "#handle_message(request, event)" do
+    let(:app) do
+      Proc.new do |connection|
+        connection.subscribe do |session, message|
+          session.send(message.upcase)
+        end
+      end
+    end
+
+    it "should receive the message"
+    it "should run user code"
+    it "should send messages"
+  end
+
+  describe "#handle_close(request, event)" do
+    it "should send the closing frame"
+    it "should open a new session"
+  end
+
+  describe "#send" do
+    it "should be defined, but it should do nothing" do
+      transport.should respond_to(:send)
+    end
+  end
+end

data/spec/sockjs/transports/welcome_screen_spec.rb

@@ -0,0 +1,36 @@
+#!/usr/bin/env bundle exec rspec
+# encoding: utf-8
+
+require "spec_helper"
+
+require "sockjs"
+require "sockjs/transports/welcome_screen"
+
+describe SockJS::Transports::WelcomeScreen do
+  describe "#handle(request)" do
+    let(:transport) do
+      described_class.new(Object.new, Hash.new)
+    end
+
+    let(:request) do
+      @request ||= FakeRequest.new
+    end
+
+    let(:response) do
+      transport.handle(request)
+    end
+
+    it "should respond with HTTP 200" do
+      response.status.should eql(200)
+    end
+
+    it "should respond with plain text MIME type" do
+      response.headers["Content-Type"].should match("text/plain")
+    end
+
+    it "should return greeting in the body" do
+      response # Run the handler.
+      response.chunks.last.should eql("Welcome to SockJS!\n")
+    end
+  end
+end

data/spec/sockjs/transports/xhr_spec.rb

@@ -0,0 +1,314 @@
+#!/usr/bin/env bundle exec rspec
+# encoding: utf-8
+
+require "spec_helper"
+
+require "sockjs"
+require "sockjs/transports/xhr"
+
+describe "XHR", :type => :transport, :em => true do
+  describe SockJS::Transports::XHRPost do
+    transport_handler_eql "/xhr", "POST"
+
+    describe "#handle(request)" do
+      let(:request) do
+        FakeRequest.new.tap do |request|
+          request.session_key = Array.new(7) { rand(256) }.pack("C*").unpack("H*").first
+          request.path_info = "/xhr"
+        end
+      end
+
+      context "with a session" do
+        before :each do
+          session
+        end
+
+        let(:request) do
+          FakeRequest.new.tap do |request|
+            request.path_info = "/xhr"
+            request.session_key = "b"
+          end
+        end
+
+        it "should respond with HTTP 200" do
+          response.status.should eql(200)
+        end
+
+        it "should respond with javascript MIME type" do
+          response.headers["Content-Type"].should match("application/javascript")
+        end
+
+        it "should run user code"
+      end
+
+      context "without a session" do
+        let :session do
+        end
+
+        it "should create one and send an opening frame" do
+          response.chunks.last.should eql("o\n")
+        end
+
+        it "should respond with HTTP 200" do
+          response.status.should eql(200)
+        end
+
+        it "should respond with javascript MIME type" do
+          response.headers["Content-Type"].should match("application/javascript")
+        end
+
+        it "should set access control" do
+          response.headers["Access-Control-Allow-Origin"].should eql(request.origin)
+          response.headers["Access-Control-Allow-Credentials"].should eql("true")
+        end
+
+        it "should set session ID" do
+          cookie = response.headers["Set-Cookie"]
+          cookie.should match("JSESSIONID=#{request.session_id}; path=/")
+        end
+      end
+    end
+  end
+
+  describe SockJS::Transports::XHROptions do
+    transport_handler_eql "/xhr", "OPTIONS"
+
+    describe "#handle(request)" do
+      let(:request) do
+        FakeRequest.new
+      end
+
+      it "should respond with HTTP 204" do
+        response.status.should eql(204)
+      end
+
+      it "should set access control" do
+        response.headers["Access-Control-Allow-Origin"].should eql(request.origin)
+        response.headers["Access-Control-Allow-Credentials"].should eql("true")
+      end
+
+      it "should set cache control to be valid for the next year" do
+        time = Time.now + 31536000
+
+        response.headers["Cache-Control"].should eql("public, max-age=31536000")
+        response.headers["Expires"].should eql(time.gmtime.to_s)
+        response.headers["Access-Control-Max-Age"].should eql("1000001")
+      end
+
+      it "should set Allow header to OPTIONS, POST" do
+        response.headers["Allow"].should eql("OPTIONS, POST")
+      end
+    end
+  end
+
+  describe SockJS::Transports::XHRSendPost do
+    transport_handler_eql "/xhr_send", "POST"
+
+    describe "#handle(request)" do
+      let(:request) do
+        FakeRequest.new.tap do |request|
+          request.session_key = rand(1 << 32).to_s
+          request.path_info = "/xhr_send"
+        end
+      end
+
+      context "with a session" do
+        before :each do
+          session
+        end
+
+        context "well formed request" do
+
+          let(:request) do
+            FakeRequest.new.tap do |request|
+              request.path_info = "/xhr_send"
+              request.session_key = 'b'
+              request.data = '["message"]'
+            end
+          end
+
+          it "should respond with HTTP 204" do
+            response.status.should eql(204)
+          end
+
+          it "should respond with plain text MIME type" do
+            response.headers["Content-Type"].should match("text/plain")
+          end
+
+          it "should set session ID" do
+            cookie = response.headers["Set-Cookie"]
+            cookie.should match("JSESSIONID=#{request.session_id}; path=/")
+          end
+
+          it "should set access control" do
+            response.headers["Access-Control-Allow-Origin"].should eql(request.origin)
+            response.headers["Access-Control-Allow-Credentials"].should eql("true")
+          end
+        end
+
+        context "badly formed JSON" do
+          let(:request) do
+            FakeRequest.new.tap do |request|
+              request.path_info = "/xhr_send"
+              request.session_key = 'b'
+              request.data = '["message"'
+            end
+          end
+
+          it "should respond with HTTP 500" do
+            response.status.should eql(500)
+          end
+
+          it "should report JSON error" do
+            response
+            request.chunks.join("").should =~ /Broken JSON encoding/
+          end
+        end
+
+        context "empty body" do
+          let(:request) do
+            FakeRequest.new.tap do |request|
+              request.path_info = "/xhr_send"
+              request.session_key = 'b'
+              request.data = ''
+            end
+          end
+
+          it "should respond with HTTP 500" do
+            response.status.should eql(500)
+          end
+
+          it "should report JSON error" do
+            response
+            request.chunks.join("").should =~ /Payload expected\./
+          end
+        end
+      end
+
+      context "without a session" do
+        it "should respond with HTTP 404" do
+          response.status.should eql(404)
+        end
+
+        it "should respond with plain text MIME type" do
+          response.headers["Content-Type"].should match("text/plain")
+        end
+
+        it "should return error message in the body" do
+          response # Run the handler.
+          request.chunks.last.should match(/Session is not open\!/)
+        end
+      end
+    end
+  end
+
+  describe SockJS::Transports::XHRSendOptions do
+    transport_handler_eql "/xhr_send", "OPTIONS"
+
+    describe "#handle(request)" do
+      let(:request) do
+        FakeRequest.new
+      end
+
+      it "should respond with HTTP 204" do
+        response.status.should eql(204)
+      end
+
+      it "should set access control" do
+        response.headers["Access-Control-Allow-Origin"].should eql(request.origin)
+        response.headers["Access-Control-Allow-Credentials"].should eql("true")
+      end
+
+      it "should set cache control to be valid for the next year" do
+        time = Time.now + 31536000
+
+        response.headers["Cache-Control"].should eql("public, max-age=31536000")
+        response.headers["Expires"].should eql(time.gmtime.to_s)
+        response.headers["Access-Control-Max-Age"].should eql("1000001")
+      end
+
+      it "should set Allow header to OPTIONS, POST" do
+        response.headers["Allow"].should eql("OPTIONS, POST")
+      end
+    end
+  end
+
+  describe SockJS::Transports::XHRStreamingPost do
+    transport_handler_eql "/xhr_streaming", "POST"
+
+    describe "#handle(request)" do
+      let :session do
+      end
+
+      let(:transport) do
+        transport  = described_class.new(connection, Hash.new)
+
+        def transport.try_timer_if_valid(*)
+        end
+
+        transport
+      end
+
+      let(:request) do
+        FakeRequest.new.tap do |request|
+          request.path_info = "/a/b/xhr_streaming"
+          request.session_key = "b"
+        end
+      end
+
+      it "should respond with HTTP 200" do
+        response.status.should eql(200)
+      end
+
+      it "should respond with prelude + open frame" do
+        response
+        request.chunks.join("").should =~ /hhhhhhhhh\no/
+      end
+
+      it "should respond with javascript MIME type" do
+        response.headers["Content-Type"].should match("application/javascript")
+      end
+
+      it "should set access control" do
+        response.headers["Access-Control-Allow-Origin"].should eql(request.origin)
+        response.headers["Access-Control-Allow-Credentials"].should eql("true")
+      end
+
+      it "should set session ID" do
+        cookie = response.headers["Set-Cookie"]
+        cookie.should match("JSESSIONID=#{request.session_id}; path=/")
+      end
+    end
+  end
+
+  describe SockJS::Transports::XHRStreamingOptions do
+    transport_handler_eql "/xhr_streaming", "OPTIONS"
+
+    describe "#handle(request)" do
+      let(:request) do
+        FakeRequest.new
+      end
+
+      it "should respond with HTTP 204" do
+        response.status.should eql(204)
+      end
+
+      it "should set access control" do
+        response.headers["Access-Control-Allow-Origin"].should eql(request.origin)
+        response.headers["Access-Control-Allow-Credentials"].should eql("true")
+      end
+
+      it "should set cache control to be valid for the next year" do
+        time = Time.now + 31536000
+
+        response.headers["Cache-Control"].should eql("public, max-age=31536000")
+        response.headers["Expires"].should eql(time.gmtime.to_s)
+        response.headers["Access-Control-Max-Age"].should eql("1000001")
+      end
+
+      it "should set Allow header to OPTIONS, POST" do
+        response.headers["Allow"].should eql("OPTIONS, POST")
+      end
+    end
+  end
+end