全部产品
云市场
云游戏

跨域 Cookie WVCookie

更新时间:2019-01-14 16:37:39

警告:该 API 不确保执行成功,使用请谨慎。

WVCookie.read

读取指定 URL 的所有 Cookie。总是建议使用 JS 来读取 Cookie,只有需要读取其它域名 Cookie 时才使用此方法。

输入参数

  • [string] url - 要读取 Cookie 的 URL。

回调参数

回调参数将会在回调方法中传递,如果成功获取指定 URL 的 Cookie,则进入 success 回调,否则进入 failure 回调。

  • [object] value - 指定 URL 的 Cookie,其中以键值对的方式存储了所有 Cookie。
  1. var params = {
  2. // 要读取 Cookie 的 URL
  3. url: 'http://h5.m.taobao.com'
  4. };
  5. window.WindVane.call('WVCookie', 'read', params, function(e) {
  6. alert('success: ' + JSON.stringify(e));
  7. }, function(e) {
  8. alert('failure: ' + JSON.stringify(e));
  9. });

WVCookie.write

写入指定的 Cookie。总是建议使用 JS 来写入 Cookie,只有需要向其它域名写入 Cookie 时才使用此方法。

输入参数

  • [string] 要写入的 Cookie 的键 - 要写入的 Cookie,可以参考下面的示例。
  • [string] domain - 要写入的 Cookie 的域。
  • [string] max-age - [可选]要写入的 Cookie 的 max-age。
  • [string] path - [可选]要写入的 Cookie 的 path,默认为 '/'

注意:其它 Cookie 属性也可以按照 max-agepath 的方式额外添加进来,一次只能设置一条 Cookie,设置多条的话请多次调用该接口。

回调参数

无回调参数,如果成功写入指定 Cookie,则进入 success 回调,否则进入 failure 回调。

  1. // 要写入的 Cookie,其名为 cookieKey,值为 cookieValue。
  2. var params = {
  3. cookieKey: 'cookieValue',
  4. domain: 'h5.m.taobao.com',
  5. };
  6. window.WindVane.call('WVCookie', 'write', params, function(e) {
  7. alert('success');
  8. }, function(e) {
  9. alert('failure: ' + JSON.stringify(e));
  10. });