Module: ActionController::TestCase::Behavior

Extended by:
ActiveSupport::Concern
Includes:
ActionDispatch::TestProcess, ActiveSupport::Testing::ConstantLookup, Rails::Dom::Testing::Assertions
Included in:
ActionController::TestCase
Defined in:
lib/action_controller/test_case.rb

Defined Under Namespace

Modules: ClassMethods

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from ActionDispatch::TestProcess

#assigns, #cookies, #fixture_file_upload, #flash, #redirect_to_url, #session

Instance Attribute Details

#request ⇒ Object (readonly)

Returns the value of attribute request.



320
321
322
 
# File 'lib/action_controller/test_case.rb', line 320

def request
  @request
end

#response ⇒ Object (readonly)

Returns the value of attribute response.



320
321
322
 
# File 'lib/action_controller/test_case.rb', line 320

def response
  @response
end

Instance Method Details

#build_response(klass) ⇒ Object 



605
606
607
 
# File 'lib/action_controller/test_case.rb', line 605

def build_response(klass)
  klass.create
end

#controller_class_name ⇒ Object 



565
566
567
 
# File 'lib/action_controller/test_case.rb', line 565

def controller_class_name
  @controller.class.anonymous? ? "anonymous" : @controller.class.controller_path
end

#delete(action, *args) ⇒ Object

Simulate a DELETE request with the given parameters and set/volley the response. See get for more details.



406
407
408
 
# File 'lib/action_controller/test_case.rb', line 406

def delete(action, *args)
  process_with_kwargs("DELETE", action, *args)
end

#generated_path(generated_extras) ⇒ Object 



569
570
571
 
# File 'lib/action_controller/test_case.rb', line 569

def generated_path(generated_extras)
  generated_extras[0]
end

#get(action, *args) ⇒ Object

Simulate a GET request with the given parameters.

  • action: The controller action to call.

  • params: The hash with HTTP parameters that you want to pass. This may be nil.

  • body: The request body with a string that is appropriately encoded (application/x-www-form-urlencoded or multipart/form-data).

  • session: A hash of parameters to store in the session. This may be nil.

  • flash: A hash of parameters to store in the flash. This may be nil.

You can also simulate POST, PATCH, PUT, DELETE, and HEAD requests with post, patch, put, delete, and head. Example sending parameters, session and setting a flash message:

get :show,
  params: { id: 7 },
  session: { user_id: 1 },
  flash: { notice: 'This is flash message' }

Note that the request method is not verified. The different methods are available to make the tests more expressive.



380
381
382
383
384
 
# File 'lib/action_controller/test_case.rb', line 380

def get(action, *args)
  res = process_with_kwargs("GET", action, *args)
  cookies.update res.cookies
  res
end

#head(action, *args) ⇒ Object

Simulate a HEAD request with the given parameters and set/volley the response. See get for more details.



412
413
414
 
# File 'lib/action_controller/test_case.rb', line 412

def head(action, *args)
  process_with_kwargs("HEAD", action, *args)
end

#patch(action, *args) ⇒ Object

Simulate a PATCH request with the given parameters and set/volley the response. See get for more details.



394
395
396
 
# File 'lib/action_controller/test_case.rb', line 394

def patch(action, *args)
  process_with_kwargs("PATCH", action, *args)
end

#post(action, *args) ⇒ Object

Simulate a POST request with the given parameters and set/volley the response. See get for more details.



388
389
390
 
# File 'lib/action_controller/test_case.rb', line 388

def post(action, *args)
  process_with_kwargs("POST", action, *args)
end

#process(action, *args) ⇒ Object

Simulate an HTTP request to action by specifying request method, parameters and set/volley the response.

  • action: The controller action to call.

  • method: Request method used to send the HTTP request. Possible values are GET, POST, PATCH, PUT, DELETE, HEAD. Defaults to GET. Can be a symbol.

  • params: The hash with HTTP parameters that you want to pass. This may be nil.

  • body: The request body with a string that is appropriately encoded (application/x-www-form-urlencoded or multipart/form-data).

  • session: A hash of parameters to store in the session. This may be nil.

  • flash: A hash of parameters to store in the flash. This may be nil.

  • format: Request format. Defaults to nil. Can be string or symbol.

Example calling create action and sending two params:

process :create,
  method: 'POST',
  params: {
    user: { name: 'Gaurish Sharma', email: '[email protected]' }
  },
  session: { user_id: 1 },
  flash: { notice: 'This is flash message' }

To simulate GET, POST, PATCH, PUT, DELETE and HEAD requests prefer using #get, #post, #patch, #put, #delete and #head methods respectively which will make tests more expressive.

Note that the request method is not verified.



459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
 
# File 'lib/action_controller/test_case.rb', line 459

