Module: Sentry::TestHelper

Defined in:
lib/sentry/test_helper.rb

Constant Summary collapse

DUMMY_DSN = 
'http://12345:[email protected]/sentry/42'

Instance Method Summary collapse

Instance Method Details

#extract_sentry_exceptions(event) ⇒ Array<Sentry::SingleExceptionInterface>

Extracts SDK’s internal exception container (not actual exception objects) from an given event.

Returns:



81
82
83
 
# File 'lib/sentry/test_helper.rb', line 81

def extract_sentry_exceptions(event)
  event&.exception&.values || []
end

#last_sentry_event ⇒ Event?

Returns the last captured event object.

Returns:



75
76
77
 
# File 'lib/sentry/test_helper.rb', line 75

def last_sentry_event
  sentry_events.last
end

#sentry_envelopes ⇒ Array<Envelope>

Returns the captured envelope objects.

Returns:



69
70
71
 
# File 'lib/sentry/test_helper.rb', line 69

def sentry_envelopes
  sentry_transport.envelopes
end

#sentry_events ⇒ Array<Event>

Returns the captured event objects.

Returns:



63
64
65
 
# File 'lib/sentry/test_helper.rb', line 63

def sentry_events
  sentry_transport.events
end

#sentry_transport ⇒ Transport

Returns:



57
58
59
 
# File 'lib/sentry/test_helper.rb', line 57

def sentry_transport
  Sentry.get_current_client.transport
end

#setup_sentry_test {|config| ... } ⇒ void

This method returns an undefined value.

Alters the existing SDK configuration with test-suitable options. Mainly:

  • Sets a dummy DSN instead of ‘nil` or an actual DSN.

  • Sets the transport to DummyTransport, which allows easy access to the captured events.

  • Disables background worker.

  • Makes sure the SDK is enabled under the current environment (“test” in most cases).

It should be called before every test case.

Yield Parameters:



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
 
# File 'lib/sentry/test_helper.rb', line 15

def setup_sentry_test(&block)
  raise "please make sure the SDK is initialized for testing" unless Sentry.initialized?
  dummy_config = Sentry.configuration.dup
  # configure dummy DSN, so the events will not be sent to the actual service
  dummy_config.dsn = DUMMY_DSN
  # set transport to DummyTransport, so we can easily intercept the captured events
  dummy_config.transport.transport_class = Sentry::DummyTransport
  # make sure SDK allows sending under the current environment
  dummy_config.enabled_environments += [dummy_config.environment] unless dummy_config.enabled_environments.include?(dummy_config.environment)
  # disble async event sending
  dummy_config.background_worker_threads = 0

  # user can overwrite some of the configs, with a few exceptions like:
  # - include_local_variables
  # - auto_session_tracking
  block&.call(dummy_config)

  # the base layer's client should already use the dummy config so nothing will be sent by accident
  base_client = Sentry::Client.new(dummy_config)
  Sentry.get_current_hub.bind_client(base_client)
  # create a new layer so mutations made to the testing scope or configuration could be simply popped later
  Sentry.get_current_hub.push_scope
  test_client = Sentry::Client.new(dummy_config.dup)
  Sentry.get_current_hub.bind_client(test_client)
end

#teardown_sentry_test ⇒ void

This method returns an undefined value.

Clears all stored events and envelopes. It should be called after every test case.



44
45
46
47
48
49
50
51
52
53
54
 
# File 'lib/sentry/test_helper.rb', line 44

def teardown_sentry_test
  return unless Sentry.initialized?

  # pop testing layer created by `setup_sentry_test`
  # but keep the base layer to avoid nil-pointer errors
  # TODO: find a way to notify users if they somehow popped the test layer before calling this method
  if Sentry.get_current_hub.instance_variable_get(:@stack).size > 1
    Sentry.get_current_hub.pop_scope
  end
  Sentry::Scope.global_event_processors.clear
end