mirai-js 2.8.3 → 2.8.5

package/srcold/core/anno/deleteAnno.js

@@ -0,0 +1,43 @@
+const { errCodeMap } = require('../../util/errCode');
+const axios = require('axios');
+const { URL } = require('../../polyfill/URL');
+const errorHandler = require('../../util/errorHandler');
+const path = require('path');
+const { isBrowserEnv } = require('../../util/isBrowserEnv');
+const locationStr = !isBrowserEnv() ? `core.${path.basename(__filename, path.extname(__filename))}` : 'borwser';
+
+/**
+ * @description 删除群公告
+ * @param {string}  baseUrl    mirai-api-http server 的地址
+ * @param {string}  sessionKey 会话标识
+ * @param {number}  id     群号
+ * @param {string}  fid    公告 id
+ * @returns {Object} { code, msg }
+ */
+module.exports = async ({ baseUrl, sessionKey, id, fid }) => {
+    try {
+        // 拼接 url
+        const url = new URL('/anno/delete', baseUrl).toString();
+
+        // 请求
+        const responseData = await axios.post(url, {
+            sessionKey, id, fid,
+        });
+        try {
+            var {
+                data: { msg: message, code }
+            } = responseData;
+        } catch (error) {
+            throw new Error(('请求返回格式出错，请检查 mirai-console'));
+        }
+        // 抛出 mirai 的异常，到 catch 中处理后再抛出
+        if (code in errCodeMap) {
+            throw new Error(message);
+        }
+        return { message, code };
+    } catch (error) {
+        console.error(`mirai-js: error ${locationStr}`);
+        errorHandler(error);
+    }
+
+};

package/srcold/core/anno/getAnno.js

@@ -0,0 +1,44 @@
+const { errCodeMap } = require('../../util/errCode');
+const axios = require('axios').default;
+const { URL } = require('../../polyfill/URL');
+const errorHandler = require('../../util/errorHandler');
+const path = require('path');
+const { isBrowserEnv } = require('../../util/isBrowserEnv');
+const locationStr = !isBrowserEnv() ? `core.${path.basename(__filename, path.extname(__filename))}` : 'borwser';
+
+/**
+ * @description 获取群公告 
+ * @param {string}  baseUrl    mirai-api-http server 的地址
+ * @param {string}  sessionKey 会话标识
+ * @param {number}  id         群号
+ * @param {number}  offset     分页
+ * @param {number}  size       分页, 默认 10
+ * @returns {Object[]}
+ */
+module.exports = async ({ baseUrl, sessionKey, id, offset, size = 10 }) => {
+    try {
+        // 拼接 url
+        const url = new URL('/anno/list', baseUrl).toString();
+
+        // 请求
+        const responseData = await axios.get(url, {
+            params: {
+                sessionKey, id, offset, size,
+            }
+        });
+        try {
+            var { data: { msg: message, code, data } } = responseData;
+        } catch (error) {
+            throw new Error(('请求返回格式出错，请检查 mirai-console'));
+        }
+
+        // 抛出 mirai 的异常，到 catch 中处理后再抛出
+        if (code in errCodeMap) {
+            throw new Error(message);
+        }
+        return data;
+    } catch (error) {
+        console.error(`mirai-js: error ${locationStr}`);
+        errorHandler(error);
+    }
+};

package/srcold/core/anno/publishAnno.js

@@ -0,0 +1,44 @@
+const { errCodeMap } = require('../../util/errCode');
+const axios = require('axios');
+const { URL } = require('../../polyfill/URL');
+const errorHandler = require('../../util/errorHandler');
+const path = require('path');
+const { isBrowserEnv } = require('../../util/isBrowserEnv');
+const locationStr = !isBrowserEnv() ? `core.${path.basename(__filename, path.extname(__filename))}` : 'borwser';
+
+/**
+ * @description 发布群公告
+ * @param {string}  baseUrl    mirai-api-http server 的地址
+ * @param {string}  sessionKey 会话标识
+ * @param {number}  target     群号
+ * @param {string}  content    公告内容
+ * @param {boolean} pinned     是否置顶
+ * @returns {Object} { code, msg }
+ */
+module.exports = async ({ baseUrl, sessionKey, target, content, pinned }) => {
+    try {
+        // 拼接 url
+        const url = new URL('/anno/publish', baseUrl).toString();
+
+        // 请求
+        const responseData = await axios.post(url, {
+            sessionKey, target, content, pinned
+        });
+        try {
+            var {
+                data: { msg: message, code }
+            } = responseData;
+        } catch (error) {
+            throw new Error(('请求返回格式出错，请检查 mirai-console'));
+        }
+        // 抛出 mirai 的异常，到 catch 中处理后再抛出
+        if (code in errCodeMap) {
+            throw new Error(message);
+        }
+        return { message, code };
+    } catch (error) {
+        console.error(`mirai-js: error ${locationStr}`);
+        errorHandler(error);
+    }
+
+};

