安装SDK
更新时间:2023-10-26
环境差异
您可以在Node.js环境和浏览器环境中使用JavaScript SDK,但受限于浏览器环境本身的功能限制和安全性限制,在浏览器环境中,SDK的一些功能将无法使用。具体有如下几种情况:
- 本地文件读写:浏览器中无法直接操作本地文件,所以BOS服务的PutObjectFromFile和GetObject等相关API将无法使用。类似的,Node.js环境也没有Blob对象,所以BOS服务的PutObjectFromBlob是专门为浏览器环境而开发的。
- Bucket相关操作:由于浏览器跨域访问的限制,需要在服务端设置相应的CORS配置才能进行跨域访问。百度智能云已支持对特定Bucket内的对象进行CORS配置,但不支持对Bucket级别API的跨域访问,所以ListBuckets等API在浏览器端无法使用,Bucket级别的API请参考Bucket。
Node.js环境
支持的Node.js版本
- Node 4.x 以及更高版本
安装步骤
-
JavaScript包已经上传npm管理器,直接使用npm安装SDK的开发包:
npm install @baiducloud/sdk
-
然后在你的程序中使用:
JavaScript1var sdk = require('@baiducloud/sdk'); 2var BosClient = sdk.BosClient; 3 4const config = { 5 endpoint: <EndPoint>, //传入Bucket所在区域域名 6 credentials: { 7 ak: <AccessKeyID>, //您的AccessKey 8 sk: <SecretAccessKey> //您的SecretAccessKey 9 } 10}; 11 12let bucket = 'my-bucket'; 13let key = 'hello.js'; 14let client = new BosClient(config); 15 16client.putObjectFromFile(bucket, key, __filename) 17 .then(response => console.log(response)) // 成功 18 .catch(error => console.error(error)); // 失败
接口会返回一个promise对象。
浏览器环境
支持的浏览器版本
浏览器类型 | 最低版本 |
---|---|
Google Chrome | 28.0+ |
Microsoft Internet Explorer | 10.0 |
Mozilla Firefox | 23.0+ |
Apple Safari | 5.1+ |
Opera | 17.0+ |
Android Browser | 4.3+ |
安装步骤
-
推荐使用 npm 来安装:
npm install @baiducloud/sdk
或者通过CDN的方式直接引用
Plain Text1<script src="https://bce.bdstatic.com/lib/@baiducloud/sdk/1.0.0-rc.40/baidubce-sdk.bundle.min.js"></script>
-
如果通过 npm 来安装,需要使用
<script>
来加载baidubce-sdk.bundle.min.js
到页面:Plain Text1<script src="node_modules/@baiducloud/sdk/dist/baidubce-sdk.bundle.min.js"></script>
当 js 加载到页面之后,可以用过全局变量
baidubce.sdk
来使用 sdk 的功能。 -
然后在你的程序中使用:
JavaScript1const config = { 2 endpoint: <EndPoint>, //传入Bucket所在区域域名 3 credentials: { 4 ak: <AccessKeyID>, //您的AccessKey 5 sk: <SecretAccessKey> //您的SecretAccessKey 6 } 7}; 8 9let bucket = 'my-bucket'; 10let key = 'hello.js'; 11let client = new baidubce.sdk.BosClient(config); 12 13client.putObjectFromString(bucket, key, 'hello world') 14 .then(response => console.log(response)) // 成功 15 .catch(error => console.error(error)); // 失败