update docs and simplify api

docs/content/2.guide/2.features/5.data-fetching.md

@@ -156,16 +156,7 @@ This method is useful if you want to refresh all the data fetching for a current
 ::ReadMore{link="/api/utils/refresh-nuxt-data"}
 ::
 
-### `clearNuxtData`
-
-Delete cache of `useAsyncData`, `useLazyAsyncData`, `useFetch` and `useLazyFetch`.
-
-This method is useful if you want to invalidate the data fetching for another page.
-
-::ReadMore{link="/api/utils/clear-nuxt-cache"}
-::
-
-### Example
+#### Example
 
 ```vue
 <template>
@@ -182,6 +173,15 @@ const refresh = () => refreshNuxtData('count')
 </script>
 ```
 
+### `clearNuxtData`
+
+Delete cached data, error status and pending promises of `useAsyncData` and `useFetch`.
+
+This method is useful if you want to invalidate the data fetching for another page.
+
+::ReadMore{link="/api/utils/clear-nuxt-data"}
+::
+
 ## Options API support
 
 Nuxt 3 provides a way to perform `asyncData` fetching within the Options API. You must wrap your component definition within `defineNuxtComponent` for this to work.

docs/content/3.api/3.utils/clear-nuxt-data.md

@@ -1,13 +1,18 @@
 # `clearNuxtData`
 
-Clears cache of `useAsyncData`, `useLazyAsyncData`, `useFetch` and `useLazyFetch`.
+::StabilityEdge
+::
+
+Delete cached data, error status and pending promises of `useAsyncData` and `useFetch`.
 
 This method is useful if you want to invalidate the data fetching for another page.
 
+## Type
+
 ```ts
-clearNuxtData ({ keys }: {keys: string | string[]})
+clearNuxtData (keys?: string | string[])
 ```
 
-Available options:
+## Parameters
 
 * `keys`: Provides an array of keys that are used in `useAsyncData` to delete cached data.

packages/nuxt/src/app/composables/asyncData.ts

@@ -254,7 +254,7 @@ export function refreshNuxtData (keys?: string | string[]): Promise<void> {
   return useNuxtApp().callHook('app:data:refresh', _keys)
 }
 
-export function clearNuxtData ({ keys }: {keys: string | string[]}): void {
+export function clearNuxtData (keys?: string | string[]): void {
   const _keys = keys ? Array.isArray(keys) ? keys : [keys] : undefined
   if (_keys === undefined) {
     return