# tag（标签）
```javascript
// 取得所有标签
const tags = await eagle.tag.get();
// 按名称筛选标签
const designTags = await eagle.tag.get({ name: "design" });
// 取得最近使用标签
const recents = await eagle.tag.getRecentTags();
// 取得常用标签
const starred = await eagle.tag.getStarredTags();
```
## 方法
## get(options)
获取标签，可通过选项进行筛选。
* `options` Object (可选) - 查询条件
* `name` string (可选) - 按标签名称进行模糊搜索，不区分大小写
* 返回 `Promise` - tags 查询结果。
```javascript
// 获取所有标签
const tags = await eagle.tag.get();
// 按名称筛选标签
const filteredTags = await eagle.tag.get({
name: "design"
});
```
{% hint style="info" %}
提示：`name` 参数需要 Eagle 4.0 build12 以上版本支持。
{% endhint %}
***
## getRecentTags()
获取最近使用的的标签。
* 返回 `Promise` - tags 查询结果。
```javascript
const recents = await eagle.tag.getRecentTags();
```
***
## getStarredTags()
获取常用标签（用户收藏的标签）。
* 返回 `Promise` - tags 查询结果。
```javascript
const starred = await eagle.tag.getStarredTags();
```
{% hint style="info" %}
提示：`getStarredTags()` 方法需要 Eagle 4.0 build18 以上版本支持。
{% endhint %}
***
## merge(options)
合并标签：将来源标签重新命名为目标标签，所有使用来源标签的素材都会自动更新。
* `options` Object - 选项参数
* `source` string - 来源标签名称（将被移除）
* `target` string - 目标标签名称（合并后保留）
* 返回 `Promise