radi-fetch is the official HTTP client for Radi.js. It deeply integrates with Radi for seamless application building.
To install the stable version:
npm install --save radi-fetch
This assumes you are using npm as your package manager.
If you're not, you can access these files on unpkg, download them, or point your package manager to them.
radi-fetch currently is compatible with browsers that support ES5.
Here is how it works. We start by initiating plugin for Radi Radi.plugin(/* radi-fetch */, /* config */). Config here is optional, but we can define crucial parts of http client.
import RadiFetch from 'radi-fetch'
Radi.plugin(RadiFetch)or
import RadiFetch from 'radi-fetch'
Radi.plugin(RadiFetch, {
/* We can define base url */
baseUrl: 'https://example.com',
/* We can define headers */
headers: {
'Authorization': 'key',
},
/* We can define dummy data that will be returned for requests made with radi-fetch */
dummy: true, // Should return dummy data or use real requests
dummyTimeout: 1000, // Dummy data latency simulation
dummyData: { // Actual dummy data
get: {
'/api': {
hello: 'world',
},
},
},
});That's it, we're ready to go. We can start fetching our api or whatever we want by using fetch by $fetch[type](url, params, headers) handle.
Response can be automatically parsed as JSON by using .json() method, or .text() for plain text response.
class MyComponent extends Radi.Component {
on() {
return {
mount() {
this.$fetch.get('/test')
.then(response => {
console.log(response.json())
})
.catch(error => {
console.log('Got some', error)
})
}
}
}
}Fetch automatically sets loading state for any ongoing request. We can listen to them in radi using $loading handle.
/* @jsx Radi.r */
class MyComponent extends Radi.Component {
view() {
return (
<ul>
<li>/api is { this.$loading.state['/api'] ? 'loading' : 'ready' }</li>
<li>Number of active requests: { this.$loading.state.$count }</li>
<li>Anything loading: { this.$loading.state.$any }</li>
</ul>
)
}
}Copyright (c) 2018-present, Marcis (Marcisbee) Bergmanis