streaming html templates
like hyperstream, but faster. it does not support all hyperstream features.
- inserting text; only html is supported
- prepending or appending to attributes
npm install hstream
var hyperstream =
Create a through stream that applies
updates is an object with CSS
selectors for keys. Values can be different types depending on what sort of
update you want to do.
Selectors support the most common CSS features, like matching tag names, classes, IDs, attributes. Pseudo selectors are not supported, but PRs are welcome.
Pass a stream or string to replace the matching element's contents with some
HTML. Pass an object to set attributes on the matching element or do some
special operations. When passing an object, you can use keys prefixed with
for the following special operations:
_html- Replace the matching element's contents with some HTML
_prependHtml- Prepend some HTML to the matching element
_appendHtml- Append some HTML to the matching element
_replaceHtml- Replace the entire element with some HTML
All properties accept streams and strings.
_replaceHtml can also be a function. Then they are called with
the html contents of the element being replaced, and should return a stream or
When setting attributes, you can also use a function that receives the value of the attribute as the only parameter and that returns a stream or string with the new contents.
npm run bench.
NANOBENCH version 2 > /usr/bin/node bench/hstream.js # 10× single transform ok ~794 ms (0 s + 794449201 ns) # many transforms ok ~595 ms (0 s + 594909989 ns) # small file ok ~20 ms (0 s + 19878309 ns) all benchmarks completed ok ~1.41 s (1 s + 409237499 ns)
NANOBENCH version 2 > /usr/bin/node bench/hyperstream.js # 10× single transform ok ~4.7 s (4 s + 697728691 ns) # many transforms ok ~5.02 s (5 s + 23333119 ns) # small file ok ~740 ms (0 s + 739903018 ns) all benchmarks completed ok ~10 s (10 s + 460964828 ns)