Script Loader: Deprecate wp_sanitize_script_attributes().

The function is no longer used by WordPress and better alternatives are available: `wp_get_script_tag()` and `wp_get_inline_script_tag()`.

Developed in WordPress#10742.

Follow-up to [61415], [61485].

Props jonsurrell, westonruter.
Fixes #64511. See #64442.


git-svn-id: https://develop.svn.wordpress.org/trunk@61518 602fd350-edb4-49c9-b593-d223f7449a82

Author: sirreal

src/wp-includes/deprecated.php

@@ -6479,3 +6479,33 @@ function wp_print_auto_sizes_contain_css_fix() {
 	<style>img:is([sizes="auto" i], [sizes^="auto," i]) { contain-intrinsic-size: 3000px 1500px }</style>
 	<?php
 }
+
+/**
+ * Sanitizes an attributes array into an attributes string to be placed inside a `<script>` tag.
+ *
+ * This function is deprecated, use {@see wp_get_script_tag()} or {@see wp_get_inline_script_tag()} instead.
+ *
+ * @since 5.7.0
+ * @deprecated 7.0.0 Use wp_get_script_tag() or wp_get_inline_script_tag().
+ * @see wp_get_script_tag()
+ * @see wp_get_inline_script_tag()
+ *
+ * @param array<string, string|bool> $attributes Key-value pairs representing `<script>` tag attributes.
+ * @return string String made of sanitized `<script>` tag attributes.
+ */
+function wp_sanitize_script_attributes( $attributes ) {
+	_deprecated_function( __FUNCTION__, '7.0.0', 'wp_get_script_tag() or wp_get_inline_script_tag()' );
+
+	$attributes_string = '';
+	foreach ( $attributes as $attribute_name => $attribute_value ) {
+		if ( is_bool( $attribute_value ) ) {
+			if ( $attribute_value ) {
+				$attributes_string .= ' ' . esc_attr( $attribute_name );
+			}
+		} else {
+			$attributes_string .= sprintf( ' %1$s="%2$s"', esc_attr( $attribute_name ), esc_attr( $attribute_value ) );
+		}
+	}
+	return $attributes_string;
+}
+

src/wp-includes/script-loader.php

@@ -2882,37 +2882,6 @@ function wp_enqueue_editor_format_library_assets() {
 	wp_enqueue_style( 'wp-format-library' );
 }
 
-/**
- * Sanitizes an attributes array into an attributes string to be placed inside a `<script>` tag.
- *
- * Automatically injects type attribute if needed.
- * Used by {@see wp_get_script_tag()} and {@see wp_get_inline_script_tag()}.
- *
- * @since 5.7.0
- *
- * @param array<string, string|bool> $attributes Key-value pairs representing `<script>` tag attributes.
- * @return string String made of sanitized `<script>` tag attributes.
- */
-function wp_sanitize_script_attributes( $attributes ) {
-	$attributes_string = '';
-
-	/*
-	 * If HTML5 script tag is supported, only the attribute name is added
-	 * to $attributes_string for entries with a boolean value, and that are true.
-	 */
-	foreach ( $attributes as $attribute_name => $attribute_value ) {
-		if ( is_bool( $attribute_value ) ) {
-			if ( $attribute_value ) {
-				$attributes_string .= ' ' . esc_attr( $attribute_name );
-			}
-		} else {
-			$attributes_string .= sprintf( ' %1$s="%2$s"', esc_attr( $attribute_name ), esc_attr( $attribute_value ) );
-		}
-	}
-
-	return $attributes_string;
-}
-
 /**
  * Formats `<script>` loader tags.
  *

tests/phpunit/tests/dependencies/wpSanitizeScriptAttributes.php

@@ -10,6 +10,7 @@
 class Tests_Dependencies_wpSanitizeScriptAttributes extends WP_UnitTestCase {
 
 	public function test_sanitize_script_attributes_type_set() {
+		$this->setExpectedDeprecated( 'wp_sanitize_script_attributes' );
 		$this->assertSame(
 			' type="application/javascript" src="https://DOMAIN.TLD/PATH/FILE.js" nomodule',
 			wp_sanitize_script_attributes(
@@ -24,6 +25,7 @@ public function test_sanitize_script_attributes_type_set() {
 	}
 
 	public function test_sanitize_script_attributes_type_not_set() {
+		$this->setExpectedDeprecated( 'wp_sanitize_script_attributes' );
 		$this->assertSame(
 			' src="https://DOMAIN.TLD/PATH/FILE.js" nomodule',
 			wp_sanitize_script_attributes(
@@ -38,13 +40,15 @@ public function test_sanitize_script_attributes_type_not_set() {
 
 
 	public function test_sanitize_script_attributes_no_attributes() {
+		$this->setExpectedDeprecated( 'wp_sanitize_script_attributes' );
 		$this->assertSame(
 			'',
 			wp_sanitize_script_attributes( array() )
 		);
 	}
 
 	public function test_sanitize_script_attributes_relative_src() {
+		$this->setExpectedDeprecated( 'wp_sanitize_script_attributes' );
 		$this->assertSame(
 			' src="PATH/FILE.js" nomodule',
 			wp_sanitize_script_attributes(
@@ -59,6 +63,7 @@ public function test_sanitize_script_attributes_relative_src() {
 
 
 	public function test_sanitize_script_attributes_only_false_boolean_attributes() {
+		$this->setExpectedDeprecated( 'wp_sanitize_script_attributes' );
 		$this->assertSame(
 			'',
 			wp_sanitize_script_attributes(
@@ -71,6 +76,7 @@ public function test_sanitize_script_attributes_only_false_boolean_attributes()
 	}
 
 	public function test_sanitize_script_attributes_only_true_boolean_attributes() {
+		$this->setExpectedDeprecated( 'wp_sanitize_script_attributes' );
 		$this->assertSame(
 			' async nomodule',
 			wp_sanitize_script_attributes(