# @ampproject/toolbox-cache-url 中文文档

规范地址：https://npmcn.com/package/%40ampproject/toolbox-cache-url/

版本：2\.10\.1
npm 元数据更新时间：2024-06-14T00:32:19.377Z
中文译文更新时间：2026-11-06T04:46:17.192Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40ampproject/toolbox-cache-url
原文对照：https://npmcn.com/package/%40ampproject/toolbox-cache-url/?lang=original
项目主页：https://github.com/ampproject/amp-toolbox/tree/main/packages/cache-url
源码仓库：https://github.com/ampproject/amp-toolbox

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

- 包体积（解压后）：77.1 kB，5 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2019-06-10T18:20:51.300Z
- 最新版本发布：2024-06-14T00:32:18.897Z
- 近 30 天下载量：5040（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：35（近 12 个月 0 个）

## 中文简介

将空格 URL 转换为 AMP 缓存 URL

## 安装

```sh
npm install @ampproject/toolbox-cache-url
```

也可以使用：`pnpm add @ampproject/toolbox-cache-url`、`yarn add @ampproject/toolbox-cache-url`、`bun add @ampproject/toolbox-cache-url`

## README

# AMP- 工具箱缓存 URL

[![npm version](https://badge.fury.io/js/%40ampproject%2Ftoolbox-cache-url.svg)](https://badge.fury.io/js/%40ampproject%2Ftoolbox-cache-url)

根据规格将一个 URL 从源代码转换到 AMP 缓存 URL 格式 备查 [AMP文档](https://developers.google.com/amp/cache/overview)。这包括AMP缓存在无效的可读缓存urls上使用的SHA256倒置URL.

## 使用量

通过 :

```
$ npm install @ampproject/toolbox-cache-url
```

### 包括模块

#### ES 模块(浏览器)

```javascript
import {ampToolboxCacheUrl} from '@ampproject/toolbox-cache-url';
```

#### 常见Js( 节点)

```javascript
const ampToolboxCacheUrl = require('@ampproject/toolbox-cache-url');
```

#### UMD (节点, 浏览器)

在浏览器中, 在 HTML 中包含 UMD 模块 `<script>` 标签。 如果使用节点, 替换 `window` 与 `global`。 。 。 .

```javascript
const {ampToolboxCacheUrl} = window.ToolboxCacheUrl;
```

### 使用模块

```javascript
  // Get an AMP Cache URL from a cache domain, and a canonical URL
  ampToolboxCacheUrl.createCacheUrl('cdn.ampproject.org', 'https://www.example.com').then((cacheUrl) => {
    // This would log: 
    // 'https://www-example-com.cdn.ampproject.org/c/s/www.example.com/'
    console.log(cacheUrl);
  });

  // Transform a canonical URL to an AMP Cache subdomain
  ampToolboxCacheUrl.createCurlsSubdomain('https://www.example.com').then((curlsSubdomain) => {
    // This would log: 
    // 'www-example-com'
    console.log(curlsSubdomain);
  });
```

## 常见问题

### @ampproject/toolbox-cache-url 是什么？

将空格 URL 转换为 AMP 缓存 URL

### 如何安装 @ampproject/toolbox-cache-url？

在项目目录运行 npm install @ampproject/toolbox-cache-url，或使用 pnpm add / yarn add / bun add。

### @ampproject/toolbox-cache-url 支持 TypeScript 吗？

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

### @ampproject/toolbox-cache-url 支持 ESM 还是 CommonJS？

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

### @ampproject/toolbox-cache-url 可以商用吗？

@ampproject/toolbox-cache-url 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @ampproject/toolbox-cache-url 的下载量有多少？

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

### @ampproject/toolbox-cache-url 还在维护吗？

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