Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/paulsmithkc/bassoon
A simplified and optimized fork of oboejs. This package will allow you to easily and efficiently stream an array of JSON objects to your front-end.
https://github.com/paulsmithkc/bassoon
ajax bassoon clarinet expressjs fetch front-end json micro-library nodejs npm-module npm-package oboejs sax-parser stream web-worker xhttp xhttprequest
Last synced: about 1 month ago
JSON representation
A simplified and optimized fork of oboejs. This package will allow you to easily and efficiently stream an array of JSON objects to your front-end.
- Host: GitHub
- URL: https://github.com/paulsmithkc/bassoon
- Owner: paulsmithkc
- License: mit
- Created: 2020-12-05T13:15:31.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-12-13T14:07:23.000Z (11 months ago)
- Last Synced: 2024-09-29T12:40:55.315Z (about 2 months ago)
- Topics: ajax, bassoon, clarinet, expressjs, fetch, front-end, json, micro-library, nodejs, npm-module, npm-package, oboejs, sax-parser, stream, web-worker, xhttp, xhttprequest
- Language: JavaScript
- Homepage:
- Size: 828 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# Bassoon.js
A simplified and optimized fork of [oboejs.](http://oboejs.com/) This package will allow you to easily and efficiently stream an array of JSON objects to your front-end.
## Install w/ Express
First install the npm package.
```
npm install bassoon
```
Then serve the built script files up.
```
app.use('/bassoon', express.static('node_modules/bassoon/dist'));
```
And finally link the script in your HTML/view.
```
```
## Basic Usage
To stream an array of JSON objects subscribe to the **data,** **end,** and **error** events.
```
bassoon('/api/example/list')
.on('data', (data) => { /* object received... */ }))
.on('end', (evt) => { /* end of stream... */ })
.on('error', (err) => { /* error occurred, stream stopped... */ });
```
- The **data** event is fired every time an object is parsed from the response.
- The **end** event is fired once the response is fully loaded.
- The **error** event is fired if anything goes wrong.
## Advanced Usage
A variety of arguments can be passed to bassoon as well.
```
bassoon({
url: '/api/example/list',
method: 'GET',
withCredentials: false,
chunkSize: 10,
})
.on('data', (data) => { /* object received... */ }))
.on('end', (evt) => { /* end of stream... */ })
.on('error', (err) => { /* error occurred, stream stopped... */ });
```
- **url** the URL of the JSON resource to be retrieved and processed incrementally.
- **method** the HTTP verb to retrieve the resource with ("GET" by default)
- **withCredentials** passed to [xhr.withCredentials](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/withCredentials) (false by default)
- **chunkSize** Rather than triggering a data event for each object, group them into chunks and send each chunk as an array. chunkSize specifies the maximum size for each chunk, but chunks may be smaller than the chunkSize. (chunking disabled by default)
- **worker** Offload the work to web worker. (default false)
- **workerPath** Path to worker script file. (default "/bassoon/bassoon.worker.js")
- **verbose** Enable verbose logging. (default false)
## Web Worker
For better performance bassoon can stream data using the provided web worker script.
```
bassoon({ url: '/api/example/list', worker: true })
.on('data', (data) => { /* object received... */ }))
.on('end', (evt) => { /* end of stream... */ })
.on('error', (err) => { /* error occurred, stream stopped... */ });
```
## Related
- [Why Oboe.js?](http://oboejs.com/why)
- [Node.js Streams (for server-side streaming)](https://nodejs.dev/learn/nodejs-streams)
- [Streaming Data with XHR API](https://hpbn.co/xmlhttprequest/#streaming-data-with-xhr)
- [Oracle Docs: Parsing an XML file using SAX](https://docs.oracle.com/javase/tutorial/jaxp/sax/parsing.html)
- [npm oboe](https://www.npmjs.com/package/oboe)
- [npm clarinet](https://www.npmjs.com/package/clarinet)
- [npm sax](https://www.npmjs.com/package/sax)