Changeset 61323 for trunk/src/wp-includes/class-wp-script-modules.php

Timestamp:

11/30/2025 12:54:26 AM (5 months ago)

Author:

westonruter

Message:

Script Loader: Emit notices when enqueueing a script, style, or script module with missing dependencies.

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

Follow-up to [60999].

Props deepakprajapati, westonruter.
See #63486.
Fixes #64229.

File:

• trunk/src/wp-includes/class-wp-script-modules.php (modified) (2 diffs)

trunk/src/wp-includes/class-wp-script-modules.php

@@ -70 +70 @@
         'high',
     );
+
+    /**
+     * List of IDs for script modules encountered which have missing dependencies.
+     *
+     * An ID is added to this list when it is discovered to have missing dependencies. At this time, a warning is
+     * emitted with {@see _doing_it_wrong()}. The ID is then added to this list, so that duplicate warnings don't occur.
+     *
+     * @since 7.0.0
+     * @var string[]
+     */
+    private $modules_with_missing_dependencies = array();
 
     /**
@@ -723 +734 @@
 
         // If the item requires dependencies that do not exist, fail.
-        if ( count( array_diff( $dependency_ids, array_keys( $this->registered ) ) ) > 0 ) {
+        $missing_dependencies = array_diff( $dependency_ids, array_keys( $this->registered ) );
+        if ( count( $missing_dependencies ) > 0 ) {
+            if ( ! in_array( $id, $this->modules_with_missing_dependencies, true ) ) {
+                _doing_it_wrong(
+                    get_class( $this ) . '::register',
+                    sprintf(
+                        /* translators: 1: Script module ID, 2: Comma-separated list of missing dependency IDs. */
+                        __( 'The script module with the ID "%1$s" was enqueued with dependencies that are not registered: %2$s.' ),
+                        $id,
+                        implode( ', ', $missing_dependencies )
+                    ),
+                    '7.0.0'
+                );
+                $this->modules_with_missing_dependencies[] = $id;
+            }
+
             return false;
         }