Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Koa middleware to return streaming JSON responses using AsyncIterators

License

koajs/json-async-iterator

@koa/json-async-iterator

Koa JSON response body streaming for async iterators

Usage

const jsonAsyncIterator = require('@koa/json-async-iterator')
const app = new Koa()
app.use(jsonAsyncIterator())
app.use(async ctx => {
 const iterator = async function* () {
 yield Promise.resolve({ foo: 'bar' })
 yield Promise.resolve({ baz: 'qux' })
 }
 ctx.body = iterator()
})

Output:

[
{"foo":"bar"}
,
{"baz":"qux"}
]

Example with PostgreSQL:

import QueryStream from 'pg-query-stream'
import pg from 'pg'
const client = new pg.Client()
await client.connect()
// later in your middleware
app.use(async (ctx) => {
 // stream all the rows from the database to the client
 ctx.body = client.query(new QueryStream(`
 SELECT * 
 FROM posts
 ORDER BY id ASC
 `))
})

Options

before

The string to write before the first value in the iterator.

Default: '[\n'

separator

The string to write between each value in the iterator.

Default: '\n,\n'

after

The string to write after the last value in the iterator.

Default: '\n]'

formatError

A function that takes an error and returns a value to be stringified.

Default: (err) => ({ error: { message: err.message } })

pretty

Whether to pretty-print the JSON.

Default: false

spaces

The number of spaces to use for pretty-printing.

Default: 2

License

MIT

About

Koa middleware to return streaming JSON responses using AsyncIterators

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

AltStyle によって変換されたページ (->オリジナル) /