WP_Script_Modules::print_script_module_data()

1016	public function print_script_module_data(): void {1017		$modules = array();1018		foreach ( array_unique( $this->queue ) as $id ) {1019			if ( '@wordpress/a11y' === $id ) {1020				$this->a11y_available = true;1021			}1022			$modules[ $id ] = true;1023		}1024		foreach ( array_keys( $this->get_import_map()['imports'] ) as $id ) {1025			if ( '@wordpress/a11y' === $id ) {1026				$this->a11y_available = true;1027			}1028			$modules[ $id ] = true;1029		}1030 1031		foreach ( array_keys( $modules ) as $module_id ) {1032			/**1033			 * Filters data associated with a given Script Module.1034			 *1035			 * Script Modules may require data that is required for initialization or is essential1036			 * to have immediately available on page load. These are suitable use cases for1037			 * this data.1038			 *1039			 * The dynamic portion of the hook name, `$module_id`, refers to the Script Module ID1040			 * that the data is associated with.1041			 *1042			 * This is best suited to pass essential data that must be available to the module for1043			 * initialization or immediately on page load. It does not replace the REST API or1044			 * fetching data from the client.1045			 *1046			 * Example:1047			 *1048			 *     add_filter(1049			 *         'script_module_data_MyScriptModuleID',1050			 *         function ( array $data ): array {1051			 *             $data['dataForClient'] = 'ok';1052			 *             return $data;1053			 *         }1054			 *     );1055			 *1056			 * If the filter returns no data (an empty array), nothing will be embedded in the page.1057			 *1058			 * The data for a given Script Module, if provided, will be JSON serialized in a script1059			 * tag with an ID of the form `wp-script-module-data-{$module_id}`.1060			 *1061			 * The data can be read on the client with a pattern like the following; you are encouraged1062			 * to use this pattern _verbatim_ to avoid common pitfalls or vulnerabilities:1063			 *1064			 * Example:1065			 *1066			 *     const dataContainer = document.querySelector( 'script[id="wp-script-module-data-MyScriptModuleID"]' );1067			 *     let data = {};1068			 *     if ( dataContainer instanceof HTMLScriptElement ) {1069			 *         try {1070			 *             data = JSON.parse( dataContainer.text );1071			 *         } catch {}1072			 *     }1073			 *     // data.dataForClient === 'ok';1074			 *     initMyScriptModuleWithData( data );1075			 *1076			 * @since 6.7.01077			 *1078			 * @param array $data The data associated with the Script Module.1079			 */1080			$data = apply_filters( "script_module_data_{$module_id}", array() );1081 1082			if ( is_array( $data ) && array() !== $data ) {1083				/*1084				 * This data will be printed as JSON inside a script tag like this:1085				 *   <script type="application/json"></script>1086				 *1087				 * A script tag must be closed by a sequence beginning with `</`. It's impossible to1088				 * close a script tag without using `<`. We ensure that `<` is escaped and `/` can1089				 * remain unescaped, so `</script>` will be printed as `\u003C/script\u00E3`.1090				 *1091				 *   - JSON_HEX_TAG: All < and > are converted to \u003C and \u003E.1092				 *   - JSON_UNESCAPED_SLASHES: Don't escape /.1093				 *1094				 * If the page will use UTF-8 encoding, it's safe to print unescaped unicode:1095				 *