我如何测试这个特定的方法？

Question

我有以下方法负责请求 URL 并返回它的 Nokogiri::HTML 文档。此方法检查是否定义了代理，如果已定义，它将调用OpenURI 的open，带或不带代理选项。

实施

require 'open-uri'
require 'nokogiri'

class MyClass 
  attr_accessor :proxy

  # ....

  def self.page_content(url)
    if MyClass.proxy
      proxy_uri = URI.parse(MyClass.proxy)
      Nokogiri::HTML(open(url, :proxy => proxy_uri)) # open provided by OpenURI
    else
      Nokogiri::HTML(open(url)) # open provided by OpenURI
    end
  end
end

我不知道应该如何编写测试来证明以下内容：

1. 定义代理后，OpenURI 发出的请求实际上使用代理信息
2. 如果未定义代理，则会建立常规的非代理连接

这是我想出的作为测试的开始。

describe MyClass, :vcr do

  describe '.proxy' do
    it { should respond_to(:proxy) }
  end

  describe '.page_content' do
    let(:url) { "https://google.com/" }
    let(:page_content) { subject.page_content(url) }

    it 'returns a Nokogiri::HTML::Document' do
      page_content.should be_a(Nokogiri::HTML::Document)
    end

    # How do i test this method actually uses a proxy when it's set vs not set?
    context 'when using a proxy' do
      # ???
      xit 'should set open-uri proxy properties' do
      end
    end

    context 'when not using a proxy' do
      # ???
      xit 'should not set open-uri proxy properties' do
      end
    end

  end

end

Answer 1

首先，您需要安排proxy 方法在一个测试用例中而不是在另一个测试用例中返回代理。如果有代理的“setter”方法，你可以使用它，否则你可以存根proxy方法。

然后，您至少希望在 open 上设置一个期望，即它会在有或没有 :proxy 选项的情况下被调用，具体取决于它是哪个测试。除此之外，您可以选择是否为方法中涉及的各种其他调用存根并设置期望值，包括URI.parse 和Nokogiri::HTML。

请参阅https://github.com/rspec/rspec-mocks，了解有关建立测试替身和设定期望值的信息。如果您想使用部分存根方法，请特别注意 and_call_original 选项。

更新：这里有一些代码可以帮助您入门。这适用于非代理方法。我把代理案留给你了。另请注意，这使用“部分存根”方法，您最终仍会调用外部 gem。

require 'spec_helper'

describe MyClass do

  describe '.proxy' do         # NOTE: This test succeeds because of attr_accessor, but you're calling a MyClass.proxy (a class method) within your page_content method
    it { should respond_to(:proxy) }
  end

  describe '.page_content' do
    let(:url) { "https://google.com/" }
    let(:page_content) { MyClass.page_content(url) } # NOTE: Changed to invoke class method

    context 'when not using a proxy' do

      before {allow(MyClass).to receive(:proxy).and_return(false)} # Stubbed for no-proxy case

      it 'returns a Nokogiri::HTML::Document' do
        page_content.should be_a(Nokogiri::HTML::Document)
      end

      it 'should not set open-uri proxy properties' do
        expect(MyClass).to receive(:open).with(url).and_call_original  # Stubbing open is tricky, see note afterwards
        page_content
      end
    end
        # How do i test this method actually uses a proxy when it's set vs not set?
    context 'when using a proxy' do
      # ???
      xit 'should set open-uri proxy properties' do
      end
    end

  end

end

open 的存根很棘手。有关说明，请参阅 How to rspec mock open-uri?。