package/srcold/core/auth.js

@@ -0,0 +1,40 @@
+const { errCodeMap } = require('../util/errCode');
+const axios = require('axios');
+const { URL } = require('../polyfill/URL');
+const errorHandler = require('../util/errorHandler');
+const path = require('path');
+const { isBrowserEnv } = require('../util/isBrowserEnv');
+const locationStr = !isBrowserEnv() ? `core.${path.basename(__filename, path.extname(__filename))}` : 'borwser';
+
+/**
+ *
+ * @description 认证 verifyKey，创建回话，返回一个 sessionKey
+ * @param {string} baseUrl mirai-api-http server 的地址
+ * @param {string} verifyKey mirai-api-http server 设置的 verifyKey
+ * @returns {string} 会话标识 sessionKey
+ */
+module.exports = async ({ baseUrl, verifyKey }) => {
+    try {
+        // 拼接 url
+        const url = new URL('/verify', baseUrl).toString();
+
+        // 请求
+        const responseData = await axios.post(url, { verifyKey });
+        try {
+            var {
+                data: { msg: message, code, session: sessionKey },
+            } = responseData;
+        } catch (error) {
+            throw new Error(('请求返回格式出错，请检查 mirai-console'));
+        }
+
+        // 抛出 mirai 的异常，到 catch 中处理后再抛出
+        if (code in errCodeMap) {
+            throw new Error(message);
+        }
+        return sessionKey;
+    } catch (error) {
+        console.error(`mirai-js: error ${locationStr}`);
+        errorHandler(error);
+    }
+};

package/srcold/core/fs/deleteGroupFile.js

@@ -0,0 +1,45 @@
+const { errCodeMap } = require('../../util/errCode');
+const axios = require('axios');
+const { URL } = require('../../polyfill/URL');
+const errorHandler = require('../../util/errorHandler');
+const path = require('path');
+const { isBrowserEnv } = require('../../util/isBrowserEnv');
+const locationStr = !isBrowserEnv() ? `core.${path.basename(__filename, path.extname(__filename))}` : 'borwser';
+
+/**
+ * @description 删除群文件
+ * @param {string}  baseUrl          mirai-api-http server 的地址
+ * @param {string}  sessionKey       会话标识
+ * @param {string}  id               文件夹id, 空串为根目录
+ * @param {string}  path             文件夹路径, 文件夹允许重名, 不保证准确, 准确定位使用 id
+ * @param {number}  group            群号
+ * @returns {Object} 结构 { message, code }
+ */
+module.exports = async ({ baseUrl, sessionKey, id, path, group }) => {
+    try {
+        // 拼接 url
+        const url = new URL('/file/delete', baseUrl).toString();
+
+        // 请求
+        const responseData = await axios.post(url, {
+            sessionKey, id, path, target: group, group,
+        });
+
+        try {
+            var {
+                data: { msg: message, code }
+            } = responseData;
+        } catch (error) {
+            throw new Error(('请求返回格式出错，请检查 mirai-console'));
+        }
+        // 抛出 mirai 的异常，到 catch 中处理后再抛出
+        if (code in errCodeMap) {
+            throw new Error(message);
+        }
+        return { message, code };
+    } catch (error) {
+        console.error(`mirai-js: error ${locationStr}`);
+        errorHandler(error);
+    }
+
+};

package/srcold/core/fs/getGroupFileInfo.js

