ad816f7b7f
* reuse serialized nodes ids With this patch, each DOM node keeps its id during its existence. This allows to apply RRWeb events to previous snapshots if needed. `resetId` has been removed because it loses its meaning: calling it would not reset the existing nodes ids anymore, only the new ones. Since we don't reset the id anymore, we may exhaust the available ids quicker, but Number.MAX_SAFE_INTEGER (2 ** 53 - 1) is pretty large, so I doubt this'll cause any problem. * improv TS typing The `nAsINode` variable was not very elegant. Simplify this by removing the cast, and make the INode interface compatible with Node. * update typings
rrweb-snapshot
Snapshot the DOM into a stateful and serializable data structure. Also, provide the ability to rebuild the DOM via snapshot.
API
This module export following methods:
snapshot
snapshot will traverse the DOM and return a stateful and serializable data structure which can represent the current DOM view.
There are several things will be done during snapshot:
- Inline some DOM states into HTML attributes, e.g, HTMLInputElement's value.
- Turn script tags into
noscripttags to avoid scripts being executed. - Try to inline stylesheets to make sure local stylesheets can be used.
- Make relative paths in href, src, CSS to be absolute paths.
- Give an id to each Node, and return the id node map when snapshot finished.
rebuild
rebuild will build the DOM according to the taken snapshot.
There are several things will be done during rebuild:
- Add data-rrid attribute if the Node is an Element.
- Create some extra DOM node like text node to place inline CSS and some states.
- Add data-extra-child-index attribute if Node has some extra child DOM.
serializeNodeWithId
serializeNodeWithId can serialize a node into snapshot format with id.
buildNodeWithSN
buildNodeWithSN will build DOM from serialized node and store serialized information in __sn property.