本文介绍跨域类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:age
和path
的方式额外添加进来,一次只能设置一条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));
});
文档内容是否对您有帮助?