Network.HTTP.Conduit.Browser

Documentation

data BrowserState

type BrowserAction = StateT BrowserState (ResourceT IO)

browse :: Manager -> BrowserAction a -> ResourceT IO a

Do the browser action with the given manager

makeRequest :: Request (ResourceT IO) -> BrowserAction (Response (Source (ResourceT IO) ByteString))

Make a request, using all the state in the current BrowserState

defaultState :: Manager -> BrowserState

getBrowserState :: BrowserAction BrowserState

You can save and restore the state at will

setBrowserState :: BrowserState -> BrowserAction ()

withBrowserState :: BrowserState -> BrowserAction a -> BrowserAction a

getMaxRedirects :: BrowserAction Int

The number of redirects to allow

setMaxRedirects :: Int -> BrowserAction ()

getMaxRetryCount :: BrowserAction Int

The number of times to retry a failed connection

setMaxRetryCount :: Int -> BrowserAction ()

getAuthorities :: BrowserAction (Request (ResourceT IO) -> Maybe (ByteString, ByteString))

A user-provided function that provides optional authorities. This function gets run on all requests before they get sent out. The output of this function is applied to the request.

setAuthorities :: (Request (ResourceT IO) -> Maybe (ByteString, ByteString)) -> BrowserAction ()

getCookieFilter :: BrowserAction (Request (ResourceT IO) -> Cookie -> IO Bool)

Each new Set-Cookie the browser encounters will pass through this filter. Only cookies that pass the filter (and are already valid) will be allowed into the cookie jar

setCookieFilter :: (Request (ResourceT IO) -> Cookie -> IO Bool) -> BrowserAction ()

getCookieJar :: BrowserAction CookieJar

All the cookies!

setCookieJar :: CookieJar -> BrowserAction ()

getCurrentProxy :: BrowserAction (Maybe Proxy)

An optional proxy to send all requests through

setCurrentProxy :: Maybe Proxy -> BrowserAction ()

getUserAgent :: BrowserAction ByteString

What string to report our user-agent as

setUserAgent :: ByteString -> BrowserAction ()

getManager :: BrowserAction Manager

The active manager, managing the connection pool

setManager :: Manager -> BrowserAction ()