path-expression-matcher

🎯 Purpose

📦 Installation

🚀 Quick Start

📖 Pattern Syntax

Basic Paths

Deep Wildcard

Attribute Matching

Position Selectors

Namespaces

Wildcard Differences

Combined Patterns

🔧 API Reference

Expression

Constructor

Methods

Matcher

Constructor

Path Tracking Methods

`push(tagName, attrValues, namespace)`

`pop()`

`updateCurrent(attrValues)`

`reset()`

Query Methods

`matches(expression)`

`getCurrentTag()`

`getCurrentNamespace()`

`getAttrValue(attrName)`

`hasAttr(attrName)`

`getPosition()`

`getCounter()`

`getIndex()` (deprecated)

`getDepth()`

`toString(separator?, includeNamespace?)`

`toArray()`

State Management

`snapshot()`

`restore(snapshot)`

Read-Only Access

`readOnly()`

💡 Usage Examples

Example 1: XML Parser with stopNodes

Example 2: Conditional Processing

Example 3: Path-based Filtering

Example 4: Custom Separator

Example 5: Attribute Checking

Example 6: Position vs Counter

Example 8: Passing a Read-Only Matcher to External Consumers

🏗️ Architecture

Data Storage Strategy

Matching Strategy

Performance

🎓 Design Patterns

Pre-compile Patterns (Recommended)

Batch Pattern Checking

🔗 Integration with fast-xml-parser

📄 License

🤝 Contributing