123456789_123456789_123456789_123456789_123456789_

Class: ActionDispatch::PermissionsPolicy

Relationships & Source Files
Namespace Children
Modules:
Request
Classes:
Middleware
Inherits: Object
Defined in: actionpack/lib/action_dispatch/http/permissions_policy.rb

Overview

Configures the HTTP Feature-Policy response header to specify which browser features the current document and its iframes can use.

Example global policy:

Rails.application.config.permissions_policy do |policy|
  policy.camera      :none
  policy.gyroscope   :none
  policy.microphone  :none
  policy.usb         :none
  policy.fullscreen  :self
  policy.payment     :self, "https://secure.example.com"
end

The Feature-Policy header has been renamed to Permissions-Policy. The Permissions-Policy requires a different implementation and isn’t yet supported by all browsers. To avoid having to rename this middleware in the future we use the new name for the middleware but keep the old header name and implementation for now.

Constant Summary

Class Method Summary

Instance Attribute Summary

Instance Method Summary

Constructor Details

.new {|_self| ... } ⇒ PermissionsPolicy

Yields:

  • (_self)

Yield Parameters:

  • _self (PermissionsPolicy) —

    the object that the method was called on

[ GitHub ] 

  


# File 'actionpack/lib/action_dispatch/http/permissions_policy.rb', line 109



def initialize
  @directives = {}
  yield self if block_given?
end


  







Instance Attribute Details



  

    #directives   (readonly)
  

  [ GitHub ]


  

  


# File 'actionpack/lib/action_dispatch/http/permissions_policy.rb', line 107



attr_reader :directives


  







Instance Method Details



  

    #build(context = nil)  
  

  [ GitHub ]


  

  


# File 'actionpack/lib/action_dispatch/http/permissions_policy.rb', line 147



def build(context = nil)
  build_directives(context).compact.join("; ")
end


  








  

    #initialize_copy(other)  
  

  [ GitHub ]


  

  


# File 'actionpack/lib/action_dispatch/http/permissions_policy.rb', line 114



def initialize_copy(other)
  @directives = other.directives.deep_dup
end