pseu·dom (_experimental_) mjs/esm

Documentless OM for markup.

Note: This package is intended for environments with native ECMAScript module support to directly import 'pseudom' or import 'https://unpkg.com/pseudom/' without the need for bundling.

_Node.js_ (8.x until 11.x — _experimental only_)

You must use --experimental-modules flag in Node.js which uses pseudom/index.mjs to load ESM modules from files ending with ".mjs" only.

_Node.js_ (12.x forward — _experimental only_)

You must use --experimental-modules flag in Node.js then import 'pseudom' which still uses pseudom/index.mjs or alternatively import 'pseudo/pseudom.js' to load identical ESM modules from files ending with ".js" instead — this is likely to change.

Why?

While in most cases, it is best to rely on the DOM directly, there are times when the DOM may not be available, sluggish, or simply hitting edge cases where the overhead is unpredictable or undesirable.

This package was extracted from such a project, where the DOM was just not right. The intent was to provide a mirrored pipeline to compose DocumentFragments in workers. However, due to the improved performance and modularity, a shift to a more complete implementation that could be use in the main thread, workers, and Node.js was more than justified.

If you find pseu·dom suitable for your particular case, please don't hesitate to contribute to this project. If not, please let me know why.

What it tries to do

- Provide a lightweight OM alternative for markup composition.
- Provide a mirrored DOM wrapper for transparent interoperability.
- Reduce overhead by allowing elements to belong to multiple parents.
- Seemlessly go where the DOM can't.
- Promote fast rendering into the DOM (ie HTMLTemplateElement or innerHTML).

What it does NOT try to do

- Work with actual documents or elements (ie either or).
- Act like a DOM or a virtual DOM (ie events and such).
- Adhere to the standards (ie completeness).