def process(action, *args)
  check_required_ivars

  if kwarg_request?(args)
    parameters, session, body, flash, http_method, format, xhr = args[0].values_at(:params, :session, :body, :flash, :method, :format, :xhr)
  else
    http_method, parameters, session, flash = args
    format = nil

    if parameters.is_a?(String) && http_method != 'HEAD'
      body = parameters
      parameters = nil
    end

    if parameters || session || flash
      non_kwarg_request_warning
    end
  end

  if body
    @request.set_header 'RAW_POST_DATA', body
  end

  if http_method
    http_method = http_method.to_s.upcase
  else
    http_method = "GET"
  end

  parameters ||= {}

  if format
    parameters[:format] = format
  end

  @html_document = nil

  self.cookies.update @request.cookies
  self.cookies.update_cookies_from_jar
  @request.set_header 'HTTP_COOKIE', cookies.to_header
  @request.delete_header 'action_dispatch.cookies'

  @request          = TestRequest.new scrub_env!(@request.env), @request.session
  @response         = build_response @response_klass
  @response.request = @request
  @controller.recycle!

  @request.set_header 'REQUEST_METHOD', http_method

  parameters = parameters.symbolize_keys

  generated_extras = @routes.generate_extras(parameters.merge(controller: controller_class_name, action: action.to_s))
  generated_path = generated_path(generated_extras)
  query_string_keys = query_parameter_names(generated_extras)

  @request.assign_parameters(@routes, controller_class_name, action.to_s, parameters, generated_path, query_string_keys)

  @request.session.update(session) if session
  @request.flash.update(flash || {})

  if xhr
    @request.set_header 'HTTP_X_REQUESTED_WITH', 'XMLHttpRequest'
    @request.fetch_header('HTTP_ACCEPT') do |k|
      @request.set_header k, [Mime[:js], Mime[:html], Mime[:xml], 'text/xml', '*/*'].join(', ')
    end
  end

  @request.fetch_header("SCRIPT_NAME") do |k|
    @request.set_header k, @controller.config.relative_url_root
  end

  begin
    @controller.recycle!
    @controller.dispatch(action, @request, @response)
  ensure
    @request = @controller.request
    @response = @controller.response

    @request.delete_header 'HTTP_COOKIE'

    if @request.have_cookie_jar?
      unless @request.cookie_jar.committed?
        @request.cookie_jar.write(@response)
        self.cookies.update(@request.cookie_jar.instance_variable_get(:@cookies))
      end
    end
    @response.prepare!

    if flash_value = @request.flash.to_session_value
      @request.session['flash'] = flash_value
    else
      @request.session.delete('flash')
    end

    if xhr
      @request.delete_header 'HTTP_X_REQUESTED_WITH'
      @request.delete_header 'HTTP_ACCEPT'
    end
    @request.query_string = ''

    @response.sent!
  end

  @response
end

#put(action, *args) ⇒ Object

Simulate a PUT request with the given parameters and set/volley the response. See get for more details.



400
401
402
 
# File 'lib/action_controller/test_case.rb', line 400

def put(action, *args)
  process_with_kwargs("PUT", action, *args)
end

#query_parameter_names(generated_extras) ⇒ Object 



573
574
575
 
# File 'lib/action_controller/test_case.rb', line 573

def query_parameter_names(generated_extras)
  generated_extras[1] + [:controller, :action]
end

#setup_controller_request_and_response ⇒ Object 



577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
 
# File 'lib/action_controller/test_case.rb', line 577

def setup_controller_request_and_response
  @controller = nil unless defined? @controller

  @response_klass = ActionDispatch::TestResponse

  if klass = self.class.controller_class
    if klass < ActionController::Live
      @response_klass = LiveTestResponse
    end
    unless @controller
      begin
        @controller = klass.new
      rescue
        warn "could not construct controller #{klass}" if $VERBOSE
      end
    end
  end

  @request          = TestRequest.create
  @response         = build_response @response_klass
  @response.request = @request

  if @controller
    @controller.request = @request
    @controller.params = {}
  end
end

#xml_http_request(*args) ⇒ Object Also known as: xhr 



416
417
418
419
420
421
422
423
424
425
426
427
428
 
# File 'lib/action_controller/test_case.rb', line 416

def xml_http_request(*args)
  ActiveSupport::Deprecation.warn(<<-MSG.strip_heredoc)
    xhr and xml_http_request methods are deprecated in favor of
    `get :index, xhr: true` and `post :create, xhr: true`
  MSG

  @request.env['HTTP_X_REQUESTED_WITH'] = 'XMLHttpRequest'
  @request.env['HTTP_ACCEPT'] ||= [Mime[:js], Mime[:html], Mime[:xml], 'text/xml', '*/*'].join(', ')
  __send__(*args).tap do
    @request.env.delete 'HTTP_X_REQUESTED_WITH'
    @request.env.delete 'HTTP_ACCEPT'
  end
end