Changeset 60909

Timestamp:

10/07/2025 01:23:00 AM (10 months ago)

Author:

westonruter

Message:

Script Loader: Add sourceURL comments to inline SCRIPT tags manually constructed in wp-includes.

This applies to tags constructed without wp_get_inline_script_tag()/wp_print_inline_script_tag().

Developed in ​https://github.com/WordPress/wordpress-develop/pull/9955.

Props westonruter, jonsurrell.
See #63887.

Location:

trunk/src/wp-includes

Files:

• class-wp-customize-manager.php (modified) (4 diffs)
• class-wp-customize-nav-menus.php (modified) (1 diff)
• class-wp-customize-widgets.php (modified) (1 diff)
• comment-template.php (modified) (1 diff)
• customize/class-wp-customize-selective-refresh.php (modified) (1 diff)
• embed.php (modified) (2 diffs)
• functions.php (modified) (1 diff)
• theme.php (modified) (1 diff)
• widgets/class-wp-widget-archives.php (modified) (1 diff)
• widgets/class-wp-widget-categories.php (modified) (1 diff)

trunk/src/wp-includes/class-wp-customize-manager.php

@@ -480 +480 @@
                         </script>
                         <?php
-                        $message .= wp_get_inline_script_tag( wp_remove_surrounding_empty_script_tags( ob_get_clean() ) );
+                        $message .= wp_get_inline_script_tag( wp_remove_surrounding_empty_script_tags( ob_get_clean() ) . "\n//# sourceURL=" . rawurlencode( __METHOD__ ) );
                 }
 
@@ -2106 +2106 @@
                 </script>
                 <?php
-                wp_print_inline_script_tag( wp_remove_surrounding_empty_script_tags( ob_get_clean() ) );
+                wp_print_inline_script_tag( wp_remove_surrounding_empty_script_tags( ob_get_clean() ) . "\n//# sourceURL=" . rawurlencode( __METHOD__ ) );
         }
 
@@ -2228 +2228 @@
                 </script>
                 <?php
-                wp_print_inline_script_tag( wp_remove_surrounding_empty_script_tags( ob_get_clean() ) );
+                wp_print_inline_script_tag( wp_remove_surrounding_empty_script_tags( ob_get_clean() ) . "\n//# sourceURL=" . rawurlencode( __METHOD__ ) );
         }
 
@@ -5023 +5023 @@
                 </script>
                 <?php
-                wp_print_inline_script_tag( wp_remove_surrounding_empty_script_tags( ob_get_clean() ) );
+                wp_print_inline_script_tag( wp_remove_surrounding_empty_script_tags( ob_get_clean() ) . "\n//# sourceURL=" . rawurlencode( __METHOD__ ) );
         }
 

trunk/src/wp-includes/class-wp-customize-nav-menus.php

@@ -1557 +1557 @@
                         'navMenuInstanceArgs' => $this->preview_nav_menu_instance_args,
                 );
-                wp_print_inline_script_tag( sprintf( 'var _wpCustomizePreviewNavMenusExports = %s;', wp_json_encode( $exports, JSON_HEX_TAG | JSON_UNESCAPED_SLASHES ) ) );
+                wp_print_inline_script_tag( sprintf( 'var _wpCustomizePreviewNavMenusExports = %s;', wp_json_encode( $exports, JSON_HEX_TAG | JSON_UNESCAPED_SLASHES ) ) . "\n//# sourceURL=" . rawurlencode( __METHOD__ ) );
         }
 

trunk/src/wp-includes/class-wp-customize-widgets.php

@@ -1336 +1336 @@
                 }
                 wp_print_inline_script_tag(
-                        sprintf( 'var _wpWidgetCustomizerPreviewSettings = %s;', wp_json_encode( $settings, JSON_HEX_TAG | JSON_UNESCAPED_SLASHES ) )
+                        sprintf( 'var _wpWidgetCustomizerPreviewSettings = %s;', wp_json_encode( $settings, JSON_HEX_TAG | JSON_UNESCAPED_SLASHES ) ) . "\n//# sourceURL=" . rawurlencode( __METHOD__ )
                 );
         }

trunk/src/wp-includes/comment-template.php

