@tarojs/taro-h5 3.4.0-beta.0 → 3.4.0

package/dist/api/media/audio/index.js

@@ -0,0 +1,88 @@
+import Taro from '@tarojs/api';
+import { temporarilyNotSupport } from '../../utils';
+import { CallbackManager } from '../../utils/handler';
+// 音频
+class InnerAudioContext {
+    constructor() {
+        this.play = () => { var _a; return (_a = this.Instance) === null || _a === void 0 ? void 0 : _a.play(); };
+        this.pause = () => { var _a; return (_a = this.Instance) === null || _a === void 0 ? void 0 : _a.pause(); };
+        this.stop = () => {
+            this.pause();
+            this.seek(0);
+            this.stopStack.trigger();
+        };
+        this.seek = (position) => {
+            if (this.Instance) {
+                this.Instance.currentTime = position;
+            }
+        };
+        /**
+         * @TODO destroy得并不干净
+         */
+        this.destroy = () => {
+            this.stop();
+            if (this.Instance) {
+                document.body.removeChild(this.Instance);
+                this.Instance = undefined;
+            }
+        };
+        this.onCanplay = (callback = () => { }) => { var _a; return (_a = this.Instance) === null || _a === void 0 ? void 0 : _a.addEventListener('canplay', callback); };
+        this.onPlay = (callback = () => { }) => { var _a; return (_a = this.Instance) === null || _a === void 0 ? void 0 : _a.addEventListener('play', callback); };
+        this.onPause = (callback = () => { }) => { var _a; return (_a = this.Instance) === null || _a === void 0 ? void 0 : _a.addEventListener('pause', callback); };
+        this.onStop = (callback = () => { }) => this.stopStack.add(callback);
+        this.onEnded = (callback = () => { }) => { var _a; return (_a = this.Instance) === null || _a === void 0 ? void 0 : _a.addEventListener('ended', callback); };
+        this.onTimeUpdate = (callback = () => { }) => { var _a; return (_a = this.Instance) === null || _a === void 0 ? void 0 : _a.addEventListener('timeupdate', callback); };
+        this.onError = (callback) => this.errorStack.add(callback);
+        this.onWaiting = (callback = () => { }) => { var _a; return (_a = this.Instance) === null || _a === void 0 ? void 0 : _a.addEventListener('waiting', callback); };
+        this.onSeeking = (callback = () => { }) => { var _a; return (_a = this.Instance) === null || _a === void 0 ? void 0 : _a.addEventListener('seeking', callback); };
+        this.onSeeked = (callback = () => { }) => { var _a; return (_a = this.Instance) === null || _a === void 0 ? void 0 : _a.addEventListener('seeked', callback); };
+        this.offCanplay = (callback = () => { }) => { var _a; return (_a = this.Instance) === null || _a === void 0 ? void 0 : _a.removeEventListener('canplay', callback); };
+        this.offPlay = (callback = () => { }) => { var _a; return (_a = this.Instance) === null || _a === void 0 ? void 0 : _a.removeEventListener('play', callback); };
+        this.offPause = (callback = () => { }) => { var _a; return (_a = this.Instance) === null || _a === void 0 ? void 0 : _a.removeEventListener('pause', callback); };
+        this.offStop = (callback = () => { }) => this.stopStack.remove(callback);
+        this.offEnded = (callback = () => { }) => { var _a; return (_a = this.Instance) === null || _a === void 0 ? void 0 : _a.removeEventListener('ended', callback); };
+        this.offTimeUpdate = (callback = () => { }) => { var _a; return (_a = this.Instance) === null || _a === void 0 ? void 0 : _a.removeEventListener('timeupdate', callback); };
+        this.offError = (callback = () => { }) => this.errorStack.remove(callback);
+        this.offWaiting = (callback = () => { }) => { var _a; return (_a = this.Instance) === null || _a === void 0 ? void 0 : _a.removeEventListener('waiting', callback); };
+        this.offSeeking = (callback = () => { }) => { var _a; return (_a = this.Instance) === null || _a === void 0 ? void 0 : _a.removeEventListener('seeking', callback); };
+        this.offSeeked = (callback = () => { }) => { var _a; return (_a = this.Instance) === null || _a === void 0 ? void 0 : _a.removeEventListener('seeked', callback); };
+        this.Instance = new Audio();
+        this.errorStack = new CallbackManager();
+        this.stopStack = new CallbackManager();
+        Taro.eventCenter.on('__taroRouterChange', () => { this.stop(); });
+    }
+    set autoplay(e) { this.setProperty('autoplay', e); }
+    get autoplay() { var _a; return ((_a = this.Instance) === null || _a === void 0 ? void 0 : _a.autoplay) || false; }
+    get buffered() { var _a; return ((_a = this.Instance) === null || _a === void 0 ? void 0 : _a.buffered.length) || 0; }
+    get currentTime() { var _a; return ((_a = this.Instance) === null || _a === void 0 ? void 0 : _a.currentTime) || 0; }
+    get duration() { var _a; return ((_a = this.Instance) === null || _a === void 0 ? void 0 : _a.duration) || 0; }
+    set loop(e) { this.setProperty('loop', e); }
+    get loop() { var _a; return ((_a = this.Instance) === null || _a === void 0 ? void 0 : _a.loop) || false; }
+    get paused() { var _a; return ((_a = this.Instance) === null || _a === void 0 ? void 0 : _a.paused) || true; }
+    set src(e) { this.setProperty('src', e); }
+    get src() { var _a; return ((_a = this.Instance) === null || _a === void 0 ? void 0 : _a.src) || ''; }
+    set volume(e) { this.setProperty('volume', e); }
+    get volume() { var _a; return ((_a = this.Instance) === null || _a === void 0 ? void 0 : _a.volume) || 0; }
+    set playbackRate(e) { this.setProperty('playbackRate', e); }
+    get playbackRate() { var _a; return ((_a = this.Instance) === null || _a === void 0 ? void 0 : _a.volume) || 0; }
+    get obeyMuteSwitch() { return true; }
+    set startTime(e) { this.setProperty('startTime', e); }
+    get startTime() { var _a; return ((_a = this.Instance) === null || _a === void 0 ? void 0 : _a.volume) || 0; }
+    setProperty(key, value) {
+        if (this.Instance) {
+            this.Instance[key] = value;
+        }
+    }
+}
+export const stopVoice = temporarilyNotSupport('stopVoice');
+export const setInnerAudioOption = temporarilyNotSupport('setInnerAudioOption');
+export const playVoice = temporarilyNotSupport('playVoice');
+export const pauseVoice = temporarilyNotSupport('pauseVoice');
+export const getAvailableAudioSources = temporarilyNotSupport('getAvailableAudioSources');
+export const createWebAudioContext = temporarilyNotSupport('createWebAudioContext');
+export const createMediaAudioPlayer = temporarilyNotSupport('createMediaAudioPlayer');
+/**
+ * 创建内部 audio 上下文 InnerAudioContext 对象。
+ */
+export const createInnerAudioContext = () => new InnerAudioContext();
+export const createAudioContext = temporarilyNotSupport('createAudioContext');

