Ticket #42438: 42438-function.diff

src/wp-includes/general-template.php

@@ -3423 +3423 @@
         }
 }
 
+/**
+ * Specify resources to preload.
+ *
+ * @global array $wp_preload_resources
+ * @since 6.1.0
+ *
+ * @param array  $preload_resources {
+ *     Array of resources and their attributes, or URLs to print for resource preloads.
+ *
+ *     @type array ...$0 {
+ *         Array of resource attributes.
+ *
+ *         @type string $href        URL to include in resource preloads. Required.
+ *         @type string $as          How the browser should treat the resource
+ *                                   (`script`, `style`, `image`, `document`, etc).
+ *         @type string $crossorigin Indicates the CORS policy of the specified resource.
+ *         @type string $type        Type of the resource (`text/html`, `text/css`, etc).
+ *         @type string $media       Accepts media types or media queries. Allows responsive preloading.
+ *         @type string $imagesizes  Responsive source size to the source Set.
+ *         @type string $imagesrcset Responsive image sources to the source set.
+ *     }
+ * }
+ */
+function wp_add_preload_resources( $preload_resources ) {
+        global $wp_preload_resources;
+
+        if ( ! is_array( $wp_preload_resources ) ) {
+                $wp_preload_resources = array();
+        }
+        $wp_preload_resources = array_merge( $wp_preload_resources, $preload_resources );
+}
+
 /**
  * Prints resource preloads directives to browsers.
  *
@@ -3437 +3469 @@
  * @link https://developer.mozilla.org/en-US/docs/Web/HTML/Link_types/preload
  * @link https://web.dev/preload-responsive-images/
  *
+ * @global array $wp_preload_resources
  * @since 6.1.0
  */
 function wp_preload_resources() {
+        global $wp_preload_resources;
         /**
          * Filters domains and URLs for resource preloads.
          *
@@ -3462 +3496 @@
          *     }
          * }
          */
-        $preload_resources = apply_filters( 'wp_preload_resources', array() );
-
+        $preload_resources = apply_filters( 'wp_preload_resources', is_array( $wp_preload_resources ) ? $wp_preload_resources : array() );
         if ( ! is_array( $preload_resources ) ) {
                 return;
         }

tests/phpunit/tests/general/wpPreloadResources.php

@@ -5 +5 @@
  * @group template
  * @ticket 42438
  * @covers ::wp_preload_resources
+ * @covers ::wp_add_preload_links
  */
 class Tests_General_wpPreloadResources extends WP_UnitTestCase {
+        /**
+         * Set up.
+         */
+        public function set_up() {
+                parent::set_up();
 
+                global $wp_preload_resources;
+                $wp_preload_resources = array();
+        }
         /**
          * @dataProvider data_preload_resources
          *
@@ -25 +34 @@
                 $this->assertSame( $expected, $actual );
         }
 
+        /**
+         * Test the `wp_add_preload_links()` function.
+         *
+         * @dataProvider data_preload_resources
+         *
+         * @ticket 42438
+         */
+        public function test_wp_add_preload_resources( $expected, $preload_resources ) {
+                wp_add_preload_resources( $preload_resources );
+                $actual = get_echo( 'wp_preload_resources' );
+                $this->assertSame( $expected, $actual );
+        }
+
         /**
          * Test provider for all preload link possible combinations.
          *
@@ -249 +271 @@
                         ),
                 );
         }
-
 }