すべてのプロダクト
Search
ドキュメントセンター

SuperApp:クロスドメイン

最終更新日:Apr 21, 2026

このドキュメントでは、H5 アプリケーションおよびミニプログラムを開発するためのクロスドメイン WVCookie JSAPI について説明します。これらの API を使用して、クッキーの読み取りと書き込みを行います。

重要

この API の実行は保証されません。

WVCookie.read

指定された URL のすべてのクッキーを読み取ります。標準の JavaScript を使用してクッキーを読み取ることを推奨します。このメソッドは、別のドメインからクッキーを読み取る必要がある場合にのみ使用してください。

入力パラメーター

  • [string] url: クッキーを読み取る URL。

コールバックパラメーター

クッキーが正常に取得された場合は success コールバックが呼び出され、それ以外の場合は failure コールバックが呼び出されます。

  • [object] value: 指定された URL のすべてのクッキーをキーと値のペアとして含むオブジェクト。

var params = {
        // クッキーを読み取る 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

指定されたクッキーを書き込みます。標準の JavaScript を使用してクッキーを書き込むことを推奨します。このメソッドは、別のドメインにクッキーを書き込む必要がある場合にのみ使用してください。

入力パラメーター

  • [string] クッキーの名前と値。キーと値のペアとして指定します。

  • [string] domain: クッキーが有効なドメイン。

  • [string] max-age (オプション): クッキーの最大有効期間。

  • [string] path (オプション): クッキーが有効なパス。デフォルトは '/' です。

説明

max-agepath などの他のクッキー属性を追加できます。一度に設定できるクッキーは 1 つだけです。複数のクッキーを設定するには、この API を複数回呼び出す必要があります。

コールバックパラメーター

コールバックパラメーターはありません。クッキーが正常に書き込まれた場合は success コールバックが呼び出され、それ以外の場合は failure コールバックが呼び出されます。

// 書き込むクッキー。名前は '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));
});