---
title: "buildUrl"
description: "Build a complete URL from a base, optional path, query parameters, and hash, handling slashes and encoding to produce a valid result."
canonical_url: "https://core.mhaibaraai.cn/en/docs/utilities/url/build-url"
---
# buildUrl

> Build a complete URL from a base, optional path, query parameters, and hash, handling slashes and encoding to produce a valid result.

## Usage

`buildUrl` builds a complete URL from its parts.

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

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

buildUrl('https://example.com', '/page', null, 'section')
// 'https://example.com/page#section'

buildUrl('https://example.com', '/api', { ids: [1, 2, 3] })
// 'https://example.com/api?ids=1&ids=2&ids=3'
```

## API

### `buildUrl(base, path?, query?, hash?)`

Build a complete URL.

### Parameters

**base** (`string`) *required*: The base URL.

**path** (`string`): The path segment.

**query** (`QueryParams | null`): Query parameters.

**hash** (`string`): The hash fragment.

### Returns

**returns** (`string`): The complete URL string.

## Changelog

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

---

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


## Sitemap

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