mirror of
https://github.com/ilyakooo0/purescript-indexedDB.git
synced 2024-09-11 06:55:48 +03:00
add documentation to IDBDatabase
This commit is contained in:
parent
e3e8c10e95
commit
5ec6af3d40
@ -1,3 +1,5 @@
|
||||
-- | Each origin has an associated set of databases. A database has zero or more object
|
||||
-- | stores which hold the data stored in the database.
|
||||
module Database.IndexedDB.IDBDatabase
|
||||
( class IDBDatabase, close, createObjectStore, deleteObjectStore, transaction
|
||||
, StoreName
|
||||
@ -16,7 +18,7 @@ import Control.Monad.Aff (Aff)
|
||||
import Control.Monad.Eff (Eff)
|
||||
import Control.Monad.Eff.Exception (Error)
|
||||
import Data.Function.Uncurried as Fn
|
||||
import Data.Function.Uncurried (Fn2, Fn3, Fn4)
|
||||
import Data.Function.Uncurried (Fn2, Fn3)
|
||||
|
||||
import Database.IndexedDB.Core
|
||||
import Database.IndexedDB.IDBObjectStore (IDBObjectStoreParameters)
|
||||
@ -25,10 +27,23 @@ import Database.IndexedDB.IDBObjectStore (IDBObjectStoreParameters)
|
||||
--------------------
|
||||
-- INTERFACE
|
||||
--
|
||||
-- | The IDBDatabase interface represents a connection to a database.
|
||||
class IDBDatabase db where
|
||||
-- | Closes the connection once all running transactions have finished.
|
||||
close :: forall e. db -> Aff (idb :: IDB | e) Unit
|
||||
|
||||
-- | Creates a new object store with the given name and options and returns a new IDBObjectStore.
|
||||
-- |
|
||||
-- | Throws a "InvalidStateError" DOMException if not called within an upgrade transaction
|
||||
createObjectStore :: forall e. db -> StoreName -> IDBObjectStoreParameters -> Aff (idb :: IDB | e) ObjectStore
|
||||
|
||||
-- | Deletes the object store with the given name.
|
||||
-- |
|
||||
-- | Throws a "InvalidStateError" DOMException if not called within an upgrade transaction.
|
||||
deleteObjectStore :: forall e. db -> StoreName -> Aff (idb :: IDB | e) ObjectStore
|
||||
|
||||
-- | Returns a new transaction with the given mode (ReadOnly|ReadWrite)
|
||||
-- | and scope which in the form of an array of object store names.
|
||||
transaction :: forall e. db -> Array StoreName -> TransactionMode -> Aff (idb :: IDB | e) Transaction
|
||||
|
||||
|
||||
@ -38,17 +53,26 @@ type StoreName = String
|
||||
--------------------
|
||||
-- ATTRIBUTES
|
||||
--
|
||||
name :: Database -> String
|
||||
-- | Returns the name of the database.
|
||||
name
|
||||
:: Database
|
||||
-> String
|
||||
name =
|
||||
_name
|
||||
|
||||
|
||||
objectStoreNames :: Database -> Array String
|
||||
-- | Returns a list of the names of object stores in the database.
|
||||
objectStoreNames
|
||||
:: Database
|
||||
-> Array String
|
||||
objectStoreNames =
|
||||
_objectStoreNames
|
||||
|
||||
|
||||
version :: Database -> Int
|
||||
-- | Returns the version of the database
|
||||
version
|
||||
:: Database
|
||||
-> Int
|
||||
version =
|
||||
_version
|
||||
|
||||
@ -56,27 +80,47 @@ version =
|
||||
--------------------
|
||||
-- EVENT HANDLERS
|
||||
--
|
||||
onAbort :: forall e e'. Database -> Eff ( | e') Unit -> Aff (idb :: IDB | e) Unit
|
||||
-- | Event handler for the `abort` event
|
||||
onAbort
|
||||
:: forall e e'
|
||||
. Database
|
||||
-> Eff ( | e') Unit
|
||||
-> Aff (idb :: IDB | e) Unit
|
||||
onAbort db f =
|
||||
Fn.runFn2 _onAbort db f
|
||||
|
||||
|
||||
onClose :: forall e e'. Database -> Eff ( | e') Unit -> Aff (idb :: IDB | e) Unit
|
||||
-- | Event handler for the `close` event
|
||||
onClose
|
||||
:: forall e e'
|
||||
. Database
|
||||
-> Eff ( | e') Unit
|
||||
-> Aff (idb :: IDB | e) Unit
|
||||
onClose db f =
|
||||
Fn.runFn2 _onClose db f
|
||||
|
||||
|
||||
onError :: forall e e'. Database -> (Error -> Eff ( | e') Unit) -> Aff (idb :: IDB | e) Unit
|
||||
-- | Event handler for the `error` event
|
||||
onError
|
||||
:: forall e e'
|
||||
. Database
|
||||
-> (Error -> Eff ( | e') Unit)
|
||||
-> Aff (idb :: IDB | e) Unit
|
||||
onError db f =
|
||||
Fn.runFn2 _onError db f
|
||||
|
||||
|
||||
onVersionChange :: forall e e'. Database -> ({ oldVersion :: Int, newVersion :: Int } -> Eff ( | e') Unit) -> Aff (idb :: IDB | e) Unit
|
||||
-- | Event handler for the `versionchange` event
|
||||
onVersionChange
|
||||
:: forall e e'
|
||||
. Database
|
||||
-> ({ oldVersion :: Int, newVersion :: Int }
|
||||
-> Eff ( | e') Unit)
|
||||
-> Aff (idb :: IDB | e) Unit
|
||||
onVersionChange db f =
|
||||
Fn.runFn2 _onVersionChange db f
|
||||
|
||||
|
||||
|
||||
--------------------
|
||||
-- INSTANCES
|
||||
--
|
||||
@ -97,34 +141,57 @@ instance idbDatabaseDatabase :: IDBDatabase Database where
|
||||
--------------------
|
||||
-- FFI
|
||||
--
|
||||
foreign import _close :: forall db e. db -> Aff (idb :: IDB | e) Unit
|
||||
foreign import _close
|
||||
:: forall db e
|
||||
. db
|
||||
-> Aff (idb :: IDB | e) Unit
|
||||
|
||||
|
||||
foreign import _createObjectStore :: forall db e. Fn3 db String { keyPath :: Array String, autoIncrement :: Boolean } (Aff (idb :: IDB | e) ObjectStore)
|
||||
foreign import _createObjectStore
|
||||
:: forall db e
|
||||
. Fn3 db String { keyPath :: Array String, autoIncrement :: Boolean } (Aff (idb :: IDB | e) ObjectStore)
|
||||
|
||||
|
||||
foreign import _deleteObjectStore :: forall db e. Fn2 db String (Aff (idb :: IDB | e) ObjectStore)
|
||||
foreign import _deleteObjectStore
|
||||
:: forall db e
|
||||
. Fn2 db String (Aff (idb :: IDB | e) ObjectStore)
|
||||
|
||||
|
||||
foreign import _name :: Database -> String
|
||||
foreign import _name
|
||||
:: Database
|
||||
-> String
|
||||
|
||||
|
||||
foreign import _objectStoreNames :: Database -> Array String
|
||||
foreign import _objectStoreNames
|
||||
:: Database
|
||||
-> Array String
|
||||
|
||||
|
||||
foreign import _onAbort :: forall db e e'. Fn2 db (Eff ( | e') Unit) (Aff (idb :: IDB | e) Unit)
|
||||
foreign import _onAbort
|
||||
:: forall db e e'
|
||||
. Fn2 db (Eff ( | e') Unit) (Aff (idb :: IDB | e) Unit)
|
||||
|
||||
|
||||
foreign import _onClose :: forall db e e'. Fn2 db (Eff ( | e') Unit) (Aff (idb :: IDB | e) Unit)
|
||||
foreign import _onClose
|
||||
:: forall db e e'
|
||||
. Fn2 db (Eff ( | e') Unit) (Aff (idb :: IDB | e) Unit)
|
||||
|
||||
|
||||
foreign import _onError :: forall db e e'. Fn2 db (Error -> Eff ( | e') Unit) (Aff (idb :: IDB | e) Unit)
|
||||
foreign import _onError
|
||||
:: forall db e e'
|
||||
. Fn2 db (Error -> Eff ( | e') Unit) (Aff (idb :: IDB | e) Unit)
|
||||
|
||||
|
||||
foreign import _onVersionChange :: forall db e e'. Fn2 db ({ oldVersion :: Int, newVersion :: Int } -> Eff ( | e') Unit) (Aff (idb :: IDB | e) Unit)
|
||||
foreign import _onVersionChange
|
||||
:: forall db e e'
|
||||
. Fn2 db ({ oldVersion :: Int, newVersion :: Int } -> Eff ( | e') Unit) (Aff (idb :: IDB | e) Unit)
|
||||
|
||||
|
||||
foreign import _transaction :: forall db e. Fn3 db (Array String) String (Aff (idb :: IDB | e) Transaction)
|
||||
foreign import _transaction
|
||||
:: forall db e
|
||||
. Fn3 db (Array String) String (Aff (idb :: IDB | e) Transaction)
|
||||
|
||||
|
||||
foreign import _version :: Database -> Int
|
||||
foreign import _version
|
||||
:: Database
|
||||
-> Int
|
||||
|
Loading…
Reference in New Issue
Block a user