Changeset 59477 for trunk/src/wp-includes/interactivity-api/class-wp-interactivity-api.php

Timestamp:

12/02/2024 08:08:34 AM (16 months ago)

Author:

gziolo

Message:

Interactivity API: Support length property on strings and arrays on the server

The Interactivity API tries to align client and server rendering so that the behavior is the same. Adds missing handling for .length to directives processing on the server on strings and numeric arrays which is inherently supported through JavaScript language on the client.

Props jonsurrell, gziolo, luisherranz.
Fixes #62582.

File:

• trunk/src/wp-includes/interactivity-api/class-wp-interactivity-api.php (modified) (1 diff)

trunk/src/wp-includes/interactivity-api/class-wp-interactivity-api.php

@@ -580 +580 @@
         $current       = $store;
         foreach ( $path_segments as $path_segment ) {
+            /*
+             * Special case for numeric arrays and strings. Add length
+             * property mimicking JavaScript behavior.
+             *
+             * @since 6.8.0
+             */
+            if ( 'length' === $path_segment ) {
+                if ( is_array( $current ) && array_is_list( $current ) ) {
+                    $current = count( $current );
+                    break;
+                }
+
+                if ( is_string( $current ) ) {
+                    /*
+                     * Differences in encoding between PHP strings and
+                     * JavaScript mean that it's complicated to calculate
+                     * the string length JavaScript would see from PHP.
+                     * `strlen` is a reasonable approximation.
+                     *
+                     * Users that desire a more precise length likely have
+                     * more precise needs than "bytelength" and should
+                     * implement their own length calculation in derived
+                     * state taking into account encoding and their desired
+                     * output (codepoints, graphemes, bytes, etc.).
+                     */
+                    $current = strlen( $current );
+                    break;
+                }
+            }
+
             if ( ( is_array( $current ) || $current instanceof ArrayAccess ) && isset( $current[ $path_segment ] ) ) {
                 $current = $current[ $path_segment ];