package/dist/api/media/background-audio.js

@@ -0,0 +1,11 @@
+import { temporarilyNotSupport } from '../utils';
+// 背景音频
+export const stopBackgroundAudio = temporarilyNotSupport('stopBackgroundAudio');
+export const seekBackgroundAudio = temporarilyNotSupport('seekBackgroundAudio');
+export const playBackgroundAudio = temporarilyNotSupport('playBackgroundAudio');
+export const pauseBackgroundAudio = temporarilyNotSupport('pauseBackgroundAudio');
+export const onBackgroundAudioStop = temporarilyNotSupport('onBackgroundAudioStop');
+export const onBackgroundAudioPlay = temporarilyNotSupport('onBackgroundAudioPlay');
+export const onBackgroundAudioPause = temporarilyNotSupport('onBackgroundAudioPause');
+export const getBackgroundAudioPlayerState = temporarilyNotSupport('getBackgroundAudioPlayerState');
+export const getBackgroundAudioManager = temporarilyNotSupport('getBackgroundAudioManager');

package/dist/api/media/camera.js

@@ -0,0 +1,3 @@
+import { temporarilyNotSupport } from '../utils';
+// 相机
+export const createCameraContext = temporarilyNotSupport('createCameraContext');

package/dist/api/media/editor.js

