@fleekhq/fleek-storage-js

中文文档
1.0.24发布于 2023/02/16ISCCommonJS近 30 天下载 2.1万

JS SDK 与 Fleek 存储器交互

此软件包已被标记为弃用

We’ve upgraded! The deprecated Fleek Storage SDK is now part of our all-new Fleek Platform SDK, which brings enhanced performance, new features, and broader support for all your development needs. Head to https://www.npmjs.com/package/@fleek-platform/sdk to get started, or visit https://fleek.xyz/docs to learn even more.

中文使用文档
文档目录12 节
  1. 起来
  2. 获取输入参数
  3. 上传
  4. 上传的输入参数
  5. 删除文件
  6. 删除的输入参数
  7. 列表文件
  8. 列表的输入参数
  9. 列表按钮
  10. 列表的输入参数
  11. 从哈什获取文件
  12. 获取FileFromHash 的输入参数

Fleek 存储 Js

Fleek存储 Js是一个与Fleek存储器交互的SDK.

: exclaim: 请不要在浏览器中直接使用此软件包. 您的 API 秘密将被该页面的用户看到 。 如果您需要客户端提出请求,请直接使用带有预签名的urls的S3 SDK: https://docs.aws.amazon.com/AmazonsS3/latest/userguide/using-presigned-url.html 互联网档案馆的存檔,存档日期2013-12-21。 。 。 .

yarn add @fleekhq/fleek-storage-js

导入

SDK可以使用 import 语句.

import fleekStorage from '@fleekhq/fleek-storage-js'

SDK也可以使用 require。 。 。 .

const fleekStorage = require('@fleekhq/fleek-storage-js')

获取 Api 密钥

Api 密钥和密钥可以生成于 Fleek 网络应用程序 或从 闪光 CLI。 。 。 .

见 获取 Api 密钥

方法

起来

这个 get 方法是获取单个文件,无论是内容还是相关数据,如密钥、散列和公用Url.

使用实例:

const myFile = await fleekStorage.get({
  apiKey: 'my-key',
  apiSecret: 'my-secret',
  key: 'my-file-key',
  getOptions: [
    'data',
    'bucket',
    'key',
    'hash',
    'publicUrl'
  ],
})

获取输入参数

段落类型说明
键字符串用于认证的 api 密钥
密码字符串用于认证的 api 秘密
键字符串在桶中识别请求文件的密钥
桶头字符串、 可选、 默认默认账户桶包含文件的桶名 。 默认使用每个 Fleek 账户创建一桶
获取选项矩阵, 可选, 默认为 ['data']指定要获取文件信息类型的阵列 。 阵列的可能值包括: data, (中文(简体) ), bucket, (中文(简体) ), hash, (中文(简体) ), key, (中文(简体) ), publicUrl

上传

这个 upload 方法上传一个文件,由密钥识别,到一桶. 函数返回文件的散列, publicUrl, 键和桶 .

使用实例:

fs.readFile(filePath, async (error, fileData) => {
  const uploadedFile = await fleekStorage.upload({
    apiKey: 'my-key',
    apiSecret: 'my-secret',
    key: 'my-file-key',
    data: fileData,
  });
})


上传的输入参数

段落类型说明
键字符串用于认证的 api 密钥
密码字符串用于认证的 api 秘密
键字符串在桶中识别请求文件的密钥
桶头字符串、 可选、 默认默认账户桶包含文件的桶名 。 默认使用每个 Fleek 账户创建一桶
数据任意要上传的文件数据

删除文件

这个 deleteFile 方法删除文件,由文件的密钥和桶识别. 函数返回已删除文件的密钥和桶, 如果成功 . 如果文件不存在, 方法仍将成功执行 .

使用实例:

  await fleekStorage.deleteFile({
    apiKey: 'my-key',
    apiSecret: 'my-secret',
    key: 'my-file-key',
    bucket: 'my-bucket',
  });

删除的输入参数

