remote data

Données distantes

De minuscules outils (moins de 450 octets) pour récupérer des données à partir de sources distantes (y compris HTTP). Pour un article détaillé expliquant pourquoi Remote Data est utile, lisez cet article.

Installation

MNP

 $ npm install @roebuk/remote-data

Modules ES

 < script type =" module " >
  import RemoteData from 'https://cdn.skypack.dev/@roebuk/remote-data' ;
</ script > 

Balise de script

 < script src =" https://unpkg.com/@roebuk/remote-data " > </ script > 

Documentation

Documentation sur l'API

Exemple de base

 import * as RemoteData from '@roebuk/remote-data' ;

// Set the initial state
var remoteUsers = RemoteData . NotAsked ( ) ;

// An interaction starts off the request
remoteUsers = RemoteData . Loading ( ) ;

// Once the request is complete,
// it will either be in a `Success` or `Failure` state.
remoteUsers = await fetch ( '/api/users' )
                        . then ( res => res . json ( ) )
                        . then ( users => RemoteData . Success ( users ) )
                        . catch ( err => RemoteData . Failure ( err ) ) ;


// "Pattern match" on the RemoteData type and extract the current state. 
// The return value of the functions should all be of the same type.
RemoteData . match ( {
    notAsked : ( ) => 'Not Requested the data'
    loading : ( ) = > 'Loading...'
    success : users => `Loaded ${ users . length } users` ,
    failed : err => `Something when wrong. Details: ${ err . message } `
} , remoteUsers ) ; 

Exemple de réaction

React et données distantes sur StackBlitz

Construction et tests

 npm ci
npm run build
npm t