@@ -0,0 +1,18 @@
+import { temporarilyNotSupport } from '../utils';
+// 富文本
+export class EditorContext {
+    constructor() {
+        this.blur = temporarilyNotSupport('EditorContext.blur');
+        this.clear = temporarilyNotSupport('EditorContext.clear');
+        this.format = temporarilyNotSupport('EditorContext.format');
+        this.getContents = temporarilyNotSupport('EditorContext.getContents');
+        this.insertDivider = temporarilyNotSupport('EditorContext.insertDivider');
+        this.insertImage = temporarilyNotSupport('EditorContext.insertImage');
+        this.insertText = temporarilyNotSupport('EditorContext.insertText');
+        this.redo = temporarilyNotSupport('EditorContext.redo');
+        this.removeFormat = temporarilyNotSupport('EditorContext.removeFormat');
+        this.scrollIntoView = temporarilyNotSupport('EditorContext.scrollIntoView');
+        this.setContents = temporarilyNotSupport('EditorContext.setContents');
+        this.undo = temporarilyNotSupport('EditorContext.undo');
+    }
+}

package/dist/api/media/image/chooseImage.js

@@ -0,0 +1,74 @@
+import { MethodHandler } from '../../utils/handler';
+import { shouldBeObject, getParameterError } from '../../utils';
+/**
+ * 从本地相册选择图片或使用相机拍照。
+ */
+export const chooseImage = function (options) {
+    // options must be an Object
+    const isObject = shouldBeObject(options);
+    if (!isObject.flag) {
+        const res = { errMsg: `chooseImage:fail ${isObject.msg}` };
+        console.error(res.errMsg);
+        return Promise.reject(res);
+    }
+    const { count = 1, success, fail, complete, imageId = 'taroChooseImage' } = options;
+    const handle = new MethodHandler({ name: 'chooseImage', success, fail, complete });
+    const res = {
+        tempFilePaths: [],
+        tempFiles: []
+    };
+    if (count && typeof count !== 'number') {
+        res.errMsg = getParameterError({
+            para: 'count',
+            correct: 'Number',
+            wrong: count
+        });
+        return handle.fail(res);
+    }
+    let el = document.getElementById(imageId);
+    if (!el) {
+        const obj = document.createElement('input');
+        obj.setAttribute('type', 'file');
+        obj.setAttribute('id', imageId);
+        if (count > 1) {
+            obj.setAttribute('multiple', 'multiple');
+        }
+        obj.setAttribute('accept', 'image/*');
+        obj.setAttribute('style', 'position: fixed; top: -4000px; left: -3000px; z-index: -300;');
+        document.body.appendChild(obj);
+        el = document.getElementById(imageId);
+    }
+    else {
+        if (count > 1) {
+            el.setAttribute('multiple', 'multiple');
+        }
+        else {
+            el.removeAttribute('multiple');
+        }
+    }
+    return new Promise(resolve => {
+        const TaroMouseEvents = document.createEvent('MouseEvents');
+        TaroMouseEvents.initEvent('click', true, true);
+        if (el) {
+            el.dispatchEvent(TaroMouseEvents);
+            el.onchange = function (e) {
+                const target = e.target;
+                if (target) {
+                    const files = target.files || [];
+                    const arr = [...files];
+                    arr && arr.forEach(item => {
+                        var _a, _b;
+                        const blob = new Blob([item], {
+                            type: item.type
+                        });
+                        const url = URL.createObjectURL(blob);
+                        (_a = res.tempFilePaths) === null || _a === void 0 ? void 0 : _a.push(url);
+                        (_b = res.tempFiles) === null || _b === void 0 ? void 0 : _b.push({ path: url, size: item.size, type: item.type, originalFileObj: item });
+                    });
+                    handle.success(res, resolve);
+                    target.value = '';
+                }
+            };
+        }
+    });
+};

package/dist/api/media/image/getImageInfo.js

