1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
|
Feature: Expecting messages
Use `expect(...).to receive(...)` to expect a message on a [test double](./test-doubles). Unfulfilled
message expectations trigger failures when the example completes. You can also use
`expect(...).not_to receive(...)` to set a negative message expectation.
Scenario: Failing positive message expectation
Given a file named "unfulfilled_message_expectation_spec.rb" with:
"""ruby
RSpec.describe "An unfulfilled positive message expectation" do
it "triggers a failure" do
dbl = double("Some Collaborator")
expect(dbl).to receive(:foo)
end
end
"""
When I run `rspec unfulfilled_message_expectation_spec.rb`
Then it should fail with:
"""
1) An unfulfilled positive message expectation triggers a failure
Failure/Error: expect(dbl).to receive(:foo)
(Double "Some Collaborator").foo(*(any args))
expected: 1 time with any arguments
received: 0 times with any arguments
"""
Scenario: Passing positive message expectation
Given a file named "fulfilled_message_expectation_spec.rb" with:
"""ruby
RSpec.describe "A fulfilled positive message expectation" do
it "passes" do
dbl = double("Some Collaborator")
expect(dbl).to receive(:foo)
dbl.foo
end
end
"""
When I run `rspec fulfilled_message_expectation_spec.rb`
Then the examples should all pass
Scenario: Failing negative message expectation
Given a file named "negative_message_expectation_spec.rb" with:
"""ruby
RSpec.describe "A negative message expectation" do
it "fails when the message is received" do
dbl = double("Some Collaborator").as_null_object
expect(dbl).not_to receive(:foo)
dbl.foo
end
end
"""
When I run `rspec negative_message_expectation_spec.rb`
Then it should fail with:
"""
1) A negative message expectation fails when the message is received
Failure/Error: dbl.foo
(Double "Some Collaborator").foo(no args)
expected: 0 times with any arguments
received: 1 time
"""
Scenario: Passing negative message expectation
Given a file named "negative_message_expectation_spec.rb" with:
"""ruby
RSpec.describe "A negative message expectation" do
it "passes if the message is never received" do
dbl = double("Some Collaborator").as_null_object
expect(dbl).not_to receive(:foo)
end
end
"""
When I run `rspec negative_message_expectation_spec.rb`
Then the examples should all pass
Scenario: Failing positive message expectation with a custom failure message
Given a file named "example_spec.rb" with:
"""ruby
RSpec.describe "An unfulfilled positive message expectation" do
it "triggers a failure" do
dbl = double
expect(dbl).to receive(:foo), "dbl never calls :foo"
end
end
"""
When I run `rspec example_spec.rb --format documentation`
Then the output should contain:
"""
1) An unfulfilled positive message expectation triggers a failure
Failure/Error: expect(dbl).to receive(:foo), "dbl never calls :foo"
dbl never calls :foo
"""
Scenario: Failing negative message expectation with a custom failure message
Given a file named "example_spec.rb" with:
"""ruby
RSpec.describe "A negative message expectation" do
it "fails when the message is received" do
dbl = double
expect(dbl).not_to receive(:foo), "dbl called :foo but is not supposed to"
dbl.foo
end
end
"""
When I run `rspec example_spec.rb --format documentation`
Then the output should contain:
"""
1) A negative message expectation fails when the message is received
Failure/Error: dbl.foo
dbl called :foo but is not supposed to
"""
|