@@ -0,0 +1,46 @@
+const { errCodeMap } = require('../../util/errCode');
+const axios = require('axios').default;
+const { URL } = require('../../polyfill/URL');
+const errorHandler = require('../../util/errorHandler');
+const path = require('path');
+const { isBrowserEnv } = require('../../util/isBrowserEnv');
+const locationStr = !isBrowserEnv() ? `core.${path.basename(__filename, path.extname(__filename))}` : 'borwser';
+
+/**
+ * @description 获取群文件详细信息
+ * @param {string}  baseUrl          mirai-api-http server 的地址
+ * @param {string}  sessionKey       会话标识
+ * @param {string}  id               文件夹id, 空串为根目录
+ * @param {string}  path             文件夹路径, 文件夹允许重名, 不保证准确, 准确定位使用 id
+ * @param {number}  group            群号
+ * @param {boolean} withDownloadInfo 是否携带下载信息，额外请求，无必要不要携带
+ * @returns {Object}   
+ * 结构 { id, name, path, parent, contact, isFile, isDirectory, downloadInfo }
+ */
+module.exports = async ({ baseUrl, sessionKey, id, path, group/*, qq 字段保留 */, withDownloadInfo }) => {
+    try {
+        // 拼接 url
+        const url = new URL('/file/info', baseUrl).toString();
+
+        // 请求
+        const responseData = await axios.get(url, {
+            params: {
+                sessionKey, id, path, target: group, group, withDownloadInfo
+            }
+        });
+        try {
+            var { data: { msg: message, code, data } } = responseData;
+        } catch (error) {
+            throw new Error(('请求返回格式出错，请检查 mirai-console'));
+        }
+
+        // 抛出 mirai 的异常，到 catch 中处理后再抛出
+        if (code in errCodeMap) {
+            throw new Error(message);
+        }
+        return data;
+    } catch (error) {
+        console.error(`mirai-js: error ${locationStr}`);
+        errorHandler(error);
+    }
+};

package/srcold/core/fs/getGroupFileList.js

@@ -0,0 +1,47 @@
+const { errCodeMap } = require('../../util/errCode');
+const axios = require('axios').default;
+const { URL } = require('../../polyfill/URL');
+const errorHandler = require('../../util/errorHandler');
+const path = require('path');
+const { isBrowserEnv } = require('../../util/isBrowserEnv');
+const locationStr = !isBrowserEnv() ? `core.${path.basename(__filename, path.extname(__filename))}` : 'borwser';
+
+/**
+ * @description 获取群文件列表
+ * @param {string}  baseUrl          mirai-api-http server 的地址
+ * @param {string}  sessionKey       会话标识
+ * @param {string}  id               文件夹id, 空串为根目录
+ * @param {string}  path             文件夹路径, 文件夹允许重名, 不保证准确, 准确定位使用 id
+ * @param {number}  group            群号
+ * @param {boolern} withDownloadInfo 是否携带下载信息，额外请求，无必要不要携带
+ * @param {number}  offset	         分页偏移
+ * @param {number}  size	         分页大小
+ * @returns {Object[]}   结构 array[...{ id, name, path, parent, contact, isFile, isDirectory, downloadInfo }]
+ */
+module.exports = async ({ baseUrl, sessionKey, id, path, group/*, qq 字段保留 */, withDownloadInfo, offset, size }) => {
+    try {
+        // 拼接 url
+        const url = new URL('/file/list', baseUrl).toString();
+
+        // 请求
+        const responseData = await axios.get(url, {
+            params: {
+                sessionKey, id, path, target: group, group, withDownloadInfo, offset, size
+            }
+        });
+        try {
+            var { data: { msg: message, code, data } } = responseData;
+        } catch (error) {
+            throw new Error(('请求返回格式出错，请检查 mirai-console'));
+        }
+
+        // 抛出 mirai 的异常，到 catch 中处理后再抛出
+        if (code in errCodeMap) {
+            throw new Error(message);
+        }
+        return data;
+    } catch (error) {
+        console.error(`mirai-js: error ${locationStr}`);
+        errorHandler(error);
+    }
+};

package/srcold/core/fs/makeGroupDir.js