@@ -0,0 +1,31 @@
+import { shouldBeObject } from '../../utils';
+import { MethodHandler } from '../../utils/handler';
+/**
+ * 获取图片信息。网络图片需先配置download域名才能生效。
+ */
+export const getImageInfo = (options) => {
+    // options must be an Object
+    const isObject = shouldBeObject(options);
+    if (!isObject.flag) {
+        const res = { errMsg: `getImageInfo:fail ${isObject.msg}` };
+        console.error(res.errMsg);
+        return Promise.reject(res);
+    }
+    const { src, success, fail, complete } = options;
+    const handle = new MethodHandler({ name: 'getImageInfo', success, fail, complete });
+    return new Promise((resolve, reject) => {
+        const image = new Image();
+        image.onload = () => {
+            handle.success({
+                width: image.naturalWidth,
+                height: image.naturalHeight
+            }, resolve);
+        };
+        image.onerror = (e) => {
+            handle.fail({
+                errMsg: e.message
+            }, reject);
+        };
+        image.src = src;
+    });
+};

package/dist/api/media/image/index.js

@@ -0,0 +1,9 @@
+import { temporarilyNotSupport } from '../../utils';
+// 图片
+export const saveImageToPhotosAlbum = temporarilyNotSupport('saveImageToPhotosAlbum');
+export const previewMedia = temporarilyNotSupport('previewMedia');
+export * from './previewImage';
+export * from './getImageInfo';
+export const compressImage = temporarilyNotSupport('compressImage');
+export const chooseMessageFile = temporarilyNotSupport('chooseMessageFile');
+export * from './chooseImage';

package/dist/api/media/image/previewImage.js

@@ -0,0 +1,67 @@
+import { shouldBeObject } from '../../utils';
+import { MethodHandler } from '../../utils/handler';
+/**
+ * previewImage api基于开源的React组件[react-wx-images-viewer](https://github.com/react-ld/react-wx-images-viewer)开发，感谢！
+ */
+/**
+ * 在新页面中全屏预览图片。预览的过程中用户可以进行保存图片、发送给朋友等操作。
+ */
+export const previewImage = async (options) => {
+    function loadImage(url, loadFail) {
+        return new Promise((resolve) => {
+            const item = document.createElement('taro-swiper-item-core');
+            item.style.cssText = 'display:flex;align-items:start;justify-content:center;overflow-y:scroll;';
+            const image = new Image();
+            image.style.maxWidth = '100%';
+            image.src = url;
+            const div = document.createElement('div');
+            div.style.cssText = 'display:flex;align-items:center;justify-content:center;max-width:100%;min-height:100%;';
+            div.appendChild(image);
+            item.appendChild(div);
+            // Note: 等待图片加载完后返回，会导致轮播被卡住
+            resolve(item);
+            if (typeof loadFail === 'function') {
+                image.addEventListener('error', (err) => {
+                    loadFail({ errMsg: err.message });
+                });
+            }
+        });
+    }
+    // options must be an Object
+    const isObject = shouldBeObject(options);
+    if (!isObject.flag) {
+        const res = { errMsg: `previewImage:fail ${isObject.msg}` };
+        console.error(res.errMsg);
+        return Promise.reject(res);
+    }
+    const { urls = [], current = '', success, fail, complete } = options;
+    const handle = new MethodHandler({ name: 'previewImage', success, fail, complete });
+    const container = document.createElement('div');
+    container.classList.add('preview-image');
+    container.style.cssText = 'position:fixed;top:0;left:0;z-index:1050;width:100%;height:100%;overflow:hidden;outline:0;background-color:#111;';
+    container.addEventListener('click', () => {
+        container.remove();
+    });
+    const swiper = document.createElement('taro-swiper-core');
+    // @ts-ignore
+    swiper.full = true;
+    let children = [];
+    try {
+        children = await Promise.all(urls.map(e => loadImage(e, fail)));
+    }
+    catch (error) {
+        return handle.fail({
+            errMsg: error
+        });
+    }
+    for (let i = 0; i < children.length; i++) {
+        const child = children[i];
+        swiper.appendChild(child);
+    }
+    const currentIndex = urls.indexOf(current);
+    // @ts-ignore
+    swiper.current = currentIndex;
+    container.appendChild(swiper);
+    document.body.appendChild(container);
+    return handle.success();
+};

package/dist/api/media/index.js

@@ -0,0 +1,13 @@
+export * from './audio';
+export * from './background-audio';
+export * from './camera';
+export * from './editor';
+export * from './image';
+export * from './live';
+export * from './map';
+export * from './media-recorder';
+export * from './recorder';
+export * from './video';
+export * from './video-decoder';
+export * from './video-processing';
+export * from './voip';

