# @forsakringskassan/cypress-axe 中文文档

规范地址：https://npmcn.com/package/%40forsakringskassan/cypress-axe/

版本：5\.1\.6
npm 元数据更新时间：2026-10-20T07:47:30.324Z
中文译文更新时间：2026-11-15T09:30:58.868Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40forsakringskassan/cypress-axe
原文对照：https://npmcn.com/package/%40forsakringskassan/cypress-axe/?lang=original
项目主页：https://github.com/Forsakringskassan/cypress-axe
源码仓库：https://github.com/Forsakringskassan/cypress-axe

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

- 包体积（解压后）：53 kB，16 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：^22\.12\.0 \|\| \>= 24\.0\.0
- 运行依赖：1 个
- 首次发布：2024-03-04T15:20:46.477Z
- 最新版本发布：2026-10-08T23:05:07.978Z
- 近 30 天下载量：24728（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 12 个）

## 中文简介

囊压测试结束时的轴注射器和执行器

## 安装

```sh
npm install @forsakringskassan/cypress-axe
```

也可以使用：`pnpm add @forsakringskassan/cypress-axe`、`yarn add @forsakringskassan/cypress-axe`、`bun add @forsakringskassan/cypress-axe`

## README

# @forsakringskassan/cypress-axe (英语)

Ett cypress插件 för att automatiskt köra 轴测试器.

插件: et placerar och utför vieringskontroller för turgänglighet i slitchet av varje cypress test. 中国植物物种信息数据库.

## 安瓦德宁

插件: et placerar automatiskt 多样化的验证检查 efter varje cypress mha. 等宽度 `afterEach` 块一 Cypress. För att injicera samt konphitra 插件:et på rätt sätt för setranvisningarna. 中国植物物种信息数据库.

### 曼努埃尔验证

Du kan också mitt i et test köra (英语:Du kan också mitt i et test köra) 互联网档案馆的存檔,存档日期2013-12-02 `cy.axe()` för att kontrollera att aktuell markup är giltig. 中国植物物种信息数据库. Användningsområdet kan exempelvis vara om du vill viera ett 元素(tex module) 索姆签证 男子在Each körs之后的som inte finns kvar när.

## 安装

欧曼哈 `cypress-axe` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}我就是这个意思

-   `package.json`
-   `cypress/support/(component|e2e|common).(js|ts)`
-   `cypress.config.(js|ts)`

### cypress/ support/( 组件- e2e- common) (js- ts)

Lägg直到 följande någonstans 我存档

```javascript
import "@forsakringskassan/cypress-axe/support";
```

### (日语). cypress.config

Lägg 一直到 följande i topppen av folen (法语)

```javascript
import { init as installAxe } from "@forsakringskassan/cypress-axe/plugins";
```

Placera därefter registreringen av 插件在 :

```javascript
e2e: {
    setupNodeEvents(on, config) {
        config = installAxe(on, config);
        return config;
    }
}
```

och / eller 键

```javascript
component: {
    setupNodeEvents(on, config) {
        config = installAxe(on, config);
        return config;
    }
}
```

### 类型/支持.d.ts

För at komma åt twitchen av Cypress kommandon likt (中文(简体) ) `cy.axe()` (原始内容存档于2013-10-12). så Behöver man uppdatera tsconfig.json under Cypress Katalogen.

```json
    "compilerOptions": {
        "types": [
            "@forsakringskassan/cypress-axe/support"
        ],
    }
```

## 配置

Konfiguration kan antingen skickas in vid init i 的缩写 `cypress.config.ts` 通过分离 JSON -fil.

`cypress.config.ts`

```ts
import { defineConfig } from "cypress";
import { init as installAxe } from "@forsakringskassan/cypress-axe/plugins";

const axeOptions = {
    "context": {
        "include": [["#app"]],
        "exclude": [[".selector1"], [".selector2"], ["..."]]
    }
}

export default defineConfig({
    e2e: {
        ...
        setupNodeEvents(on, config) {
            return installAxe(on, config, axeOptions);
        },
    },
});
```

`fk-cypress-axe.json`

```json
{
    "context": {
        "include": [["#app"]],
        "exclude": [[".selector1"], [".selector2"], ["..."]]
    }
}
```

