register_block_script_handle( array $metadata, string $field_name, int $index = 0 ): string|false

267function register_block_script_handle( $metadata, $field_name, $index = 0 ) {268	if ( empty( $metadata[ $field_name ] ) ) {269		return false;270	}271 272	$script_handle_or_path = $metadata[ $field_name ];273	if ( is_array( $script_handle_or_path ) ) {274		if ( empty( $script_handle_or_path[ $index ] ) ) {275			return false;276		}277		$script_handle_or_path = $script_handle_or_path[ $index ];278	}279 280	$script_path = remove_block_asset_path_prefix( $script_handle_or_path );281	if ( $script_handle_or_path === $script_path ) {282		return $script_handle_or_path;283	}284 285	$path                  = dirname( $metadata['file'] );286	$script_asset_raw_path = $path . '/' . substr_replace( $script_path, '.asset.php', - strlen( '.js' ) );287	$script_asset_path     = wp_normalize_path(288		realpath( $script_asset_raw_path )289	);290 291	// Asset file for blocks is optional. See https://core.trac.wordpress.org/ticket/60460.292	/** @var array{ handle?: non-falsy-string, dependencies?: list<non-falsy-string>, version?: string|false|null, ... } $script_asset */293	$script_asset  = ! empty( $script_asset_path ) ? require $script_asset_path : array();294	$script_handle = $script_asset['handle'] ??295		generate_block_asset_handle( $metadata['name'], $field_name, $index );296	if ( wp_script_is( $script_handle, 'registered' ) ) {297		return $script_handle;298	}299 300	$script_path_norm    = wp_normalize_path( realpath( $path . '/' . $script_path ) );301	$script_uri          = get_block_asset_url( $script_path_norm );302	$script_dependencies = $script_asset['dependencies'] ?? array();303	$block_version       = $metadata['version'] ?? false;304	$script_version      = $script_asset['version'] ?? $block_version;305	$script_args         = array();306	if ( 'viewScript' === $field_name && $script_uri ) {307		$script_args['strategy'] = 'defer';308	}309 310	$result = wp_register_script(311		$script_handle,312		$script_uri,313		$script_dependencies,314		$script_version,315		$script_args316	);317	if ( ! $result ) {318		return false;319	}320 321	if ( ! empty( $metadata['textdomain'] ) && in_array( 'wp-i18n', $script_dependencies, true ) ) {322		wp_set_script_translations( $script_handle, $metadata['textdomain'] );323	}324 325	return $script_handle;326}