package/dist/api/media/live.js

@@ -0,0 +1,4 @@
+import { temporarilyNotSupport } from '../utils';
+// 实时音视频
+export const createLivePusherContext = temporarilyNotSupport('createLivePusherContext');
+export const createLivePlayerContext = temporarilyNotSupport('createLivePlayerContext');

package/dist/api/media/map.js

@@ -0,0 +1,3 @@
+import { temporarilyNotSupport } from '../utils';
+// 地图
+export const createMapContext = temporarilyNotSupport('createMapContext');

package/dist/api/media/media-recorder.js

@@ -0,0 +1,3 @@
+import { temporarilyNotSupport } from '../utils';
+// 画面录制器
+export const createMediaRecorder = temporarilyNotSupport('createMediaRecorder');

package/dist/api/media/recorder.js

@@ -0,0 +1,5 @@
+import { temporarilyNotSupport } from '../utils';
+// 录音
+export const stopRecord = temporarilyNotSupport('stopRecord');
+export const startRecord = temporarilyNotSupport('startRecord');
+export const getRecorderManager = temporarilyNotSupport('getRecorderManager');

package/dist/api/media/video/index.js

@@ -0,0 +1,74 @@
+import { MethodHandler } from '../../utils/handler';
+import { findDOM, shouldBeObject, temporarilyNotSupport } from '../../utils';
+// 视频
+export const saveVideoToPhotosAlbum = temporarilyNotSupport('saveVideoToPhotosAlbum');
+export const openVideoEditor = temporarilyNotSupport('openVideoEditor');
+export const getVideoInfo = temporarilyNotSupport('getVideoInfo');
+/**
+ * 创建 video 上下文 VideoContext 对象。
+ */
+export const createVideoContext = (id, inst) => {
+    const el = findDOM(inst);
+    // TODO HTMLVideoElement to VideoContext
+    return el === null || el === void 0 ? void 0 : el.querySelector(`taro-video-core[id=${id}]`);
+};
+export const compressVideo = temporarilyNotSupport('compressVideo');
+/**
+ * 拍摄视频或从手机相册中选视频。
+ */
+export const chooseVideo = (options) => {
+    // options must be an Object
+    const isObject = shouldBeObject(options);
+    if (!isObject.flag) {
+        const res = { errMsg: `chooseVideo:fail ${isObject.msg}` };
+        console.error(res.errMsg);
+        return Promise.reject(res);
+    }
+    const { success, fail, complete } = options;
+    const handle = new MethodHandler({ name: 'chooseVideo', success, fail, complete });
+    const res = {
+        tempFilePath: '',
+        duration: 0,
+        size: 0,
+        height: 0,
+        width: 0
+    };
+    const inputEl = document.createElement('input');
+    inputEl.setAttribute('type', 'file');
+    inputEl.setAttribute('multiple', 'multiple');
+    inputEl.setAttribute('accept', 'video/*');
+    inputEl.setAttribute('style', 'position: fixed; top: -4000px; left: -3000px; z-index: -300;');
+    document.body.appendChild(inputEl);
+    return new Promise(resolve => {
+        const TaroMouseEvents = document.createEvent('MouseEvents');
+        TaroMouseEvents.initEvent('click', true, true);
+        inputEl.dispatchEvent(TaroMouseEvents);
+        inputEl.onchange = function (e) {
+            var _a;
+            const target = e.target;
+            const file = (_a = target.files) === null || _a === void 0 ? void 0 : _a[0];
+            const reader = new FileReader();
+            reader.onload = function (event) {
+                var _a;
+                const videoEl = document.createElement('video');
+                const url = (_a = event.target) === null || _a === void 0 ? void 0 : _a.result;
+                videoEl.preload = 'metadata';
+                videoEl.src = url;
+                videoEl.onloadedmetadata = () => {
+                    res.tempFilePath = url;
+                    res.duration = videoEl.duration;
+                    res.size = event.total;
+                    res.height = videoEl.videoHeight;
+                    res.width = videoEl.videoHeight;
+                    return handle.success(res, resolve);
+                };
+            };
+            if (file) {
+                reader.readAsDataURL(file);
+            }
+        };
+    }).finally(() => {
+        document.body.removeChild(inputEl);
+    });
+};
+export const chooseMedia = temporarilyNotSupport('chooseMedia');

