jQuery getJSON() 方法

封面图 • 2025-10-13 • jQuery

`jQuery.getJSON()` 是 jQuery 提供的一个用于发送 **GET** 请求并获取 **JSON 格式数据** 的方法。它简化了 AJAX 请求，特别适用于从服务器获取 JSON 数据。

---

## ✅ 语法

```javascript
$.getJSON(url, [data], [success(data, textStatus, jqXHR)])
```

- `url`: 要请求的 URL 地址。
- `[data]`: (可选) 发送到服务器的数据（通常为对象或字符串）。
- `[success(data, textStatus, jqXHR)]`: 请求成功时的回调函数，参数包括：
  - `data`: 服务器返回的 JSON 数据。
  - `textStatus`: 请求状态（如 `"success"`）。
  - `jqXHR`: jQuery 的 XMLHttpRequest 对象。

---

## 📌 示例

### 示例 1：基本使用

```javascript
$.getJSON("https://api.example.com/data", function(data) {
    console.log(data);
});
```

> 假设 API 返回如下 JSON 数据：

```json
{
    "name": "John",
    "age": 30,
    "city": "New York"
}
```

输出结果：

```javascript
{ name: "John", age: 30, city: "New York" }
```

---

### 示例 2：带参数的 GET 请求

```javascript
$.getJSON("https://api.example.com/data", { id: 123 }, function(data) {
    console.log("ID 123 的数据:", data);
});
```

这相当于向 `https://api.example.com/data?id=123` 发送请求。

---

### 示例 3：错误处理

```javascript
$.getJSON("https://api.example.com/data", function(data) {
    console.log("成功获取数据:", data);
}).fail(function(jqXHR, textStatus, errorThrown) {
    console.error("请求失败:", textStatus, errorThrown);
});
```

---

## ⚠️ 注意事项

- `$.getJSON()` 是 `$.ajax()` 的一个简化版本，专门用于获取 JSON 数据。
- 如果服务器返回的不是有效的 JSON，会触发错误。
- 不支持跨域请求（CORS）如果服务器没有正确设置响应头，需要使用 `jsonp` 或其他方式。
- 如果你需要发送 POST 请求并获取 JSON，应使用 `$.post()` 或 `$.ajax()`。

---

## 💡 与 `$.get()` 和 `$.ajax()` 的区别

| 方法         | 是否自动解析 JSON | 是否适合获取 JSON | 说明                     |
|--------------|-------------------|-------------------|--------------------------|
| `$.get()`    | 否                | 可以              | 需手动解析返回的文本     |
| `$.getJSON()`| 是                | 推荐              | 专为 JSON 设计           |
| `$.ajax()`   | 否                | 可以              | 更灵活，适合复杂请求     |

---

如果你有具体的使用场景或问题，可以告诉我，我可以帮你写出更详细的示例！