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.

Sign up for GitHub

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

HTML API: Stop counting noop seek operations against the max seek count. #7399

Closed
wants to merge 4 commits into from
Closed

HTML API: Stop counting noop seek operations against the max seek count. #7399

Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
ad75ad5
HTML API: Stop counting noop seek operations against the max seek count.
dmsnell Sep 18, 2024
a430966
Verify behavior of new seeking shortcut.
dmsnell Sep 19, 2024
aaa6562
Merge branch 'trunk' of https://github.com/WordPress/wordpress-develo…
westonruter Feb 11, 2025
0712e17
Add ticket number to test
westonruter Feb 11, 2025
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
9 changes: 9 additions & 0 deletions src/wp-includes/html-api/class-wp-html-tag-processor.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2548,6 +2548,15 @@ public function seek( $bookmark_name ): bool {
return false;
}

$existing_bookmark = $this->bookmarks[ $bookmark_name ];

if (
$this->token_starts_at === $existing_bookmark->start &&
$this->token_length === $existing_bookmark->length
) {
return true;
}
Comment on lines +2554 to +2561
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How will this impact (or not) WP_HTML_Processor::seek() since its actual bookmarks get prefixed with _?

wordpress-develop/src/wp-includes/html-api/class-wp-html-processor.php

Lines 5266 to 5275 in b071c28

public function seek( $bookmark_name ): bool {
// Flush any pending updates to the document before beginning.
$this->get_updated_html();
$actual_bookmark_name = "_{$bookmark_name}";
$processor_started_at = $this->state->current_token
? $this->bookmarks[ $this->state->current_token->bookmark_name ]->start
: 0;
$bookmark_starts_at = $this->bookmarks[ $actual_bookmark_name ]->start;
$direction = $bookmark_starts_at > $processor_started_at ? 'forward' : 'backward';

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it shouldn't because by the time it calls this parent-class method, it has supplied the underscore.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK, right. By the way, what is the reasoning behind prefixing bookmarks with underscores in HTML Processor? In WordPress/performance#1546 I'm making use of WP_HTML_Processor when available, but in the logic that injects additional markup into the head and body, it needs to obtain the start position of the bookmark. For the HTML Processor version it has to prepend the _ which seems strange, although granted this is an internal API:

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the reason was to avoid any possible conflicts between bookmarks set by the HTML Processor itself, and the user-space code setting bookmarks. that is, any time someone calls WP_HTML_Processor::set_bookmark() it will be prefixed, but calls inside the processor to parent::set_bookmark() will be un-prefixed. it's a very basic namespacing mechanism.


if ( ++$this->seek_count > static::MAX_SEEK_OPS ) {
_doing_it_wrong(
__METHOD__,
Expand Down
Loading