WP_Script_Modules::get_import_map │ private │ WP 6.5.0

Returns the import map array.

Method of the class: WP_Script_Modules{}

No Hooks.

Returns

Array. array<string, string>> Array with an imports key mapping to an array of script module identifiers and their respective URLs, including the version query.

Usage

// private - for code of main (parent) class only
$result = $this->get_import_map(): array;

Notes

• Global. WP_Scripts. $wp_scripts

Changelog

WP_Script_Modules::get_import_map() WP Script Modules::get import map code ^{WP 7.0}

private function get_import_map(): array {
	global $wp_scripts;

	$imports = array();

	// Identify script modules that are dependencies of classic scripts.
	$classic_script_module_dependencies = array();
	if ( $wp_scripts instanceof WP_Scripts ) {
		$handles = array_merge(
			$wp_scripts->queue,
			$wp_scripts->to_do,
			$wp_scripts->done
		);

		$processed = array();
		while ( ! empty( $handles ) ) {
			$handle = array_pop( $handles );
			if ( isset( $processed[ $handle ] ) || ! isset( $wp_scripts->registered[ $handle ] ) ) {
				continue;
			}
			$processed[ $handle ] = true;

			$module_dependencies = $wp_scripts->get_data( $handle, 'module_dependencies' );
			if ( is_array( $module_dependencies ) ) {
				$missing_module_dependencies = array();
				foreach ( $module_dependencies as $module ) {
					if ( is_string( $module ) ) {
						$id = $module;
					} elseif ( is_array( $module ) && isset( $module['id'] ) && is_string( $module['id'] ) ) {
						$id = $module['id'];
					} else {
						// Invalid module dependency was supplied by direct manipulation of the extra data.
						// Normally, this error scenario would be caught when WP_Scripts::add_data() is called.
						continue;
					}

					if ( ! isset( $this->registered[ $id ] ) ) {
						$missing_module_dependencies[] = $id;
					} else {
						$classic_script_module_dependencies[] = $id;
					}
				}

				if ( count( $missing_module_dependencies ) > 0 ) {
					_doing_it_wrong(
						'WP_Scripts::add_data',
						sprintf(
							/* translators: 1: Script handle, 2: 'module_dependencies', 3: List of missing dependency IDs. */
							__( 'The script with the handle "%1$s" was enqueued with script module dependencies ("%2$s") that are not registered: %3$s.' ),
							$handle,
							'module_dependencies',
							implode( wp_get_list_item_separator(), $missing_module_dependencies )
						),
						'7.0.0'
					);
				}
			}

			foreach ( $wp_scripts->registered[ $handle ]->deps as $dep ) {
				if ( ! isset( $processed[ $dep ] ) ) {
					$handles[] = $dep;
				}
			}
		}
	}

	// Note: the script modules in $this->queue are not included in the importmap because they get printed as scripts.
	$ids = array_unique(
		array_merge(
			$classic_script_module_dependencies,
			array_keys( $this->get_dependencies( array_merge( $this->queue, $classic_script_module_dependencies ) ) )
		)
	);
	foreach ( $ids as $id ) {
		$src = $this->get_src( $id );
		if ( '' !== $src ) {
			$imports[ $id ] = $src;
		}
	}
	return array( 'imports' => $imports );
}