@commerce-klaus/eslint-config-sfcc

中文文档
2.1.0发布于 2026/11/06MITTypeScriptES Module构建来源已验证近 30 天下载 2613

销售力量商业云(SFCC)可分享的ESLint配置集

中文使用文档
文档目录4 节
  1. 要点
  2. 安装
  3. 文档
  4. 许可证

NPM version Downloads

@commercial-klaus/eslint-config-sfcc (英语)

可共享的ESLint平面配置用于销售力量商业云项目. 钓到鱼了 SFCC 脚本运行时间 相容性问题和平台特定错误在代码到达沙盒之前.

要点

  • 检测不支持的语法和标准库 API
  • 检查 SFCC 模块路径、 钩和自定义 API 导出
  • 针对犀牛的处理 const 和范围界定行为
  • 包括SFCC和SiteGenesis规则
  • 提供 Storefront Next, PWA, SFRA, 和 SiteGenesis 策略预设
  • 为更古老的SFCC兼容模式提供添加剂预设
  • 提供可审查的、安全的批次移出SFCC empty() 全球
  • 包括面向行动的用于 empty() 移徙清单
  • 使用自定义属性和站点首选元数据来增强自信 empty() 移徙指导
  • 连接解析自定义 API 请求机构生成 OAS 操作类型
  • 为在元数据边界执行生成的项目类型提供选入预设
  • 提供选入 sfcc-test 用于相继运行时间使用、延迟导入墨盒、管理测试全局和安全模拟设置的预设
  • 支持 ESLint 和一个与 Oxlint 兼容的预设
  • 为推荐、兼容、生成类型、空移、存储前置架构和SFCC测试配置提供等同的 Oxlint 覆盖构建器

更喜欢Oxlint的日常行走. 它为正常发展和CI提供了快回馈回回回路并运行与ESLint相同的服务器侧弹匣文件上推荐的JavaScript规则. 使用ESLint进行完整的迁移和审计 .ds 文件, E4X 类似语法, JavaScript 类型说明, JSON 元数据, 或复杂推断类型需要它的解析器和 TypeScript 服务. 完整的向导记录了聚焦的 ESLint 为四条规则 Oxlint 无法运行的倒置.

安装

pnpm add -D eslint @commerce-klaus/eslint-config-sfcc
npm install -D eslint @commerce-klaus/eslint-config-sfcc
yarn add -D eslint @commerce-klaus/eslint-config-sfcc
vp install -D eslint @commerce-klaus/eslint-config-sfcc
import sfcc from "@commerce-klaus/eslint-config-sfcc"
import { defineConfig } from "eslint/config"

export default defineConfig(sfcc.configs.recommended)

产生申报的项目 @commerce-klaus/typescript-sfcc 能够添加 generated-types 预设于 recommended数字 :

export default defineConfig(sfcc.configs.recommended, sfcc.configs["generated-types"])

预设检查已注册的工作步骤功能,SFCC系统钩子执行,自定义 API 处理器,以及本地自定义 API 成功响应值对照其生成的类型.

下面推荐的配置检查服务器侧 JavaScript cartridges/ 不包括客户端和静态资产文件夹. 它也禁用从更早的平面配置条目中继承的Node.js和浏览器Globals,同时保留了CommonJS和SFCC运行时Globals.

它还禁用ESLint核心/推荐中选定的不兼容规则, eslint-plugin-unicorn, (中文(简体) ), typescript-eslint,以及 eslint-plugin-sonarjs。这可以使这些预设与 SFCC 代码一起使用,而不建议语法、 API 或 SFCC 脚本运行时间不支持的模块模式。 见文档相容性覆盖的配置指南 .

建议的配置遵循目前的SFCC脚本 API. 使用老年人的项目 兼容模式可以在 recommended数字 :

export default defineConfig(sfcc.configs.recommended, sfcc.configs["compatibility-21.2"])

兼容模式的预设可用 21.2 财务报告和审定财务报表 22.7编辑 22.7 预设 目前与建议的API基线相匹配,并建立一个明确的版本 未来脚本 API 添加合同。 这个 21.2 预设还防止独角兽 从建议Bigint, globalThis,或 Object.fromEntries 作为替代.

文档

见 完整的配置指南和规则参考。 。 。 .

许可证

麻省理工学院

版本与发布记录

@commerce-klaus/eslint-config-sfcc 共发布 47 个版本,首次发布于 2026/06/29;过去 12 个月发布了 47 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.1.0latest2026/11/064 天前
2.0.12026/10/3011 天前
2.0.02026/10/3011 天前
1.15.12026/10/2912 天前
1.15.02026/10/2417 天前
1.14.02026/10/051 个月前

关于 @commerce-klaus/eslint-config-sfcc 的常见问题

@commerce-klaus/eslint-config-sfcc 是什么?

销售力量商业云(SFCC)可分享的ESLint配置集

如何安装 @commerce-klaus/eslint-config-sfcc?

在项目目录运行 npm install @commerce-klaus/eslint-config-sfcc,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:eslint(>=9.0.0)、globals(>=13.24.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@commerce-klaus/eslint-config-sfcc 支持 TypeScript 吗?

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

@commerce-klaus/eslint-config-sfcc 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@commerce-klaus/eslint-config-sfcc 需要什么版本的 Node.js?

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

@commerce-klaus/eslint-config-sfcc 可以商用吗?

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

@commerce-klaus/eslint-config-sfcc 的下载量有多少?

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

@commerce-klaus/eslint-config-sfcc 还在维护吗?

最新版本 2.1.0 发布于 2026/11/06(4 天前);至今共发布 47 个版本,其中过去 12 个月发布了 47 个;首次发布于 2026/06/29。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。