Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improved accuracy of tracked source positions #2056

Merged
merged 5 commits into from
Nov 20, 2023
Merged
Show file tree
Hide file tree
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion src/main/java/org/jsoup/nodes/LeafNode.java
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,10 @@

import java.util.List;

abstract class LeafNode extends Node {
/**
A node that does not hold any children. E.g.: {@link TextNode}, {@link DataNode}, {@link Comment}.
*/
public abstract class LeafNode extends Node {
Object value; // either a string value, or an attribute map (in the rare case multiple attributes are set)

protected final boolean hasAttributes() {
Expand Down
34 changes: 33 additions & 1 deletion src/main/java/org/jsoup/nodes/Range.java
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,15 @@ public Position start() {
return start;
}

/**
Get the starting cursor position of this range.
@return the 0-based start cursor position.
@since 1.17.1
*/
public int startPos() {
return start.pos;
}

/**
Get the end position of this node.
* @return the end position
Expand All @@ -43,6 +52,15 @@ public Position end() {
return end;
}

/**
Get the ending cursor position of this range.
@return the 0-based ending cursor position.
@since 1.17.1
*/
public int endPos() {
return end.pos;
}

/**
Test if this source range was tracked during parsing.
* @return true if this was tracked during parsing, false otherwise (and all fields will be {@code -1}).
Expand All @@ -51,6 +69,20 @@ public boolean isTracked() {
return this != Untracked;
}

/**
Checks if the range represents a node that was implicitly created / closed.
<p>For example, with HTML of {@code <p>One<p>Two}, both {@code p} elements will have an explicit
{@link Element#sourceRange()} but an implicit {@link Element#endSourceRange()} marking the end position, as neither
have closing {@code </p>} tags. The TextNodes will have explicit sourceRanges.
<p>A range is considered implicit if its start and end positions are the same.
@return true if the range is tracked and its start and end positions are the same, false otherwise.
@since 1.17.1
*/
public boolean isImplicit() {
if (!isTracked()) return false;
return start.equals(end);
}

/**
Retrieves the source range for a given Node.
* @param node the node to retrieve the position for
Expand Down Expand Up @@ -124,7 +156,7 @@ public Position(int pos, int lineNumber, int columnNumber) {

/**
Gets the position index (0-based) of the original input source that this Position was read at. This tracks the
total number of characters read into the source at this position, regardless of the number of preceeding lines.
total number of characters read into the source at this position, regardless of the number of preceding lines.
* @return the position, or {@code -1} if untracked.
*/
public int pos() {
Expand Down
Loading