[wp-trac] [WordPress Trac] #62503: Add speculative loading support
WordPress Trac
noreply at wordpress.org
Tue Feb 18 22:30:21 UTC 2025
#62503: Add speculative loading support
-------------------------------------------------+-------------------------
Reporter: flixos90 | Owner: flixos90
Type: feature request | Status: closed
Priority: high | Milestone: 6.8
Component: General | Version:
Severity: normal | Resolution: fixed
Keywords: has-patch has-unit-tests needs-dev- | Focuses:
note | performance
-------------------------------------------------+-------------------------
Changes (by flixos90):
* status: assigned => closed
* resolution: => fixed
Comment:
In [changeset:"59837" 59837]:
{{{
#!CommitTicketReference repository="" revision="59837"
General: Add speculative loading support via the Speculation Rules API.
This changeset adds support for the Speculation Rules API and configures
it by default to `prefetch` certain links with an eagerness of
`conservative`, leading to improved performance by starting to load URLs
before the user lands on them.
The new `WP_Speculation_Rules` class is a container class representing the
set of used speculation rules. By default, WordPress Core will only add a
single speculation rule, which results in most links being prefetched
conservatively.
The behavior of that main speculation rule can be altered by using the new
`wp_speculation_rules_configuration` filter, which receives an associative
array with `mode` and `eagerness` keys, or `null`. Both `mode` and
`eagerness` have a default value of `auto`, which for now will result in
the aforementioned behavior. The value `null` is used by default in
certain scenarios such as when the current user is logged in. Developers
can explicitly provide supported mode values (`prefetch` or `prerender`)
and other supported eagerness values (`conservative`, `moderate`, or
`eager`) to override and enforce the respective behaviors, or return
`null` to disable speculative loading feature (either unconditionally or
for certain situations). The Speculative Loading feature plugin for
example, which this feature is based on, will make use of this filter to
continue to use mode `prerender` and eagerness `moderate` by default.
Developers can call the `wp_get_speculation_rules_configuration()`
function to check how speculative loading is configured on the WordPress
site.
Another important filter introduced is
`wp_speculation_rules_href_exclude_paths`, which allows to expand the list
of URL patterns that are excluded from being prefetched or prerendered per
WordPress Core's main speculation rule configuration. Several URL patterns
such `/wp-admin/*` (any URL within WP Admin) or `/*\\?(.+)` (any URL that
includes query parameters) are already excluded by default. Plugins that
use content that would be preferable not to prefetch or prerender can use
the filter to provide corresponding URL patterns.
More advanced customization is possible by adding further speculation
rules that will be loaded in addition to WordPress Core's main speculation
rule. This can be achieved via the new `wp_load_speculation_rules` action,
which receives the `WP_Speculation_Rules` class instance and can amend it
as needed.
Props flixos90, westonruter, joemcgill, desrosj, mukesh27, tunetheweb,
thelovekesh, adamsilverstein, swissspidy, domenicdenicola, jeremyroman.
Fixes #62503.
}}}
--
Ticket URL: <https://core.trac.wordpress.org/ticket/62503#comment:25>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform
More information about the wp-trac
mailing list