Changeset 64784

Timestamp:

10/27/2026 12:15:09 AM (31 hours ago)

Author:

lancewillett

Message:

Tests: Cover menu location REST response preparation.

Replace the empty test_prepare_item() placeholder with checks for menu location data, assigned-menu links, and _fields filtering.

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

Props devmuhib, shailu25, huzaifaalmesbah.
See #40538.

File:

• trunk/tests/phpunit/tests/rest-api/wpRestMenuLocationsController.php (modified) (1 diff)

trunk/tests/phpunit/tests/rest-api/wpRestMenuLocationsController.php

@@ -227 +227 @@
 
         /**
-         * The prepare_item() method does not exist for menu locations.
-         *
-         * @doesNotPerformAssertions
+         * @ticket 40538
+         *
+         * @covers ::prepare_item_for_response
          */
         public function test_prepare_item() {
-                // Controller does not implement prepare_item().
+                $this->register_nav_menu_locations( array( 'primary' ) );
+
+                $menu = wp_create_nav_menu( 'Primary Menu' );
+                set_theme_mod( 'nav_menu_locations', array( 'primary' => $menu ) );
+
+                $location = (object) array(
+                        'name'        => 'primary',
+                        'description' => 'Primary',
+                );
+
+                $endpoint = new WP_REST_Menu_Locations_Controller();
+                $request  = new WP_REST_Request( 'GET', '/wp/v2/menu-locations/primary' );
+                $response = $endpoint->prepare_item_for_response( $location, $request );
+
+                $this->assertInstanceOf( WP_REST_Response::class, $response );
+                $this->assertSame( 200, $response->get_status() );
+
+                $data = $response->get_data();
+                $this->assertSame( 'primary', $data['name'] );
+                $this->assertSame( 'Primary', $data['description'] );
+                $this->assertSame( $menu, $data['menu'] );
+
+                $links = $response->get_links();
+                $this->assertArrayHasKey( 'self', $links );
+                $this->assertSame( rest_url( 'wp/v2/menu-locations/primary' ), $links['self'][0]['href'] );
+                $this->assertArrayHasKey( 'collection', $links );
+                $this->assertSame( rest_url( 'wp/v2/menu-locations' ), $links['collection'][0]['href'] );
+                $this->assertArrayHasKey( 'https://api.w.org/menu', $links );
+                $this->assertSame( rest_url( rest_get_route_for_term( $menu ) ), $links['https://api.w.org/menu'][0]['href'] );
+        }
+
+        /**
+         * @ticket 40538
+         *
+         * @covers ::prepare_item_for_response
+         */
+        public function test_prepare_item_limit_fields() {
+                $location = (object) array(
+                        'name'        => 'primary',
+                        'description' => 'Primary',
+                );
+
+                $endpoint = new WP_REST_Menu_Locations_Controller();
+                $request  = new WP_REST_Request( 'GET', '/wp/v2/menu-locations/primary' );
+                $request->set_param( '_fields', 'name' );
+
+                $response = $endpoint->prepare_item_for_response( $location, $request );
+                $this->assertSame( array( 'name' => 'primary' ), $response->get_data() );
+                $this->assertEmpty( $response->get_links() );
         }