跨域

本文介绍跨域类WVCookie相关的JSAPI,供您在通过跨平台DevOps创建H5端应用或者小程序时参考。跨域类WVCookie的JSAPI提供写入、读取Cookie的相关能力。

重要

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

WVCookie.read

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

输入参数

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

回调参数

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

  • [object]value:指定URL的Cookie,其中以键值对的方式存储了所有Cookie。

var params = {
        // 要读取 Cookie 的 URL
        url: 'http:// 
xxx 
.com'
};
window.WindVane.call('WVCookie', 'read', params, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVCookie.write

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

输入参数

  • [string]要写入的Cookie 的键,可以参考下面的示例。

  • [string]domain:要写入的Cookie的域。

  • [string]max-age:(可选)要写入的Cookie的max-age。

  • [string]path:(可选)要写入的Cookie的path,默认为 '/'

说明

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

回调参数

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

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