codebattle/js

chai-code-checker Docker镜像文档

一、镜像概述和主要用途

chai-code-checker 是一个基于 Chai 断言库的 Docker 镜像，专为 JavaScript 代码的自动化测试与质量检查设计。该镜像集成了 Chai 的核心断言功能与基础代码检查逻辑，可快速验证 JavaScript 代码的语***范性、逻辑正确性及断言有效性，适用于开发流程中的代码质量管控环节。

二、核心功能和特性

• Chai 断言支持：内置 Chai 断言库，支持 BDD（expect/should）和 TDD（assert）两种断言风格，满足不同测试场景需求。
• 轻量级设计：基于精简的 Node.js 基础镜像构建，体积小、启动快，适合集成到资源受限的环境。
• 即插即用：无需本地安装依赖，通过 Docker 容器化运行，避免开发环境配置冲突。
• 基础代码检查：内置语法校验逻辑，可快速识别代码中的语法错误及常见逻辑问题。

三、使用场景和适用范围

• 本地开发阶段：开发人员在提交代码前，通过容器快速检查本地 JavaScript 文件的语法和断言有效性。
• CI/CD 流程集成：作为 CI 流水线的前置步骤，自动检查提交的代码质量，避免不合格代码进入构建环节。
• 自动化测试任务：配合测试脚本，对 JavaScript 项目执行单元测试或集成测试，验证代码逻辑正确性。

四、使用方法和配置说明

4.1 基本使用（docker run 命令）

通过挂载本地代码目录到容器内，执行代码检查：

bash
docker run --rm -v /本地代码目录:/app docker.xuanyuan.run/chai-code-checker:latest

参数说明：

• --rm：容器退出后自动删除，避免残留容器文件。
• -v /本地代码目录:/app：将本地待检查的代码目录挂载到容器内的 /app 目录（容器默认检查路径）。

4.2 指定检查目录

若需检查非默认目录（/app），可通过命令行参数指定目标路径：

bash
docker run --rm -v /本地代码目录:/workspace docker.xuanyuan.run/chai-code-checker:latest /workspace/src

上述命令将检查 /workspace/src 目录下的 JavaScript 文件（需确保本地目录已挂载到 /workspace）。

4.3 docker-compose 配置示例

在项目中通过 docker-compose.yml 集成，便于批量执行检查任务：

yaml
version: '3'
services:
  code-check:
    image: docker.xuanyuan.run/chai-code-checker:latest
    volumes:
      - ./src:/app  # 挂载项目源码目录到容器/app
    command: /app  # 指定检查目录（默认可不填，即检查/app）

执行检查：

bash
docker-compose run --rm code-check

4.4 配置参数说明

4.4.1 环境变量

示例：指定日志级别为 debug 并检查 /code 目录：

bash
docker run --rm -v /本地代码:/code -e CHECK_DIR=/code -e LOG_LEVEL=debug docker.xuanyuan.run/chai-code-checker:latest

4.4.2 卷挂载

五、注意事项

1. 镜像默认仅支持 .js 后缀文件的检查，其他类型文件需通过自定义配置扩展。
2. 若需集成自定义代码检查规则（如 ESLint 配置），可通过挂载配置文件到 /config 目录实现。
3. 容器运行时需确保挂载的本地目录有读权限，避免因权限问题导致检查失败。