JavaScript decodeURIComponent() 函数

封面图 • 2025-09-19 • JavaScript

`decodeURIComponent()` 是 JavaScript 中的一个内置函数，用于对使用 `encodeURIComponent()` 编码的 URI 组件进行解码。

---

## ✅ 语法

```javascript
decodeURIComponent(encodedURI)
```

- **参数**：
  - `encodedURI`：一个由 `encodeURIComponent()` 编码过的字符串。

- **返回值**：
  - 返回原始的未编码字符串。

---

## 📌 示例

```javascript
let encoded = "Hello%20World%21";
let decoded = decodeURIComponent(encoded);
console.log(decoded); // 输出: Hello World!
```

---

## 🔍 与 `decodeURI()` 的区别

| 方法 | 作用 | 是否解码保留字符 |
|------|------|------------------|
| `decodeURIComponent()` | 解码 URI 组件（如查询参数、路径等） | ✅ 解码所有特殊字符（包括 `+`, `%`, `&`, `=`, `?`, `#` 等） |
| `decodeURI()` | 解码整个 URI | ❌ 不解码 `+`, `%`, `&`, `=`, `?`, `#` 等保留字符 |

---

## ⚠️ 注意事项

- 如果输入不是有效的编码格式，`decodeURIComponent()` 会抛出 `URIError`。
- 它不能处理 `encodeURI()` 的输出，因为 `encodeURI()` 保留了某些字符（如 `:`、`/`、`?`、`#` 等），而 `decodeURIComponent()` 会尝试解码这些字符。

---

## ✅ 常见用途

- 解析 URL 查询参数
- 处理表单数据或 AJAX 请求中的编码内容

### 示例：解析 URL 查询参数

```javascript
let url = "https://example.com?name=John%20Doe&age=30";
let params = new URLSearchParams(url.split("?")[1]);
console.log(params.get("name")); // 输出: John Doe
```

---

如果你有具体的使用场景或问题，欢迎继续提问！