remote-cloudflare-kv 在 Vercel 上使用 Cloudflare KV - 服务器托管|北京服务器租用|机房托管租用|IDC托管租用|机房机柜带宽租用-价格及费用咨询

最近我在做 Next.js 项目部署 Cloudflare Pages 时发现本地开发调试、登录鉴权等好多问题，所以又想要切回到 Vercel 中，便有了这么一个项目，可以在 Cloudflare 以外的环境上得到类似于 Worker Runtime 的 KV 使用体验。

废话不多说，直接进入正题。

源码： https://github.com/willin/remote-cloudflare-kv

安装

npm install --save remote-cloudflare-kv
# or
yarn add remote-cloudflare-kv
# or
pnpm install --save remote-cloudflare-kv

使用

初始化

import CloudflareKV from 'remote-cloudflare-kv';

export const NAMESPACE = new CloudflareKV({
  account_id: process.env.CF_ACCOUNT_ID || '',
  namespace_id: process.env.CF_NAMESPACE_ID || '',
  // use bearer token
  api_token: process.env.CF_API_TOKEN || '',
  // or use email & api key
  api_email: '',
  api_key: ''
});

写入 kv

await NAMESPACE.put(key, value);
// void

设置超时：

// 传入 unix 时间戳
await NAMESPACE.put(key, value, { expiration: secondsSinceEpoch });
// 传入秒数
await NAMESPACE.put(key, value, { expirationTtl: secondsFromNow });

设置 Metadata：

await NAMESPACE.put(key, value, {
  metadata: { someMetadataKey: 'someMetadataValue' }
});

读取 kv

// 替换 key & type
const result = await NAMESPACE.get('key', { type: 'json' });
console.log(result);
// {"hello": 1}

支持的类型： text、json、arrayBuffer、stream。

读取 kv 并带 Metadata

const result = await NAMESPACE.getWithMetadata(key, { type: 'json' });
//  {"value": {"hello": 1}, "metadata": {"someKey": "someVal"}}

删除 kv

await NAMESPACE.delete(key);
// void

列出 kv

const result = await NAMESPACE.list();
console.log(result);

更多详细查询（在 Typescript 中）：

await NAMESPACE.list({ prefix: string, limit: number, cursor: string });

列表响应参考：

{
  "keys": [
    {
      "name": "foo",
      "expiration": 1234,
      "metadata": { "someMetadataKey": "someMetadataValue" }
    }
  ],
  "list_complete": false,
  "cursor": "6Ck1la0VxJ0djhidm1MdX2FyD"
}

参考资料

Runtime API: https://developers.cloudflare.com/workers/runtime-apis/kv/
RESTful API: https://developers.cloudflare.com/api/operations/workers-kv-n…

赞助

关注我的 Github 账号：@willin
参与爱发电计划
支付宝或微信扫码打赏

服务器托管，北京服务器托管，服务器租用 http://www.fwqtg.net

相关推荐: Linux 上的 .NET 如何自主生成 Dump

一：背景 1. 讲故事前几天微信上有位朋友找到我，说他程序的线程数会偶发性瞬时飙高，让我看下大概是什么原因，截图如下：如果这种问题每天都会出现，比较好的做法就是用 dotnet-trace 捕获 ThreadCreated 事件，但可气的是朋友说大概一…

安装

使用

初始化