st-dapp-sdk-js v1.0.7

• Documentation (English)
• 使用说明(中文)

安装起步

npm install st-dapp-sdk-js -S

ES-Module:

import dappSDK from "st-dapp-sdk-js";

dappSDK.gui.showToast({ message: "Hello World!", delay: 1000 });

作为普通资源加载, 使用 node_modules/dappsdk/dist/index.js:

<script type="text/javascript" src="路径"></script>

window.dappSDK.gui.showToast({ message: "Hello World!", delay: 1000 });

不管你使用何种方式引入, window.dappSDK始终存在.

回调与 Promise

首先, SDK 本身并不附带 promise, 如果你需要 promise, 请确保 window.Promise 存在.

所有的 API 均有一个可选的回调函数参数, 如果这个参数不存在, 那调用这个 API 将返回一个 Promise 实例:

window.dappSDK.system.getSdkInfo({}).then(({ version }) => alert(version));

window.dappSDK.system.getSdkInfo({}, function (err, data) {
  if (err) {
    return alert("Error: " + err.message);
  }
  var version = data.version;
  alert(version);
});

错误处理

在使用 callback 风格调用 API 的时候, 注意回调函数永远接收两个参数, 第一个为错误, 第二个为请求结果, 如果存在错误, 大部分情况请求结果会为空, 所以在代码中应使用 错误优先回调 :

window.dappSDK.system.getSdkInfo({}, function (err, data) {
  if (err) {
    var code = error.code;
    console.log(code);
    // 如果错误存在, 那么return可以保证之后的代码不执行
    return alert("Error: " + err.message);
  }
  var version = data.version;
  alert(version);
});

错误

不管使用何种风格处理异步, error 都会包含 3 个变量, error.message, error.code, error.extra. message 是对error的简单描述, code 是 message 的映射, extra 是 message 额外描述, 在大多数情况下, extra 为 undefined.

错误与状态码

API

• Documentation (English)
• 使用说明(中文)