# wx.onCopyUrl(function listener)

基础库 2.14.3 开始支持,低版本需做兼容处理

# 功能描述

监听用户点击右上角菜单的「复制链接」按钮时触发的事件。

# 参数

# function listener

用户点击右上角菜单的「复制链接」按钮时触发的事件的监听函数

# 参数

# Object res
属性 类型 说明 最低版本
query string 用短链打开小程序时当前页面携带的查询字符串,默认为空字符串。小程序中使用时,应在进入页面时调用 wx.onCopyUrl 自定义 query,退出页面时调用 wx.offCopyUrl,防止影响其它页面。
title string 短链中的自定义标题,显示在小程序名称之后。在基础库3.15.1之前,默认是 navigationBarTitleText 的值,在基础库3.15.1及之后,默认为空字符串。 3.15.1
promise Object 如果该参数存在且为有效的 Promise,则最终的 querytitle 将以该 Promise 的 resolve 结果为准;如果 Promise 在 2 秒内未 resolve 或 reject,则回退使用同步传入的默认参数。 3.15.3

# 示例代码


  // 基础用法:同步返回分享参数
  wx.onCopyUrl(() => {
    return { query: 'a=1&b=2' }
  })

  // 使用 promise 异步返回分享参数
  wx.onCopyUrl(() => {
    return {
      query: 'a=1',  // 兜底默认参数,promise 超时时使用
      title: '默认标题',
      promise: fetchSomeInfo().then((info) => ({ query: info.query, title: info.title }))
    }
  })

  // 取消绑定分享参数
  wx.offCopyUrl()

点击咨询小助手