CHANGELOG.md

Changelog

All notable changes to the dom_query crate will be documented in this file.

[0.9.0] - 2024-11-09

Changed

• Using Tree::merge_with_fn instead of Tree::merge to reduce code duplication.
• Tree::child_ids_of_it now require rev argument. Set true to iterate children in reverse order.
• NodeRef::children_it now require rev argument. Set true to iterate children in reverse order.
• Improved internal logic of Selection::append_selection and Selection::replace_with_selection.

Added

• Introduced new NodeRef::prepend_child method, that inserts a child at the beginning of node content.
• Introduced new NodeRef::prepend_children method, that inserts a child and its siblings at the beginning of the node content.
• Introduced new NodeRef::prepend_html method, that parses html string and inserts its parsed nodes at the beginning of the node content.
• Introduced new Selection::prepend_html method, which parses an HTML string and inserts its parsed nodes at the beginning of the content of all matched nodes.
• Introduced new selection methods: Selection::add_selection, Selection:add_matcher, Selection::add and Selection::try_add to extend current selection with other selections.

Fixed

• Fixed Selection::append_selection to work with selections with multiple nodes and selections from another tree.
• Fixed Selection::replace_with_selection to work with selections with multiple nodes and selections from another tree.
• Fixed Node::append_child, Node::append_children, Node::prepend_child, and Node::prepend_children: these methods now internally remove the child/children from their previous parent node before attachment.
• Critical fix for NodeRef::first_element_child: Previously, due to a logic error, the method checked the node itself instead of its child nodes. This could have caused:
  • Incorrect element selection in DOM traversal
  • Unexpected behavior in code relying on first element child detection
  • Note: Code that depends on this method's behavior should be reviewed after upgrading

[0.8.0] - 2024-11-03

Changed

• Simplified Node::has_text.
• Replaced generic types with the concrete type NodeData, simplifying code and improving readability without affecting the public API.
• Replaced implementations for Node with implementations for NodeRef. Node is just an alias for NodeRef.
• Simplified internal logic of Selection::replace_with_html, Selection::set_html, Selection::append_html, Node::set_html, Node::append_html, and Node::replace_with_html by using Tree::merge.

Added

• Added Selection::filter , Selection::filter_matcher and Selection::try_filter methods that filter a current selection.
• Added Selection::filter_selection method that filters a current selection with another selection.
• Added NodeRef::replace_with method that allows to replace a node with another one.
• Added NodeRef::replace_with_html method that allows to replace a node with a new node created from the given HTML.
• Added NodeIdProver trait and implementations for NodeRef and Node. Which allows to call some node functions with a &NodeRef and &NodeId. Previously these functions required NodeId as a parameter.
• Added a new pseudo-class :only-text that allows selecting a node with no child elements except a single text child node.
• Added the NodeRef::set_text method, which sets the text content of a node, replacing any existing content.
• Added NodeRef::append_prev_siblings method, which allows to prepend other nodes and their siblings before the selected node.

Fixed

• Fixed <NodeRef<'a> as selectors::Element>::is_empty to correctly handle line breaks, whitespace, and ensure only elements pass the check.

Removed

• Removed Tree::append_children_from_another_tree method.
• Removed Tree::append_prev_siblings_from_another_tree method.
• Removed Node::append_children_from_another_tree method.
• Removed Node::append_prev_siblings_from_another_tree method.

[0.7.0] - 2024-10-27

Changed

• Exposed Matcher::match_element since it can be useful outside the crate.
• Changed impl<'a> selectors::Element for Node<'a>::opaque to work with :has pseudo-element from selectors crate.
• Switched to :has implementation from selectors crate.
• Internal changes due to switch to selectors v0.26.0 switch.
• Selection methods that required &mut now doesn't require &mut, finally.
• Improve performance for Document::from, Selection::select and others.
• Switched from using rustc-hash to foldhash.

Added

