Add experimental util to allow fetch remote url data from REST API (#…

…31085)

* Add new helper to utilise new REST endpoint

* Provide docblock

packages/core-data/src/fetch/__experimental-fetch-remote-url-data.js

@@ -0,0 +1,46 @@
+/**
+ * WordPress dependencies
+ */
+import apiFetch from '@wordpress/api-fetch';
+import { addQueryArgs, prependHTTP } from '@wordpress/url';
+
+/**
+ * @typedef WPRemoteUrlData
+ *
+ * @property {string} title     contents of the remote URL's `<title>` tag.
+ */
+
+/**
+ * Fetches data about a remote URL.
+ * eg: <title> tag, favicon...etc.
+ *
+ * @async
+ * @param {string}              url
+ *
+ * @example
+ * ```js
+ * import { __experimentalFetchRemoteUrlData as fetchRemoteUrlData } from '@wordpress/core-data';
+ *
+ * //...
+ *
+ * export function initialize( id, settings ) {
+ *
+ * settings.__experimentalFetchRemoteUrlData = (
+ *     url
+ * ) => fetchRemoteUrlData( url );
+ * ```
+ * @return {Promise< WPRemoteUrlData[] >} Remote URL data.
+ */
+const fetchRemoteUrlData = async ( url ) => {
+	const endpoint = '/__experimental/url-details';
+
+	const args = {
+		url: prependHTTP( url ),
+	};
+
+	return apiFetch( {
+		path: addQueryArgs( endpoint, args ),
+	} );
+};
+
+export default fetchRemoteUrlData;

packages/core-data/src/fetch/index.js

@@ -1 +1,2 @@
 export { default as __experimentalFetchLinkSuggestions } from './__experimental-fetch-link-suggestions';
+export { default as __experimentalFetchRemoteUrlData } from './__experimental-fetch-remote-url-data';

packages/editor/src/components/provider/use-block-editor-settings.js

@@ -11,6 +11,7 @@ import { useDispatch, useSelect } from '@wordpress/data';
 import {
 	store as coreStore,
 	__experimentalFetchLinkSuggestions as fetchLinkSuggestions,
+	__experimentalFetchRemoteUrlData as fetchRemoteUrlData,
 } from '@wordpress/core-data';
 
 /**
@@ -107,6 +108,8 @@ function useBlockEditorSettings( settings, hasTemplate ) {
 			__experimentalReusableBlocks: reusableBlocks,
 			__experimentalFetchLinkSuggestions: ( search, searchOptions ) =>
 				fetchLinkSuggestions( search, searchOptions, settings ),
+			__experimentalFetchRemoteUrlData: ( url ) =>
+				fetchRemoteUrlData( url ),
 			__experimentalCanUserUseUnfilteredHTML: canUseUnfilteredHTML,
 			__experimentalUndo: undo,
 			__experimentalShouldInsertAtTheTop: isTitleSelected,