Awesome
Pegasus
![](https://badge-size.herokuapp.com/typicode/pegasus/master/dist/pegasus.min.js.svg?compression=gzip)
Pegasus is a tiny lib that lets you load JSON data while loading other scripts.
If you have a static website, using this technique, you can reduce the time to display data. Works with any JS lib (React, Vue, jQuery, ...).
Before
JSON (yellow bar) is downloaded several milliseconds after the JS library (orange bar).
After (with Pegasus)
JSON (yellow bar) and the JS library (orange bar) are downloaded at the same time.
Install
Embedded (recommended)
To save a network call, it's recommended to simply paste the following code pegasus.min.js in your HTML page before other scripts.
CDN
https://unpkg.com/@typicode/pegasus/dist/pegasus.min.js
npm
$ npm install @typicode/pegasus
Please note that pegasus is available on npm under @typicode/pegasus
Demo
http://typicode.github.io/pegasus
Benchmark
Average time to display data on the demo site.
jQuery only | jQuery + Pegasus | |
---|---|---|
EDGE | 3000 ms | 2100 ms |
3G | 860 ms | 640 ms |
DSL | 270 ms | 230 ms |
Note: jQuery is used for illustration only, you can use Pegasus with any other Javascript library.
Usage example
<!-- Load (or embed) Pegasus before loading any other script -->
<script src="pegasus.min.js"></script>
<!-- Make your request(s) -->
<script>
var request = pegasus('http://api.example.com');
</script>
<!-- Load your app lib(s) -->
<script src="lib.js"></script>
<!-- Use .then() method to retrieve data in your app -->
<script>
request.then(
// success handler
function(data, xhr) {
// do something useful like
$('#data').text(JSON.stringify(data));
},
// error handler (optional)
function(data, xhr) {
console.error(data, xhr.status)
}
);
</script>
Optionally, you can set a timeout using pegasus.timeout = milliseconds
Support
All modern browsers and IE9+
License
MIT - Typicode