• Added Node::ancestors method, that allows to get all or limited number of ancestors of a node.
• Added From<Vec<NodeRef<'a, NodeData>>> for Selection<'a>
• Enable support for :is() and :where() pseudo-classes.
• Added Node::element_children method that returns children nodes, that are node_data::Elements.
• Added Node::children_it method that returns an iterator over children nodes.
• Added Node::ancestors_it method that returns an iterator over ancestors nodes.
• Added Tree:child_ids_of and Tree:child_ids_of_it methods that returns ids of the child nodes as vec and as iterator respectively.
• Added Tree:ancestor_ids_of and Tree:ancestor_ids_of_it methods that returns ids of the ancestor nodes as vec and as iterator respectively.
• Added Node::immediate_text method returns text of the node without it's descendants. Selection::immediate_text does the same thing for the every node inside selection.

[0.6.0] - 2024-10-19

Changed

• Exposed Document::tree.
• Selection methods that required &mut now doesn't require &mut.
• Changed the project structure, now modules are divided based on the struct implementations.

Added

• Added Node::append_html and Node::set_html methods for creating children nodes of a single selected node.
• Added Tree<NodeData>::new_element, an easy way to create an empty element with a given name.
• Added NodeRef::last_child.
• Added Node::has_attr method, which returns true if an attribute exists on the node element. Selection::has_attr does the same thing for the first node inside selection.
• Added Node::remove_all_attrs method for removing all attributes of a node. Selection::remove_all_attrs does the same thing for the every node inside selection.
• Added Node::remove_attrs method, a convenient way to remove multiple attributes from the node element. Selection::remove_attrs does the same thing for the every node inside selection.
• Added Node::rename method, which allows to change node's name. Selection::rename does the same thing for the every node inside selection.

[0.5.0] - 2024-10-10

Added

• Added select_single_matcher and select_single methods for Document and Selection.
• Added Document::fragment which allows to create a document fragment.

Changed

• Update documentation
• A small breaking change: From implementation for Document, now it is based on Into<StrTendril> and because of that, previous From<&String> implementation will not work anymore (they are in config). If your code consumes &String, you should use String::as_str() instead.
• Refactored the code (NodeData::Element).

[0.4.2] - 2024-10-05

Removed

• Removed a readability examples and related dev-dependencies.

Added

• Added Selection::inner_html, Selection::try_html, and Selection::try_inner methods.
• Added more examples and doc-tests.

Changed

• Improved the documentation.

[0.4.1] - 2024-10-04

Fixed

• Fixed Iterator::next for Matches

Added

• Added doc-tests

[0.4.0] - 2024-10-01

Changed

• Update dependencies.
• Refactor code due to major changes in html5ever 0.29.0

[0.3.6] - 2024-07-19

Changed

• Update dependencies.

[0.3.5] - 2024-04-04

Changed

• Update dependencies.

[0.3.4] - 2024-02-17

Added

• Add support for :has-text and :contains pseudo-classes, which allow to search elements by their text contents. Some example are here.

[0.3.3] - 2024-02-10

Fixed

• Fix :has selector name comparison. Previously :has behavior worked, even if pseudo-class just started from :has.

[0.3.2] - 2024-01-19

Added

• add InnerNode<NodeData>.is_comment.

Changed

• expose dom_tree::NodeData.
• minor adjustments.
• revise matcher::Matcher usage, now selection::Selection's underlying select methods uses matcher::Matcher reference if it possible.
• css::CssString now wraps String instead of StrTendril. Because StrTendril can't be shared between multiple threads without mutex.

[0.3.1] - 2024-01-03

Changed

• Minor refactoring.

Fixed

• Fix spelling.

[0.3.0] - 2023-12-31

Changed

• Refactor dom_tree.rs -- remove internal macro, revise some functions for better performance.
• Improve performance for some functions inside, traversal.rs (switching from hashmaps to vecs).
• Add optional feature hashbrown -- which replace standard HashSet and HashMap with it's own implementation.

[0.2.1] - 2023-12-30

Changed

• CssString now wraps a StrTendril instead of a String.
• Use rustc_hash::FxHashSet instead of std::collections::HashSet.
• Use rustc_hash::FxHashMap instead of std::collections::HashMap.

[0.2.0] - 2023-12-26

Changed

• Replace unsafe code with safe code.