https://github.com/reviewdog/action-eslint

Run eslint with reviewdog
https://github.com/reviewdog/action-eslint

eslint reviewdog

Last synced: 21 days ago
JSON representation

Run eslint with reviewdog

• Host: GitHub
• URL: https://github.com/reviewdog/action-eslint
• Owner: reviewdog
• License: mit
• Created: 2019-09-23T15:07:15.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-04-25T10:01:33.000Z (12 months ago)
• Last Synced: 2024-05-02T01:26:08.302Z (12 months ago)
• Topics: eslint, reviewdog
• Language: JavaScript
• Homepage: https://github.com/marketplace?type=actions&query=reviewdog
• Size: 662 KB
• Stars: 224
• Watchers: 27
• Forks: 63
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-actions - Run ESLint, with reviewdog output on the PR
• fucking-awesome-actions - Run ESLint, with reviewdog output on the PR
• awesome-workflows - Run ESLint, with reviewdog output on the PR
• awesome-actions - 链接
• awesome-actions - 链接

README

        
# GitHub Action: Run eslint with reviewdog

[![depup](https://github.com/reviewdog/action-eslint/workflows/depup/badge.svg)](https://github.com/reviewdog/action-eslint/actions?query=workflow%3Adepup)

[![release](https://github.com/reviewdog/action-eslint/workflows/release/badge.svg)](https://github.com/reviewdog/action-eslint/actions?query=workflow%3Arelease)

[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/reviewdog/action-eslint?logo=github&sort=semver)](https://github.com/reviewdog/action-eslint/releases)

[![action-bumpr supported](https://img.shields.io/badge/bumpr-supported-ff69b4?logo=github&link=https://github.com/haya14busa/action-bumpr)](https://github.com/haya14busa/action-bumpr)

[![Used-by counter](https://img.shields.io/endpoint?url=https://haya14busa.github.io/github-used-by/data/reviewdog/action-eslint/shieldsio.json)](https://github.com/haya14busa/github-used-by/tree/main/repo/reviewdog/action-eslint)

This action runs [eslint](https://github.com/eslint/eslint) with

[reviewdog](https://github.com/reviewdog/reviewdog) on pull requests to improve

code review experience.

[![github-pr-check sample](https://user-images.githubusercontent.com/3797062/65439130-a6043b80-de61-11e9-98b5-bd9567e184b0.png)](https://github.com/reviewdog/action-eslint/pull/1)

![eslint reviewdog rdjson demo](https://user-images.githubusercontent.com/3797062/97085944-87233a80-165b-11eb-94a8-0a47d5e24905.png)

## Inputs

### `github_token`

**Required**. Default is `${{ github.token }}`.

### `level`

Optional. Report level for reviewdog \[`info`,`warning`,`error`\].

It's same as `-level` flag of reviewdog.

### `reporter`

Reporter of reviewdog command \[`github-pr-check`,`github-check`,`github-pr-review`\].

Default is `github-pr-review`.

It's same as `-reporter` flag of reviewdog.

`github-pr-review` can use Markdown and add a link to rule page in reviewdog reports.

### `filter_mode`

Optional. Filtering mode for the reviewdog command \[`added`,`diff_context`,`file`,`nofilter`\].

Default is added.

### `fail_level`

Optional. If set to `none`, always use exit code 0 for reviewdog. Otherwise, exit code 1 for reviewdog if it finds at least 1 issue with severity greater than or equal to the given level.

Possible values: [`none`, `any`, `info`, `warning`, `error`]

Default is `none`.

### `fail_on_error`

Deprecated, use `fail_level` instead.

Optional. Exit code for reviewdog when errors are found \[`true`,`false`\]

Default is `false`.

### `reviewdog_flags`

Optional. Additional reviewdog flags

### `eslint_flags`

Optional. Flags and args of eslint command. Default: '.'

### `workdir`

Optional. The directory from which to look for and run eslint. Default '.'

### `node_options`

Optional. The NODE_OPTIONS environment variable to use with eslint. Default is ''.

## Example usage

You also need to install [eslint](https://github.com/eslint/eslint).

```shell

# Example

$ npm install eslint -D

```

You can create [eslint

config](https://eslint.org/docs/user-guide/configuring)

and this action uses that config too.

### [.github/workflows/reviewdog.yml](.github/workflows/reviewdog.yml)

```yml

name: reviewdog

on: [pull_request]

jobs:

  eslint:

    name: runner / eslint

    runs-on: ubuntu-latest

    permissions:

      contents: read

      pull-requests: write

    steps:

      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2

      - uses: reviewdog/action-eslint@2fee6dd72a5419ff4113f694e2068d2a03bb35dd # v1.33.2

        with:

          github_token: ${{ secrets.GITHUB_TOKEN }}

          reporter: github-pr-review # Change reporter.

          eslint_flags: "src/"

```

You can also set up node and eslint manually like below.

```yml

name: reviewdog

on: [pull_request]

jobs:

  eslint:

    name: runner / eslint

    runs-on: ubuntu-latest

    steps:

      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2

      - uses: actions/setup-node@cdca7365b2dadb8aad0a33bc7601856ffabcc48e # v4.3.0

        with:

          node-version: "20"

      - run: yarn install

      - uses: reviewdog/action-eslint@2fee6dd72a5419ff4113f694e2068d2a03bb35dd # v1.33.2

        with:

          reporter: github-check

          eslint_flags: "src/"

```