段落类型说明
键字符串用于认证的 api 密钥
密码字符串用于认证的 api 秘密
键字符串在桶中识别文件的密钥
桶头字符串、 可选、 默认默认账户桶包含文件的桶名 。 默认使用每个 Fleek 账户创建一桶

列表文件

这个 listFiles 方法就是在密钥、散列和公用Url等桶中获取所有文件的信息.

使用实例:

const files = await fleekStorage.listFiles({
  apiKey: 'my-key',
  apiSecret: 'my-secret',
  prefix: 'my-folder',
  getOptions: [
    'bucket',
    'key',
    'hash',
    'publicUrl'
  ],
})

列表的输入参数

段落类型说明
键字符串用于认证的 api 密钥
密码字符串用于认证的 api 秘密
桶头字符串、 可选、 默认默认账户桶包含文件的桶名 。 默认使用每个 Fleek 账户创建一桶
前缀字符串,可选的,默认为空字符串您想要列出文件的文件夹名称 。 可用于通过 Fleek 存储中的文件夹结构重现
获取选项矩阵,可选,默认为 ['键', 'bucket', 'publicUrl']指定要获取文件信息类型的阵列 。 阵列的可能值包括: bucket, (中文(简体) ), hash, (中文(简体) ), key, (中文(简体) ), publicUrl

列表按钮

这个 listBuckets 方法返回与 api 密钥账户相关的桶名.

使用实例:

const buckets = await fleekStorage.listBuckets({
  apiKey: 'my-key',
  apiSecret: 'my-secret',
})

列表的输入参数

段落类型说明
键字符串用于认证的 api 密钥
密码字符串用于认证的 api 秘密

从哈什获取文件

getFileFromHash 是一个使用散列从 Fleek 的 IPFS 网关下载文件数据的工具函数。 由于网关是公开的,所以不需要钥匙和秘密.

使用实例:

const myFile = await fleekStorage.getFileFromHash({
  hash: 'bafybeige4bhzjvrptn7fdz7mqgigzoczcliqpuo7km4jm7vgjg2pbmuhna',
  getFileFromHashOptions: [
    'buffer',
  ],
})

获取FileFromHash 的输入参数

段落类型说明
散列轴字符串请求文件的散列
从 Hash 选项获取文件矩阵, 可选, 默认为 []以散列获取时指定附加选项的数组 。 阵列的可能值包括: buffer (这一次返回整个文件而不是块)

版本与发布记录

@fleekhq/fleek-storage-js 共发布 28 个版本,首次发布于 2020/06/12;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.0.24latest2023/02/163 年前
1.0.232022/12/293 年前
1.0.222022/07/214 年前
1.0.212022/03/014 年前
1.0.202021/09/175 年前
1.0.192021/09/165 年前

其他发布通道:beta → 1.0.18-beta.3。

关于 @fleekhq/fleek-storage-js 的常见问题

@fleekhq/fleek-storage-js 是什么?

JS SDK 与 Fleek 存储器交互注意:该包已被作者标记为弃用——We’ve upgraded! The deprecated Fleek Storage SDK is now part of our all-new Fleek Platform SDK, which brings enhanced performance, new features, and broader support for all your development needs. Head to https://www.npmjs.com/package/@fleek-platform/sdk to get started, or visit https://fleek.xyz/docs to learn even more.

如何安装 @fleekhq/fleek-storage-js?

在项目目录运行 npm install @fleekhq/fleek-storage-js,或使用 pnpm add / yarn add / bun add。

@fleekhq/fleek-storage-js 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/fleekhq__fleek-storage-js 是否存在。

@fleekhq/fleek-storage-js 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@fleekhq/fleek-storage-js 可以商用吗?

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

@fleekhq/fleek-storage-js 的下载量有多少?

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

@fleekhq/fleek-storage-js 还在维护吗?

最新版本 1.0.24 发布于 2023/02/16(3 年前);至今共发布 28 个版本,其中过去 12 个月发布了 0 个;首次发布于 2020/06/12。作者已将其标记为弃用,新项目建议寻找替代方案。