Changeset 60909

Timestamp:

10/07/2025 01:23:00 AM (less than one hour 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';