微信小程序webview postmessage通信完整配置和使用

// app.json 或 page.json
{
  "usingComponents": {},
  "permission": {
    "scope.webView": {
      "desc": "用于网页和小程序通信"
    }
  }
}

<!-- 内嵌网页需引入微信JS-SDK -->
<script src="https://res.wx.qq.com/open/js/jweixin-1.6.0.js"></script>
<!-- 或使用官方最新版本 -->

// page.js
Page({
  data: {
    webViewUrl: 'https://your-domain.com/page.html'
  },

  onLoad() {
    // 通过 web-view 组件的 ref 发送消息
  },

  // 向网页发送消息
  sendToWebPage() {
    const webview = this.selectComponent('#myWebview')
    webview.postMessage({
      data: {
        type: 'from_miniprogram',
        message: 'Hello from Mini Program!',
        timestamp: Date.now()
      }
    })
  },

  // 接收网页消息
  onMessage(e) {
    console.log('收到网页消息:', e.detail.data)
    // 处理网页发送的数据
    const { type, data } = e.detail.data
    if (type === 'from_web') {
      // 处理逻辑
    }
  }
})

<!-- page.wxml -->
<web-view 
  id="myWebview"
  src="{{webViewUrl}}"
  bindmessage="onMessage"
  bindload="onWebViewLoad"
/>
<button bindtap="sendToWebPage">发送消息到网页</button>

// 监听小程序消息
document.addEventListener('message', function(e) {
  const data = e.data
  console.log('收到小程序消息:', data)
  
  // 处理消息
  if (data.type === 'from_miniprogram') {
    // 执行相应操作
    
    // 回复消息给小程序
    if (window.wx && window.wx.miniProgram) {
      window.wx.miniProgram.postMessage({
        data: {
          type: 'from_web',
          reply: 'Message received!',
          original: data.message
        }
      })
    }
  }
})

// 主动发送消息到小程序
function sendToMiniProgram() {
  if (window.wx && window.wx.miniProgram) {
    window.wx.miniProgram.postMessage({
      data: {
        type: 'user_action',
        action: 'button_click',
        value: 'some_value',
        timestamp: new Date().getTime()
      }
    })
  }
}

// utils/webviewBridge.js
class WebViewBridge {
  constructor(webviewRef) {
    this.webview = webviewRef
    this.messageHandlers = new Map()
  }

  // 发送消息到网页
  postMessage(type, data) {
    if (!this.webview) return false
    
    this.webview.postMessage({
      data: {
        type,
        payload: data,
        timestamp: Date.now(),
        source: 'miniprogram'
      }
    })
    return true
  }

  // 注册消息处理器
  onMessage(type, handler) {
    this.messageHandlers.set(type, handler)
  }

  // 处理接收到的消息
  handleMessage(event) {
    const { type, payload, source } = event.detail.data
    if (source === 'web') {
      const handler = this.messageHandlers.get(type)
      if (handler) {
        handler(payload)
      }
    }
  }

  // 移除处理器
  offMessage(type) {
    this.messageHandlers.delete(type)
  }
}

export default WebViewBridge

// webview-bridge.js
class MiniProgramBridge {
  constructor() {
    this.handlers = new Map()
    this.init()
  }

  init() {
    // 监听小程序消息
    document.addEventListener('message', (e) => {
      const { type, payload, source } = e.data
      if (source === 'miniprogram') {
        this.dispatch(type, payload)
      }
    })

    // 监听页面卸载
    window.addEventListener('beforeunload', () => {
      this.postMessage('page_unload', {})
    })
  }

  // 发送消息到小程序
  postMessage(type, data) {
    if (window.wx && window.wx.miniProgram) {
      window.wx.miniProgram.postMessage({
        data: {
          type,
          payload: data,
          timestamp: Date.now(),
          source: 'web'
        }
      })
      return true
    }
    return false
  }

  // 注册消息处理器
  on(type, handler) {
    if (!this.handlers.has(type)) {
      this.handlers.set(type, [])
    }
    this.handlers.get(type).push(handler)
  }

