@craftercms/classes

中文文档
4.4.1发布于 2026/10/27GNU LGPL 3.0TypeScriptESM + CJS近 30 天下载 5137

Crafter CMS utility classes for developing sites and applications

原始使用文档
文档目录4 节
  1. Usage
  2. Package Index
  3. crafterConf
  4. SDK Service

npm (scoped)

@craftercms/classes

This package contains useful classes for developing craftercms websites & applications.

Usage

All of Crafter CMS packages can be used either via npm or in plain html/javascript via regular script imports.

  • Install module using yarn or npm
    • yarn add @craftercms/classes or
    • npm install @craftercms/classes
  • Import and use the classes you need

Package Index

The examples below assume usage in the style of using via npm. If you're using the bundles, directly importing as a script in the browser, these functions will be under the global variable named craftercms.classes (i.e. window.craftercms.classes).

crafterConf

Example

The crafterConf is a special class to globally configure CrafterCMS libraries. Most services you can supply these configurations on a call-by-call basis, but you may simplify by configuring all services via crafterConf early-on on your application bootstrap.

import { crafterConf } from '@craftercms/classes';

crafterConf.configure({
  // Set the base url for all service calls (i.e. urls get built `${baseUrl}/some-endpoint.json`)
  baseUrl: process.env.CRAFTER_HOST_NAME,
  // Set the site id of the site to fetch from/against
  site: process.env.CRAFTER_SITE_NAME,
  // Optionally, set cors mode to true/false (default is false)
  cors: true,
  // Optionally, set any headers you want SDK requests to go out with
  headers: {
    SOME_HEADER: 'some-value'
  }
});

SDK Service

SDKService Provides http get and post methods for Crafter services

Examples

  import { httpGet } from '@craftercms/classes';

  const requestURL = "/some-url";

  httpGet(requestURL, { 
    crafterSite: "editorial"
  }).subscribe((response) => {
    console.log(response);
  })

版本与发布记录

@craftercms/classes 共发布 37 个版本,首次发布于 2018/07/31;过去 12 个月发布了 1 个版本。

版本发布日期距今
4.4.1latest2026/10/2715 天前
4.4.02025/07/291.3 年前
4.3.02025/02/211.7 年前
4.2.22025/01/211.8 年前
4.2.12024/12/161.9 年前
4.1.9support-4.1.x2024/11/262 年前

关于 @craftercms/classes 的常见问题

@craftercms/classes 是什么?

Crafter CMS utility classes for developing sites and applications

如何安装 @craftercms/classes?

在项目目录运行 npm install @craftercms/classes,或使用 pnpm add / yarn add / bun add。

@craftercms/classes 支持 TypeScript 吗?

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

@craftercms/classes 支持 ESM 还是 CommonJS?

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

@craftercms/classes 可以商用吗?

@craftercms/classes 使用 GNU LGPL 3.0 许可。声明的许可为 GNU LGPL 3.0,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

@craftercms/classes 的下载量有多少?

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

@craftercms/classes 还在维护吗?

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