Warning: Reason support is experimental. We are looking for beta-tester and contributors.

Module Eliom_comet.Configuration

module Configuration : sig..end

Change the reactivity of channels. Multiples configurations ( of type t ) can be created. The resulting behaviour is the minimal ( in the meaning of maximal reactivity ) between all configurations


type t
val new_configuration : unit -> t

Creates a new configuration with default value. It modifies the current behaviour immediately

val drop_configuration : t -> unit

drop_configuration t restores the behaviour to the minimum of configuration without t. If there is no other configuration than t, it is restored to the defaults.

val set_always_active : t -> bool -> unit

set_always_active c b if b is true, tells the client to always stay active. Default value is false.

val set_timeout : t -> float -> unit

set_timeout c t tells the client to stay active at least t seconds when the application lose the focus. Default value is 180.

val set_active_until_timeout : t -> bool -> unit

set_active_until_timeout c v sets the activity changing behaviour. if v is true the page is kept active even if not focused until the client receive a timeout message from the server. It implies that if the server keeps sending data to the client, the comet connection will never be closed. Default value is false.

val set_time_between_requests : t -> float -> unit

after set_time_between_requests t v, the main loop will wait for v seconds between two requests. It is taken into account immediately. Default value is 0.

val set_time_between_requests_when_idle : 
  t -> float * float * float -> unit

set_time_between_requests_when_idle t (a, b, c) sets the time between two requests when the the windows does not have the focus, after the timeout. This amount of time is computed using an affine function (a * T + b), where T is the amount of time elapsed since the beginning of the idle phase, with a maximal time of c. If you want no request at all, do set_always_active false. Setting this to (0., 0., 0.) is equivalent to set_always_active true. Default value is (0.5, 60., 600.).