📰 XML Streamify

 

Fetch and parse XML documents using the power of JavaScript web streams and async iterators ✨

* Small, fast, zero dependencies †
* Work with data before the fetch is complete
* Cross-runtime support (Bun, Deno, Node, and web browsers)

This is experimental work in progress. But it does seem to work. It was designed to parse RSS feeds.

Usage

The parse generator function is the main export. Below is a basic example that logs RSS item titles as they're found:

``javascript
import {parse} from "@dbushell/xml-streamify";

for await (const node of parse('https://dbushell.com/rss.xml')) {
if (node.is('channel', 'item')) {
console.log(node.first('title').innerText);
}
}
`

See src/types.ts for parse options.

parse uses a lower level XMLStream that can be used alone:

`javascript
const response = await fetch('https://dbushell.com/rss.xml');
const stream = response.body.pipeThrough(new XMLStream());
for await (const [type, value] of stream) {
// e.g. declaration:
console.log(${type}: ${value});
}
`

Advanced

See the examples directory for more advanced and platform specific examples.

In the examples/advanced directory there is a Deno web server. It will proxy RSS feeds, add CORS headers, and throttle streaming speed for testing. Run deno run -A examples/advanced/mod.ts for the full example script.

Notes

This project may not be fully XML compliant. It can handle XHTML in some cases. It will not parse HTML where elements like are not self-closing and

Browsers may need a polyfill until they support async iterator on ReadableStream`.

† bring your own HTML entities decoder

*

MIT License | Copyright © 2024 David Bushell