@@ -1375 +1375 @@
         if ( current_user_can( 'unfiltered_html' ) ) {
                 wp_nonce_field( 'unfiltered-html-comment_' . $post_id, '_wp_unfiltered_html_comment_disabled', false );
-                wp_print_inline_script_tag( "(function(){if(window===window.parent){document.getElementById('_wp_unfiltered_html_comment_disabled').name='_wp_unfiltered_html_comment';}})();" );
+                wp_print_inline_script_tag( "(function(){if(window===window.parent){document.getElementById('_wp_unfiltered_html_comment_disabled').name='_wp_unfiltered_html_comment';}})();\n//# sourceURL=" . rawurlencode( __FUNCTION__ ) );
         }
 }

trunk/src/wp-includes/customize/class-wp-customize-selective-refresh.php

@@ -194 +194 @@
 
                 // Export data to JS.
-                wp_print_inline_script_tag( sprintf( 'var _customizePartialRefreshExports = %s;', wp_json_encode( $exports, JSON_HEX_TAG | JSON_UNESCAPED_SLASHES ) ) );
+                wp_print_inline_script_tag( sprintf( 'var _customizePartialRefreshExports = %s;', wp_json_encode( $exports, JSON_HEX_TAG | JSON_UNESCAPED_SLASHES ) ) . "\n//# sourceURL=" . rawurlencode( __METHOD__ ) );
         }
 

trunk/src/wp-includes/embed.php

@@ -519 +519 @@
          * back to WordPress 4.4, so in order to not break older installs this script must come at the end.
          */
+        $js_path = '/js/wp-embed' . wp_scripts_get_suffix() . '.js';
         $output .= wp_get_inline_script_tag(
-                file_get_contents( ABSPATH . WPINC . '/js/wp-embed' . wp_scripts_get_suffix() . '.js' )
+                trim( file_get_contents( ABSPATH . WPINC . $js_path ) ) . "\n//# sourceURL=" . includes_url( $js_path )
         );
 
@@ -1091 +1092 @@
  */
 function print_embed_scripts() {
+        $js_path = '/js/wp-embed-template' . wp_scripts_get_suffix() . '.js';
         wp_print_inline_script_tag(
-                file_get_contents( ABSPATH . WPINC . '/js/wp-embed-template' . wp_scripts_get_suffix() . '.js' )
+                trim( file_get_contents( ABSPATH . WPINC . $js_path ) ) . "\n//# sourceURL=" . includes_url( $js_path )
         );
 }

trunk/src/wp-includes/functions.php

@@ -7798 +7798 @@
                 }
         }());
+        //# sourceURL=<?php echo rawurlencode( __FUNCTION__ ); ?>
         </script>
         <?php

trunk/src/wp-includes/theme.php

@@ -3816 +3816 @@
         </script>
         <?php
-        wp_print_inline_script_tag( wp_remove_surrounding_empty_script_tags( ob_get_clean() ) );
+        wp_print_inline_script_tag( wp_remove_surrounding_empty_script_tags( ob_get_clean() ) . "\n//# sourceURL=" . rawurlencode( __FUNCTION__ ) );
 }
 

trunk/src/wp-includes/widgets/class-wp-widget-archives.php

@@ -121 +121 @@
 </script>
                         <?php
-                        wp_print_inline_script_tag( wp_remove_surrounding_empty_script_tags( ob_get_clean() ) );
+                        wp_print_inline_script_tag( wp_remove_surrounding_empty_script_tags( ob_get_clean() ) . "\n//# sourceURL=" . rawurlencode( __METHOD__ ) );
                 } else {
                         $format = current_theme_supports( 'html5', 'navigation-widgets' ) ? 'html5' : 'xhtml';

trunk/src/wp-includes/widgets/class-wp-widget-categories.php

@@ -109 +109 @@
 
                         <?php
-                        wp_print_inline_script_tag( wp_remove_surrounding_empty_script_tags( ob_get_clean() ) );
+                        wp_print_inline_script_tag( wp_remove_surrounding_empty_script_tags( ob_get_clean() ) . "\n//# sourceURL=" . rawurlencode( __METHOD__ ) );
                 } else {
                         $format = current_theme_supports( 'html5', 'navigation-widgets' ) ? 'html5' : 'xhtml';