Skip to content

stkb/purescript-affjax

 
 

Repository files navigation

purescript-affjax

Build Status

A library taking advantage of purescript-aff to enable pain-free asynchronous AJAX requests and response handling.

Getting Started

Installation

bower install purescript-affjax

If you are intending to use the library in a Node.js setting rather than the browser, you will need an additional dependency from npm:

npm install xhr2

Introduction

You can construct requests with the affjax function:

main = launchAff $ do
  res <- affjax $ defaultRequest { url = "/api", method = GET }
  liftEff $ log $ "GET /api response: " ++ res.response

(defaultRequest is a record value that has all the required fields pre-set for convenient overriding when making a request.)

Or use of a number of helpers for common cases:

main = launchAff $ do
  res1 <- get "/api"
  liftEff $ log $ "GET /api response: " ++ res1.response

  res2 <- post "/api" someData
  liftEff $ log $ "POST /api response: " ++ res2.response

See the module documentation for a full list of these helpers.

When sending data in a request the Requestable class enables automatic conversion into a format that is acceptable for an XHR request. Correspondingly there is a Respondable class for reading data that comes back from the server.

Module documentation

General HTTP

Note: these values and types will most likely be moved into separate libraries at a later date.

About

An asynchronous AJAX library built using Aff.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PureScript 81.8%
  • JavaScript 18.2%