# eslint-plugin-arrow-return-style

> Enforce arrow function return style and automatically fix it

Latest version **1.3.1** (published 2024-07-15) · MIT license · 0 weekly downloads

## Install

```sh
npm install eslint-plugin-arrow-return-style
pnpm add eslint-plugin-arrow-return-style
yarn add eslint-plugin-arrow-return-style
bun add eslint-plugin-arrow-return-style
```

## Health

**Score 45/100 (D)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities; high maintenance score; high quality score.

Warnings: low downloads.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 1.3.1 |
| Published | 2024-07-15 |
| First published | 2023-08-07 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 2 |
| Unpacked size | 31.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 10 |
| Author | u3u |
| Maintainers | u3u |
| Keywords | arrow-body-style, arrow-return-style, arrow-function |

## Links

- npm: https://www.npmjs.com/package/eslint-plugin-arrow-return-style
- Repository: https://github.com/u3u/eslint-plugin-arrow-return-style
- Homepage: https://github.com/u3u/eslint-plugin-arrow-return-style#readme
- Issues: https://github.com/u3u/eslint-plugin-arrow-return-style/issues
- npm.io page: https://npm.io/package/eslint-plugin-arrow-return-style

## Dependencies (2)

- [scule](https://npm.io/package/scule.md) ^1.3.0
- [@typescript-eslint/utils](https://npm.io/package/@typescript-eslint/utils.md) ^7.16.0

## Recent versions

- 1.3.1 (latest) — 2024-07-15
- 1.3.0 — 2024-01-06
- 1.2.2 — 2023-09-06
- 1.2.1 — 2023-08-10
- 1.2.0 — 2023-08-09
- 1.1.1 — 2023-08-08
- 1.1.0 — 2023-08-08
- 1.0.0 — 2023-08-07

## README

# eslint-plugin-arrow-return-style

> Enforce arrow function return style and automatically fix it

[![npm version][npm-version-src]][npm-version-href]
[![npm downloads][npm-downloads-src]][npm-downloads-href]
[![codecov][codecov-src]][codecov-href]
[![License][license-src]][license-href]

## Features

> This rule serves as an alternative to the [`arrow-body-style`](https://eslint.org/docs/latest/rules/arrow-body-style#as-needed) with `as-needed` options, used to improve the style of arrow function return statement.

- When arrow function expressions are multiline or exceed a certain length, explicit return should be enforced to improve readability and extensibility.
- When an arrow function has only one return statement (and does not contain any comments), implicit return should be used to simplify the code and improve readability.
- When using arrow functions as named exports, explicit return should always be used to maintain consistency with regular functions.
- When using arrow functions as React components, always use explicit return to facilitate the addition of `props` and `hooks` in the future.

## Install

```sh
pnpm add eslint-plugin-arrow-return-style -D
```

## Usage

```js
/** @type {import('eslint').Linter.Config} */
module.exports = {
  extends: ['plugin:arrow-return-style/recommended'],
};
```

## Examples

### Fail

```tsx
/* eslint-disable arrow-return-style/arrow-return-style */

const delay = () =>
  new Promise((resolve) => {
    setTimeout(resolve, 1000);
  });

const foo = () => {
  return 'foo';
};

Array.from({ length: 10 }).map((_, i) => {
  return i + 1;
});

const obj = () => {
  return { name: '' };
};

const data = () => ({
  name: '',
});

export const defineConfig = <T extends Linter.Config>(config: T) => config;

const fn = () => /* block comment */ 1;

const Div = () => (
  <>
    <div />
  </>
);
```

### Pass

```tsx
const delay = () => {
  return new Promise((resolve) => {
    setTimeout(resolve, 1000);
  });
};

const foo = () => 'foo';

const obj = () => ({ name: '' });

Array.from({ length: 10 }).map((_, i) => i + 1);

const data = () => {
  return {
    name: '',
  };
};

export const defineConfig = <T extends Linter.Config>(config: T) => {
  return config;
};

const fn = () => {
  /* block comment */
  return 1;
};

const Div = () => {
  return (
    <>
      <div />
    </>
  );
};
```

## Options

### `maxLen`

Type: `number`\
Default: `80`

If the arrow function expression exceeds `maxLen` characters, it is forced to use explicit return.

### `jsxAlwaysUseExplicitReturn`

Type: `boolean`\
Default: `false`

If set `true`, always use explicit return when return value is `JSXElement` or `JSXFragment`.

### `namedExportsAlwaysUseExplicitReturn`

Type: `boolean`\
Default: `true`

By default, named exported arrow functions will always use explicit return to maintain consistency with regular functions because it is more intuitive and unified, and convenient for expansion.

## Rules

<!-- prettier-ignore-start -->
<!-- begin auto-generated rules list -->

⚠️ Configurations set to warn in.\
✅ Set in the `recommended` configuration.\
🔧 Automatically fixable by the [`--fix` CLI option](https://eslint.org/docs/user-guide/command-line-interface#--fix).

| Name                                                             | Description                                                                                               | ⚠️ | 🔧 |
| :--------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------- | :- | :- |
| [arrow-return-style](docs/rules/arrow-return-style.md)           | Enforce arrow function return style                                                                       | ✅  | 🔧 |
| [no-export-default-arrow](docs/rules/no-export-default-arrow.md) | Disallow export default anonymous arrow function<br/>_**Automatically fix using the current file name.**_ | ✅  | 🔧 |

<!-- end auto-generated rules list -->
<!-- prettier-ignore-end -->

## License

[MIT](./LICENSE) License © 2023 [u3u](https://github.com/u3u)

<!-- Badges -->

[npm-version-src]: https://img.shields.io/npm/v/eslint-plugin-arrow-return-style
[npm-version-href]: https://npmjs.com/package/eslint-plugin-arrow-return-style
[npm-downloads-src]: https://img.shields.io/npm/dm/eslint-plugin-arrow-return-style
[npm-downloads-href]: https://npmjs.com/package/eslint-plugin-arrow-return-style
[codecov-src]: https://codecov.io/gh/u3u/eslint-plugin-arrow-return-style/graph/badge.svg
[codecov-href]: https://codecov.io/gh/u3u/eslint-plugin-arrow-return-style
[license-src]: https://img.shields.io/github/license/u3u/eslint-plugin-arrow-return-style.svg
[license-href]: ./LICENSE

---
_Source: https://npm.io/package/eslint-plugin-arrow-return-style · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
