---
title: "extractFilename"
description: "从响应头中提取文件名"
seo_title: "extractFilename"
seo_description: "Extract a filename from HTTP response headers, parsing Content-Disposition with a fallback name for reliable file downloads."
canonical_url: "https://core.mhaibaraai.cn/docs/helpers/file/extract-filename"
---
# extractFilename

> 从响应头中提取文件名

## 用法

`extractFilename` 函数用于从响应头中提取文件名。

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

// 从响应头中提取文件名
const headers = new Headers({
  'content-disposition': 'attachment; filename="report.pdf"'
})
const filename = extractFilename(headers, 'download')
console.log(filename) // 'report.pdf'

// 处理编码的文件名
const encodedHeaders = new Headers({
  'content-disposition': 'attachment; filename*=UTF-8\'\'%E6%8A%A5%E5%91%8A.pdf'
})
const encodedFilename = extractFilename(encodedHeaders)
console.log(encodedFilename) // '报告.pdf'
```

## API

### `extractFilename(headers?, fallbackName?)`

从响应头中提取文件名。

### 参数

**headers** (`Headers`): 响应头对象。

**fallbackName** (`string`): 默认文件名,默认为 'file'。

### 返回值

**返回值** (`string`): 提取的文件名。

## Changelog

See commit history for [src/helpers/file/extractFilename.ts](https://github.com/mhaibaraai/movk-core/commits/main/src/helpers/file/extractFilename.ts).


## Sitemap

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