---
title: "parseQuery"
description: "Parse a URL query string into a key-value object, grouping repeated keys into arrays so query data is easy to read and update."
canonical_url: "https://core.mhaibaraai.cn/en/docs/utilities/url/parse-query"
---
# parseQuery

> Parse a URL query string into a key-value object, grouping repeated keys into arrays so query data is easy to read and update.

## Usage

`parseQuery` parses a URL query string into an object.

```ts
import { parseQuery } from '@movk/core'

parseQuery('?name=John&age=30')
// { name: 'John', age: '30' }

parseQuery('tags=a&tags=b&tags=c')
// { tags: ['a', 'b', 'c'] }

parseQuery('encoded=%E4%B8%AD%E6%96%87')
// { encoded: '中文' }
```

## API

### `parseQuery(search)`

Parse a URL query string into an object.

### Parameters

**search** (`string`) *required*: The query string, with or without the leading ?.

### Returns

**returns** (`Record<string, string | string[]>`): The parsed query parameters object.

## Changelog

See commit history for [src/utilities/url/query.ts](https://github.com/mhaibaraai/movk-core/commits/main/src/utilities/url/query.ts).

---

- [GitHub](https://github.com/mhaibaraai/movk-core/blob/main/src/utilities/url/query.ts)


## Sitemap

See the full [sitemap](https://core.mhaibaraai.cn/sitemap.md) for all pages.