  // 分发消息
  dispatch(type, data) {
    const typeHandlers = this.handlers.get(type)
    if (typeHandlers) {
      typeHandlers.forEach(handler => handler(data))
    }
  }

  // 移除处理器
  off(type, handler) {
    const typeHandlers = this.handlers.get(type)
    if (typeHandlers) {
      const index = typeHandlers.indexOf(handler)
      if (index > -1) {
        typeHandlers.splice(index, 1)
      }
    }
  }
}

// 创建全局实例
window.MiniProgramBridge = new MiniProgramBridge()

import WebViewBridge from '../../utils/webviewBridge'

Page({
  data: {
    url: 'https://example.com'
  },

  onLoad() {
    // 在 web-view 加载完成后初始化
  },

  onWebViewLoad() {
    const webview = this.selectComponent('#webview')
    this.bridge = new WebViewBridge(webview)
    
    // 注册消息处理器
    this.bridge.onMessage('user_login', (data) => {
      console.log('用户登录:', data)
      // 处理登录逻辑
    })

    this.bridge.onMessage('payment_success', (data) => {
      console.log('支付成功:', data)
      wx.showToast({
        title: '支付成功'
      })
    })
  },

  // 发送用户信息到网页
  sendUserInfo() {
    this.bridge.postMessage('user_info', {
      userId: '123',
      nickname: '张三',
      avatar: 'url'
    })
  }
})

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
</head>
<body>
  <button onclick="sendMessage()">发送消息到小程序</button>
  
  <script src="https://res.wx.qq.com/open/js/jweixin-1.6.0.js"></script>
  <script src="webview-bridge.js"></script>
  <script>
    // 监听小程序消息
    MiniProgramBridge.on('user_info', (data) => {
      console.log('收到用户信息:', data)
      document.getElementById('user-name').innerText = data.nickname
    })

    // 发送消息到小程序
    function sendMessage() {
      MiniProgramBridge.postMessage('button_click', {
        buttonId: 'submit',
        value: 'confirmed'
      })
    }

    // 页面加载完成通知小程序
    window.addEventListener('load', () => {
      MiniProgramBridge.postMessage('page_loaded', {
        title: document.title,
        url: window.location.href
      })
    })
  </script>
</body>
</html>

// 1. 添加消息类型常量
const MessageTypes = {
  USER_INFO: 'user_info',
  PAYMENT: 'payment',
  NAVIGATION: 'navigation',
  ERROR: 'error'
}

// 2. 添加超时处理
function postMessageWithTimeout(type, data, timeout = 5000) {
  return new Promise((resolve, reject) => {
    const timer = setTimeout(() => {
      reject(new Error('Message timeout'))
    }, timeout)
    
    // 发送消息逻辑
  })
}

// 3. 错误处理
try {
  webview.postMessage(data)
} catch (error) {
  console.error('发送消息失败:', error)
  // 重试或降级处理
}

// 方案1：使用URL参数传递状态（实时）
// 网页端
function updateState(state) {
  // 通过修改hash或reload传递数据
  window.location.hash = 'state=' + encodeURIComponent(JSON.stringify(state))
  
  // 或者使用URL参数
  const newUrl = window.location.pathname + '?data=' + encodeURIComponent(JSON.stringify(state))
  window.history.replaceState({}, '', newUrl)
}

// 方案2：使用Storage同步（需要轮询）
// 网页端
function sendViaStorage(data) {
  localStorage.setItem('web_to_miniprogram', JSON.stringify({
    data,
    timestamp: Date.now()
  }))
}

// 小程序端（需要轮询）
setInterval(() => {
  const storage = wx.getStorageSync('web_to_miniprogram')
  if (storage) {
    this.handleMessage(storage.data)
    wx.removeStorageSync('web_to_miniprogram')
  }
}, 100)

// 方案3：使用WebSocket（真正实时）
const ws = new WebSocket('wss://your-server.com')
ws.onmessage = (e) => {
  // 小程序通过后端中转消息
}