lizhengnacl/post-message-im

让通信更简单，支持离线消息

Electron版请参考：electron-ipc-im，抽象主进程、主窗口、非主窗口，让通信更简单。

概述

页面server与iframeclient的通信过程，可以用一种简易的消息模型来理解。

Feature

• 兼容所有支持ES5语法的浏览器
• 支持离线消息模型
• 平台中立，支持electron

安装

npm i post-message-im

client 使用

import { Client } from 'post-message-im'

const client = new Client({id: 'iframe id'})

client.request({
    type: '',
    params: {},
    callback: (err, res) => {}
})

client.on({
    type: '',
    callback: (err, res) => {}
})

client.request({
    type: 'offline',
    callback: (err, res) => {
        client.distribute(res);
    }
})

callback返回值

{
    rescode: 0, // 0 正确 401 鉴权失败 403 用户未授权 404 协议类型错误，协议过期 408 超时
    data: {}
}

server 使用

import { Server } from 'post-message-im'

const server = new Server({validator: () => {}})

server.on({
    type: '',
    callback: (err, res) => {
        // get data
        server.response(Object.assign({}, res, {data: data}))
    }
})

server.response('frameId', server.CONSTANTS.TYPE.SOME_SPECIFIC_TYPE, data)

Promisify

可以选择业界任意一个标准的promisify库，例如：

• bluebird 模块里有 promisify 方法
• es6-promisify 模块
• ThinkJS 里的 promisify 方法

当然，也可以直接使用下面的示例代码

let promisify = (fn, receiver = null) => {
    return (...args) => {
        return new Promise((resolve, reject) => {
            fn.apply(receiver, [...args, (err, data) => {
                return err? reject(err): resolve(data);
            }]);
        });
    };
};

client.request = promisify(c.request, c);

client.request({
    type: '',
}).then((data) => {})

// 显式的callback参数优先级会更高，但不建议这么使用
client.request({
    type: '',
    callback: (err, data) => {}
}).then((data) => {})