# 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