# 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` - タグのクエリ結果。
```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` - タグのクエリ結果。
```javascript
const recents = await eagle.tag.getRecentTags();
```
***
## getStarredTags()
お気に入りタグ（ユーザーがスターを付けたタグ）を取得します。
* 戻り値 `Promise` - タグのクエリ結果。
```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