Script Modules API: Add deregister module function

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

@@ -151,6 +151,20 @@ public function dequeue( string $id ) {
 		unset( $this->enqueued_before_registered[ $id ] );
 	}
 
+	/**
+	 * Deregister the script module so it will no longer be registered.
+	 *
+	 * @since 6.5.0
+	 *
+	 * @param string $id The identifier of the script module.
+	 */
+	public function deregister( string $id ) {
+		if ( isset( $this->registered[ $id ] ) ) {
+			unset( $this->registered[ $id ] );
+		}
+		unset( $this->enqueued_before_registered[ $id ] );
+	}
+
 	/**
 	 * Adds the hooks to print the import map, enqueued script modules and script
 	 * module preloads.

src/wp-includes/script-modules.php

@@ -112,3 +112,14 @@ function wp_enqueue_script_module( string $id, string $src = '', array $deps = a
 function wp_dequeue_script_module( string $id ) {
 	wp_script_modules()->dequeue( $id );
 }
+
+/**
+ * Unregisters the script module.
+ *
+ * @since 6.5.0
+ *
+ * @param string $id The identifier of the script module.
+ */
+function wp_deregister_script_module( string $id ) {
+	wp_script_modules()->deregister( $id );
+}

tests/phpunit/tests/script-modules/wpScriptModules.php

@@ -126,6 +126,33 @@ public function test_wp_dequeue_script_module() {
 		$this->assertTrue( isset( $enqueued_script_modules['bar'] ) );
 	}
 
+
+	/**
+	* Tests that a script module can be deregistered
+	* after being enqueued, and that will be removed
+	* from the enqueue list too.
+	*
+	* @ticket 60463
+	*
+	* @covers ::register()
+	* @covers ::enqueue()
+	* @covers ::deregister()
+	* @covers ::print_enqueued_script_modules()
+	*/
+	public function test_wp_deregister_script_module() {
+		$this->script_modules->register( 'foo', '/foo.js' );
+		$this->script_modules->register( 'bar', '/bar.js' );
+		$this->script_modules->enqueue( 'foo' );
+		$this->script_modules->enqueue( 'bar' );
+		$this->script_modules->deregister( 'foo' ); // Dequeued.
+
+		$enqueued_script_modules = $this->get_enqueued_script_modules();
+
+		$this->assertCount( 1, $enqueued_script_modules );
+		$this->assertFalse( isset( $enqueued_script_modules['foo'] ) );
+		$this->assertTrue( isset( $enqueued_script_modules['bar'] ) );
+	}
+
 	/**
 	* Tests that a script module can be enqueued before it is registered, and will
 	* be handled correctly once registered.