@@ -0,0 +1,45 @@
+const { errCodeMap } = require('../../util/errCode');
+const axios = require('axios');
+const { URL } = require('../../polyfill/URL');
+const errorHandler = require('../../util/errorHandler');
+const path = require('path');
+const { isBrowserEnv } = require('../../util/isBrowserEnv');
+const locationStr = !isBrowserEnv() ? `core.${path.basename(__filename, path.extname(__filename))}` : 'borwser';
+
+/**
+ * @description 新建群文件夹
+ * @param {string}  baseUrl          mirai-api-http server 的地址
+ * @param {string}  sessionKey       会话标识
+ * @param {string}  id               文件夹id, 空串为根目录
+ * @param {string}  path             文件夹路径, 文件夹允许重名, 不保证准确, 准确定位使用 id
+ * @param {number}  group            群号
+ * @param {boolern} withDownloadInfo 是否携带下载信息，额外请求，无必要不要携带
+ * @returns {Object} 结构 { id, name, path, parent, contact, isFile, isDirectory, downloadInfo }
+ */
+module.exports = async ({ baseUrl, sessionKey, id, rename, path, group, withDownloadInfo }) => {
+    try {
+        // 拼接 url
+        const url = new URL('/file/mkdir', baseUrl).toString();
+
+        // 请求
+        const responseData = await axios.post(url, {
+            sessionKey, id, rename, path, group, withDownloadInfo
+        });
+
+        try {
+            var {
+                data: { msg: message, code, data }
+            } = responseData;
+        } catch (error) {
+            throw new Error(('请求返回格式出错，请检查 mirai-console'));
+        }
+        // 抛出 mirai 的异常，到 catch 中处理后再抛出
+        if (code in errCodeMap) {
+            throw new Error(message);
+        }
+        return data;
+    } catch (error) {
+        console.error(`mirai-js: error ${locationStr}`);
+        errorHandler(error);
+    }
+};

package/srcold/core/fs/moveGroupFile.js

@@ -0,0 +1,47 @@
+const { errCodeMap } = require('../../util/errCode');
+const axios = require('axios');
+const { URL } = require('../../polyfill/URL');
+const errorHandler = require('../../util/errorHandler');
+const path = require('path');
+const { isBrowserEnv } = require('../../util/isBrowserEnv');
+const locationStr = !isBrowserEnv() ? `core.${path.basename(__filename, path.extname(__filename))}` : 'borwser';
+
+/**
+ * @description 移动群文件
+ * @param {string}  baseUrl    mirai-api-http server 的地址
+ * @param {string}  sessionKey 会话标识
+ * @param {string}  id         文件夹id, 空串为根目录
+ * @param {string}  path       文件夹路径, 文件夹允许重名, 不保证准确, 准确定位使用 id
+ * @param {number}  group      群号
+ * @param {string}  moveTo     移动目标文件夹id
+ * @param {string}  moveToPath 移动目标文件夹path
+ * @returns {Object} 结构 { message, code }
+ */
+module.exports = async ({ baseUrl, sessionKey, id, path, group, moveTo, moveToPath }) => {
+    try {
+        // 拼接 url
+        const url = new URL('/file/move', baseUrl).toString();
+
+        // 请求
+        const responseData = await axios.post(url, {
+            sessionKey, id, path, target: group, group, moveTo, moveToPath
+        });
+
+        try {
+            var {
+                data: { msg: message, code }
+            } = responseData;
+        } catch (error) {
+            throw new Error(('请求返回格式出错，请检查 mirai-console'));
+        }
+        // 抛出 mirai 的异常，到 catch 中处理后再抛出
+        if (code in errCodeMap) {
+            throw new Error(message);
+        }
+        return { message, code };
+    } catch (error) {
+        console.error(`mirai-js: error ${locationStr}`);
+        errorHandler(error);
+    }
+
+};

package/srcold/core/fs/renameGroupFile.js

@@ -0,0 +1,44 @@
+const { errCodeMap } = require('../../util/errCode');
+const axios = require('axios');
+const { URL } = require('../../polyfill/URL');
+const errorHandler = require('../../util/errorHandler');
+const path = require('path');
+const { isBrowserEnv } = require('../../util/isBrowserEnv');
+const locationStr = !isBrowserEnv() ? `core.${path.basename(__filename, path.extname(__filename))}` : 'borwser';
+
+/**
+ * @description 重命名群文件
+ * @param {string} baseUrl    mirai-api-http server 的地址
+ * @param {string} sessionKey 会话标识
+ * @param {number} id         文件 id
+ * @param {number} group      群号
+ * @param {string} rename     重命名
+ * @returns {Object} 结构 { message, code }
+ */
+module.exports = async ({ baseUrl, sessionKey, id, path, group, renameTo }) => {
+    try {
+        // 拼接 url
+        const url = new URL('/file/rename', baseUrl).toString();
+
+        // 请求
+        const responseData = await axios.post(url, {
+            sessionKey, id, path, target: group, group, renameTo
+        });
+
+        try {
+            var {
+                data: { msg: message, code }
+            } = responseData;
+        } catch (error) {
+            throw new Error(('请求返回格式出错，请检查 mirai-console'));
+        }
+        // 抛出 mirai 的异常，到 catch 中处理后再抛出
+        if (code in errCodeMap) {
+            throw new Error(message);
+        }
+        return { message, code };
+    } catch (error) {
+        console.error(`mirai-js: error ${locationStr}`);
+        errorHandler(error);
+    }
+};