package/dist/api/media/video-decoder.js

@@ -0,0 +1,3 @@
+import { temporarilyNotSupport } from '../utils';
+// 视频解码器
+export const createVideoDecoder = temporarilyNotSupport('createVideoDecoder');

package/dist/api/media/video-processing.js

@@ -0,0 +1,3 @@
+import { temporarilyNotSupport } from '../utils';
+// 音视频合成
+export const createMediaContainer = temporarilyNotSupport('createMediaContainer');

package/dist/api/media/voip.js

@@ -0,0 +1,16 @@
+import { temporarilyNotSupport } from '../utils';
+// 实时语音
+export const updateVoIPChatMuteConfig = temporarilyNotSupport('updateVoIPChatMuteConfig');
+export const subscribeVoIPVideoMembers = temporarilyNotSupport('subscribeVoIPVideoMembers');
+export const setEnable1v1Chat = temporarilyNotSupport('setEnable1v1Chat');
+export const onVoIPVideoMembersChanged = temporarilyNotSupport('onVoIPVideoMembersChanged');
+export const onVoIPChatStateChanged = temporarilyNotSupport('onVoIPChatStateChanged');
+export const onVoIPChatSpeakersChanged = temporarilyNotSupport('onVoIPChatSpeakersChanged');
+export const onVoIPChatMembersChanged = temporarilyNotSupport('onVoIPChatMembersChanged');
+export const onVoIPChatInterrupted = temporarilyNotSupport('onVoIPChatInterrupted');
+export const offVoIPVideoMembersChanged = temporarilyNotSupport('offVoIPVideoMembersChanged');
+export const offVoIPChatStateChanged = temporarilyNotSupport('offVoIPChatStateChanged');
+export const offVoIPChatMembersChanged = temporarilyNotSupport('offVoIPChatMembersChanged');
+export const offVoIPChatInterrupted = temporarilyNotSupport('offVoIPChatInterrupted');
+export const joinVoIPChat = temporarilyNotSupport('joinVoIPChat');
+export const exitVoIPChat = temporarilyNotSupport('exitVoIPChat');

package/dist/api/navigate/index.js

@@ -0,0 +1,6 @@
+import { temporarilyNotSupport } from '../utils';
+// 跳转
+export const openEmbeddedMiniProgram = temporarilyNotSupport('openEmbeddedMiniProgram');
+export const navigateToMiniProgram = temporarilyNotSupport('navigateToMiniProgram');
+export const navigateBackMiniProgram = temporarilyNotSupport('navigateBackMiniProgram');
+export const exitMiniProgram = temporarilyNotSupport('exitMiniProgram');

package/dist/api/network/download.js

