refactor: add query alias to params option (#105)

Co-authored-by: Pooya Parsa <pooya@pi0.io>

README.md

@@ -125,18 +125,18 @@ const article = await $fetch<Article>(`/api/article/${id}`)
 
 ## ✔️ Adding `baseURL`
 
-By using `baseURL` option, `$fetch` prepends it with respecting to trailing/leading slashes and query params for baseURL using [ufo](https://github.com/unjs/ufo):
+By using `baseURL` option, `$fetch` prepends it with respecting to trailing/leading slashes and query search params for baseURL using [ufo](https://github.com/unjs/ufo):
 
 ```js
 await $fetch('/config', { baseURL })
 ```
 
-## ✔️ Adding params
+## ✔️ Adding Query Search Params
 
-By using `params` option, `$fetch` adds params to URL by preserving params in request itself using [ufo](https://github.com/unjs/ufo):
+By using `query` option (or `params` as alias), `$fetch` adds query search params to URL by preserving query in request itself using [ufo](https://github.com/unjs/ufo):
 
 ```js
-await $fetch('/movie?lang=en', { params: { id: 123 } })
+await $fetch('/movie?lang=en', { query: { id: 123 } })
 ```
 
 ## ✔️ Interceptors
@@ -155,9 +155,9 @@ await $fetch('/api', {
     // Log request
     console.log('[fetch request]', request, options)
 
-    // Add `?t=1640125211170` to query params
-    options.params = options.params
-    options.params.t = new Date()
+    // Add `?t=1640125211170` to query search params
+    options.query = options.query
+    options.query.t = new Date()
   }
 })
 ```

src/fetch.ts

@@ -27,6 +27,7 @@ export interface FetchOptions<R extends ResponseType = ResponseType> extends Omi
   baseURL?: string
   body?: RequestInit['body'] | Record<string, any>
   params?: SearchParams
+  query?: SearchParams
   parseResponse?: (responseText: string) => any
   responseType?: R
   response?: boolean
@@ -105,8 +106,8 @@ export function createFetch (globalOptions: CreateFetchOptions): $Fetch {
       if (ctx.options.baseURL) {
         ctx.request = withBase(ctx.request, ctx.options.baseURL)
       }
-      if (ctx.options.params) {
-        ctx.request = withQuery(ctx.request, ctx.options.params)
+      if (ctx.options.query || ctx.options.params) {
+        ctx.request = withQuery(ctx.request, { ...ctx.options.params, ...ctx.options.query })
       }
       if (ctx.options.body && isPayloadMethod(ctx.options.method)) {
         if (isJSONSerializable(ctx.options.body)) {