---
title: "setQueryParams"
description: "批量设置 URL 的多个查询参数，覆盖同名已有参数，返回更新后的新 URL 字符串。"
seo_title: "setQueryParams"
seo_description: "Set or replace multiple query parameters in a URL from an object in one call, returning a new URL string with every value applied."
canonical_url: "https://core.mhaibaraai.cn/docs/utilities/url/set-query-params"
---
# setQueryParams

> 批量设置 URL 的多个查询参数，覆盖同名已有参数，返回更新后的新 URL 字符串。

## 用法

`setQueryParams` 函数用于批量设置 URL 的查询参数。

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

setQueryParams('https://example.com', { page: 1, limit: 10 })
// 'https://example.com?page=1&limit=10'

setQueryParams('https://example.com?page=1', { page: 2, sort: 'name' })
// 'https://example.com?page=2&sort=name'
```

## API

### `setQueryParams(url, params)`

批量设置 URL 的查询参数。

### 参数

**url** (`string`) *required*: URL 字符串。

**params** (`QueryParams`) *required*: 要设置的参数对象。

### 返回值

**返回值** (`string`): 新的 URL 字符串。

## Changelog

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


## Sitemap

See the full [sitemap](/sitemap.md) for all pages.