package/srcold/core/fs/uploadGroupFIle.js

@@ -0,0 +1,58 @@
+const { errCodeMap } = require('../../util/errCode');
+const axios = require('axios').default;
+const { URL } = require('../../polyfill/URL');
+const errorHandler = require('../../util/errorHandler');
+const path = require('path');
+const { isBrowserEnv } = require('../../util/isBrowserEnv');
+const locationStr = !isBrowserEnv() ? `core.${path.basename(__filename, path.extname(__filename))}` : 'borwser';
+const FormData = require('form-data');
+
+
+/**
+ * @description 上传文件至服务器并发送，返回文件 id
+ * @param {string}  baseUrl    mirai-api-http server 的地址
+ * @param {string}  sessionKey 会话标识
+ * @param {string}  type       "friend" 或 "group"，目前仅支持 group
+ * @param {string}  target     群/好友号
+ * @param {string}  path       上传目录id
+ * @param {Buffer}  file       文件二进制数据
+ * @returns {string} 文件 id
+ */
+module.exports = async ({ baseUrl, sessionKey, type, target, path, file }) => {
+    try {
+        // 拼接 url
+        const targetUrl = new URL('/file/upload', baseUrl).toString();
+
+        // 构造 fromdata
+        const form = new FormData();
+        form.append('sessionKey', sessionKey);
+        form.append('type', type);
+        form.append('target', target);
+        form.append('path', path);
+        form.append('file', file, { filename: 'payload' });
+
+        // 请求
+        const responseData = await axios.post(targetUrl, form, {
+            // formdata.getHeaders 将会指定 content-type，同时给定随
+            // 机生成的 boundary，即分隔符，用以分隔多个表单项而不会造成混乱
+            headers: form.getHeaders(),
+        });
+
+        try {
+            var {
+                data: { msg: message, code, id }
+            } = responseData;
+        } catch (error) {
+            throw new Error(('请求返回格式出错，请检查 mirai-console'));
+        }
+
+        // 抛出 mirai 的异常，到 catch 中处理后再抛出
+        if (code in errCodeMap) {
+            throw new Error(message);
+        }
+        return id;
+    } catch (error) {
+        console.error(`mirai-js: error ${locationStr}`);
+        errorHandler(error);
+    }
+};

package/srcold/core/getFriendList.js

@@ -0,0 +1,37 @@
+const { errCodeMap } = require('../util/errCode');
+const axios = require('axios').default;
+const { URL } = require('../polyfill/URL');
+const errorHandler = require('../util/errorHandler');
+const path = require('path');
+const { isBrowserEnv } = require('../util/isBrowserEnv');
+const locationStr = !isBrowserEnv() ? `core.${path.basename(__filename, path.extname(__filename))}` : 'borwser';
+
+/**
+ * @description 获取好友列表
+ * @param {string}             baseUrl      mirai-api-http server 的地址
+ * @param {string}             sessionKey   会话标识
+ * @returns {Object[]} 结构 array[...{ id, nickname, remark }]
+ */
+module.exports = async ({ baseUrl, sessionKey }) => {
+    try {
+        // 拼接 url
+        const url = new URL('/friendList', baseUrl).toString();
+
+        // 请求
+        const responseData = await axios.get(url, { params: { sessionKey } });
+        try {
+            var { data: { msg: message, code, data } } = responseData;
+        } catch (error) {
+            throw new Error(('请求返回格式出错，请检查 mirai-console'));
+        }
+
+        // 抛出 mirai 的异常，到 catch 中处理后再抛出
+        if (code in errCodeMap) {
+            throw new Error(message);
+        }
+        return data;
+    } catch (error) {
+        console.error(`mirai-js: error ${locationStr}`);
+        errorHandler(error);
+    }
+};

package/srcold/core/getGroupConfig.js