@@ -0,0 +1,124 @@
+import { CallbackManager } from '../utils/handler';
+import { NETWORK_TIMEOUT, setHeader, XHR_STATS } from './utils';
+const createDownloadTask = ({ url, header, success, error }) => {
+    let timeout;
+    const apiName = 'downloadFile';
+    const xhr = new XMLHttpRequest();
+    const callbackManager = {
+        headersReceived: new CallbackManager(),
+        progressUpdate: new CallbackManager()
+    };
+    xhr.open('GET', url, true);
+    xhr.responseType = 'blob';
+    setHeader(xhr, header);
+    xhr.onprogress = e => {
+        const { loaded, total } = e;
+        callbackManager.progressUpdate.trigger({
+            progress: Math.round(loaded / total * 100),
+            totalBytesWritten: loaded,
+            totalBytesExpectedToWrite: total
+        });
+    };
+    xhr.onreadystatechange = () => {
+        if (xhr.readyState !== XHR_STATS.HEADERS_RECEIVED)
+            return;
+        callbackManager.headersReceived.trigger({
+            header: xhr.getAllResponseHeaders()
+        });
+    };
+    xhr.onload = () => {
+        const response = xhr.response;
+        const status = xhr.status;
+        success({
+            errMsg: `${apiName}:ok`,
+            statusCode: status,
+            tempFilePath: window.URL.createObjectURL(response)
+        });
+    };
+    xhr.onabort = () => {
+        clearTimeout(timeout);
+        error({
+            errMsg: `${apiName}:fail abort`
+        });
+    };
+    xhr.onerror = (e) => {
+        error({
+            errMsg: `${apiName}:fail ${e.message}`
+        });
+    };
+    /**
+     * 中断任务
+     */
+    const abort = () => {
+        xhr.abort();
+    };
+    const send = () => {
+        xhr.send();
+        timeout = setTimeout(() => {
+            xhr.onabort = null;
+            xhr.onload = null;
+            xhr.onprogress = null;
+            xhr.onreadystatechange = null;
+            xhr.onerror = null;
+            abort();
+            error({
+                errMsg: `${apiName}:fail timeout`
+            });
+        }, NETWORK_TIMEOUT);
+    };
+    send();
+    /**
+     * 监听 HTTP Response Header 事件。会比请求完成事件更早
+     * @param {HeadersReceivedCallback} callback HTTP Response Header 事件的回调函数
+     */
+    const onHeadersReceived = callbackManager.headersReceived.add;
+    /**
+     * 取消监听 HTTP Response Header 事件
+     * @param {HeadersReceivedCallback} callback HTTP Response Header 事件的回调函数
+     */
+    const offHeadersReceived = callbackManager.headersReceived.remove;
+    /**
+     * 监听进度变化事件
+     * @param {ProgressUpdateCallback} callback HTTP Response Header 事件的回调函数
+     */
+    const onProgressUpdate = callbackManager.progressUpdate.add;
+    /**
+     * 取消监听进度变化事件
+     * @param {ProgressUpdateCallback} callback HTTP Response Header 事件的回调函数
+     */
+    const offProgressUpdate = callbackManager.progressUpdate.remove;
+    return {
+        abort,
+        onHeadersReceived,
+        offHeadersReceived,
+        onProgressUpdate,
+        offProgressUpdate
+    };
+};
+/**
+ * 下载文件资源到本地。客户端直接发起一个 HTTPS GET 请求，返回文件的本地临时路径。使用前请注意阅读相关说明。
+ * 注意：请在服务端响应的 header 中指定合理的 Content-Type 字段，以保证客户端正确处理文件类型。
+ */
+export const downloadFile = ({ url, header, success, fail, complete }) => {
+    let task;
+    const result = new Promise((resolve, reject) => {
+        task = createDownloadTask({
+            url,
+            header,
+            success: res => {
+                success && success(res);
+                complete && complete(res);
+                resolve(res);
+            },
+            error: res => {
+                fail && fail(res);
+                complete && complete(res);
+                reject(res);
+            }
+        });
+    });
+    result.headersReceive = task.onHeadersReceived;
+    result.progress = task.onProgressUpdate;
+    result.abort = task.abort;
+    return result;
+};

package/dist/api/network/index.js

@@ -0,0 +1,7 @@
+export * from './download';
+export * from './mdns';
+export * from './request';
+export * from './tcp';
+export * from './udp';
+export * from './upload';
+export * from './websocket';

package/dist/api/network/mdns.js

@@ -0,0 +1,12 @@
+import { temporarilyNotSupport } from '../utils';
+// mDNS
+export const stopLocalServiceDiscovery = temporarilyNotSupport('stopLocalServiceDiscovery');
+export const startLocalServiceDiscovery = temporarilyNotSupport('startLocalServiceDiscovery');
+export const onLocalServiceResolveFail = temporarilyNotSupport('onLocalServiceResolveFail');
+export const onLocalServiceLost = temporarilyNotSupport('onLocalServiceLost');
+export const onLocalServiceFound = temporarilyNotSupport('onLocalServiceFound');
+export const onLocalServiceDiscoveryStop = temporarilyNotSupport('onLocalServiceDiscoveryStop');
+export const offLocalServiceResolveFail = temporarilyNotSupport('offLocalServiceResolveFail');
+export const offLocalServiceLost = temporarilyNotSupport('offLocalServiceLost');
+export const offLocalServiceFound = temporarilyNotSupport('offLocalServiceFound');
+export const offLocalServiceDiscoveryStop = temporarilyNotSupport('offLocalServiceDiscoveryStop');