wp_maybe_enqueue_oembed_host_js() │ WP 5.9.0

Enqueue the wp-embed script if the provided oEmbed HTML contains a post embed.

In order to only enqueue the wp-embed script on pages that actually contain post embeds, this function checks if the provided HTML contains post embed markup and if so enqueues the script so that it will get printed in the footer.

No Hooks.

Return

String. Embed markup (without modifications).

Usage

wp_maybe_enqueue_oembed_host_js( $html );
$html(string) (required)
Embed markup.

Changelog

Since 5.9.0 Introduced.

wp_maybe_enqueue_oembed_host_js() code WP 6.5.2

wp-includes/embed.php 
function wp_maybe_enqueue_oembed_host_js( $html ) {
	if (
		has_action( 'wp_head', 'wp_oembed_add_host_js' )
		&&
		preg_match( '/<blockquote\s[^>]*?wp-embedded-content/', $html )
	) {
		wp_enqueue_script( 'wp-embed' );
	}
	return $html;
}