# @arabasta/eslint-plugin-javascript 中文文档

规范地址：https://npmcn.com/package/%40arabasta/eslint-plugin-javascript/

版本：1\.0\.1
npm 元数据更新时间：2026-04-03T11:36:21.906Z
中文译文更新时间：2026-11-06T23:37:16.252Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40arabasta/eslint-plugin-javascript
原文对照：https://npmcn.com/package/%40arabasta/eslint-plugin-javascript/?lang=original
项目主页：https://github.com/CloudNStoyan/arabasta#readme
源码仓库：https://github.com/CloudNStoyan/arabasta

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：19 kB，8 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：eslint \>=8\.0\.0
- 首次发布：2024-10-30T11:49:56.581Z
- 最新版本发布：2026-04-03T11:36:21.533Z
- 近 30 天下载量：2162（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 1 个）

## 中文简介

Javascript 规则的 ESLint 插件

## 安装

```sh
npm install @arabasta/eslint-plugin-javascript
```

也可以使用：`pnpm add @arabasta/eslint-plugin-javascript`、`yarn add @arabasta/eslint-plugin-javascript`、`bun add @arabasta/eslint-plugin-javascript`

## README

# `@arabasta/eslint-plugin-javascript`

[![NPM Version](https://img.shields.io/npm/v/%40arabasta%2Feslint-plugin-javascript)](https://www.npmjs.com/package/@arabasta/eslint-plugin-javascript) [![NPM License](https://img.shields.io/npm/l/%40arabasta%2Feslint-plugin-javascript)](https://github.com/CloudNStoyan/arabasta/blob/main/eslint-plugin-javascript/LICENSE)

Javascript 规则的 ESLint 插件 .

## 安装

假设您已经安装了 ESLint, 请运行 :

```sh
# npm
npm install --save-dev @arabasta/eslint-plugin-javascript

# yarn
yarn add --dev @arabasta/eslint-plugin-javascript

# pnpm
pnpm add --save-dev @arabasta/eslint-plugin-javascript
```

## 使用量

[平面配置](https://eslint.org/docs/latest/use/configure/configuration-files) (单位:千美元)**互联网档案馆的存檔,存档日期2013-12-02**(中文(简体) )

```js
// ...
import arabastaJavascript from '@arabasta/eslint-plugin-javascript';

export default [
  // ...
  arabastaJavascript.configs.recommended,
];
```

[遗产配置](https://eslint.org/docs/latest/use/configure/configuration-files-deprecated) (单位:千美元)**.slintrc (英语)**(中文(简体) )

```json
{
  "extends": [
    // ...
    "plugin:@arabasta/javascript/recommended-legacy"
  ]
}
```

## 规则

QQ 配置启用 .  
设置在 `recommended` 配置 .  
自动修复 [`--fix` CLI 选项](https://eslint.org/docs/user-guide/command-line-interface#--fix)。 。 。 .  
手动修复 [编辑器建议](https://eslint.org/docs/latest/use/core-concepts#rule-suggestions)。 。 。 .

| 名称 | 说明 | 💼 | 🔧 | 💡 |
| --- | --- | --- | --- | --- |
| [报告错误](https://npmcn.com/package/%40arabasta/eslint-plugin-javascript/docs/rules/report-caught-error.md) | 要求报告被捕获出错 | ✅ |  | 💡 |
| [替代函数](https://npmcn.com/package/%40arabasta/eslint-plugin-javascript/docs/rules/use-alternative-functions.md) | 需要使用替代功能 |  | 🔧 |  |

## 设置

您可以在配置中设置以下设置:

### `@arabasta/alternative-functions`

从替代函数组名称到一系列替代函数的地图.

此设置目前仅用于 [替代函数](https://npmcn.com/package/%40arabasta/eslint-plugin-javascript/docs/rules/use-alternative-functions.md) 规则作为替代规则 [规则选项](https://eslint.org/docs/latest/use/configure/rules#using-configuration-files) 因为我们想要多个配置添加自己的选项 - 这个特性是 [无法](https://github.com/eslint/eslint/issues/9192) 在当前的斯林特.

```ts
interface AlternativeFunction {
  /**
   * The name of the function that will be replaced by the alternative (`to`) function.
   */
  from: string;

  /**
   * The name of the alternative function that will replace the `from` function.
   */
  to: string;
}

interface Settings {
  '@arabasta/alternative-functions': {
    /**
     * The key of the object that holds the array of alternative functions is
     * recommended to be used as a description of the group of alternative functions.
     * Note: The key should be distinctive enough so that it won't be overwritten by other configs.
     */
    [key?: string]: AlternativeFunction[];
  };
}

const exampleSettings: Settings = {
  '@arabasta/alternative-functions': {
    redux: [
      {
        from: 'useDispatch',
        to: 'useAppDispatch',
      },
      {
        from: 'useSelector',
        to: 'useAppSelector',
      },
    ],
    'redux-thunk': [
      {
        from: 'createAsyncThunk',
        to: 'createAppAsyncThunk',
      },
    ],
  },
};
```

## 常见问题

### @arabasta/eslint-plugin-javascript 是什么？

Javascript 规则的 ESLint 插件

### 如何安装 @arabasta/eslint-plugin-javascript？

在项目目录运行 npm install @arabasta/eslint-plugin-javascript，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：eslint（\>=8\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @arabasta/eslint-plugin-javascript 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @arabasta/eslint-plugin-javascript 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @arabasta/eslint-plugin-javascript 可以商用吗？

@arabasta/eslint-plugin-javascript 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @arabasta/eslint-plugin-javascript 的下载量有多少？

根据 npm 官方下载统计，@arabasta/eslint-plugin-javascript 在 2026/10/07 – 2026/11/05 这 30 天内被下载 2,162 次，日均约 72 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @arabasta/eslint-plugin-javascript 还在维护吗？

最新版本 1\.0\.1 发布于 2026/04/03（7 个月前）；至今共发布 2 个版本，其中过去 12 个月发布了 1 个；首次发布于 2024/10/30。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。