@@ -0,0 +1,37 @@
+const { errCodeMap } = require('../util/errCode');
+const axios = require('axios').default;
+const { URL } = require('../polyfill/URL');
+const errorHandler = require('../util/errorHandler');
+const path = require('path');
+const { isBrowserEnv } = require('../util/isBrowserEnv');
+const locationStr = !isBrowserEnv() ? `core.${path.basename(__filename, path.extname(__filename))}` : 'borwser';
+
+/**
+ * @description 获取群配置
+ * @param {string} baseUrl    mirai-api-http server 的地址
+ * @param {string} sessionKey 会话标识
+ * @param {string} target     群号
+ * @returns {Object} 
+ */
+module.exports = async ({ baseUrl, sessionKey, target }) => {
+    try {
+        // 拼接 url
+        const url = new URL('/groupConfig', baseUrl).toString();
+
+        // 请求
+        const responseData = await axios.get(url, { params: { sessionKey, target } });
+        try {
+            var { data, data: { msg: message, code } } = responseData;
+        } catch (error) {
+            throw new Error(('请求返回格式出错，请检查 mirai-console'));
+        }
+        // 抛出 mirai 的异常，到 catch 中处理后再抛出
+        if (code in errCodeMap) {
+            throw new Error(message);
+        }
+        return data;
+    } catch (error) {
+        console.error(`mirai-js: error ${locationStr}`);
+        errorHandler(error);
+    }
+};

package/srcold/core/getGroupList.js

@@ -0,0 +1,37 @@
+const { errCodeMap } = require('../util/errCode');
+const axios = require('axios').default;
+const { URL } = require('../polyfill/URL');
+const errorHandler = require('../util/errorHandler');
+const path = require('path');
+const { isBrowserEnv } = require('../util/isBrowserEnv');
+const locationStr = !isBrowserEnv() ? `core.${path.basename(__filename, path.extname(__filename))}` : 'borwser';
+
+/**
+ * @description 获取群列表
+ * @param {string} baseUrl    mirai-api-http server 的地址
+ * @param {string} sessionKey 会话标识
+ * @returns {Object[]} 结构 array[...{ id, name, permission }]
+ */
+module.exports = async ({ baseUrl, sessionKey }) => {
+    try {
+        // 拼接 url
+        const url = new URL('/groupList', baseUrl).toString();
+
+        // 请求
+        const responseData = await axios.get(url, { params: { sessionKey } });
+        try {
+            var { data, data: { msg: message, code } } = responseData;
+        } catch (error) {
+            throw new Error(('请求返回格式出错，请检查 mirai-console'));
+        }
+
+        // 抛出 mirai 的异常，到 catch 中处理后再抛出
+        if (code in errCodeMap) {
+            throw new Error(message);
+        }
+        return data;
+    } catch (error) {
+        console.error(`mirai-js: error ${locationStr}`);
+        errorHandler(error);
+    }
+};

package/srcold/core/getMemberInfo.js

@@ -0,0 +1,41 @@
+const { errCodeMap } = require('../util/errCode');
+const axios = require('axios');
+const { URL } = require('../polyfill/URL');
+const errorHandler = require('../util/errorHandler');
+const path = require('path');
+const { isBrowserEnv } = require('../util/isBrowserEnv');
+const locationStr = !isBrowserEnv() ? `core.${path.basename(__filename, path.extname(__filename))}` : 'borwser';
+
+/**
+ * @description 获取群成员信息
+ * @param {string} baseUrl    mirai-api-http server 的地址
+ * @param {string} sessionKey 会话标识
+ * @param {number} target     群成员所在群号
+ * @param {number} memberId   群成员的 qq 号
+ * @returns {Object}
+ */
+module.exports = async ({ baseUrl, sessionKey, target, memberId }) => {
+    try {
+        // 拼接 url
+        const url = new URL('/memberInfo', baseUrl).toString();
+
+        // 请求
+        const responseData = await axios.get(url, { params: { sessionKey, target, memberId } });
+        try {
+            var {
+                data, data: { msg: message, code }
+            } = responseData;
+        } catch (error) {
+            throw new Error(('请求返回格式出错，请检查 mirai-console'));
+        }
+        // 抛出 mirai 的异常，到 catch 中处理后再抛出
+        if (code in errCodeMap) {
+            throw new Error(message);
+        }
+        return data;
+    } catch (error) {
+        console.error(`mirai-js: error ${locationStr}`);
+        errorHandler(error);
+    }
+
+};