# cos-nodejs-sdk-v5

> cos nodejs sdk v5

Latest version **3.0.0** (published 2026-07-10) · ISC license · 0 weekly downloads

## Install

```sh
npm install cos-nodejs-sdk-v5
pnpm add cos-nodejs-sdk-v5
yarn add cos-nodejs-sdk-v5
bun add cos-nodejs-sdk-v5
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 3.0.0 |
| Published | 2026-07-10 |
| First published | 2017-04-24 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >= 9 |
| Dependencies | 3 |
| Unpacked size | 418.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 239 |
| Author | carsonxu |
| Maintainers | galenyip, yinshawnrao, carsonxu, tianfeng, wonderswang, annexwu |
| Keywords | tencent, tencent cloud, qcloud, cos, cos-sdk |

## Links

- npm: https://www.npmjs.com/package/cos-nodejs-sdk-v5
- Repository: https://github.com/tencentyun/cos-nodejs-sdk-v5
- Homepage: https://github.com/tencentyun/cos-nodejs-sdk-v5#readme
- Issues: https://github.com/tencentyun/cos-nodejs-sdk-v5/issues
- npm.io page: https://npm.io/package/cos-nodejs-sdk-v5

## Dependencies (3)

- [mime-types](https://npm.io/package/mime-types.md) ^2.1.35
- [cos-request](https://npm.io/package/cos-request.md) ^1.3.0
- [cos-fast-xml-parser](https://npm.io/package/cos-fast-xml-parser.md) ^1.0.0

## Recent versions

- 3.0.0 (latest) — 2026-07-10
- 2.16.0-beta.9 (beta) — 2026-06-22
- 2.16.0-beta.8 — 2025-08-06
- 2.16.0-beta.7 — 2025-08-06
- 2.15.4 — 2025-08-06
- 2.16.0-beta.6 — 2025-08-05
- 2.15.3 — 2025-08-05
- 2.16.0-beta.4 — 2025-06-12
- 2.16.0-beta.3 — 2025-06-03
- 2.15.1 — 2025-05-27
- 2.16.0-beta.2 — 2025-05-27
- 2.15.0 — 2025-05-27
- 2.16.0-beta.0 — 2025-04-24
- 2.14.7 — 2025-03-21
- 2.14.6 — 2024-08-23
- … 166 more at https://npm.io/package/cos-nodejs-sdk-v5/versions

## README

# cos-nodejs-sdk-v5

腾讯云 COS Nodejs SDK（[XML API](https://cloud.tencent.com/document/product/436/7751)）

[releases and changelog](https://github.com/tencentyun/cos-nodejs-sdk-v5/releases)

## install

> 环境要求：Node.js >= 9.0.0（自 v3.0.0 起，不再支持 Node 6 / 7 / 8）

[npm 地址](https://www.npmjs.com/package/cos-nodejs-sdk-v5)

```
npm i cos-nodejs-sdk-v5 --save
```

## demo

```javascript
// 引入模块
var COS = require('cos-nodejs-sdk-v5');
// 创建实例
var cos = new COS({
  SecretId: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
  SecretKey: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
});

// 存储桶名称，由bucketname-appid 组成，appid必须填入，可以在COS控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucket
var Bucket = 'test-1250000000';
// 存储桶Region可以在COS控制台指定存储桶的概览页查看 https://console.cloud.tencent.com/cos5/bucket/
// 关于地域的详情见 https://cloud.tencent.com/document/product/436/6224
var Region = 'ap-guangzhou';

// 高级上传
cos.uploadFile(
  {
    Bucket: Bucket,
    Region: Region,
    Key: '1.zip',
    FilePath: './1.zip', // 本地文件地址，需自行替换
    SliceSize: 1024 * 1024 * 5, // 触发分块上传的阈值，超过5MB使用分块上传，非必须
  },
  function (err, data) {
    console.log(err, data);
  }
);
```

## 说明文档

[使用例子](demo/demo.js)

[快速入门](https://cloud.tencent.com/document/product/436/8629)

[接口文档](https://cloud.tencent.com/document/product/436/12264)

---
_Source: https://npm.io/package/cos-nodejs-sdk-v5 · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._