## 贝斯泰尔宁

```javascript
{
  "axe": {
    "rules": [
      // Disable color contrast rule
      {
        "id": 'color-contrast',
        "enabled": false,
      },
    ],
  },
  "context": null,
  "assertOnViolation": true, // Stoppar resterande tester så fort ett misslyckas. (Annars rapporteras även felaktiga testfall som lyckade).
  "displayHelpUrl": true, // Visar aXe help URL tillsammans med felet. Default true.
  "displayContext": true, // Visar sammanhang (CSS selector, HTML, Förslag till rättelse, osv.)
  "displayPasses": true, // Visar även passes. Default true
  "displayViolations": true, // Visar felen. Default true.
  "standardsToReport": ['wcag2a', 'wcag2aa'], // Lista med standarder som kontrolleras. Om listan är tom visas valideras samtliga standarder.
  "ignoreAxeFailures": false, // Ignorera Axe-valideringsfel. Default false
  "displayWhen": 'both', // När felen ska visas ("immediate", "end", "both")
  "excludeSelectorsList": [], // Lista med eventuella CSS selectorer som ska undantas från tillgänglighetskontrollerna
}
```

Genom att fylla i en lokal 地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平 `fk-cypress-axe.json` (原始内容存档于2018-10-21) (英语). kan man alltså skriva över enskilda inställningar i dena filen. (原始内容存档于2018-10-29). Resterande fält diff:as mot basintällningarna.

**欧比:** Vissa inställningar diff:as ej, nämligen inställningarna som Finns i (英语: `axe.rules`。 。 。 . (原始内容存档于2018-09-21) (英语). Dvs.om man I sin Lokala konfigulation ändrar `'color-contrast'` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}雷格恩 {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}我们想把阿特斯特尔特 {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}真的 `enabled`。 。 。 .

### `include` 编号 : `exclude`

乌托弗 `excludeSelectorsList` 坎曼·阿旺达 `context` för at ange vod som ska inkluders och exkluders. (原始内容存档于2018-09-29) (英语). Detta påverkar vilka 元素 som 轴克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克.

```json
{
    "context": {
        "include": [["#app"]],
        "exclude": [[".selector1"], [".selector2"], ["..."]]
    }
}
```

### 缩写

(原始内容存档于2018-10-21). Det är möjligt at ändra konfigurationen för en enskild fil. Dessa ändringar kommer alltså int sprida sig to övriga (英语: `.spec` 存档者. Detta görs genom at tiggt I spec filen lägga to följande kodstycke. 中国植物物种信息数据库.

```javascript
before(() => {
    // Retrieves the current configuration used by @forsakringskassan/cypress-axe.
    cy.getAxeConfigThisFile().then((config) => {
        // Make your changes here, for example, the following is a valid change
        config.excludeSelectorsList = [".secret-menu"];

        // Don't forget to pass your changed config back to cypress
        cy.setAxeConfigThisFile(config);
    });
});
```

法语区 **点** möjligt at ändra konfigurationen för enskilda testfall. 中国植物物种信息数据库. Ovanstående stycke kommer at påverka hela (英语:Ovanstående stycke stycke symmer at påverka hela) 互联网档案馆的存檔,存档日期2013-12-21 `.spec` (原始内容存档于2013-10-12). folen fr.o.m då det körs. Det finns därför ingen mening med att placera det på annan plats än i det yttersta scope:t. 中国植物物种信息数据库.

## 常见问题

### @forsakringskassan/cypress-axe 是什么？

囊压测试结束时的轴注射器和执行器

### 如何安装 @forsakringskassan/cypress-axe？

在项目目录运行 npm install @forsakringskassan/cypress-axe，或使用 pnpm add / yarn add / bun add。

### @forsakringskassan/cypress-axe 支持 TypeScript 吗？

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

### @forsakringskassan/cypress-axe 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @forsakringskassan/cypress-axe 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js ^22\.12\.0 \|\| \>= 24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @forsakringskassan/cypress-axe 可以商用吗？

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

### @forsakringskassan/cypress-axe 的下载量有多少？

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

### @forsakringskassan/cypress-axe 还在维护吗？

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

