# Streamのクエリ

## オープン状態のissue <a href="#open-issue" id="open-issue"></a>

オープン(クローズやマージされていない)状態のissueを見るStreamを作るには`is:open`を使います。たとえば`nodejs/node`リポジトリのオープンなissueを見るには次のクエリでStreamを作成します。

```
repo:nodejs/node is:open is:issue
```

しかし、Jasperでは`is:open`を使ったStreamを作ることは非推奨です。なぜなら、オープン状態のissueがクローズされたときにJasperではクローズの検知ができないためです。

{% hint style="info" %}
これはJasperがGitHub Search APIをポーリングしていることによる制約です
{% endhint %}

そのため`is:open`を使う場合は通常のStreamではなく、Filter Streamを使うようにしてください。Filter Streamは通常のStreamに対してJasper独自のフィルターをかけることができます。先程の例は次のようになります。

Stream

```
repo:nodejs/node is:issue
```

Filter Stream

```
is:open
```

![](https://2521784492-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHdBvXuUTTvADT4CXrm%2F-MI8cbwgT_YZCdZ9LLfm%2F-MI8d16INiVTd0m5gQWa%2F05_open.png?alt=media\&token=530d118a-b69e-4b1c-8d22-e437d5885d0c)

{% hint style="info" %}
Filter Streamについてはリファレンスの「[Filter Stream](https://docs.jasperapp.io/ja/reference/filter-stream)」を参照してください。
{% endhint %}

{% hint style="info" %}
クローズ状態、マージ状態、ドラフト状態についても同様の制限があります。
{% endhint %}

## Teamメンションされたissue <a href="#team-issue" id="team-issue"></a>

Teamメンションされたissueを見るには`team:ORGNAME/TEAMNAME`を使います。例えば`@jekyll/owners`がメンションされたissueを見るには次のようなクエリでStreamを作成します。

```
team:@jekyll/owners
```

GitHub Docs: [Search by team mention](https://docs.github.com/en/github/searching-for-information-on-github/searching-issues-and-pull-requests#search-by-team-mention)

## ユーザが関係するissue <a href="#involves-issue" id="involves-issue"></a>

特定のユーザが関係するissueを見るには`involves:USERNAME`を使います。例えば`defunkt`もしくは`jlord`が関係するissueを見るには次のようなクエリでStreamを作成します。

```
involves:defunkt OR involves:jlord
```

{% hint style="info" %}
`involves:USERNAME`はauthor, assign, mention, comment, review-requestedをまとめて指定することができる便利なクエリです。
{% endhint %}

GitHub Docs: [Search by a user that's involved in an issue or pull request](https://docs.github.com/en/github/searching-for-information-on-github/searching-issues-and-pull-requests#search-by-a-user-thats-involved-in-an-issue-or-pull-request)

## リポジトリやOrganizationのissue <a href="#repo-issue" id="repo-issue"></a>

特定のリポジトリのissueを見るには`repo:USERNAME/REPOSITORY`を使います。例えば`nodejs/node`もしくは`electron/electron`リポジトリのissueを見るには次のようなクエリでStreamを作成します。

```
repo:nodejs/node OR repo:electron/electron
```

特定のOrganizationのissueを見るには`org:ORGNAME`を使います。例えば`nodejs`や`electron` Organizationのissueを見るには次のようなクエリでStreamを作成します。

```
org:nodejs OR org:electron
```

GitHub Docs: [Search within a user's or organization's repositories](https://docs.github.com/en/github/searching-for-information-on-github/searching-issues-and-pull-requests#search-within-a-users-or-organizations-repositories)

## マイルストーンやラベルがついたissue <a href="#label-issue" id="label-issue"></a>

特定のマイルストーンが付いたissueを見るには`milestone:MILESTONE_NAME`を使います。例えば`nodejs/node`リポジトリで`13.0.0`もしくは`14.0.0`のマイルストーンがついたissueを見るには次のようなクエリでStreamを作成します。

```
repo:nodejs/node ( milestone:13.0.0 OR milestone:14.0.0 )
```

特定のラベルが付いたissueを見るには`label:LABEL_NAME`を使います。例えば`nodejs/node`リポジトリで`build`**と**`zlib`のラベルが付いたissueを見るには次のようなクエリでStreamを作成します。

```
repo:nodejs/node label:build label:zlib
```

{% hint style="info" %}
複数のラベルを指定するとand条件となります。
{% endhint %}

{% hint style="info" %}
スペースを含むマイルストーンやラベルの場合は`milestone:"foo bar"`のように指定してください。
{% endhint %}

GitHub Docs: [Search by milestone](https://docs.github.com/en/github/searching-for-information-on-github/searching-issues-and-pull-requests#search-by-milestone), [Search by label](https://docs.github.com/en/github/searching-for-information-on-github/searching-issues-and-pull-requests#search-by-label)&#x20;

## キーワードが含まれるissue <a href="#keyword-issue" id="keyword-issue"></a>

特定のキーワードが含まれるissueを見るにはKEYWORDを使います。例えばoctocatとgithubが含まれるissueを見るには次のようなクリエでStreamを作成します。

{% tabs %}
{% tab title="AND条件" %}

```
octocat github
```

{% endtab %}

{% tab title="OR条件" %}

```
octocat OR github
```

{% endtab %}

{% tab title="NOT条件" %}

```
octocat NOT github
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
日本後などのマルチバイト文字やスペースを含むキーワードは`"foo bar"`のように指定してください。
{% endhint %}

GitHub Docs: [Limitations on query length](https://docs.github.com/en/github/searching-for-information-on-github/troubleshooting-search-queries#limitations-on-query-length),  [Exclude certain results](https://docs.github.com/en/github/searching-for-information-on-github/understanding-the-search-syntax#exclude-certain-results)

## 除外指定 <a href="#exclude-issue" id="exclude-issue"></a>

特定のリポジトリやラベルを含まないように指定するには`-QUALIFIER`を使います。例えば`nodejs` organizatonで`nodejs/node`リポジトリと`bug`ラベルを含まいないissueを見るには次のようなクエリでStreamを作成します。

```
org:nodejs -repo:nodejs/node -label:bug
```

GitHub Docs: [Exclude certain results](https://docs.github.com/en/github/searching-for-information-on-github/understanding-the-search-syntax#exclude-certain-results)